This repo is tracking the development of several projects related to Fedora Docs (2.0? .next? reboot?). None of it is official work of the Fedora Project, yet.
This is all in one repo and kind of a "hot mess." This is because we have no end-to-end testing yet so it should be easier to keep it all building together and then tease it apart later when it matures.
This is to test some topic based building ideas. The ideas are centered on how to have modules and build them into assemblies. For some details on the language, pending some meta-documentation getting committed here, see this thread.
assemblies: Directory of user story assemblies
modules: Directory of discrete standalone text elements
asciibinder doesn't support multiple source repositories, this work extends
asciibinder with a preprocessor.
_collections_map.yml: yaml file to drive the multi-repository preprocessor
builder.sh: original bash version of the preprocessor. Includes non-ruby implemented Zanata updates
multi_ascii_binder.rb: Ruby version of the preprocessor
Work needs to be done on loading AsciiDoc into Zanata and getting localized text back. The
builder.sh developed for the multi-repository
asciibinder work does this in a rough way. This needs to be extended. The current solution relies on
po4a No work has been done since
asciibinderstores display titles in both
_topic_map.ymlthe solution needs to account for these
Moving to AsciiDoc will require a one-time conversion of Fedora Docs materials from DocBook to AsciiDoc. If the material is not rewritten in modules immediately, it'd be great to have a way of doing this with some automation so that it is less work and can get done faster. This automation will also help others and provide us with some test material for localization (see above).
We need a search solution and elastic seems to be the way to go. One idea is to use the sitemap.xml produced by
asciibinder to feed an elastic instance. No work has been done.
Ideally we will get both CI and CD in the future.
asciibinder to build the site has a lot of potential. It is also used by several other projects giving us a larger community base to build on.
_distro_map.yml: Configuration File
_topic_map.yml: Configuration File