Note:

If you want to create a new page for developers, you should create it on the Moodle Developer Resource site.

Translating Moodle Docs: Difference between revisions

From MoodleDocs
(Added reference to The quick guides)
(added link for Mount Orange for Boost theme replication)
Line 10: Line 10:


==Translating the screen images used in Moodle Docs==
==Translating the screen images used in Moodle Docs==
If you want to recreate the bright orange-coloured screen images used in the Documentation pages (eg, [https://docs.moodle.org/30/en/New_features Moodle 3.0 New features Docs page]), you can replicate the Mount Orange school theme in your local server by following the details outlined [https://docs.moodle.org/30/en/Standard_themes#Mount_Orange:_example_of_a_customised_More_theme here].
If you want to recreate the bright orange-coloured screen images used in the Documentation pages (eg, [https://docs.moodle.org/30/en/New_features Moodle 3.0 New features Docs page]), you can replicate the Mount Orange school theme in your local server by following the details outlined [https://docs.moodle.org/30/en/Standard_themes#Mount_Orange:_example_of_a_customised_More_theme here for Moodle 3.0] and [https://docs.moodle.org/32/en/Standard_themes#Example_of_a_customised_Boost_theme here for the Boost theme in more recent Moodle branches].


==Which documentation pages are most important or useful to translate?==
==Which documentation pages are most important or useful to translate?==

Revision as of 14:45, 11 May 2017

Contributing to the documentation

Moodle Docs pages, such as the page you are reading right now, are wiki pages available in several languages. Any registered Moodle user can contribute to Moodle Docs and improve or translate these wiki pages. Please make sure to follow the guidelines for contributors.

You need to make at least one edit to an existing docs page before you are allowed to create a new page (an anti-spam feature).

You might find it useful to add the original English documentation pages that you have just translated to your watchlist (alt-shift-w), so that you will know when your translation might need to be re-checked for a possible update.

If your language does not have a documentation wiki, you are welcome to add a link to en:Moodle manuals to documentation available elsewhere e.g. Google Docs.

Translating the screen images used in Moodle Docs

If you want to recreate the bright orange-coloured screen images used in the Documentation pages (eg, Moodle 3.0 New features Docs page), you can replicate the Mount Orange school theme in your local server by following the details outlined here for Moodle 3.0 and here for the Boost theme in more recent Moodle branches.

Which documentation pages are most important or useful to translate?

Many Moodle users will start reading the English docs main page. This might be a good page to have translated.

The new features in the latest version would surely be of interest to the users of previous Moodle versions that want to catch up with the new available features.

The quick guides are very short pages (that hopefully you can very quickly translate) that teachers can quickly check, in order to grasp how an important Moodle feature works, without having to read the standard detailed (long) Moodle full documentation pages.

The Table of contents has a very comprehensive and organized list of important Moodle topics. This might be a worthy addition to your language documentation.

If you see a post which has been rated as 'Useful' several times in a Forum in a language other than English, which links to an untranslated English documentation page, it might be a good idea to translate this page.

The English Documentation Special Page with the Most linked-to pages shows the English pages that have the highest number of links and (except for all the User: pages) you will find there many pages highly useful for Moodlers of all languages and worth translating to your language (eg, Managing a Moodle site & Managing a Moodle course).

If you are a Moodle site admin or teacher, using a language other than English, and you use the 'Moodle Docs for this page' link in your daily work, please consider translating the English pages that helped you most to do your job and solve your problems. See below.

Translating the Documentation pages for 'Mooodle Docs for this page' and 'More help' links

  • When logged in as an admin or teacher, 'Moodle Docs for this page' links at the bottom of each page in Moodle take you to documentation about that page in your language, if it exists, otherwise in English.

Moodle Docs for this page.png

  • You might be tempted to start typing the documentation in your own language (if such a page exists), but please don't do it. Instead, change your language to English and then click in the 'Moodle Docs for this page' link.
  • In the English documentation page that just opened, add a language link for your language (see Interlanguage-linking), save it and then open the given translation page.
  • If the English Documentation page has only a redirect instruction, please add a translation for the redirection and then save the English page with the redirection

Redirected page.png Redirected page in English.png

  • Make sure that you add a translation link for the redirection, check that it works (create the page if it did not exist) and save the page.

Redirected page in English with Spanish translation link.png

  • You can now jump to the redirected page in your own language and work on it.

Redirected page in Spanish.png

  • The 'More help' links have the same icon (i) and work the same way as the 'Moodle Docs for this page' links.

Is it important to translate English Documentation pages that only have one #Redirect instruction?

Yes, it is very, very fast and it will make your translated wiki more efficient, because you will replicate all the automatic redirections that exist in the English Docs in your own language Docs, specially with the Docs pages related to online help for specific pages in your Moodle server (see the example above).

If you have translated Documentation pages with #Redirect instructions, it will then be a good idea to go to the TOOLS column at the bottom of the page (in your language wiki documentation) and click on 'Special pages'. There, check the 'Broken redirects' and 'Double redirects' links and fix any pages that might show up there.

Which English documentation pages will change when there is a new Moodle version release


See also