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

Bearbeiten

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

Bearbeiten

Diese Vorlage wird immer eingebunden:

Diese Vorlage verweist auf:

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

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

basiert auf   Vorlage:Babel field 1

basiert auf   Vorlage:Babel field 2

basiert auf   Vorlage:Babel field 3

basiert auf Wikibooks:Babel: Vorlage:Babel field 3

basiert auf   Vorlage:Babel field M

Beispiel: Deutsch

Bearbeiten

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.

Kategorien

Bearbeiten

Sonderkategorien

Bearbeiten

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

Bearbeiten

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

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:

Jede Sprachunterkategorie enthält:

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

Vorhandene Bausteine

Bearbeiten

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

Neue Sprache bereitstellen

Bearbeiten

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

Bearbeiten

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

Bearbeiten

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

Bearbeiten

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 <!-- {{subst... }} --> 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

Bearbeiten

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

Bearbeiten

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

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.

Testseiten

Bearbeiten

Wikibooks:Babel: Testseite

Wikibooks:Babel: Nutzer Grad M

Muss vorhanden sein in

darf in anderen Seiten nicht vorhanden sein

Wikibooks:Babel: Nutzer Grad 3

Muss vorhanden sein in

darf in anderen Seiten nicht vorhanden sein

Wikibooks:Babel: Nutzer Grad 2

Muss vorhanden sein in

darf in anderen Seiten nicht vorhanden sein

Wikibooks:Babel: Nutzer Grad 1

Muss vorhanden sein in

darf in anderen Seiten nicht vorhanden sein

Wikibooks:Babel: Nutzer Grad 0

Muss vorhanden sein in

darf in anderen Seiten nicht vorhanden sein