Hilfe:Wikibooks-Lehrbuch/ Projektentwicklung/ Babel Textbaustein

Hier wird beschrieben, wie die Vorlage:Babel aufgebaut ist und wie die Kategorien mit den Sprachkenntnissen der Nutzer gestaltet werden. Das Babel-System selbst wird unter Wikibooks:Babel und die praktische Verwendung auf dieser Hilfeseite beschrieben.

Diese Seite richtet sich in erster Linie an Administratoren, die das Babel-System ergänzen sollen. „Normale“ Nutzer können aus diesen Informationen das Zusammenspiel der Vorlagen und Kategorien erkennen. Erfahrene Nutzer könnten bei Bedarf weitere Babel-Bausteine manuell erstellen. Aber der Import aus anderen Wikis ist das sinnvollste Verfahren, und den dürfen nur Admins ausführen.

Gestaltung

Die einzige Vorlage, die von Nutzern verwendet werden soll, ist:

Vorlage:Babel

Ihr können beliebig viele maximal 20 "Werte" (Sprachkürzel, siehe Babel) übergeben werden können.

Alle weiteren Vorlagen sind gewöhnliche Seiten, die wie bucheigene Vorlagen behandelt werden. Dies geschieht, um die Zahl der projektweiten Vorlagen so gering wie möglich zu halten.

Wer wissen will, welche Technik hinter dieser Vorlage steckt, schaut am besten auf ThePackers-Archiv nach.

Vorlagen

Diese Vorlage wird immer eingebunden:

Wikibooks:Babel: Vorlage:Babel

Diese Vorlage verweist auf:

Kategorie:Benutzer nach Sprache

Der folgende Text erklärt alle weiteren Seiten, die nicht als Vorlagen für Nutzer („Schnittstellenvorlagen“) dienen, aber dort wie Vorlagen eingebunden werden.

Wikibooks:Babel: Vorlage:Babel

wird verwendet von allen Schnittstellenvorlagen (zz. nur die Vorlage:Babel, aber eine Nutzerin könnte auch eine persönliche Variante erstellen)
enthält Tabellenbeginn und css Formatierung
verweist auf die Hilfeseite Wikibooks:Babel

Wikibooks:Babel: Vorlage:Babel field

basiert auf Vorlage:Babel field
Funktion im "System": Dies ist die Grundlage für alle Babel field [X] Bausteine, welche wiederum Grundlage für die Sprachbausteine sind.
Variablen
- color 1
- color 2
- letter code size
- letter code
- text size
- text
Inhalt: Eine vollständige Tabelle. die einzelnen Felder sind css-formatiert, Inhalte sind von div-tags umschlossene Variablen

Wikibooks:Babel: Vorlage:Babel field 0

basiert auf Vorlage:Babel field 0
bindet ein: Wikibooks:Babel: Vorlage:Babel field
Variablen
- letter code size
- letter code
- text size
- text
Inhalt: besteht nur aus dem Aufruf der Babel field Vorlage, die übergebenen „Werte“ sind allerdings sehr komplex

Beispiel: Deutsch

Alle Bausteingruppen gleichen sich im Aufbau, deswegen ist nur die Gruppe für die deutsche Sprache genauer erklärt. Alle Sprachbausteine nehmen Gestalt an durch Einbinden der Vorlagen Babel Field X (X=M,4,3,2,1). Die Babel Field Templates wiederum rufen alle Babel Field auf. Im Grunde wird eine einzige Vorlage also auf alle Sprachbausteine „vererbt“.

Achtung! X=0, also die Verneinung der Sprachfähigkeit, ist auf de-wikibooks nur für Deutsch sinnvoll.

Wikibooks:Babel: Vorlage:User_de
- basiert auf Vorlage:User de
- bindet ein: Wikibooks:Babel: Vorlage:Babel field M
- verweist auf w:Deutsche Sprache
- verweist auf Category:User de-M
- verweist auf Category:User de
- kategorisiert als [[Category:User de-M|{{PAGENAME}}]]
Wikibooks:Babel: Vorlage:User_de-4
- basiert auf Vorlage:User de-4
- bindet ein: Wikibooks:Babel: Vorlage:Babel field 4
- verweist auf w:Deutsche Sprache
- verweist auf Category:User de-4
- verweist auf Category:User de
- kategorisiert als [[Category:User de-4|{{PAGENAME}}]]
Wikibooks:Babel: Vorlage:User_de-3
- basiert auf Vorlage:User de-3
- bindet ein: Wikibooks:Babel: Vorlage:Babel field 3
- verweist auf w:Deutsche Sprache
- verweist auf Category:User de-3
- verweist auf Category:User de
- kategorisiert als [[Category:User de-3|{{PAGENAME}}]]
Wikibooks:Babel: Vorlage:User_de-2
- basiert auf Vorlage:User de-2
- bindet ein: Wikibooks:Babel: Vorlage:Babel field 2
- verweist auf w:Deutsche Sprache
- verweist auf Category:User de-2
- verweist auf Category:User de
- kategorisiert als [[Category:User de-2|{{PAGENAME}}]]
Wikibooks:Babel: Vorlage:User_de-1
- basiert auf Vorlage:User de-1
- bindet ein: Wikibooks:Babel: Vorlage:Babel field 1
- verweist auf w:Deutsche Sprache
- verweist auf Category:User de-1
- verweist auf Category:User de
- kategorisiert als [[Category:User de-1|{{PAGENAME}}]]
Wikibooks:Babel: Vorlage:User_de-0
- basiert auf Vorlage:User de-0
- bindet ein: Wikibooks:Babel: Vorlage:Babel field 0
- verweist auf w:Deutsche Sprache
- verweist auf Category:User de-0
- kategorisiert als [[Category:User de-0|{{PAGENAME}}]]

Kategorien

Sonderkategorien

Kategorie:Benutzer nach Sprache enthält alle Sprachkategorien, nicht jedoch die Sprachunterkategorien oder die „Verneinungskategorie“.

Kategorie:User_de-0 enthält alle Nutzer ohne ausreichende Deutschkenntnisse.

Sprach- und Sprachunterkategorien

Die Kategorien enthalten Verzeichnisse der Nutzer, die sich über Bausteine einer Sprache bzw. dem Kentnisstand einer Sprache zugeordnet haben.

Aufbau

Für jede Sprache gibt es eine übergeordnete Sprachhauptkategorie. Diese enthält die Sprachunterkategorien für jede der fünf Fähigkeitsstufen, aber nicht die Liste aller Nutzer einer Sprache. Zu erkennen ist diese Kategorie daran, dass ihr Name ohne Zusatz ist. Bei der kroatischen Sprache ist dies beispielsweise die Kategorie:User hr.

Die Sprachhauptkategorie enthält:

einen Verweis auf Wikibooks:Babel.
den Text aller fünf Bausteine
Einbindung als Kategorie:Benutzer nach Sprache

Jede Sprachunterkategorie enthält:

ein eingebundenes Inhaltsverzeichnis: Vorlage:KategorieTOC.
einen Verweis auf Wikibooks:Babel.
den Text des jeweiligen Bausteins
Einbindung bei der jeweiligen Sprachhauptkategorie – beispielsweise wird Kategorie:User hr-1 kategorisiert als Kategorie:User hr.

Die Hierarchie aller Kategorien kann im nächsten Abschnitt nachgeschlagen werden; am Ende stehen alle Kategorien bereit.

Vorhandene Bausteine

Die folgende Tabelle enthält die zurzeit registrierten Sprachen für das Babelsystem von de.Wikibooks. In das Babelsystem von Wikibooks sind zurzeit die Sprachen der folgenden Liste eingebunden.

Die Spalte Sprache enthält die deutsche Bezeichnung der Sprache.
Die Spalte Kürzel nennt das Sprachkürzel, das für Bausteine und Kategorien gilt und in der Vorlage:Babel verwendet werden kann.
Die Spalte vorhanden gibt an, welche Sprachfähigkeiten gewählt werden können. Es handelt sich dabei um Links auf den entsprechenden Babel-Baustein.
- M = Muttersprache
- 4 = Niveau 4
- 3 = Niveau 3
- 2 = Niveau 2
- 1 = Niveau 1
Die Spalte Kategorien zeigt die jeweiligen Sprachkategorien an. Ein Klick auf den Keil öffnet die Liste der Unterkategorien; ein Klick auf eine der Kategorien zeigt die Liste der Benutzer mit den betreffenden Sprachkenntnissen an.
Die Spalte Herkunft gibt an, aus welchem Projekt die Bausteine übernommen worden sind. Nähere Informationen dazu stehen auf der jeweiligen Diskussionsseite des Babel-Bausteins.

Sprache	Kürzel	vorhanden	Kategorien	Herkunft	Bemerkung
Alemannisch	als	M 4 3 2 1	User als	de.Wikipedia
Arabisch	ar	M 4 3 2 1	User ar	de.Wikipedia
Aserbeidschanisch	az	M 4 3 2 1	User az	de.Wikipedia
Bosnisch	bs	M 4 3 2 1	User bs	bs.Wikipedia	bs-4 aus de.Wikipedia
Chinesisch	zh	M 4 3 2 1	User zh	de.wikipedia	siehe dort
Dänisch	da	M 4 3 2 1	User da	de.Wikipedia
Deutsch	de	M 4 3 2 1	User de	de.Wikipedia
Deutsch *	de-0	0	User_de-0	de.Wikipedia	keine ausreichenden Kenntnisse
Englisch	en	M 4 3 2 1	User en	de.Wikipedia
Esperanto	eo	M 4 3 2 1	User eo	de.Wikipedia
Finnisch	fi	M 4 3 2 1	User fi	de.Wikipedia
Französisch	fr	M 4 3 2 1	User fr	de.Wikipedia
Hebräisch (Ivrit)	he	M 4 3 2 1	User he	de.Wikipedia
Isländisch	is	M 4 3 2 1	User is	de.Wikipedia
Italienisch	it	M 4 3 2 1	User it	de.Wikipedia
Japanisch	ja	M 4 3 2 1	User ja	de.Wikipedia
Jiddisch	yi	M 3 2 1	User yi	de.Wikipedia
Kroatisch	hr	M 4 3 2 1	User hr	de.Wikipedia
Latein	la	4 3 2 1	User la	de.Wikipedia	Eine tote Sprache kann keine Muttersprache sein.
Lettisch	lv	M 4 3 2 1	User lv	de.Wikipedia
Litauisch	lt	M 4 3 2 1	User lt	de.Wikipedia
Neugriechisch	el	M 4 3 2 1	User el	de.Wikipedia
Niederländisch	nl	M 4 3 2 1	User nl	de.Wikipedia
Norwegisch (bokmål)	no	M 4 3 2 1	User no	de.Wikipedia
Persisch	fa	M 4 3 2 1	User fa	de.Wikipedia
Polnisch	pl	M 4 3 2 1	User pl	de.Wikipedia
Portugiesisch	pt	M 4 3 2 1	User pt	en.Wikipedia
Rumänisch	ro	M 4 3 2 1	User ro	de.Wikipedia
Russisch	ru	M 4 3 2 1	User ru	en.Wikipedia
Schwedisch	sv	M 4 3 2 1	User sv	de.Wikipedia
Serbisch	sr	M 4 3 2 1	User sr	de.Wikipedia
Slowenisch	sl	M 4 3 2 1	User sl	de.Wikipedia
Spanisch	es	M 4 3 2 1	User es	en.Wikipedia
Tschechisch	cs	M 4 3 2 1	User cs	de.Wikipedia
Türkisch	tr	M 4 3 2 1	User tr	en.Wikipedia
Ungarisch	hu	M 4 3 2 1	User hu	unbekannt
Vietnamesisch	vi	M 4 3 2 1	User vi	de.Wikipedia

Die Zwei- oder Dreibuchstabenkürzel sind fast immer der ISO 639 entnommen.

Wenn eine Sprache in der Liste fehlt, dann schau in der aktuellen Liste nach: Ein Klick auf den folgenden Keil öffnet die Liste. Welche Sprache sich dahinter verbirgt, ist durch einen weiteren Klick auf die User-Angabe festzustellen. Wenn die Sprache auch in dieser Liste fehlt, dann melde deinen Wunsch nach einer neuen Sprache bitte auf der Diskussionsseite an.

Benutzer nach Sprache

Neue Sprache bereitstellen

Wenn ein Wunsch nach einer weiteren Sprache erfüllt werden soll, sind in der Regel fünf Vorlagen zu importieren und sechs Kategorien einzurichten. Auch wenn ein neuer Nutzer sich nur für ein Niveau interessiert, ist es zu empfehlen, alle Bausteine zu übernehmen, damit jede Sprache vollständig bereitgestellt wird.

Dabei werden die folgenden Kürzel verwendet; diese sind jeweils durch die entsprechenden Werte zu ersetzen.

w: steht für die Herkunft des importierten Bausteins, in der Regel die deutsche Wikipedia.
„Name der Sprache“ steht für die deutsche Bezeichnung der Sprache.
xx steht für das Sprachkürzel, in der Regel gemäß ISO 639.
-n steht für das Sprachniveau eines Nutzers: 'M' für Muttersprachler, '4' für vergleichbares Niveau, '3' für hohes Niveau, '2' für mittleres und '1' für niedriges Niveau. Siehe dazu Sprachniveau.

Ein Baustein für ein bestimmtes Sprachniveau kann auch einzeln übernommen werden. Die betreffende Vorlage und die Einzelkategorie sind so zu bearbeiten wie hier erläutert. Außerdem muss die Sprachhauptkategorie ergänzt werden.

Importieren und Verschieben (ohne Weiterleitung) kann nur von Administratoren ausgeführt werden; deshalb richtet sich diese Seite an sie und nicht an „normale“ Nutzer. Bitte wundert euch nicht über die ausführlichen Formulierungen: Jeder einzelne Schritt gehört zum „täglichen Brot“ eines Administrators. Aber ein neuer Babel-Baustein kommt relativ selten vor; deshalb führe ich jeden Schritt detailliert aus. Jürgen

Vorlagen

Für jede Vorlage sind die nachstehenden Schritte auszuführen, und zwar für fünf Vorlagen bei jeder Sprache:

[[w:Template:User_xx]]
[[w:Template:User_xx-4]]
[[w:Template:User_xx-3]]
[[w:Template:User_xx-2]]
[[w:Template:User_xx-1]]

Vorlage importieren

Für jede dieser Vorlagen sind die folgenden Schritte auszuführen:

auf Spezial:Import festlegen
Quell-Wiki/-Seite	w Template:User_xx
Zielnamensraum	Wikibooks (nicht wichtig, weil sowieso anschließend verschoben wird)
allgemein	Alle Versionen importieren – Aktivieren ist wichtig! Alle Vorlagen einschließen – Deaktivieren ist wichtig!
Grund	Babel erweitern
aktiviere die übernommene Seite [[Template:User_xx]]
bei Verschieben festlegen
Quelle	Template:User_xx
Zielnamensraum	Wikibooks
Zielseite	Babel: Vorlage:User xx
Grund	Babel erweitern
allgemein	Weiterleitung erstellen – Deaktivieren ist sinnvoll.

Vorlage anpassen

Jede der Vorlagen muss wie folgt geändert werden:

Zeile 1

Der vorhandene Text muss erweitert werden:

bisher: {{Babel field

ändern: {{:Wikibooks:Babel: Vorlage:Babel field

letter code

Der Link auf den Artikel zur Sprache muss ergänzt werden um den Verweis auf die Wikipedia, beispielsweise so:

bisher: [[Deutsche Sprache]]

ändern: [[w:Deutsche Sprache]]

<onlyinclude>: Dieser Tag ist zu entfernen: sowohl die Einleitung <onlyinclude> als auch der Abschluss </onlyinclude>. Achtung: Der Inhalt darf natürlich nicht gelöscht werden; das ist der eigentliche Inhalt der Vorlage.

<noinclude>: Alle Hinweise von <noinclude> bis </noinclude> können gelöscht werden. Sie sind zwar nützlich als Hinweis darauf, in welchen anderen Wikibooks-Sprachen diese Vorlage existiert. Aber zurzeit verweisen diese Einträge auf Wikipedia, sind also falsch; bei Bedarf wird ein Bot sie neu eintragen.

<includeonly>: Mit diesem Abschnitt ist die Kategorie einzutragen, der sich der Nutzer zuordnet. Kopiere dazu den folgenden Abschnitt:

<includeonly>[[Category:User xx-n|{{PAGENAME}}]]</includeonly>

Füge ihn am Ende der Vorlage ein. Ersetze xx durch das Sprachkürzel. Ersetze n durch das Zeichen M,4,3,2,1, das oben hinter {{Babel field steht.
text size: Bei manchen nichtlateinischen Schriften – z. B. arabisch oder chinesisch – ist dieser Wert bis auf 1.5em zu vergrößern.

Liste der Autoren übernehmen

Dieser Schritt kann entfallen, wenn sämtliche Versionen übernommen wurden; dann sind die Autoren aus der Versionsgeschichte zu ersehen. Wegen der besseren Übersichtlichkeit ist es nicht falsch, für jede der fünf Vorlagen die Autorenliste trotzdem zusätzlich zu speichern. Das geht am einfachsten und besten so:

Achtung: Dieses Tool wurde deaktivert; die Variante mit XTools wurde in diesem Zusammenhang noch nicht benutzt.

Starte in einem neuen Tab Duesentrieb's Contributor Tool.
Nimm die folgenden Einstellungen vor (als Beispiel der Standard, dass die Vorlage aus der deutschen Wikipedia übernommen wird):

Quell-Wiki/-Seite	de – wikipedia.org
Page	Template:User_xx Template:User_xx-4 Template:User_xx-3 Template:User_xx-2 Template:User_xx-1
allgemein	group by user IPs haben in der Regel nicht mitgearbeitet, können also wahlweise übernommen oder ignoriert werden.
Format	de.wikibooks.template

Durch Load gibt es die benötigte Liste als vollständig ausgefüllte Vorlage. Kopiere die gesamte Liste in die Zwischenablage.
Gehe in einem anderen Tab zur Vorlagenseite. Aktiviere die Diskussionsseite und füge die Liste per Paste aus der Zwischenablage ein. Das Einfügen mit Shift + Strg + V ist besser als mit Strg + V, weil dann der Zeilenumbruch eher erhalten bleibt.
Benutze einmal die Vorschau und verbessere (soweit erforderlich) den Zeilenumbruch.

Danach können die Autoren der nächsten Vorlage geholt werden: Gehe zurück zum Tab mit Duesentrieb's Tool; mit Zurück kann die Eingabeseite reaktiviert werden.

Kategorien

Nach diesen Vorlagen sind sechs Kategorieseiten zu erstellen.

Die Erstellung der Sprachunterkategorien verläuft analog zur Erstellung der Sprachhauptkategorie. Es ist allerdings für fünf Kategorienseiten auszuführen. Aus praktischen Gründen ist die Kategorie zur Muttersprache getrennt zu bearbeiten.

Die verwendeten Vorlagen können hier zur Bearbeitung geöffnet werden (am besten mit Rechtsklick in einem neuen Tab):

Die erläuternden Texte stammen aus einer Vorlage, um eine einheitliche Anzeige mit einfacher Änderung zu ermöglichen. Dazu sind die folgenden Vorlagen vorgesehen:

Sprachhauptkategorie

Die Hauptkategorie zur Sprache wird wie folgt bearbeitet:

Öffne die Hauptvorlage [[Wikibooks:Babel: Vorlage:User_xx]] zur Sprache.
Klicke im erläuternden Text auf den Link, der auf [[Kategorie:User_xx]] verweist; das ist meistens der Name der Sprache in der Fremdsprache und oft der erste Link innerhalb des Textes.
Öffne die Kategorienseite zum Bearbeiten.
Füge die nachstehende Vorlage zum Aufbau der Seite ein, ändere den Sprachnamen und das Sprachkürzel und speichere die Seite:

{{subst::Wikibooks:Babel: Vorlage:Sprachhauptkategorie|Sprachname|xx}}

Auf diesem Weg werden die fünf Babel-Bausteine direkt angezeigt, ebenso wie ein erläuternder Text. Störend ist jetzt, dass die verschiedenen Kategorien zur Sprache – [[Kategorie:User xx-4]] usw. – ebenfalls in die Seite geschrieben worden sind. Im nächsten Schritt wird dieser Missstand bereinigt.

Öffne die Kategorienseite erneut zum Bearbeiten. Zu sehen ist, dass in einer Tabelle tatsächlich der gesamte Inhalt der Textbausteine eingestellt worden ist.
Bei manchen nichtlateinischen Schriften ist ggf. der Wert von text size fünfmal zu ändern (wie bei den Vorlagen).
Es sind Hinweise auf Kategorien zu entfernen, und zwar nach dem Parameter | lang=xx}} – an fünf Stellen jeweils eine Kategorie.
Wenn es in Einzelfällen eine Unterkategorie (noch) nicht gibt, ist innerhalb der Tabelle eine subst-Anweisung stehen geblieben. Diese kann gelöscht werden, wenn es die betreffende Unterkategorie niemals geben wird (wie bei Latein als Muttersprache), oder sie wird durch  auskommentiert, damit sie später problemlos aktiviert werden kann.
Dann wird gespeichert.

Die endgültige Fassung der Seite ist nur noch unter Kategorie:Benutzer nach Sprache eingeordnet.

Unterkategorie Muttersprache

Die Sprachunterkategorie zur Muttersprache wird wie folgt bearbeitet – die Sprachhauptkategorie ist noch geöffnet.

Klicke im erläuternden Text auf den Link, der auf [[Kategorie:User_xx-M]] verweist; das ist im obersten Babel-Feld etwas wie der Begriff „Muttersprache“ in der Fremdsprache.
Öffne diese Kategorienseite zum Bearbeiten.
Füge die nachstehende Vorlage zum Aufbau der Seite ein, ändere den Sprachnamen und das Sprachkürzel und speichere die Seite:

{{subst::Wikibooks:Babel: Vorlage:Unterkategorie Muttersprache|Sprachname|xx}}

Öffne die Kategorienseite erneut zum Bearbeiten. Zu sehen ist, dass in einer Tabelle der Inhalt des Textbausteins eingestellt worden ist.
Bei manchen nichtlateinischen Schriften ist ggf. der Wert von text size einmal zu ändern (wie bei den Vorlagen).
Es ist eine überflüssige Kategorie zu entfernen, und zwar nach dem Parameter | lang=xx}}.
Bei Sprachen mit vermutlich wenigen Nutzern kann {{KategorieTOC}} gestrichen werden.

Dann wird gespeichert. Die endgültige Fassung der Seite ist nur noch unter [[Kategorie:User xx]] eingeordnet, also der Hauptkategorie zu dieser Sprache.

Sprachunterkategorien 4, 3, 2, 1

Die anderen Sprachunterkategorien werden auf dem gleichen Weg bearbeitet – eine Sprachunterkategorie ist noch geöffnet.

Aktiviere durch Klick auf die Anzeige am unteren Rand der Seite erneut die Hauptkategorie [[Kategorie:User xx]].
Klicke im erläuternden Text auf den Link, der auf [[Kategorie:User_xx-n]] verweist; das ist in den Babel-Feldern 4/3/2/1 ein Begriff, der das Sprachniveau in der Fremdsprache beschreibt.
Öffne diese Kategorienseite zum Bearbeiten.
Füge die nachstehende Vorlage zum Aufbau der Seite ein, ersetze dabei „Sprachname“ sowie xx und n durch die jeweiligen Werte und speichere die Seite:

{{subst::Wikibooks:Babel: Vorlage:Sprachunterkategorie|Sprachname|xx|n}}

Öffne die Kategorienseite erneut zum Bearbeiten. Zu sehen ist, dass in einer Tabelle der Inhalt des Textbausteins eingestellt worden ist.
Bei manchen nichtlateinischen Schriften ist ggf. der Wert von text size einmal zu ändern (wie bei den Vorlagen).
Es ist jeweils eine überflüssige Kategorie zu entfernen, und zwar nach dem Parameter | lang=xx}}.
Bei Sprachen mit vermutlich wenigen Nutzern kann {{KategorieTOC}} gestrichen werden.

Dann wird gespeichert. Die endgültige Fassung der Seite ist nur noch unter [[Kategorie:User xx]] eingeordnet, also der Hauptkategorie zu dieser Sprache.

Auflistung

Abschließend ist die neue Sprache in der obigen Liste einzutragen:

Auflistung bearbeiten (am besten mit Rechtsklick in einem neuen Tab öffnen)

Die dort verwendete Vorlage kann einfach kopiert und mit den Parametern versehen werden. Soweit sie sich nicht von selbst versteht, werden die Parameter als Html-Kommentar erklärt.