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

‎Kernel maintenance: About kernel -devel packages and related

← Older revision Revision as of 23:36, 24 January 2026 Line 200: Line 200:           We have a helper: Beginning with Mageia 9 on 64 bit Live like on a 64 bit installed system, {{cmd|rok}}, [[Mageia_9_Release_Notes#remove-old-kernels|remove-old-kernels]] is installed. The updated 1.0.3+ version detects when it runs on a Live system and then keep max 2 kernels (of each flavour - note backport kernel is of another flavour) and does never uninstall the original kernel.  rok runs occasionally in the background which means on slow USB dives the system may suddenly become sluggish for a while, and Xfce file managers pop up {{Bug|34964}}.  To avoid such surprise you may want to disable rok from running automatically by launching it by {{cmd|rok -A0}} as root. We have a helper: Beginning with Mageia 9 on 64 bit Live like on a 64 bit installed system, {{cmd|rok}}, [[Mageia_9_Release_Notes#remove-old-kernels|remove-old-kernels]] is installed. The updated 1.0.3+ version detects when it runs on a Live system and then keep max 2 kernels (of each flavour - note backport kernel is of another flavour) and does never uninstall the original kernel.  rok runs occasionally in the background which means on slow USB dives the system may suddenly become sluggish for a while, and Xfce file managers pop up {{Bug|34964}}.  To avoid such surprise you may want to disable rok from running automatically by launching it by {{cmd|rok -A0}} as root.  +  +==== About kernel -devel packages ====  +Note that for '''(the few) wifi''' adapters needing drivers rtl8192eu or broadcom-wl:  If Live finds such hardware during boot, kernel modules will be automatically complied for it. For this to succeed, the corresponding -devel package for the running kernel needs to be installed. The same applies to the '''proprietary nvidia''' driver(s) if you choose that boot alternative or install them another way.  +  +From the beginning there is no -devel- package installed in Live systems. It is however like other packages needed for compilation included in the in-ISO repositories and gets installed when needed. But of course it is the version for the original kernel - not compatible with other kernels you install.  +  +That means that if you update the system and get a new kernel, you should manually '''install the same kernel package that have "-devel-" added in the name''', so the system is prepared to compile kernel modules whenever needed.  Also note that at least for nvidia, you should also keep the driver updated - as early driver sometimes do not work for a late kernel.  Once installed, -devel packages and drivers will be updated like the kernel when you update the system.     == Custom Live ISO == == Custom Live ISO == Morgano

‎Backport kernels: Released :-)

← Older revision Revision as of 23:24, 24 January 2026 Line 71: Line 71:     '''In Mageia 9'''<br> '''In Mageia 9'''<br> −''{{Bug|34962}} January 2026 kernels are currently in backport_testing repo''<br>+Kernel 6.18.4+ is provided since January 2026 in the core backport repository for x86_64 in desktop and server flavour, and for i586 the same plus desktop586.<br> −Kernel 6.18.4+ is provided in Backport repository for all architectures in desktop and server flavour, plus desktop586.<br>+For aarch64 and armv7hl we currently only provide source and doc packages. <br> −You also find kernel 6.12.60 for all architectures in desktop flavour in Backort testing repository ''- note that it is old security wise now but you may like to ''test'' it if 6.18 is not compatible for your use.''<br>+You also find kernel 6.12.60 for all architectures in desktop flavour in core backort testing repository ''- note that it is old security wise now but you may like to ''test'' it if 6.18 is not compatible for your use.''<br>     Only two packages to install per kernel''' (from Backport): <br> Only two packages to install per kernel''' (from Backport): <br> Morgano

← Older revision Revision as of 21:15, 24 January 2026 Line 71: Line 71:     '''In Mageia 9'''<br> '''In Mageia 9'''<br> −''{{Bug|34962}} January 2026 kernels are currently in backport_testing repo)''<br>+''{{Bug|34962}} January 2026 kernels are currently in backport_testing repo''<br>  Kernel 6.18.4+ is provided in Backport repository for all architectures in desktop and server flavour, plus desktop586.<br> Kernel 6.18.4+ is provided in Backport repository for all architectures in desktop and server flavour, plus desktop586.<br>  You also find kernel 6.12.60 for all architectures in desktop flavour in Backort testing repository ''- note that it is old security wise now but you may like to ''test'' it if 6.18 is not compatible for your use.''<br> You also find kernel 6.12.60 for all architectures in desktop flavour in Backort testing repository ''- note that it is old security wise now but you may like to ''test'' it if 6.18 is not compatible for your use.''<br> Line 92: Line 92:  kernel-stable-testing-source <br> kernel-stable-testing-server <br> kernel-stable-testing-server-devel <br> kernel-stable-testing-desktop <br> kernel-stable-testing-desktop-devel <br>   kernel-stable-testing-source <br> kernel-stable-testing-server <br> kernel-stable-testing-server-devel <br> kernel-stable-testing-desktop <br> kernel-stable-testing-desktop-devel <br>    kernel-stable-testing-desktop586<br> kernel-stable-testing-desktop586-devel <br> kernel-stable-testing-desktop586<br> kernel-stable-testing-desktop586-devel <br> −:''(The three first only needed for 6.12, the other for 6.18 where the two last are only needed for i585 systems.)''+:''(The three first only needed for 6.12, the other for 6.18 where the two last are only needed for i586 systems.)''     === Backport incompatibilities === === Backport incompatibilities === Psyca