Note: You are currently viewing documentation for Moodle 1.9. Up-to-date documentation for the latest stable version is available here: Starting MoodleDocs.

MoodleDocs:Starting MoodleDocs

From MoodleDocs
Moodle Docs development


Starting Moodle Docs in another language

Would you like Moodle Docs in your language?

Please check first whether all of the help files included in Moodle have been translated into your language. If not, perhaps you could offer to help your language pack maintainer(s) - see Translation credits for contact details.

Moodle Docs in a new language needs:

  • An administrator (or two)
The administrator should understand MediaWiki features such as page redirects, categories, templates and disambiguation pages. Please browse this wiki to discover how these features work.
  • Lots of people wishing to contribute
Please find out how many people are interested by discussing Moodle Docs in your moodle.org community discussion course. You should also contact your language pack maintainer(s) - see Translation credits for contact details.

If you wish to start Moodle Docs in your language, are willing to take on administrator responsibility, and know of lots of people wishing to contribute, please send an email to docs@moodle.org to arrange for a wiki https://docs.moodle.org/xx to be set up.

Once your documentation wiki is set up, please announce it in your moodle.org community discussion course. Suggestions of what to do next are described below. Whilst everyone in your community may login and contribute to the documentation, system messages pages i.e. pages in the MediaWiki namespace are locked so that only administrators may edit them.

Initial pages

  • Create a Main Page with appropriate links. You may wish to focus initially on the teacher or the administrator documentation.
  • Transfer the information from the files in your language pack docs directory to Moodle Docs, updating the information as necessary (see Language packs and Moodle Docs for details of where up-to-date information from the en language pack docs directory may be found in Moodle Docs). Files in your language pack docs directory may then be deleted from CVS (see tracker report [https://tracker.moodle.org/browse/MDL-4912 MDL-4912 /docs folder needs to be reviewed and files removed]).
  • Update the main navigation block and create the documentation block by translating MediaWiki:Sidebar.
  • Translate MediaWiki:Noarticletext to provide links to the English documentation for pages which do not yet exist in your language.

Inter-language linking

  • Add inter-language links to pages by typing [[xx:Corresponding page title in the new language]] in the English MoodleDocs, and [[en:Corresponding page title in English]] in the new language Moodle Docs, at the bottom of the page, below the category link. Inter-language links will appear automatically in the "In other languages" block.

Further links to the English documentation

  • Optional: Provide further links to English documentation pages by typing [[:en:English page title]] (adding an extra : before en:) e.g. en:Release Notes.

Note: MediaWiki:Noarticletext, containing the text below, automatically provides links for every page in Moodle to the corresponding English documentation page if they do not yet exist in your language. 

This page does not exist yet. You are welcome to [{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|action=edit}} create it]
 or read ''[[:en:{{NAMESPACE}}:{{PAGENAME}}|the corresponding page in the English documentation]]''.

Moodle Docs pages

Translate the following, including page names:

System messages

Translate the following system messages:

Depending upon the language, certain additional system messages may require translating, for example:

Link pages

  • Create a set of link pages, leaving the names as file paths and simply adding translated categories.
  • Move all link pages to provide translated page names.

Publicity

Retrieved from "https://docs.moodle.org/19/en/index.php?title=MoodleDocs:Starting_MoodleDocs&oldid=46764"
Powered by MediaWiki