Lector de Feeds

Show changes Morgano

tell this page will be replaced

← Older revision Revision as of 11:46, 25 January 2026 Line 5: Line 5:  {{multi language banner|[[How_to_write_and_translate_Mageia_doc|English]] ; [[Como_escrever_e_trduzir_documentos_Mageia_pt_PT|Portuguese (Portugal)]] ;}} {{multi language banner|[[How_to_write_and_translate_Mageia_doc|English]] ; [[Como_escrever_e_trduzir_documentos_Mageia_pt_PT|Portuguese (Portugal)]] ;}}    −{{template:draft}}+'''This page is OUTDATED and will be replaced as soon as possible by [[How to write our official documentation]] and [[How to translate our official documentation]]'''     == Introduction == == Introduction == Marja

‎From writing to publishing

← Older revision Revision as of 11:37, 25 January 2026 Line 18: Line 18:  == From writing to publishing == == From writing to publishing ==    −Our manuals and help files are written using XML files. They are written with Calenco tools on the Calenco website, although it is also possible to upload new or changed XML files. The latter is done for all translations. Calenco tools are used to create HTML, WebHelp HTML, EPUB and PDF publications. See [https://publish.calenco.com/Calenco/en/780251e6-0bc8-4597-8cac-202917f5c77d-1621626492/index.html Calenco's exhaustive documentation]. There is also a very short [https://www.calenco.com/en/Documentation/Getting-to-write-quickly.html quickstarter] available.+Our manuals and help files are written using DocBook XML files. They are written with Calenco tools on the Calenco website, although it is also possible to upload new or changed XML files. The latter is done for all translations. Calenco tools are used to create HTML, WebHelp HTML, EPUB and PDF publications. See [https://publish.calenco.com/Calenco/en/780251e6-0bc8-4597-8cac-202917f5c77d-1621626492/index.html Calenco's exhaustive documentation]. There is also a very short [https://www.calenco.com/en/Documentation/Getting-to-write-quickly.html quickstarter] available.     == Calenco access == == Calenco access == Marja

start stub

New page

[[Category:Doc]]
[[Category:Howtos]]
[[Category:l10n]]

{{multi language banner|[[How_to_translate_our_official_documentation|English]]; None yet}}

{{template:draft}}

To be created. Together with [[How to write our official documentation]] intended as replacement of outdated [[How to write and translate Mageia doc]] Marja

Start page

New page

[[Category:Doc]]
[[Category:Howtos]]

{{multi language banner|[[How_to_write_our_official_documentation|English]]; None yet}}

{{template:draft}}

== Introduction ==

This page deals with the tools and processes to write Mageia's official documentation. Whilst primarily intended for use by members of the Documentation Team, all are welcome to read it.

This page is intended to replace [[How to write and translate Mageia doc]], which became outdated. About translating our official documentation, [[How to translate our official documentation]] will be written later.

== Requirements ==

If you aren't coming from this page [https://wiki.mageia.org/en/Documentation_team https://wiki.mageia.org/en/Documentation_team], have a look on it. You will learn how to join the Doc team and how to subscribe the doc-discuss mailing list. It is the place to be to have all the needed information about works in progress.

== From writing to publishing ==

Our manuals and help files are written using XML files. They are written with Calenco tools on the Calenco website, although it is also possible to upload new or changed XML files. The latter is done for all translations. Calenco tools are used to create HTML, WebHelp HTML, EPUB and PDF publications. See [https://publish.calenco.com/Calenco/en/780251e6-0bc8-4597-8cac-202917f5c77d-1621626492/index.html Calenco's exhaustive documentation]. There is also a very short [https://www.calenco.com/en/Documentation/Getting-to-write-quickly.html quickstarter] available.

== Calenco access ==

If you would like to help improve our official documentation and have already helped to improve the English part of our wiki, then you can ask for credentials.

However, If we see that we haven't managed to explain you well enough how to correctly contribute to the wiki, then we first need to find a way to improve our communication.<br/><br/>

If that isn't a problem, then you can send a mail to <br/>
"papoteur At mageia DOT org"
This e-mail must include the following information:
* Your full name (given name + surname)
* The chosen nickname Marja