Hinweise für MoodleDocs Autoren: Unterschied zwischen den Versionen
Aus MoodleDocs
MoodleDocs nutzen
MoodleDocs schreiben
Keine Bearbeitungszusammenfassung |
|||
| (9 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
{{ | {{MoodleDocs}} | ||
== Einleitung== | == Einleitung== | ||
* Wir freuen uns über jede Mithilfe an den deutschen MoodleDocs-Seiten. Falls Sie in den Artikeln etwas finden, das sprachlich, grammatikalisch oder in der Formatierung verbesserungswürdig scheint, dann verbessern Sie es! | * Wir freuen uns über jede Mithilfe an den deutschen MoodleDocs-Seiten. Falls Sie in den Artikeln etwas finden, das sprachlich, grammatikalisch oder in der Formatierung verbesserungswürdig scheint, dann verbessern Sie es! | ||
| Zeile 10: | Zeile 5: | ||
* Eine Liste der Seiten zum Übersetzen finden Sie in der Seitenkategorie [[:Category:Update|Update]]. | * Eine Liste der Seiten zum Übersetzen finden Sie in der Seitenkategorie [[:Category:Update|Update]]. | ||
* Alle Beiträge unterliegen der [http://www.gnu.org/copyleft/fdl.html GNU Free Documentation License 1.2]. | * Alle Beiträge unterliegen der [http://www.gnu.org/copyleft/fdl.html GNU Free Documentation License 1.2]. | ||
* Die Moodle-Hilfedateien werden nach wie vor mit den Sprachpaketen ausgeliefert. D.h. Sie brauchen nicht die Inhalte der Hilfedateien in die | * Die Moodle-Hilfedateien werden nach wie vor mit den Sprachpaketen ausgeliefert. D.h. Sie brauchen nicht die Inhalte der Hilfedateien in die MoodleDocs Seiten kopieren (gleichwohl wird es vokommen, dass gewisse Informationen sowohl in den Hilfedateien als auch in MoodleDocs stehen). | ||
* Um Inhalte anschaulicher zu gestalten, können Sie auch Screenshots und Bilder in die Seiten einpflegen. Eine Anleitung dazu finden Sie im [[ | * Um Inhalte anschaulicher zu gestalten, können Sie auch Screenshots und Bilder in die Seiten einpflegen. Eine Anleitung dazu finden Sie im [[MoodleDocs StyleGuide|StyleGuide]]. | ||
'''Anmerkung:''' <font color="red"> ''Die folgenden Abschnitte und die darin enthaltenen Links zu weiteren Artikeln enthalten zahlreiche Hinweise für Autor/innen, Syntaxhilfen, StyleGuide-Regeln usw. Bitte lassen Sie sich von der Fülle nicht abschrecken. Wir sind bisher eine Handvoll Moodle-Begeisterte, die die MoodleDocs schreiben und jeder kleine Beitrag ist herzlich willkommen!''</font> | |||
==Anlegen neuer MoodleDocs-Seiten== | ==Anlegen neuer MoodleDocs-Seiten== | ||
| Zeile 17: | Zeile 15: | ||
*Verwenden Sie kurze Namen für neue Seiten. Der Name der Seite soll mit einem Großbuchstaben beginnen. Verwenden Sie Begriffe aus dem dt. Sprachpaket. Fragen Sie bei der [http://moodle.org/user/view.php?id=40518&course=1 Koordinatorin] nach, wenn Sie sich unsicher sind. | *Verwenden Sie kurze Namen für neue Seiten. Der Name der Seite soll mit einem Großbuchstaben beginnen. Verwenden Sie Begriffe aus dem dt. Sprachpaket. Fragen Sie bei der [http://moodle.org/user/view.php?id=40518&course=1 Koordinatorin] nach, wenn Sie sich unsicher sind. | ||
*Neue Seiten, die sich speziell an Entwickler richten, sollten im speziellen Namensraum ''Entwicklung'' angelegt werden, d.h. Sie geben der Seite den Namen <code><nowiki>[[Entwicklung:Name der neuen Seite]]</nowiki></code>. | *Neue Seiten, die sich speziell an Entwickler richten, sollten im speziellen Namensraum ''Entwicklung'' angelegt werden, d.h. Sie geben der Seite den Namen <code><nowiki>[[Entwicklung:Name der neuen Seite]]</nowiki></code>. | ||
*Beachten Sie die Hinweise im [[MoodleDocs | *Beachten Sie die Hinweise im [[MoodleDocs StyleGuide|StyleGuide]] und stellen Sie insbesondere sicher, dass neue Seiten richtig kategorisiert werden. | ||
*Namen von neuen Seiten können zu einem späteren Zeitpunkt durch Verschieben bzw. Weiterleiten geändert werden. Dies ist u.a. Aufgabe des [http://moodle.org/user/view.php?id=40518&course=1 Koordinators]. | *Namen von neuen Seiten können zu einem späteren Zeitpunkt durch Verschieben bzw. Weiterleiten geändert werden. Dies ist u.a. Aufgabe des [http://moodle.org/user/view.php?id=40518&course=1 Koordinators]. | ||
==Verlinkung zu anderssprachigen | ==Verlinkung zu anderssprachigen MoodleDocs Seiten== | ||
* Bitte fügen Sie in eine deutsche | * Bitte fügen Sie in eine deutsche MoodleDocs Seite Links zu entsprechenden anderssprachigen Moodle-Seiten, insbesondere zur englischen Originalseite, ein. Tragen Sie dazu einfach die Zeile <code><nowiki>[[en:Name der entsprechenden englischen Seite]]</nowiki></code> für Englisch oder <code><nowiki>[[es:Name der entsprechenden spanischen Seite]]</nowiki></code> für Spanisch, ganz unten auf die Seite, noch unter den Kategorie-Links, ein. Für jede Sprache, die Sie eintragen, erscheint ein Link zur entsprechenden Seite im Block ''Andere Sprachen'' links unten auf der MoodleDocs-Seite. | ||
==Vorlagen== | ==Vorlagen== | ||
Vorlagen sind Seiten, die in andere Seiten eingefügt werden können. Wenn Sie rechts oben auf die Seite sehen, finden Sie dort den Block: | Vorlagen sind Seiten, die in andere Seiten eingefügt werden können. Wenn Sie rechts oben auf die Seite sehen, finden Sie dort den Block: MoodleDocs. Der Inhalt dieses Blocks ist eine Vorlage. Detaillierte Informationen zu Vorlagen finden Sie im Artikel [[MoodleDocs:Vorlagen|MoodleDocs Vorlagen]]. | ||
Darüber hinaus gibt es spezielle Vorlagen, die für bestimme Markierungen vorgesehen sind. Welche das sind, lesen Sie bitte im '''[[ | Darüber hinaus gibt es spezielle Vorlagen, die für bestimme Markierungen vorgesehen sind. Welche das sind, lesen Sie bitte im '''[[MoodleDocs StyleGuide#Vorlagen|StyleGuide]]''' nach, in dem Sie alle Informationen zur Gestaltung von Seiten finden. | ||
== Kommentare == | == Kommentare == | ||
| Zeile 43: | Zeile 41: | ||
== Siehe auch== | == Siehe auch== | ||
* [[ | * [[MoodleDocs StyleGuide|StyleGuide]] | ||
* [[Bearbeitung von | * [[Bearbeitung von MoodleDocs-Seiten]] | ||
[[en:MoodleDocs:Guidelines for contributors]] | [[en:MoodleDocs:Guidelines for contributors]] | ||
[[es:MoodleDocs:Normas para colaboradores]] | |||
[[fr:Contribution à la documentation]] | |||
[[ja:MoodleDocs:寄稿のガイドライン]] | |||
Aktuelle Version vom 24. März 2019, 22:01 Uhr
Einleitung
- Wir freuen uns über jede Mithilfe an den deutschen MoodleDocs-Seiten. Falls Sie in den Artikeln etwas finden, das sprachlich, grammatikalisch oder in der Formatierung verbesserungswürdig scheint, dann verbessern Sie es!
- Zunächst sollten Sie sich dazu hier anmelden.
- Eine Liste der Seiten zum Übersetzen finden Sie in der Seitenkategorie Update.
- Alle Beiträge unterliegen der GNU Free Documentation License 1.2.
- Die Moodle-Hilfedateien werden nach wie vor mit den Sprachpaketen ausgeliefert. D.h. Sie brauchen nicht die Inhalte der Hilfedateien in die MoodleDocs Seiten kopieren (gleichwohl wird es vokommen, dass gewisse Informationen sowohl in den Hilfedateien als auch in MoodleDocs stehen).
- Um Inhalte anschaulicher zu gestalten, können Sie auch Screenshots und Bilder in die Seiten einpflegen. Eine Anleitung dazu finden Sie im StyleGuide.
Anmerkung: Die folgenden Abschnitte und die darin enthaltenen Links zu weiteren Artikeln enthalten zahlreiche Hinweise für Autor/innen, Syntaxhilfen, StyleGuide-Regeln usw. Bitte lassen Sie sich von der Fülle nicht abschrecken. Wir sind bisher eine Handvoll Moodle-Begeisterte, die die MoodleDocs schreiben und jeder kleine Beitrag ist herzlich willkommen!
Anlegen neuer MoodleDocs-Seiten
- Gern können Sie neue Seiten anlegen, um die Moodle-Dokumentation zu erweitern. Geben Sie einfach den Namen der neuen Seite (in doppelte eckige Klammern eingeschlossen:
[[Name der neuen Seite]]) auf einer bestehenden MoodleDocs-Seite ein. Folgen Sie dem so entstandenen Link, um die neue Seite zu bearbeiten. Alternativ können Sie im Browser die URL der neuen Seite eingeben:https://docs.moodle.org/de/Name_der_neuen_Seite(ersetzen Sie Leerzeichen im Namen der Seite durch Unterstriche). - Verwenden Sie kurze Namen für neue Seiten. Der Name der Seite soll mit einem Großbuchstaben beginnen. Verwenden Sie Begriffe aus dem dt. Sprachpaket. Fragen Sie bei der Koordinatorin nach, wenn Sie sich unsicher sind.
- Neue Seiten, die sich speziell an Entwickler richten, sollten im speziellen Namensraum Entwicklung angelegt werden, d.h. Sie geben der Seite den Namen
[[Entwicklung:Name der neuen Seite]]. - Beachten Sie die Hinweise im StyleGuide und stellen Sie insbesondere sicher, dass neue Seiten richtig kategorisiert werden.
- Namen von neuen Seiten können zu einem späteren Zeitpunkt durch Verschieben bzw. Weiterleiten geändert werden. Dies ist u.a. Aufgabe des Koordinators.
Verlinkung zu anderssprachigen MoodleDocs Seiten
- Bitte fügen Sie in eine deutsche MoodleDocs Seite Links zu entsprechenden anderssprachigen Moodle-Seiten, insbesondere zur englischen Originalseite, ein. Tragen Sie dazu einfach die Zeile
[[en:Name der entsprechenden englischen Seite]]für Englisch oder[[es:Name der entsprechenden spanischen Seite]]für Spanisch, ganz unten auf die Seite, noch unter den Kategorie-Links, ein. Für jede Sprache, die Sie eintragen, erscheint ein Link zur entsprechenden Seite im Block Andere Sprachen links unten auf der MoodleDocs-Seite.
Vorlagen
Vorlagen sind Seiten, die in andere Seiten eingefügt werden können. Wenn Sie rechts oben auf die Seite sehen, finden Sie dort den Block: MoodleDocs. Der Inhalt dieses Blocks ist eine Vorlage. Detaillierte Informationen zu Vorlagen finden Sie im Artikel MoodleDocs Vorlagen.
Darüber hinaus gibt es spezielle Vorlagen, die für bestimme Markierungen vorgesehen sind. Welche das sind, lesen Sie bitte im StyleGuide nach, in dem Sie alle Informationen zur Gestaltung von Seiten finden.
Kommentare
- Zu jeder MoodleDocs-Seite können Kommentare geschrieben und Ideen diskutiert werden. Klicken Sie dazu oben auf den Reiter diskussion. Bitte markieren und datieren Sie ihren Eintrag dort mit vier Tildezeichen ~~~~, damit die Diskussion übersichtlich bleibt.
- Für umfangreichere Diskussionen zu verschiedenen Artikeln, nutzen Sie bitte das Übersetzungsforum im Kurs "Deutschsprachiges Moodle'" auf moodle.org.
Tipps
- Betrachten Sie MoodleDocs als die zentrale Wissensbasis zu Moodle.
- Übertragen Sie Inhalte der Diskussionsforen aus dem Kurs Using Moodle auf moodle.org (z.B. HowTo-Fragen, FAQs, Vorschläge zur Nutzung einer bestimmten Funktionalität in Moodle usw.)
- Ermutigen Sie Moodle-Neulinge, zu MoodleDocs beizutragen: Moodle-Neulinge sind ideale Autoren für allgemeine Artikel rund um Moodle oder für Beiträge zu den FAQs.
- Ermutigen Sie erfahrene Nutzer von Using Moodle, ihre Antworten auf Fragen in den Diskussionsforen nach MoodleDocs zu übertragen.
- Verwenden Sie "Siehe auch"-Links auf MoodleDocs-Seiten und referenzieren Sie passende Beiträge aus den Diskussionsforen in Using Moodle. Ergebnisse einer Diskussion sollten danach jedoch direkt in MoodleDocs einfließen.
