MoodleDocs:StyleGuide

Diese Seite ist noch nicht vollständig übersetzt.

Siehe en:MoodleDocs:Style guide

Kategorien

Eine Kategorie ist eine Übersichtsseite von Dokumentations-Seiten. Dh. Seiten die zu einem bestimmen Thema zusammengefasst werden, finden sich in einer Kategorie wieder.

• Eine Seite kann zu einer Kategorie hinzugefügt werden, in dem Sie die entsprechende Kategorie in die Seite einfügen. Dies geschieht durch folgenden Wiki-Syntax: [[Category:Kategorie-name]], zum Beispiel [[Category:Trainer]], am Ende der Seite. Sie können mehrere unterschiedliche Kategorien zu einer Seite hinzufügen, wenn Sie die Seite in unterschiedliche Kategorien aufnehmen möchten. Aber Sie können nicht unterschiedliche Kategorien in den Tag aufnehmen. Beispiel:

[[Category:Trainer]]
[[Category:Teilnehmer]] 

• Um sicherzustellen, dass die Seiten in alphabetischer Reihenfolge bei Aufruf der Kategorie-Übersicht aufgelistet werden, sollte der Seitenname in den Kategorie-Link mit aufgenommen werden. Z.B.: [[Category:Entwickler|Neuer Seiten Name]].
• Der Link Kategorien listet alle Moodle Docs Kategorien auf. Der Link kann auch über den Block "Werkzeuge" auf der rechten Seite unter dem Menüpunkt "Spezialseiten" aufgerufen werden.
• To improve the browsing of Moodle Docs by category, please categorize category pages too. This will result in subcategories being created. For example, Category:Capabilities is categorized as "Administrator" and "Roles", and appears as a subcategory in Category:Administrator and Category:Roles.
• It is not necessary to categorize pages in a subcategory with the same category as the category page. For example, none of the pages in Category:Capabilities need to be categorized as "Administrator" or "Roles".
• For further information about categories and how they work in MediaWiki, please refer to the Wikipedia:Categorization.

Screenshots

• You are encouraged to illustrate documentation with screenshots. Please use the official Moodle demo site, or any other site or course using one of the standard themes, and ensure that the screenshot is as small as possible.
• Screenshots should be GIF, JPEG or PNG format, with 72ppi resolution, and maximum width 800px.
• To fit more into a screenshot, select a smaller text size for the web page via the View > Text size menu in your web browser.
• Screenshots can be uploaded using the toolbox Upload file link.
• Please name screenshots descriptively to avoid confusion.
• To include the screenshot in an article, use a link in the form [[Image:Screenshot.png|thumb|alt text]].
• Please do not apply effects such as borders, watermarks or drop shadows to screenshots. This will allow others to add or replace screenshots over time and still maintain a consistent look and feel to articles.
• For help on image placement and adding an image caption, please refer to the Wikipedia Picture tutorial.

Vorlagen

• In MediaWiki, a template is a page which can be inserted into another page. For example, the Moodle Docs help block on this page is a template.
• A template may be added to a page by typing {{Name}} for Template:Name.
• All pages (Template namespace) lists all Moodle Docs templates.
• Please refer to the MediaWiki Template help for further information.

Moodle Docs bearbeiten tags

• Deletion - If you find any page requiring deletion, type {{Deletion}} at the top of the page. Use the page comments if necessary to state the reason for deletion.
• Update - Features increase with each Moodle version. If you find a page requiring updating, type [[Template:Update]] at the top of the page.
• Stub - Developers and Moodle Docs administrators may add a new page with a {{Stub}} tag at the top, requesting help in adding content.
• You can also use the edit summary to communicate the need for more editing. For example in the page history you might see: "Added section, needs more work, see page comments".

PHP Syntax Hervorhebung

• Um PHP-Syntax (oder jeden beliebigen anderen Programmier-Code) speziell hervorzuheben, schließen Sie die Codezeilen in Tags ein. Nutzen Sie dazu folgende Befehle:

<code php>...Der Code folgt hier...</code>