Hinweise für MoodleDocs Autoren: Unterschied zwischen den Versionen

Aus MoodleDocs
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
 
(12 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Moodle Docs}}
{{MoodleDocs}}
 
'''Hinweis''': Lange Zeit waren die deutschen MoodleDocs-Seiten ein wenig ein Sorgenkind. Nach einem ersten Start durch Ulrike Montgomery und eine ganze Reihe von Lehrern wurde es ruhig. Niemand fand die Zeit und die Energie dazu, dieses Projekt in Angriff zu nehmen.
 
Das hat sich nun geändert. Im April 2008 hat [http://moodle.org/user/view.php?id=40518&course=1 Gisela Hillenbrand] die Koordination für das deutschsprachige Dokumentationswiki übernommen. Sie verfügt über Administrationsrechte für die deutschen MoodleDocs-Seiten und koordiniert die Übersetzungsarbeit. Siehe auch [http://moodle.org/mod/forum/view.php?id=1489 Übersetzungsforum] im Kurs "Deutschsprachiges Moodle" auf moodle.org.
 
== 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 Moodle Docs Seiten kopieren (gleichwohl wird es vokommen, dass gewisse Informationen sowohl in den Hilfedateien als auch in MoodleDocs stehen).
* 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 [[Moodle Docs StyleGuide|StyleGuide]].
* 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:StyleGuide|StyleGuide]] und stellen Sie insbesondere sicher, dass neue Seiten richtig kategorisiert werden.
*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 MoodleDocs-Seiten==
==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 <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.
* 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: Hilfe. Der Inhalt dieses Blocks ist eine Vorlage.
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 '''[[MoodleDocs:StyleGuide#Vorlagen|StyleGuide]]''' nach, in dem Sie alle Informationen zur Gestaltung von Seiten finden.
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.
 
Zusätzlich können Sie Inhalte mit einer Markierung versehen, aus der ersichtlich wird, ab welcher Moodle-Version die beschriebene Funktionalität zur Verfügung steht. Auch dazu finden Sie weitere Informationen im '''[[MoodleDocs:StyleGuide#Vorlagen_f.C3.BCr_verschiedene_Moodle-Versionen|StyleGuide]]'''.


== Kommentare ==
== Kommentare ==
Zeile 36: Zeile 32:
* 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 '''<nowiki>~~~~</nowiki>''', damit die Diskussion übersichtlich bleibt.
* 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 '''<nowiki>~~~~</nowiki>''', damit die Diskussion übersichtlich bleibt.
* Für umfangreichere Diskussionen zu verschiedenen Artikeln, nutzen Sie bitte das [http://moodle.org/mod/forum/view.php?id=1489 Übersetzungsforum] im Kurs "Deutschsprachiges Moodle'" auf moodle.org.
* Für umfangreichere Diskussionen zu verschiedenen Artikeln, nutzen Sie bitte das [http://moodle.org/mod/forum/view.php?id=1489 Ü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 [http://moodle.org/course/view.php?id=5 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 [http://moodle.org/course/view.php?id=5 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  [http://moodle.org/course/view.php?id=5 Using Moodle]. Ergebnisse einer Diskussion sollten danach jedoch direkt in MoodleDocs einfließen.


== Siehe auch==
== Siehe auch==
* [[MoodleDocs:StyleGuide|StyleGuide für die dt. MoodleDocs]]
* [[MoodleDocs StyleGuide|StyleGuide]]
* [[Hilfe:Bearbeitung von Wiki-Seiten|Bearbeitung von Wiki-Seiten]]
* [[Bearbeitung von MoodleDocs-Seiten]]


{{Credits}} [https://docs.moodle.org/19/de/MoodleDocs:Anleitung]


[[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.

Siehe auch