119
edits
Changes
→FOP (need Java)
Creation of the Gramps manual (docbook/pdf/html) starting from the [[Gramps 3.0 Wiki Manual]]. ==How creating to create a manual starting from the wiki ?==
===MediaWiki to OpenDocument===
*[http://www.mediawiki.org/wiki/Extension:OpenDocument_Export OpenDocument Export] extension makes possible to export single pages or [http://www.mediawiki.org/wiki/Extension:Collection collections] from MediaWiki in OpenDocument Text format (.odt).
===MediaWiki to PDF===
*[http://www.mediawiki.org/wiki/Extension:PDF_Writer PDF writer] extension makes possible to export single pages or [http://www.mediawiki.org/wiki/Extension:Collection collections] from MediaWiki in PDF format (.pdf).
*There is a [http://www[Manual Generation 3.princexml.com/samples/ sample style sheet for the 0 Prince|Conversion using Prince XML formatter], which can be used for two-column printouts of Wikipedia articles, which is based on MediaWiki.]
===XML to XML===
===Wikibooks===
An alternative is to proceed as [httphttps://en.wikibooks.org/wiki/WikibooksHelp:Print_versions Wikibooks] do.
===PHP===
* [httphttps://toolswww.wikimediamediawiki.de/~magnusorg/wiki2xmlw/w2xindex.php ?oldid=3062040 wiki2xml] is was a [httphttps://svnphabricator.wikimedia.org/svnrootdiffusion/SVN/mediawikibrowse/trunk/parsers/graveyard/wiki2xml/php/wiki2xml.php GPL script] for parsing MediaWiki.
* [httphttps://wikirenderer.berliosjelix.de/enorg/ WikiRenderer] is a php component which can parse a wiki content, and transform it to XHTML content, to any other markup language, or to an other wiki content with a different syntax. Sounds correct with [http://www.dokuwiki.org/syntax dokuwiki syntax], which is not far away (headline rule inversed) from Mediawiki syntax ! => [httphttps://wikirenderer.berliosjelix.deorg/en/demo.php Demo]
===wt2db===
===wiki text to html===
===xhtml to ODT===
Overuse of ''emphasis'' and ''emphasis role="bold"''
*[http://search.cpan.org/dist/html2dbk/ HTML::ToDocBook] is CPAN perl module who that converts an XHTML file into DocBook.
==Manual Text Guidelines==
*# <nowiki>{{grampsmanualcopyright}}</nowiki>: the copyright template. This will be stripped out on manual generation.
*# <nowiki>{{man label|Labels}}</nowiki>: template for GUI elements, example: {{man label|Labels}}
*# <nowiki>{{man button|Buttons}}</nowiki>: template for GUI buttons , example {{man button|Buttons}}
*# <nowiki>{{man tip| 1=title |2=text.}}</nowiki>: template to add a tip in the text
*# <nowiki>{{man note| title |text}}</nowiki>: template to add a note to the text
*# <nowiki>{{man warn| title |text}}</nowiki>: template to add a warning to the text
*# <nowiki>{{man index|prevpage|nextpage}}</nowiki>: template to add the bottom index bar. This will be stripped out on manual generation.
*#<nowiki>{{man menu|Edit->Preferences}}</nowiki>: template for the menu items sequence, example {{man menu|Edit->Preferences}}
*# <nowiki>{{languages}}</nowiki>: template to add language bar. This will be stripped out on manual generation.
*The following markup code may be used:
*#<nowiki>''' bold '''</nowiki>: for bold or menuselections in GRAMPS, eg. '''Edit->PreferencesGramps'''
*#<nowiki>'' italic ''</nowiki>: for italic or filenames in GRAMPS, eg. ''filename''
*#<nowiki><code> code sections</code></nowiki>: for commands you type in the command line.
===xmlto (need PassiveTeX and TeX)===
A tool for converting XML files to various formats [httphttps://cyberelkpagure.net/tim/softwareio/xmlto/ xmlto] pdf mydoc.xmlIs it [http://www.gramps-project.org/wiki/index.php?title=Gramps-about Tim Waugh] ?[[media:Ancestors.xsl.gz|Ancestors.xsl]] [[media:Birthday.xsl.gz|Birthday.xsl]]
[[media:Birthday.xsl.gz|Birthday.xsl]] ===FOP (need Formatting Objects Processor)(needs Java)===see [http://www.gramps-project.org/wiki/index.php?title=[Manual_Generation |Manual generation]]
==A Test==
There is a user request for a [http{{bug|2132}}://www.gramps-project.org/bugs/view.php?id=2132 ''downloadable text format users manual] '' on bug manager.
Steps:
# add/clean anchors
# using [http://tidy.sourceforge.net/ Tidy]
==See also==
* [[User manual]]
* [[Rollover for the manual]]
* [[Manual Generation]]
* [[Manual Generation 3.0 Prince]]
[[Category:Documentation]]
[[Category:Translators/Categories]]
