preface-conventions.asciidoc

Annahmen in diesem Handbuch

Die in diesem Handbuch getroffenen Annahmen verstehen.

Annahmen und Voraussetzungen

Dieses Handbuch geht von den folgenden Annahmen und Voraussetzungen aus:

• Dieses Handbuch ist nach Themen gegliedert. (Siehe: [preface-organization] für weitere Informationen.) Viele Themen enthalten den Abschnitt „Erforderliche Vorkenntnisse", in dem andere Themen genannt werden, mit deren Inhalten Sie sich auseinandergesetzt haben müssen, um das Thema, dass Sie gerade lesen verstehen zu können. Außerdem setzen wir auch etwas Hintergrundwissen voraus, das im Handbuch selbst nicht behandelt wird. Siehe: [preface-audience] für weitere Informationen.

• Viele Arbeitsthemen listen Anforderungen an die Website auf, d.h. Aufgaben, die Sie auf Ihrer Website bereits abgeschlossen haben müssen, damit Sie eine neue Aufgabe, die in dem Thema behandelt wird, dass sie gerade durcharbeiten möchten, umsetzen können.

• Die Besonderheiten der Anforderungen an die Website beziehen sich auf das Szenario, das im gesamten Handbuch für die Erstellung der Wochenmarkt-Website verwendet wird (siehe: [preface-scenario] für Einzelheiten). Sie können die Aufgaben an Ihr eigenes Szenario anpassen, müssen sich dann aber auch an die benutzerdefinierten Änderungen erinnern, die Sie vorgenommen haben, um entscheiden zu können, ob Ihre Website die Anforderungen erfüllt, die erforderlich sind, um eine Aufgabe erfolgreich bearbeiten zu können.

• Für alle Arbeitsthemen nach [install-run] gibt es auch eine implizierte Voraussetzung: Sie müssen die letzte stabile Version der CMS-Software auf Ihrem System installiert haben und sich mit einem Benutzerkonto an Ihrer Website angemeldet haben, das über ausreichend Berechtigungen verfügt, um die Aufgabe auszuführen (z. B. das Benutzerkonto, das erstellt wurde, als Sie Drupal installiert haben. Dieses Benutzerkonto verfügt automatisch über alle vorhandenen Berechtigungen).

• Wenn Sie alle Themen der Reihe nach lesen und alle Schritte in den Arbeitsthemen nach und nach ausführen (währen Sie an der Website angemeldet bleiben), sollten Sie am Ende über das notwendige Hintergrundwissen verfügen. So erfüllen Sie automatisch auch die für jedes folgende Thema geltenden Anforderungen an die Website, während Sie das Handbuch Stück für Stück durcharbeiten.

• Dieses Handbuch zeigt Ihnen, wie Sie Aufgaben über den Verwaltungsbereich und wo immer möglich, auch unter Verwendung der neuesten stabilen Version des Kommandozeilenwerkzeugs „Drush“ (siehe: [install-tools]) erledigen können. Sie können gerne ein anderes Kommandozeilenwerkzeug, wie z. B. die Drupal Console (wenn Sie die dafür aktuell verfügbaren Befehle nachschlagen) oder vorerst nur den Verwaltungsbereich der Benutzeroberfläche verwenden.

Text-Konventionen

Die folgenden Konventionen werden im Text dieses Handbuchs verwendet:

• Die URL example.com ist die Basis-URL Ihrer Website. Lesen Sie den Abschnitt Navigation weiter unten, um weitere Informationen darüber zu erhalten, wie URLs innerhalb Ihrer Website aussehen und angegeben werden.

• Text, den Sie in der Benutzeroberfläche Ihrer Website sehen sollten, wird in Kursivschrift angezeigt, wie zum Beispiel: Klicken Sie auf Konfiguration speichern. Dies gilt nur für die Texte der Benutzeroberfläche, die mit der Software mitgeliefert werden und nur für den Teil der Benutzeroberfläche, der im aktuellen Thema behandelt wird. Zum Beispiel könnten Sie in einem Thema über das Bearbeiten von Inhalten folgendes lesen: Klicken Sie auf Bearbeiten in der Zeile der Seite „Info“ (Bearbeiten wäre in diesem Fall Kursiv dargestellt. Das Wort Info wäre nicht kursiv dargestellt, weil die Info-Seite in einem vorherigen Thema behandelt worden wäre).

• URLs, Dateinamen und neu eingeführte Terminologie werden auch in Kursivschrift dargestellt.

• Text, den Sie in ein Kommandozeilenfenster eingeben sollten, wird in Monospace-Schrift angezeigt, beispielsweise so:

  drush cache:rebuild

• In diesem Handbuch wird das Wort Verzeichnis immer als Verweis auf Datei-Verzeichnisse (die manche Leute lieber als Ordner bezeichnen) verwendet.

Navigation

Um die meisten Aufgaben in diesem Handbuch erledigen zu können, müssen Sie zu einem der folgenden Themen oder über mehrere Seiten im Verwaltungsbereich der Website hinweg navigieren. In den Anweisungen könnte folgendes zu lesen sein (dies wird mehr Sinn machen, nachdem Sie das Kernsystem installiert haben):

Navigieren Sie im Menü Verwalten zum Menüpunkt Struktur > Taxonomie (admin/structure/taxonomy).

Navigationsanweisungen wie diese setzen voraus, dass Sie das Modul Toolbar, das mit dem Kernsystem ausgeliefert wird, installiert haben. Das obige Beispiel bedeutet, dass Sie in der Werkzeugleiste oben auf Ihrer Website, auf Verwalten klicken, um die Menüoptionen anzuzeigen und dann auf den Menüpunkt Struktur und den untergeordneten Menüpunkt Taxonomie klicken, so dass Sie am Ende auf einer Seite mit der URL http://example.com/admin/structure/taxonomy landen (wenn die Basis-URL Ihrer Website http://example.com) lautet.

Hier ist ein weiteres Beispiel:

Navigieren Sie im Menü Verwalten zum Menüpunkt Konfiguration > System > Grundlegende Einstellungen der Website (admin/config/system/site-information).

In diesem Beispiel würden Sie, nachdem Sie auf Verwalten und Konfiguration geklickt haben, Im Bereich Konfiguration nach System gesucht haben. Anschließend hätten Sie den Link auf der Benutzeroberfläche gefunden und darauf geklickt. Im Abschnitt System hätten Sie auf Grundeinstellungen der Website geklickt und damit die Seite http://example.com/admin/config/system/site-information aufgerufen.

Ein weiterer Hinweis: Wenn Sie das mit dem Kernsystem ausgelieferte Verwaltungs-Theme Seven verwenden, werden viele „Hinzufügen"-Button im Verwaltungsbereich mit +-Zeichen angezeigt. Zum Beispiel erscheint unter dem Menüpunkt Verwalten/Inhalt der Button „Neuen Inhalt hinzufügen als + Neuen Inhalt hinzufügen. Dies ist jedoch abhängig vom verwendeten Theme und gehört nicht wirklich zum Text des Buttons (Ein Screen Reader würde den Text beispielsweise falsch vorlesen), so dass wir uns entschieden haben, das +-Zeichen in diesem Handbuch nicht zu erwähnen obwohl es sich auf den Schaltflächen befindet.

Ausfüllen von Formularen

Viele der Arbeitsthemen in diesem Handbuch enthalten Arbeitsschritte, bei denen Sie ein Webformular ausfüllen müssen. In den meisten Fällen wird ein Bildschirmfoto des Formulars, zusammen mit einer Tabelle von Beispielwerten die Sie in das jeweilige Formularfeld eingeben müssen mitgeliefert. Beispielsweise könnten Sie eine Tabelle sehen, die wie folgt beginnt und das Formular Grundeinstellungen der Website erläutert, das Sie sehen würden, wenn Sie zum Menüpunkt Konfiguration > System > Grundeinstellungen der Website (admin/config/system/site-information) navigieren würden:

Feldname	Erläuterung	Beispielwert
Grundeinstellungen der Website > Name der Website	Name Ihrer Website	Musterstadt Wochenmarkt

Um diese Tabelle zu verwenden, suchen Sie das Feld mit der Bezeichnung Name der Website im Abschnitt Website-Details im Formular, und geben den Namen Ihrer Website in das Feld ein. Ein Beispiel für den Namen „Musterstadt Wochenmarkt" wird im Feld Beispielwert bereitgestellt. Die Tabelle, die sich auf das Szenario der Erstellung einer Website für einen Wochenmarkt bezieht finden Sie in diesem Handbuch (siehe: [preface-scenario] für weitere Informationen). Beachten Sie auch, dass Sie auf einigen Formularen möglicherweise auf den Titel eines Abschnitts klicken müssen. (z. B. auf Grundeinstellungen der Website), um einem Formularabschnitt ausklappen, und das jeweilige Feld sehen zu können.

Mitwirkende

Geschrieben von Jennifer Hodgdon.

Ins Deutsche übersetzt von Joachim Namyslo.