Technischer Wiki-Leitfaden: Unterschied zwischen den Versionen

Aus EnzyklopAtys

Wechseln zu: Navigation, Suche
K (Erstellung von Nicht-Loristen)
K (Offizielle Kopie)
Zeile 99: Zeile 99:
 
==== Offizielle Kopie ====
 
==== Offizielle Kopie ====
 
Von den Loristen verfasste und von "Enzyklopädisten" transkribierte oder übersetzte Texte.
 
Von den Loristen verfasste und von "Enzyklopädisten" transkribierte oder übersetzte Texte.
Das Lore-Logo ''<code><nowiki>{{Offizielle Lore}}</nowiki></code>'' wird oben auf der Seite angebracht, die das Bild [[Datei:Rubber-Stamp-Lore choice Green.png|64px]] anzeigt.
+
Das Lore-Logo ''<code><nowiki>{{Offizielle Lore}}</nowiki></code>'' wird oben auf der Seite angebracht, die das Bild [[Datei:Rubber-Stamp-Lore_choix_H.png|64px]] anzeigt.
  
 
==== Erstellung von Nicht-Loristen ====
 
==== Erstellung von Nicht-Loristen ====

Version vom 15. September 2021, 06:06 Uhr

    Script edit.png Übersetzungs StatusDies ist eine von 35 Seiten, die wir gerne ins Deutsche übersetzt sehen würden.
De.png Übersetzung im GangeGb.png TranslatedEs.png Traducción requeridaFr.png OriginalRu.png Не переведено
de:Technischer Wiki-Leitfaden
en:Wiki Technical Guide
es:Guía Técnica de la Wiki
fr:Guide Technique du wiki
ru:Техническое руководство по Вики
 
UnderConstruction.png
Übersetzung zur Überprüfung
Gib nicht den Mitwirkenden die Schuld, sondern komm und hilf ihnen. 😎
Important.png
Under Construction Panel.png !!!! WIP !!!! Under Construction Panel.png
Es sind gerade 26 Artikel in der Bearbeitung in der Kategorie "WIP"
Dieser Artikel wird gerade bearbeitet. Bitte laß es den Autor beenden, bevor du es veränderst.
Die letzte Bearbeitung war von Leda am 15.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.

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

EN wiki history comparing.png
EN wiki history see.png
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:


Important.png
Under Construction Panel.png !!!! WIP !!!! Under Construction Panel.png
Es sind gerade 26 Artikel in der Bearbeitung in der Kategorie "WIP"
Dieser Artikel wird gerade bearbeitet. Bitte laß es den Autor beenden, bevor du es veränderst.
Die letzte Bearbeitung war von Leda am 15.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!

(Permanente) Inhaltsvalidierung

Normalerweise sind in Ryzom-Wikis alle Seiten frei bearbeitbar, solange es keinen Vandalismus gibt. Dennoch benötigen die Spieler möglicherweise zuverlässige Dokumente. Dies betrifft hauptsächlich:

  • Den Verhaltenscodex im gesamten Spiel, einschließlich dieses Wikis.
  • Die Lore, die die grundlegenden Merkmale des Spiels festlegt (Homins sprechen kein Klingonisch, die Karavan fliegen nicht auf Feuerdrachen und Kamis kommen nicht aus einer Öllampe). Diese Eigenschaften werden in der Lore beschrieben. Sie sollen hier nur kurz erwähnt werden, um auf ihre Existenz hinzuweisen.

Andere Dokumente können als wartungsempfindlich eingestuft werden, wie z. B. die Vorlagen, die in großem Umfang verwendet werden und das Aussehen oder sogar die Lesbarkeit von Dokumenten verändern können.

Schließlich kann die Validierung für die Mitwirkenden, ob Entwickler, Spieler (RP oder nicht), Moderatoren oder andere, nützlich sein, um eine Bestätigung ihrer Arbeit zu bitten.

Ein Dokument, das von den Loristen, den offiziellen Kommunikationsmanagern oder den "Administratoren" validiert wurde, ist geschützt gegen alle nicht ausdrücklich genehmigten Änderungen.

Die Lore

Zusammenfassung der spezifischen Behandlung von Dokumenten im Zusammenhang mit der Lore.

Offizielle Kopie

Von den Loristen verfasste und von "Enzyklopädisten" transkribierte oder übersetzte Texte. Das Lore-Logo {{Offizielle Lore}} wird oben auf der Seite angebracht, die das Bild Rubber-Stamp-Lore choix H.png anzeigt.

Erstellung von Nicht-Loristen

Um die Validierung durch das Lore-Team anzufordern, muss das Banner {{Lore Validation Request}} ganz oben auf der Seite angebracht werden, das wie folgt angezeigt wird:

Dummy.png
This page is submitted to the Lore staff for validation.
Editing date:...


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: Rubber-Stamp-Lore choix H.png.

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.


6 wikis, 6 category systems, all images in common
—• Six wikis, six category systems, all images in common •—

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.

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

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}}

Spe labs.png
Alle thematischen Portale der Enzyklopatys (Ryzom Wiki)

Ryzom: Die LoreDas Spiel OOC
Atys: Die Welt von AtysFloraFauna
Nationen: FyrosMatisTrykerZoraï
Fraktionen: KamiKaravanMarodeureRangerTrytonisten
Enzyklopädie: Atys ChronikenDie Große BibliothekMysterien 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).
This latter markup is used, for example, to hide in the original article the “To be continued…” ({{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



Neueste Version 04.08.2023•