I recommend we use the Fedora wiki syntax conventions for the textbook. In particular, the content on marking up technical items:
http://fedoraproject.org/wiki/Help:Editing#Marking_Technical_Terms http://fedoraproject.org/wiki/Help:Editing#Writing_Example_Commands That was specifically written to give a consistent markup for a team working on material that is going to be converted to DocBook XML. (It's always a good idea to be consistent, but it really helps to know that when you find <emphasis>Foo</emphasis> it only means <application>Foo</application> or actually <emphasis>, etc.) We have a page that is slightly out of date, but the conversion tables are accurate: https://fedoraproject.org/wiki/Converting_wiki_to_DocBook_XML#Wiki_markup_output_to_XML.2C_mapped_to_DocBook_XML I am going to check with our Publican and MediaWiki experts to be sure, but I may need to refactor the = sections = for each chapter. Not a big deal, but we want something that is going to export and nest properly right away. A final item is seeing if I can get a working toolchain for the export from MediaWiki. Paul Frields has a package in testing that may provide the long-awaited solution so we can get a working mw-render again (it's from python-mwlib, a Python library for interacting with MediaWiki articles.) - Karsten -- name: Karsten 'quaid' Wade, Sr. Community Gardener team: Red Hat Community Architecture uri: http://TheOpenSourceWay.org/wiki gpg: AD0E0C41
pgpkg7eq560wX.pgp
Description: PGP signature
_______________________________________________ tos mailing list [email protected] http://teachingopensource.org/mailman/listinfo/tos
