Aus EnzyklopAtys
(Die Seite wurde neu angelegt: „{{WIP}} __NOTOC__ <noinclude>{{Trad |DE=Technischer Wiki-Leitfaden |EN=Wiki Technical Guide |ES=Guía Técnica de la Wiki |FR=Guide Technique du wiki |RU=Те…“) |
K (→The main categories of this wiki) |
||
| (7 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
| − | |||
| − | |||
<noinclude>{{Trad | <noinclude>{{Trad | ||
|DE=Technischer Wiki-Leitfaden | |DE=Technischer Wiki-Leitfaden | ||
| Zeile 7: | Zeile 5: | ||
|FR=Guide Technique du wiki | |FR=Guide Technique du wiki | ||
|RU=Техническое руководство по Вики | |RU=Техническое руководство по Вики | ||
| + | }} | ||
| + | {{TIP | ||
| + | |DE=2 | ||
| + | |EN=4 | ||
| + | |ES=1 | ||
| + | |FR=0 | ||
| + | |RU=5 | ||
}}</noinclude> | }}</noinclude> | ||
| − | + | '''Ein kurzer technischer Leitfaden für erfahrene Mitarbeiter und Dokumentationsmanager.''' Siehe [[Schreibanleitung]] für grundlegende Wiki-Kenntnisse. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | =='''<big>Arbeiten als Team</big>'''== | |
| + | 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 [[{{FULLPAGENAME}}#Bearbeitung]] und [[{{FULLPAGENAME}}#Inhaltsvalidierung]]) um bewährte Praktiken zu befolgen. | ||
| − | + | ===Diskussionsseiten=== | |
| + | 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:{{FULLPAGENAME}}]] '''<code><nowiki>[[Talk:{{FULLPAGENAME}}]]</nowiki></code>'''. | ||
| − | + | Auf jeden Fall musst du versuchen in einer lesbaren Schreibenstill pflegen. Jedes Thema beginnt mit einem Titel '''<code><nowiki>===Titel des Themas==</nowiki></code>'''. 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 '''<code><nowiki>~~~~</nowiki></code>'''. 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 <code>:</code> 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 '''{{OK}}''' deinem Titel anzuhängen, das zeigt, dass das Thema geschlossen ist '''<code><nowiki>==Titel des Themas {{OK}}==</nowiki></code>'''. Falls das Thema wieder geöffnet wurde, dann kann das '''{{OK}}''' mit '''{{KO}}''' ersetzt werden '''<code><nowiki>{{KO}}</nowiki></code>'''. |
| − | |||
| − | + | 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. | |
| − | == | + | === Förderung === |
| − | + | 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]]. | |
| − | |||
| − | + | =='''<big>Übersetzungen</big>'''== | |
| + | Es gibt vier Regeln, die nebeneinander existieren: | ||
| + | ;* Forge (Entwicklungsteil), Spiel-Gewohnheits-Tabelle, Grafik-Tabelle, grundlegende Kategorien: | ||
| + | *alles muss ins Englische übersetzt werden, damit es für so viele Menschen wie möglich verfügbar ist, dessen Mehrheit mehr oder weniger geschriebenes Englisch verstehen. | ||
| + | ;* Im-Spiel Verhaltenstabelle, Grafik-Tabelle, Wiki-Verwaltungsvorlagen, grundlegende Kategorien: | ||
| + | *alles muss in alle Sprachen übersetzt werden. | ||
| + | ;*Lore, Chroniken, öffentliche Events: | ||
| + | *alles muss zumnindest in die drei Muttersprachen Ryzom's übersetzt werden: DE, EN und FR; | ||
| + | ;* Der Rest und besonders der Rollenspiel-Teil: | ||
| + | *da gibt es keine Regeln, nur Anliegen von Spielern und Übersetzern haben Vorrang. | ||
| − | + | =='''<big>Bearbeitung</big>'''== | |
| + | 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 '''<code><nowiki><!--</nowiki></code>''' einzuleiten und mit '''<code><nowiki>--></nowiki></code>''' 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 '''<code><nowiki><noinclude><includeonly></nowiki></code>''' und '''<code><nowiki></includeonly></noinclude></nowiki></code>''' 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: |
| − | [.. | + | ===Berabeitungskrieg (Edit-War)=== |
| + | Auszug aus der Wikipedia '''[https://de.wikipedia.org/wiki/Wikipedia:Edit-War Edit-War]''' | ||
| − | + | ||
| − | '' | + | Das sollte nicht mit einen Bearbeitenskonflikt vertauscht werden. Auszug aus der Wikipedia '''[[https://de.wikipedia.org/wiki/Hilfe:Bearbeitungskonflikt Bearbeitungskonflikt]]''': |
| − | + | ||
| − | + | (siehe Wikipedia '''[https://de.wikipedia.org/wiki/Hilfe:Bearbeitungskonflikt Bearbeitungskonflikt]''' für mehr Informationen) | |
| − | |||
| − | '' | + | === Arbeite in Gelassenheit=== |
| + | 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 '''[https://de.wikipedia.org/wiki/Hilfe:Bearbeitungskonflikt#Bearbeitungskonflikten_vorbeugen 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'' ''<code><nowiki>{{WIP|~~~~}}</nowiki></code>''' '' hinzuzufügen, wie folgt angezigt wird:'' |
| − | |||
| − | + | {{WIP|-- [[User:Zorroargh|Zo'ro-Argh]] <sup><small>[[User talk:Zorroargh|Woren Siloy]]</small></sup> 28 mai 2019 à 14:19 (CEST)}} | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | ''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'' '''<code><nowiki>{{WIP}}</nowiki></code>'''.” | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | (siehe Wikipedia '''[https://de.wikipedia.org/wiki/Hilfe:Bearbeitungskonflikt Bearbeitungskonflikt]''' für mehr Informationen) | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | ===Der Entwurf=== | |
| − | + | Ein andere Art und Weise in Frieden zu arbeiten, ist die Arbeit in deinem eigenen Benutzerbereich. Dieser Bereich ist ''<code><nowiki>[[Benutzer:Heernis/Entwurf/...]]</nowiki></code>''' | |
| − | === | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | Die Dokumente, die du dort vorbereitest, sind für die Suchmaschinen nicht verfügbar (außer du makierst die Seite explizit mit __INDEX__) Nicht einmal Google sollte dahin gehen. | |
| + | |||
| + | =='''<big>Inhaltsvalidierung</big>'''== | ||
| + | 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: | ||
| + | *Der '''[https://app.ryzom.com/app_forum/index.php?page=topic/view/28406/1&post187218=de#1 Ryzom Verhaltenscodex]''' des gesamten Spiels, inklusive der Wiki. | ||
| + | *Die ''Lore''', die die grundlegenden Merkmale des Spiels festlegt (Homins sprechen kein Klingonisch, Karavans fliegen nicht auf Feuerdrachen und Kami tauchen nicht aus eine Öllampe auf). Diese Merkmale sind im '''[[Portal:Lore| Portal Lore]''' detailliert beschrieben. Hier werden diese kurz beschrieben, um ihre Existenz anzudeuten. | ||
| + | Andere Dokumente können als empfindlich für die Wartung gesehen werden, wie zum Beispiel die häufig genutzten [[Kategoriesierung#Die_Wikipatys|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. | ||
| + | |||
| + | <big>>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.</big> | ||
| + | |||
| + | == Die Lore == | ||
| + | Zusammenfassung der spezifischen Behandlung von Dokumenten der Lore | ||
| + | ==== Offizelle Kopie ==== | ||
| + | Von den Loristen geschriebene Texte, transkribiert oder übersetzt von ''Encyclopatysten''. | ||
| + | Ganz oben auf der Seite ist das Lore Logo angebracht '''<code><nowiki>{{Official Lore}}</nowiki></code>''', welches als Bild angezeigt wird [[File:Rubber-Stamp-Lore_choix_Vert.png|64px]] | ||
| + | ====Kreation von Nicht-Lorist==== | ||
| + | Um eine Validierung vom Lore-Team anzufordern, füge ganz oben auf der Seite das Banner '''<code><nowiki>{{Lore Validation Request}}</nowiki></code>''' hinzu, welcher wie folgt angezeigt wird: | ||
| + | |||
| + | {{Lore Validation Request}} | ||
| + | |||
| + | ==== Validierung ==== | ||
| + | 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: [[image:Rubber-Stamp-Lore_choix_H.png|64px]]. | ||
| + | |||
| + | =='''<big>Kategorien</big>'''== | ||
| + | Alle Daten, Artikel, Bilder, Vorlagen, Portale, usw., müssen kategorisiert werden. | ||
| + | ===Verwendung der Kategorien=== | ||
| + | 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: | ||
| + | *ein Artikel can mehreren Sets angehören | ||
| + | *ein Set eines Artikels can völlig in einem Anderen beinhaltet sein | ||
| + | *Es ist nicht notwendig einen Artikel, der zwei Sets angehört, zu deklarieren, falls einer von beiden von dem anderen komplett einbezogen wurde. | ||
| + | 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: | ||
<div style="text-align:center;"> | <div style="text-align:center;"> | ||
| − | {{3DText|3D=outset|group=ranger|text=<span style="font-size:large;font-variant: small-caps;font-weight: bold;">''''' | + | {{3DText|3D=outset|group=ranger|text=<span style="font-size:large;font-variant: small-caps;font-weight: bold;">'''''Portal …'''''</span>}} |
| − | {{3DText|3D=outset|group=ranger|text=''' | + | {{3DText|3D=outset|group=ranger|text='''There are for now 19 pages …'''}} |
| − | + | Das wird erreicht durch '''<code><nowiki> Es gibt jetzt{{Number of pages}} Seiten auf …</nowiki></code>'''</div> | |
| − | |||
| − | |||
| − | + | 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|Spotlight on]] unten) in Kategoriebäumen viel Zeit und Energie. Daher ist es vorzuziehen <code><nowiki>{{Number of pages}}</nowiki></code> zu nutzen, was nicht in Unterkategorien fällt. | |
| − | |||
| − | |||
| − | == | + | ==== The main categories of this wiki ==== |
| − | + | 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 <big>'''''[[:en:Categorization]]'''''</big>. 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. | ||
| − | |||
| − | + | [[File:Mindmap 6 wikis and image categories 2019-06-14.png|center|800px|alt=6 wikis, 6 category systems, all images in common|Six wikis, six category systems, all images in common]] | |
| − | + | <div style="text-align:center;">'''—• Six wikis, six category systems, all images in common •—'''</div> | |
| − | |||
| − | + | =='''<big>Template</big>'''== | |
| − | + | Translated excerpt from Wikipédia '''[https://fr.wikipedia.org/wiki/Aide:Mod%C3%A8le 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 '''[https://en.wikipedia.org/wiki/Help:Template Help:Template]''' for further information) | |
| − | == | + | ===Visual aspect and graphic charter=== |
| − | + | 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): | |
| − | * | + | *an identification function, recalling the spirit of the site (for example by using the emblematic colours of nations, factions); |
| − | + | *an ergonomic function, by avoiding the “element of surprise”, i.e. avoiding differences of behaviour between pages or between translations. | |
| − | * | ||
| − | |||
| − | |||
| − | + | For these two reasons, it should be adhered to as much as possible. | |
| − | ===Doc | + | ===Banners, seals and indicators in header=== |
| − | + | 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. | |
| − | + | ===Banners, navigation, time stamps=== | |
| + | Footer templates are used to provide the reader with additional information that may be of interest after reading the page. | ||
| + | ===Page body=== | ||
| + | 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. | ||
| + | |||
| + | ===Naming your Template=== | ||
| + | Some rules for naming templates. | ||
| + | |||
| + | ===All templates=== | ||
| + | <big>'''Warning''' : not exactly the same for all languages, but let us try to harmonize them as much as possible.</big> | ||
| + | |||
| + | All templates are placed in the [[:en:Category:Templates]] whose tree view is explained in the document [[:en:Categorization#The_Wikipatys]] | ||
| + | |||
| + | =='''<big>Portal</big>'''== | ||
| + | Portals in our wiki serve as home pages for the various major areas of interest in the game. They are listed in the panel '''<code><nowiki>{{Portal bottom}}</nowiki></code>''' | ||
| + | {{Portal bottom}} | ||
| + | |||
| + | 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: | ||
| + | *several tabs of sub-themes, the general home page positioning the reading on the first of them; in some cases, there may be a second row of tabs; | ||
| + | *the number of articles concerned and categorized (see [[#Associated categories|Associated categories]]) ; | ||
| + | *a summary; | ||
| + | *information (on the left the [[#Doc of the day|Doc of the day]], on the right a [[#Bulletin board|Bulletin board]]); | ||
| + | *the panel summarizing the main portals of the Ryzom Wiki ('''<code><nowiki>{{Portal bottom}}</nowiki></code>'''). | ||
| + | |||
| + | 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 '''<code><nowiki>{{:DOCNAME}}</nowiki></code>''' where DOCNAME=Name of the document to include. | ||
| + | ===Doc of the day=== | ||
| + | It is sometimes pleasant to have documentation that gives an overview of the themes presented under the portal. | ||
| + | This can be done as follows: | ||
{| class="wikitable centre" | {| class="wikitable centre" | ||
| − | ! | + | ! A different document included || ENGLISH || FRENCH |
|- | |- | ||
| − | | | + | | When necessary || <nowiki>{{:Featured article/...}}</nowiki> || <nowiki>{{:Lumière sur/...}}</nowiki> |
|- | |- | ||
| − | | | + | | Every day of the week || <nowiki>{{:Featured article/GBA/Week/{{CURRENTDOW}}}}</nowiki> || <nowiki>{{:Lumière sur/.../Jour/{{CURRENTDOW}}}}</nowiki> |
|- | |- | ||
| − | | | + | | Every day of the month || <nowiki>{{:Featured article/GBA/Month/{{CURRENTDAY2}}}}</nowiki> || <nowiki>{{:Lumière sur/.../Mois/{{CURRENTDAY2}}}}</nowiki> |
|} | |} | ||
| − | === | + | ===Bulletin board=== |
| − | + | Bulletin boards contain information about both readers and contributors. This can range from simple information to emergencies, “To do” lists and “Tips and Tricks”. | |
| − | === | + | ===Associated categories=== |
| − | ==== | + | ====All relevant pages==== |
| − | + | 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: | |
| − | <pre><nowiki>{{clear}}{{Last version link}} | + | '''<pre><nowiki>{{clear}}{{Last version link}} |
<noinclude>{{Portal|xxx}} | <noinclude>{{Portal|xxx}} | ||
| − | [[Category: | + | [[Category:yyyy]]</noinclude></nowiki></pre>''' |
| − | + | where: | |
| − | * | + | *the “clear” ensures that the navigation bar to the portal is well above the last image; |
| − | * | + | *the “last version link” allows you to time stamp the page and adds a discreet tab to find the origin of an inclusion; |
| − | * | + | *the “noinclude” can be put in so as not to pollute the inclusion. |
| − | ==== | + | ====On the front page==== |
| − | + | 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. | |
| + | *'''<code><nowiki><noinclude></nowiki></code>''' and '''<code><nowiki></noinclude></noinclude></nowiki></code>''' tags allow to exclude the parts they frame from the future inclusion. | ||
| + | *'''<code><nowiki><onlyinclude></nowiki></code>''' and '''<code><nowiki></onlyinclude></nowiki></code>''' tags allow to include only the parts they frame in the future inclusion. | ||
| + | *'''<code><nowiki><includeonly></nowiki></code>''' and '''<code><nowiki></includeonly></nowiki></code>''' 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). | ||
| − | + | This latter markup is used, for example, to hide in the original article the “To be continued…” ('''<code><nowiki>{{read more|<<the original article>}}</nowiki></code>''' displayed below) but displays it in the inclusion. {{read more|{{FULLPAGENAME}}}} | |
| − | + | =='''<big>Home page</big>'''== | |
| − | + | 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 advanced commands == |
| − | + | *[[:en:Wiki Technical Guide/Special Pages]] | |
| + | * [[:en:Wiki Technical Guide/API]] | ||
| + | Other usefull links | ||
| + | * https://regex101.com/ | ||
| + | * https://www.mediawiki.org/wiki/Manual%3APywikibot and [[:en:User:Amosys/Pywiki]] (for tests) | ||
| + | ----------------------------------------------------------------------------------------------- | ||
<references/> | <references/> | ||
{{clear}}{{Last version link}} | {{clear}}{{Last version link}} | ||
| − | <noinclude>{{ | + | <noinclude>{{Portal|Wikipatys|}}</noinclude> |
| − | [[ | + | [[Category:Wikipatys]][[Category:Encyclopatys]][[Category:Hilfe]] |
Version vom 29. März 2020, 20:10 Uhr
 Übersetzungs Status → Dies ist eine von 37 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.
Inhaltsverzeichnis
Arbeiten als Team
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.
Diskussionsseiten
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.
Förderung
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.
Übersetzungen
Es gibt vier Regeln, die nebeneinander existieren:
- Forge (Entwicklungsteil), Spiel-Gewohnheits-Tabelle, Grafik-Tabelle, grundlegende Kategorien
- alles muss ins Englische übersetzt werden, damit es für so viele Menschen wie möglich verfügbar ist, dessen Mehrheit mehr oder weniger geschriebenes Englisch verstehen.
- Im-Spiel Verhaltenstabelle, Grafik-Tabelle, Wiki-Verwaltungsvorlagen, grundlegende Kategorien
- alles muss in alle Sprachen übersetzt werden.
- Lore, Chroniken, öffentliche Events
- alles muss zumnindest in die drei Muttersprachen Ryzom's übersetzt werden: DE, EN und FR;
- Der Rest und besonders der Rollenspiel-Teil
- da gibt es keine Regeln, nur Anliegen von Spielern und Übersetzern haben Vorrang.
Bearbeitung
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:
Berabeitungskrieg (Edit-War)
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)
Arbeite in Gelassenheit
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:
!!!! WIP !!!! Die letzte Bearbeitung war von Craftjenn am 29.03.2020.
-- Zo'ro-Argh Woren Siloy 28 mai 2019 à 14:19 (CEST)
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)
Der Entwurf
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.
Inhaltsvalidierung
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:
- Der Ryzom Verhaltenscodex des gesamten Spiels, inklusive der Wiki.
- Die Lore', die die grundlegenden Merkmale des Spiels festlegt (Homins sprechen kein Klingonisch, Karavans fliegen nicht auf Feuerdrachen und Kami tauchen nicht aus eine Öllampe auf). Diese Merkmale sind im [[Portal:Lore| Portal Lore] detailliert beschrieben. Hier werden diese kurz beschrieben, um ihre Existenz anzudeuten.
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.
Die Lore
Zusammenfassung der spezifischen Behandlung von Dokumenten der Lore
Offizelle Kopie
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 
Kreation von Nicht-Lorist
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:
Validierung
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: 
.
Kategorien
Alle Daten, Artikel, Bilder, Vorlagen, Portale, usw., müssen kategorisiert werden.
Verwendung der Kategorien
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:
- ein Artikel can mehreren Sets angehören
- ein Set eines Artikels can völlig in einem Anderen beinhaltet sein
- Es ist nicht notwendig einen Artikel, der zwei Sets angehört, zu deklarieren, falls einer von beiden von dem anderen komplett einbezogen wurde.
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.
The main categories of this wiki
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 en: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.
Template
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)
Visual aspect and graphic charter
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):
- an identification function, recalling the spirit of the site (for example by using the emblematic colours of nations, factions);
- an ergonomic function, by avoiding the “element of surprise”, i.e. avoiding differences of behaviour between pages or between translations.
For these two reasons, it should be adhered to as much as possible.
Banners, seals and indicators in header
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
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.
Naming your Template
Some rules for naming templates.
All 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
Portal
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:
- several tabs of sub-themes, the general home page positioning the reading on the first of them; in some cases, there may be a second row of tabs;
- the number of articles concerned and categorized (see Associated categories) ;
- a summary;
- information (on the left the Doc of the day, on the right a Bulletin board);
- the panel summarizing the main portals of the Ryzom Wiki (
{{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.
Doc of the day
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 board
Bulletin boards contain information about both readers and contributors. This can range from simple information to emergencies, “To do” lists and “Tips and Tricks”.
Associated categories
All relevant pages
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:
- the “clear” ensures that the navigation bar to the portal is well above the last image;
- the “last version link” allows you to time stamp the page and adds a discreet tab to find the origin of an inclusion;
- the “noinclude” can be put in so as not to pollute the inclusion.
On the front page
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 page
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 advanced commands
Other usefull links
- https://regex101.com/
- https://www.mediawiki.org/wiki/Manual%3APywikibot and en:User:Amosys/Pywiki (for tests)
