Aus EnzyklopAtys
Leda (Diskussion | Beiträge) K (→Bearbeitung) |
Leda (Diskussion | Beiträge) K |
||
Zeile 5: | Zeile 5: | ||
|FR=Guide Technique du wiki | |FR=Guide Technique du wiki | ||
|RU=Техническое руководство по Вики | |RU=Техническое руководство по Вики | ||
− | }}</noinclude> | + | }}{{WIP|[[Benutzer:Leda|Leda]] ([[Benutzer Diskussion:Leda|Diskussion]]) 23:49, 14. Sep. 2021 (CEST)}}</noinclude> |
'''''Ein kurzer technischer Leitfaden für sachkundige Mitarbeiter und Dokumentenmanager.'''''<br /> | '''''Ein kurzer technischer Leitfaden für sachkundige Mitarbeiter und Dokumentenmanager.'''''<br /> | ||
Siehe auch die [[Anleitung zum Schreiben]] (Grundlagen) und allgemein die Kategorie [[:Kategorie:Hilfe|Hilfe]]. | Siehe auch die [[Anleitung zum Schreiben]] (Grundlagen) und allgemein die Kategorie [[:Kategorie:Hilfe|Hilfe]]. |
Version vom 14. September 2021, 22:49 Uhr
Übersetzungs Status → Dies ist eine von 36 Seiten, die wir gerne ins Deutsche übersetzt sehen würden. |
Übersetzung im Gange • Translated • Traducción requerida • Original • Не переведено |
Die letzte Bearbeitung war von Leda am 14.09.2021.
Leda (Diskussion) 23:49, 14. Sep. 2021 (CEST)
Ein kurzer technischer Leitfaden für sachkundige Mitarbeiter und Dokumentenmanager.
Siehe auch die Anleitung zum Schreiben (Grundlagen) und allgemein die Kategorie Hilfe.
Inhaltsverzeichnis
Teamarbeit
Vergessen Sie nie, daß jedes Dokument (mit Ausnahme geschützter Seiten, die nur für Administratoren zugänglich sind) jederzeit von jedem bearbeitet werden kann. Siehe unten (Änderungen und (Permanente) Inhaltsvalidierung) um bewährte Praktiken zu befolgen.
Um "mit mehreren Personen zu schreiben", ist es besser, ein PAD zu verwenden. Mehr unter Dateiformat#Pads.
Diskussionsseiten
Oft ist es nützlich, bequem oder notwendig, eine Nachricht für andere zu hinterlassen. Für diesen Zweck wird jedem Dokument bei seiner Erstellung eine Seite "Diskussion" zugeordnet, zum Beispiel hier: Diskussion:Technischer Wiki-Leitfaden [[Diskussion:{{FULLPAGENAME}}]
.
Auf jeden Fall sollten Sie versuchen, einen lesbaren Schreibstil zu pflegen. Jedes Thema sollte mit einem Titel ===Titel des Themas===
beginnen. Es ist besser, fünfzig einzelne kleine Themen mit jeweils einem Titel zu haben als ein Paket mit fünfzig Themen. Dies erleichtert die Berücksichtigung, Vervollständigung usw. von differenzierten Antworten.
Am Ende des Themas sollten Sie immer mit ~~~~
unterschreiben. So ist sofort ersichtlich, wer die Nachricht zu welchem Zeitpunkt veröffentlicht hat.
Traditionell erfolgt die Beantwortung durch Einrücken wie in E-Mails. Dies geschieht, indem die Zeile mit einem :
mehr beginnt als der vorherige Teil. Natürlich wird jede Antwort, jeder Bounce unterschrieben. Dies ist sehr nützlich für jemanden, der später dieselben Fragen stellt und diese Diskussion als Teil einer "Wissensdatenbank" betrachtet.
Schließlich kann es sinnvoll sein, ein ✓ an den Titel anzuhängen, um anzuzeigen, dass das Thema geschlossen ist ==Titel des Themas {{OK}}==
. Wenn das Thema wiedereröffnet werden soll, können wir das ✓ durch ein ✗ {{KO}}
ersetzen.
Leider werden die von der Befragung betroffenen Personen nicht unbedingt benachrichtigt (die Anzahl der verfolgten Artikel - und damit die Wahrscheinlichkeit, dass ihre Änderungen gemeldet werden - ist begrenzt, um die Datenbank nicht zu sprengen). Denken Sie also auch daran, die Person(en) zu benachrichtigen, die möglicherweise betroffen sind, indem Sie auf den Link zur Diskussion hinweisen. Auch hier sind Titel und Unterschrift, selbst wenn sie sehr kurz sind, willkommen.
Förderung
Bei der ersten Lektüre wird man feststellen, daß das Wiki, auch wenn es einfach ist, dort zu schreiben, sehr aufwändig zu verwalten ist, mit all den Regeln der Benutzerfreundlichkeit und Effizenz, seinen Traditionen, die auf den Erfahrungen der Vorgänger aufbauen, usw. Das liegt daran, daß das Wiki auch seine "Lore" hat. (aus dem Englischen entlehnt und bedeutet "mündliche Überlieferung").
Wollen Sie sich wirklich an dem Wiki beteiligen? Dann zögern Sie nicht, eine Patenschaft zu übernehmen, ohne Verlegenheit, Schüchternheit oder Scham... Wir haben alle angefangen, und vielleicht, so hoffen wir, sind Sie später als Pate an der Reihe. Kennen Sie niemanden? Versuchen Sie, einige "alte Hasen" auf https://chat.ryzom.com/channel/pj-ryzom_wiki zu kontaktieren oder kontaktieren Sie sie über Special:ActiveUsers.
Übersetzungen
Es gibt vier Regeln, die nebeneinander bestehen:
- • Schmiede (Entwicklungsteil), Charta für das Verhalten im Spiel, Grafik-Charta, Grundlegende Kategorien
- Alles muß ins Englische übersetzt werden, damit es einer möglichst großen Zahl von Menschen zugänglich ist, die das geschriebene Englisch mehr oder weniger gut verstehen;
- • Charta für das Verhalten im Spiel, Grafik-Charta, Vorlagen für die Verwaltung des Wikis, grundlegende Kategorien
- Alles muß in alle Sprachen übersetzt werden;
- • Überlieferungen, Chroniken, öffentliche Animationen
- Alles muß mindestens in die drei "Muttersprachen" von Ryzom übersetzt werden: DE, EN und FR;
- • den Rest, insbesondere die Rollenspielteile
- Es gibt keine Regeln, nur das Interesse der Spieler und der Übersetzer ist entscheidend.
Für Hilfe bei der Übersetzung dieses Wikis siehe fr:WikiTrad/WikiTrad-FR oder dessen englische Version [1].
Änderungen
Mit Ausnahme von archivierten Dokumenten und Dokumenten mit dem offiziellem Status "Finales Dokument" (Lore, Chronik) kann alles verbessert werden, und das ist einer der Reichtümer von Wikis.Dennoch müssen bestimmte Regeln der konstruktiven Zusammenarbeit beachtet werden.
Zunächst ist zu prüfen, ob die Änderungen tiefgreifend sind oder nicht. Es gibt keine Regeln und es ist mehr ein "Gefühl", aber wenn die Änderung tiefgreifend ist, ist es ratsam, sich zunächst den Verlauf der Seite anzusehen (Schaltfläche "Versionsgeschichte" neben "Bearbeiten"). Wenn sich der Inhalt (nicht die Form, das Aussehen, die Rechtschreibung...) seit einiger Zeit nicht mehr geändert hat, kann man davon ausgehen, daß der Verfasser ihn so belassen hat, wie er ist, und daß das Dokument möglicherweise veraltet ist und aktualisiert werden muß. Ein Beispiel ist nebenstehend abgebildet.
Eine Aktualisierung kann als tiefgreifend angesehen werden, wenn sie Zeilen oder sogar Absätze löscht, die für die Entwicklung des Themas von grundlegender Bedeutung sind. In diesem Fall ist es angebracht, eine Nachricht auf der Seite "Benutzerdiskussion:xyz" zu hinterlassen. Während Sie auf eine Antwort warten (eine Woche?), ist es ratsam, den ursprünglichen Text auf der geänderten Seite beizubehalten. Die einfachste Art, einen Text zu kommentieren, ist, ihn mit <!--
einzuleiten und mit -->
zu beenden. Aber manchmal gibt es Probleme, vor allem wenn es bereits andere Kommentare gibt. In diesem Fall kann man Hammer und Meißel benutzen, indem man den Text mit <noinclude><includeonly>
und </includeonly></noinclude>
umschließt. Warum diese Komplikation? Weil es immer nötig ist, die Texte des Autors und seine geistige Urheberschaft zu respektieren, auch bei freier Software. Andernfalls riskieren wir einen :
Berabeitungskrieg (Edit-War)
Siehe auch Wikipedia [2]
In einem "Edit-War" äußern zwei oder mehr Redakteure eine starke Meinungsverschiedenheit über einen bestimmten Punkt (den Inhalt oder Titel eines Artikels, seine Unterteilung in mehrere kleinere Artikel, einen nicht neutralen Absatz...). Folgende Anzeichen sind zu beobachten: aktiver Widerrufszyklus zum Artikel selbst, aggressive Kommentare, persönliche Angriffe, fehlende Diskussion über das Thema des Artikels zwischen den Protagonisten.
Die absichtliche Verschlechterung des Inhalts, das Beschönigen von Seiten oder die Verwendung von Beleidigungen auf der Diskussionsseite oder in der Zusammenfassung gelten als Vandalismus.
[...]
Als letztes Mittel kann ein Administrator außerhalb der Debatte die Seite schützen. Da in diesem Fall alle Redakteure die gleichen Bearbeitungsrechte haben, werden die an der Debatte Beteiligten gebeten, die Regel "keine Bearbeitung" zu beachten. Es wird auch daran erinnert, dass die Teilnahme an einem Edit-War zur Sperrung von engagierten Mitwirkenden führen kann und dass jederzeit die Drei-Widerrufs-Regel gilt.
Dies ist nicht zu verwechseln mit einem Bearbeitungskonflikt. In der Wikipedia tritt ein Versionskonflikt oder "Bearbeitungskonflikt" auf, wenn zwei Autoren gleichzeitig an derselben Seite arbeiten: Der zweite, der mit einer veralteten Version der Seite arbeitet, wird zurückgewiesen. Seit MediaWiki Version 1.3 geschieht dies nur noch, wenn die Änderungen nicht automatisch zusammengeführt werden können. (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 tiefgreifend modifiziert wird, zuerst den Banner {{WIP|~~~~}}
hinzuzufügen, der wie folgt angezeigt wird:
Die letzte Bearbeitung war von Leda am 14.09.2021.
Leda (Diskussion) 23:48, 14. Sep. 2021 (CEST)
Sobald die Seite mit dem Banner veröffentlicht wird, können Sie es jedeszeit ändern. Begrenzen Sie die Anzahl der Änderungen, indem Sie die Vorschau verwenden, um Anpassungen vorznehmen (das spart Zeit und vermeidet eine Unordnung der Seite "Letzte Änderungen".)
Wenn Sie fertig sind, vergessen Sie bitte nicht, die Vorlage {{WIP}}
wieder zu entfernen.
Der Entwurf
Eine andere Methode, um in Ruhe zu arbeiten, ist die Arbeit in Ihrem eigenen Benutzerbereich. Dieser Raum ist [[Benutzer:Leda/Entwurf/...]]
.
Die Dokumente, die Sie dort erstellen, sind für Suchmaschinen nicht zugänglich (außer du makierst die Seite explizit mit ). Selbst Google sollte nicht dorthin 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)