Übersetzungs Status → Dies ist eine von 35 Seiten, die wir gerne ins Deutsche übersetzt sehen würden. |
Übersetzung im Gange • Translated • Traducción requerida • Original • Не переведено |
Ein kurzer technischer Leitfaden für erfahrene Mitarbeiter und Dokumentationsmanager. Siehe Schreibanleitung für grundlegende Wiki-Kenntnisse.
Vergiss niemals, dass jedes Dokument (außer geschützte Seiten, die nur zugänglich durch Administratoren sind) jederzeit von jedem bearbeitet werden kann. Schaue unter Technischer Wiki-Leitfaden#Bearbeitung und Technischer Wiki-Leitfaden#Inhaltsvalidierung) um bewährte Praktiken zu befolgen.
Es ist oft nützliche, bequem oder auch notwendig eine Nachricht für jemanden zu hinterlassen. Für diesen Zweck wird jedem Dokument eine Diskussionsseite zugeordnet, wenn es erstellt wird. Zum Beipiel hier: Talk:Technischer Wiki-Leitfaden [[Talk:{{FULLPAGENAME}}]]
.
Auf jeden Fall musst du versuchen in einer lesbaren Schreibenstill pflegen. Jedes Thema beginnt mit einem Titel ===Titel des Themas==
. Es ist besser 50 kleine und seperate Themen, jedes mit einem Titel versehen, zu haben, als ein Paket mit 50 Themen. Dies verhindert benachteiligte Antworten bei der Berücksichtigung, Umsetzung, usw.
Am Ende des Betreffs unterschreibe immer mit ~~~~
. Das lässt jeden sofort nachvollziehen, wer und wann die Nachricht geschrieben hat.
In der Regel erfolgen Antworten durch Einrückungen wie in Emails. Das wird durch das Setzen eines :
in einem neuen Absatz. Natürlich wird jede Nachricht unterschrieben. Das is sehr nützlich für jemanden, der später die gleichen Fragen stellen wird und diese Diskussion als Teil einer Wissensdatenbank sieht.
Schließlich kann es nützlich sein ein ✓ deinem Titel anzuhängen, das zeigt, dass das Thema geschlossen ist ==Titel des Themas {{OK}}==
. Falls das Thema wieder geöffnet wurde, dann kann das ✓ mit ✗ ersetzt werden {{KO}}
.
Leider werden die von der Frage Betroffenen nicht unbedingt informiert (die Anzahl der Artikel, die überwacht werden, und damit die Wahrscheinlichkeit, dass die Änderung gemeldet werden, ist begrenzt, um die Datenbank nicht zu vergrößern. Denken auch darüber nach die Person oder Personen, die betroffen sind durch Diskussion oder durch das Hinweisen mit einem Link zu der Diskussion zu benachrichtigen. Nochmals: Titel und Unterschriften, auch wenn sehr kurz, sind willkommen.
Auf den ersten Blick wird man feststellen, dass die Wiki, auch wenn es einfach ist, dort zu schreiben, es sehr aufwändig ist, diese zu verwalten, mit all den Regeln der Geselligkeit und Effizenz und deren Traditionen, die auf Erfahrungen der Vorgänger aufbauen. Das ist weil die Wiki auch ihre "Lore" (mündliche Tradition) hat.
Willst du dich wirklich an der Wiki beteiligen? Dann zögere nicht gefördert zu werden, ohne Verlegenheit, Schüchternheit oder Schamgefühl... Wir haben alle unsere Einführung gehabt und vielleicht, hoffentlich, wird es für dich auch eine Zeit geben, ein Förderer sein zu dürfen. Du kennst niemanden? Versuche "Alumni" zu kontaktieren auf https://chat.ryzom.com/channel/pj-ryzom_wiki oder kontaktieren jemanden auf Special:ActiveUsers.
Es gibt vier Regeln, die nebeneinander existieren:
Mit Ausnahme der archivierten Dokumente und der Dokumente mit dem offizellen Status "Finales Dokument" (Lore, Chroniken), kann alles verbessert werden und das ist eines der reichsten der Wikis.
Andereseits müssen bestimmte Regeln der konstrutkitven Geselligkeitrespektiert werden.
Dazu ist es notwendig zu beurteilen, ob die Änderungen wesentlich sind oder nicht. Es gibt keine Regeln und ist mehr ein Gefühl. Aber wenn es drastisch verändert wird, ist es weise, sich die Versionshistorie (Button neben "Bearbeiten".) anzuschauen. Falls der Inhalt (nicht die Form, Aussehen, Schreibweise...) einige Zeit nicht verändert wurde, kann man davon ausgehen, dass der Autor es so belassen hat und dass das Dokument möglicherweise veraltet ist und aktuallisiert werden muss. Ein Beispiel ist nebenstehend abgebildet.
Eine Aktualisierung kann als drastisch betrachtet werden, wenn es Absätze oder sogar Zeilen löscht, die grundlegend für die Entweicklung des Themas sind. In der Zusammenhang ist es sinnvoll eine Nachricht in der “Benutzer:Diskussion:xyz”-Seite zu hinterlassen. Während man auf die Antwort warte (eine Woche?), ist es ratsam, in der modifizierte Seite den Originaltext als Kommentar zu hinterlassen. Der einfachste Weg einen Text als Kommentar zu übermitteln, ist es mit <!--
einzuleiten und mit -->
abzuschließen. Aber es gibt manchmal Probleme, besonders wenn es schon andere Kommentare gibt. In dem Fall können Hammer und Meißel benutzt werden, indem der Text mit <noinclude><includeonly>
und </includeonly></noinclude>
umrahmt wird. Warum solch eine Komplikation? Weil es immer nötig ist die Texte des Autors zu respektieren und seine intellektuelle Urheberschaft, sogar in der Welt der freien Software. Anderfalls laufen wir in Gefahr, dass ein:
Auszug aus der Wikipedia Edit-War
Das sollte nicht mit einen Bearbeitenskonflikt vertauscht werden. Auszug aus der Wikipedia [Bearbeitungskonflikt]:
(siehe Wikipedia Bearbeitungskonflikt für mehr Informationen)
Natürlich werden solche Zwischenfälle und Unschicklichkeiten nicht zu 100% vermieden werden können, also ist es am sinnvollsten den folgenden Empfehlungen zu folgen ( von Wikipedia Bearbeitungskonflikten vorbeugen):
"Um Versionskonflikte zu meiden, ist es der einfachste Weg, lange Änderungen zu vermeiden.
Dies is jedoch nicht immer möglich. Das ist der Grund, warum es empfohlen wird, wenn eine Seite in der Tiefe modifiziert wird, zuerst den Banner {{WIP|~~~~}}
hinzuzufügen, wie folgt angezigt wird:
Sobald die Seite mit dem Banner veröffentlicht wird, kannst du es jedeszeit ändern. Begrenzen die Anzahl der Änderungen, indem du die Vorschau verwendest, um Anpassungen vorznehmen (das spart Zeit und vermeidet eine Unordnung der Seite "Letzte Änderungen".)
Wenn du fertig bist, vergiss nicht die Vorlage zu entfernen {{WIP}}
.”
(siehe Wikipedia Bearbeitungskonflikt für mehr Informationen)
Ein andere Art und Weise in Frieden zu arbeiten, ist die Arbeit in deinem eigenen Benutzerbereich. Dieser Bereich ist [[Benutzer:Heernis/Entwurf/...]]
'
Die Dokumente, die du dort vorbereitest, sind für die Suchmaschinen nicht verfügbar (außer du makierst die Seite explizit mit ) Nicht einmal Google sollte dahin gehen.
Gewöhnlich sind in Ryzom alle Seiten frei bearbeitbar, solange es keinen Vanadalismus gibt. Dennoch können Spieler möglicherweise zuverlässige Dokumente benötigen. Das betrifft im Wesentlichen:
Andere Dokumente können als empfindlich für die Wartung gesehen werden, wie zum Beispiel die häufig genutzten Vorlagen, die das Aussehen und sogar die Lesbarkeit der Dokumente verändern können.
Schließlich können die Mitwirkende, ob Entwickler, Spieler (RP oder nicht), Animatoren oder andere, es nützlich finden die Validierung ihrer Arbeit anzufragen.
>Ein Dokument, dass durch die Loristen, die offizellen Komunikationsoffiziere oder der Administratoren validiert wurde, ist geschützt gegen jede Modifikation, die nicht ausdrücklich genehmigt wurde.
Zusammenfassung der spezifischen Behandlung von Dokumenten der Lore
Von den Loristen geschriebene Texte, transkribiert oder übersetzt von Encyclopatysten.
Ganz oben auf der Seite ist das Lore Logo angebracht {{Official Lore}}
, welches als Bild angezeigt wird
Um eine Validierung vom Lore-Team anzufordern, füge ganz oben auf der Seite das Banner {{Lore Validation Request}}
hinzu, welcher wie folgt angezeigt wird:
Ein Lorist bringt, falls das nicht schon getan wurde, das Lore Logo an, und löscht jedes Banner, das möglicherweise für eine Validierungsanfrage genutzt wurde. Dann schützt der Lorist (der diese Aufgabe als Administrator delegieren kann) die Seite. Das Lore Logo wird dann zu: .
Alle Daten, Artikel, Bilder, Vorlagen, Portale, usw., müssen kategorisiert werden.
Kategorien sind sehr nützlich zur Katalogisierung von Dokumenten und erleichtern die Suche. Es muss verstanden werden, dass eine Kategorie einem Set im mathematischen Sinne des Ausdrucks ähneltm in anderen Worten:
Beispiel: rote Socke kann Socke, rote Objekte, rote Kleidung, Kleidung angehören. Normalerweise genügt es, wenn man erklärt, dass die Socke zu den rote Kleider gehört. Aber man könnte auch sagen, dass die Socke zu den roten Objekte gehört ohne sich auf rote Kleider zu bezieht. In beiden Fällen ist es sinnlos zu erklären, dass es zu Kleider gehört.
Die Auswahl der Kategorien kann manchmal mit Werkzeugen verlinkt werden, die es erlauben in einer Kategorie zu suchen und die oft in Portalen angezeigt werden. Zum Beispiel:
Portal …
There are for now 19 pages …
Das wird erreicht durch Es gibt jetzt{{Number of pages}} Seiten auf …
Natürlich scheint es aus dem vorherigen Beispiel, dass es Ausnahmen geben kann, die hauptsächlich mit der Ergonomie der Forschung zusammenhängen. Tatsächich erfordert die automatische Suche (zufällige Suche, um einen Gegenstand einzubeziehen, schaue zum Beipiel Spotlight on unten) in Kategoriebäumen viel Zeit und Energie. Daher ist es vorzuziehen {{Number of pages}}
zu nutzen, was nicht in Unterkategorien fällt.
Wikis, linked to the Ryzom universe, are supposed to share data common to the basic languages of the game. These common data are grouped in four trees detailed in the article Categorization. Only the “big branches” are detailed to leave the freedom to organize the data to each linguistic group. But these trunks and their “big branches” are essential, especially for translators who want to easily navigate between groups of articles.
Translated excerpt from Wikipédia Aide:Modèle
“A template is used to reproduce the same message, or the same layout, on several pages, sometimes according to parameters.
It is a pre-written element, more or less complex, intended to be embedded in a page in order to instantly obtain the desired visual result (formatting, display of specific elements, etc.). The banners at the top of the articles, the infoboxes, the centuries display… are templates.”
(see Wikipedia Help:Template for further information)
The visual aspect must recall the identity of the game. For example: “infoboxes” remind us of “memory ambers” (RP) or interfaces of the Karavan (OOC). Icons in general refer more or less clearly to the game world.
A graphic charter has two functions (at least):
For these two reasons, it should be adhered to as much as possible.
Header or paragraph templates are used to alert the reader on the way the page they are consulting should be interpreted (obsolescence, in the process of being written, etc.) and to highlight important announcements regarding the article.
Footer templates are used to provide the reader with additional information that may be of interest after reading the page.
Page body templates are used to complete or highlight information related to the current page. Highlightings can be diverse, such as large inserts or various typographic layouts.
Some rules for naming templates.
Warning : not exactly the same for all languages, but let us try to harmonize them as much as possible.
All templates are placed in the en:Category:Templates whose tree view is explained in the document en:Categorization#The_Wikipatys
Portals in our wiki serve as home pages for the various major areas of interest in the game. They are listed in the panel {{Portal bottom}}
Ryzom: Die Lore • Das Spiel OOC
Atys: Die Welt von Atys • Flora • Fauna
Nationen: Fyros • Matis • Tryker • Zoraï
Fraktionen: Kami • Karavan • Marodeure • Ranger • Trytonisten
Enzyklopädie: Atys Chroniken • Die Große Bibliothek • Mysterien OOC
All portals have a similar structure, but their appearance varies according to the complexity of the data they present. In general, a portal contains, from top to bottom:
{{Portal bottom}}
).Portals have not been built in a day and therefore their design has been refined over time. In general, we try to include documents in them using the template {{:DOCNAME}}
where DOCNAME=Name of the document to include.
It is sometimes pleasant to have documentation that gives an overview of the themes presented under the portal. This can be done as follows:
A different document included | ENGLISH | FRENCH |
---|---|---|
When necessary | {{:Featured article/...}} | {{:Lumière sur/...}} |
Every day of the week | {{:Featured article/GBA/Week/{{CURRENTDOW}}}} | {{:Lumière sur/.../Jour/{{CURRENTDOW}}}} |
Every day of the month | {{:Featured article/GBA/Month/{{CURRENTDAY2}}}} | {{:Lumière sur/.../Mois/{{CURRENTDAY2}}}} |
Bulletin boards contain information about both readers and contributors. This can range from simple information to emergencies, “To do” lists and “Tips and Tricks”.
To associate an article to a portal, just add at the bottom of the text of the said article a block of instructions of the following type:
{{clear}}{{Last version link}} <noinclude>{{Portal|xxx}} [[Category:yyyy]]</noinclude>
where:
Adding the navigation banner to the portal also places the article in “hidden” categories, categories that would not be shown to the reader because they are not relevant, but are indicated by a [+] located after the last displayed category. The random choice technique has been rejected by Mediawiki as too expensive. Currently, it is preferred a restricted choice (day of the week or month). This requires you to create one redirection at a time to the page you want to highlight. Thus, for example, the “Featured article/GBA/Day/3” page (3rd of the month or Wednesday) is redirected to “Primes Raider”.
What if the article is too long to be included, or if only some of its sections are worthwhile?
The wisest way is to signal the sections to be displayed or hidden in the future inclusion by marking them up in the source article.
<noinclude>
and </noinclude></noinclude>
tags allow to exclude the parts they frame from the future inclusion.<onlyinclude>
and </onlyinclude>
tags allow to include only the parts they frame in the future inclusion.<includeonly>
and </includeonly>
tags allow to include only the parts they frame in the future inclusion, while masking them in the original article (to be handled carefully in a template).{{read more|<<the original article>}}
displayed below) but displays it in the inclusion.
Home pages are “specific” because they are those that appear by default when you log in to the wiki. These pages are not editable and can contain many HTML (and Java) tricks. This implies that only seasoned contributors can modify them on community consensus or communication imperatives.
Other usefull links