GSB 7.0 Standardlösung

Navigation

Die Navigationsstruktur sowie die Angabe der Inhalte, die an einem Navigationsknoten dargestellt werden, müssen von unterschiedlichen Personen gleichzeitig bearbeitet werden können.

Daher werden zur Umsetzung der Navigationsstruktur zwei Dokumenttypen eingesetzt. Im Aufgabenbereich der Redakteure liegt das Befüllen der Navigationsziele mit Inhalt tragenden Dokumenten. Alle anderen Inhalte dieses Dokuments sowie die Navigationsknoten fallen in den Aufgabenbereich der Site Manager. Die Aufgaben der Redakteure sind im entsprechenden Handbuch beschrieben. Sie bilden die Grundlage für die technische Beschreibung.

Die Navigationsdokumente werden immer gemeinsam mit dem Content abgelegt. Wenn die Navigationsdokumente bei dem Inhalt liegen, zu dem sie gehören, dann sind sie für alle Beteiligten leichter auffindbar. Eine entsprechende Namenskonvention (z.B._node und_target) erleichtert darüber hinaus das Auffinden.

Hinweis: Sofern es sich um die Darstellung von dynamischen Seiten handelt, liegen die Navigationsdokumente im Content in dem Ordner, deren Navigationspunkt sie repräsentieren. Die Inhalte, die mit Hilfe der dynamischen Seite zusammengesucht werden und das Konfigurations-Dokument der dynamischen Seite liegen nicht zwingend bei diesen Navigationsknoten, sondern in einem SharedDocs- bzw. Functions-Ordner.

Weitere Details können Sie dem Dokument der Ordnerhierarchie () und dem Navigationsknoten-Dokument () entnehmen.

Die Ausgabe von Navigationsknoten erfolgt mit Hilfe einer automatischen Silbentrennung, wobei entsprechende Trennzeichen auf Basis eines allgemeinen, sprachabhängigen Wörterbuchs eingefügt werden. Somit werden Bezeichner mehrzeilig dargestellt, falls diese die definierte Breite der Navigationsboxen überschreiten. Sofern Begriffe nicht wie gewünscht umgebrochen werden,kann die Silbetrennung im Dokument /standardlsg/SiteGlobals/_config/Hyphenation_de bzw. /standardlsg/SiteGlobals/_config/Hyphenation_en konfiguriert werden, z.B. kann eine Regel definiert werden, nach der das Wort Assembler wie folgt umgebrochen wird: As-sem-bler

Benötigte Navigationsdokumente

home_node: Hierbei handelt es sich nicht um einen eigenen Dokumenttyp, aber um ein Dokument vom Typ „Navigationsknoten“, in dem die erste Navigationsebene definiert wird. Für jede Sprache wird ein eigener Wurzelknoten benötigt.

  • Dieses Dokument dient der Erfassung der Navigationspunkte, welche die erste Ebene darstellen.

Navigationsknoten: Ein Dokument vom Typ „Navigationsknoten“ (NavNode) repräsentiert einen Navigationsknoten innerhalb einer Navigationsstruktur. Navigationsknoten-Dokumente können hierarchisch strukturiert werden, wodurch die eigentliche Navigationsstruktur erstellt wird. Ihnen werden auch eigene Navigations-Styles mitgegeben (s.u.).

Navigationsziel: Ein Dokument vom Typ „Navigationsziel“ (NavTarget) hat die Aufgabe, ein oder mehrere Dokumente (LanguageEnt-Dokumente) innerhalb des Content-Bereiches anzuordnen und diesen entsprechende Layouts zuzuweisen.

Die Navigationsstruktur stellt sich wie folgt dar:

Navigationsstruktur, -ziele und dargestellte Dokumente

Die oben stehende Abbildung stellt das Zusammenspiel zwischen Navigationsknoten- und Navigationsziel-Dokumenten vereinfacht dar. Der hierarchische Aufbau der Navigationsstruktur wird mit Hilfe von Navigationsknoten-Dokumenten festgelegt. Jedem Navigationsknoten-Dokument wird ein Navigationsziel-Dokument zugewiesen.

Im Navigationsziel-Dokument wird festgelegt,

  • mit welchem Layout der Contentbereich dargestellt werden soll,
  • welche redaktionellen Inhalte in den einzelnen Teilabschnitten des Contentbereichs dargestellt werden und
  • mit welchem Layout die redaktionellen Inhalte im Contentbereich dargestellt werden sollen,

wenn der zugehörige Navigationspunkt ausgewählt wird.

Bei der Auswahl der redaktionellen Inhalte können die gewünschten Dokumente entweder direkt verlinkt oder über eine dynamische Dokumentliste zusammengesucht werden. Dazu werden in der dynamischen Dokumentliste Kriterien zum Auffinden der Dokumente angeben (z.B. alle Kurzmeldungen aus dem Ordner „Kurzmeldungen“).

Wird ein Navigationsknoten-Dokument angewählt, wird das zugehörige Navigationsziel ermittelt und die damit verbundenen redaktionellen Inhalte (LanguageEnt-Dokumente) mit ihren zugewiesenen Layouts dargestellt.

Kurze URLs (Redirect)

Wenn Sie beispielsweise einer bestimmten Benutzergruppe (Journalisten) einen schnelleren Zugriff auf einen bestimmten Bereich der Website ermöglichen möchten, können Sie einen so genannten Redirect einrichten. Dies bedeutet, dass die Benutzer eine bestimmte URL eingeben und dann direkt auf der von Ihnen dafür eingerichteten Seite landen. Die URL könnte beispielsweise „ lauten.

Fahren Sie zum Anlegen wie folgt fort:

  1. Legen Sie einen Navigationsknoten und ein Navigationsziel für den Inhalt an, der über die kurze URL aufgerufen werden soll. Wenn Sie dazu schon Knoten und Ziel haben, können Sie das weiterhin verwenden.
  2. Legen Sie nun direkt unterhalb von "/standardlsg" ein Dokument vom Typ „Konfiguration-Kurz-URL“ mit dem Namen "presse" an (also genau der Name in der Schreibweise, die der Benutzer nach dem Schrägstrich tippen soll).
  3. In dem Dokument gibt es ein Feld "Wert". In dieses Feld hängen Sie nun den zugehörigen Navigationsknoten ein.
  4. Nach der Publikation kann der Benutzer der Website nun den Pfad wie oben beschrieben eingeben und gelangt direkt auf den entsprechenden Navigationsknoten.

Flyout-Navigation

Die Ebene-1 Navigation der Standardlösung ist als Flyout realisiert. Das Flyout-Menü kann mehrspaltig konfiguriert werden, wobei die GSB-SL bis zu zwei Spalten unterstützt. Die Anzahl der Spalten wird über das Konfigurationsdokument FlyoutColumns (Dokumenttyp Konfiguration-Integer) definiert. Das für den jeweiligen Ebene-1 Navigationspunkt zuständige Konfigurationsdokument wir über den rekursiven Config-Reader gesucht.

Fixieren der Navigationsleiste

Für Navigation in der Small- und Medium-Darstellung werden die in Large verwendeten Navigationen ausgeblendet und stattdessen eine spezielle Navigationsleiste angezeigt. Über diesen kann dann die Hauptnavigation, die Suche sowie die Bereiche "Leichte Sprache" und "Gebärdensprache" aufgerufen werden. Ob diese Leisteimmer am oberen Seitenrand fixiert werden soll, kann in dem Dokument /standardlsg/_config/NaviMobileFixed (ConfigInt) festgelegt werden. Ist der Wert des Konfigurationseintrags 0, so wird die Leiste nicht fixiert. Ist der Wert 1, wird die Leiste fixiert.

Ausblenden der Breadcrumbnavigation

Die Breadcumbnavigation gibt dem User der Website stehts Aufschluss über den aktuellen Standpunkt in der Struktur der Website. Soll die Breadcrumb hingegen auf einzelnen Seiten nicht ausgegeben werden, so kann dies pfadabhängig über den Konfigurationeintrag /standardlsg/_config/NaviBreadcrumbHide (ConfigBool) konfiguriert werden.

Anlegen eines Navigationspunktes

Beispielhaft soll in der Standardlösung der Navigationspunkt Mein Thema unterhalb von Themen angelegt werden. Als Navigationsziel soll ein beispielhafter Inhalt im Content-Bereich dienen.

Screenshot Bereichsmenü Screenshot Bereichsmenü

Um einen Navigationspunkt anzulegen, müssen zum einen ein Dokument vom Typ Navigationsknoten und zum anderen ein Dokument vom Typ Navigationsziel erstellt und entsprechend konfiguriert werden.

  • Das Dokument Navigationsknoten (Originalbezeichnung: NavNode) dient zum Aufbau der Navigation. Der Dokumenttyp Navigationsknoten dient zur Erfassung der Informationen eines Navigationspunktes.
  • Das Dokument Navigationsziel (Originalbezeichnung: NavTarget) bestimmt, was unter einem Navigationsknoten dargestellt wird.

Beim Anlegen des Navigationsknotens wird auf das Navigationsziel verwiesen. Daher legen wir im Folgenden erst das Navigationsziel und anschließend den Navigationsknoten an.

Ordner anlegen

Navigieren Sie im Navigator oder Explorer zu dem Ordner, der das Navigationsziel enthalten soll. Erstellen Sie einen neuen Unterordner und nennen Sie ihn Mein_Thema.

Navigationsziel anlegen

In dem neu erstellten Ordner erstellen Sie nun ein neues Dokument vom Typ Navigationsziel. Nennen Sie es mein_thema_target und öffnen Sie es zur Bearbeitung.

Navigationsziel anlegen Navigationsziel anlegen

Seitenbefüllung

Slotbelegung: Wählen Sie hier den Content-Bereich aus.

Layout: Als Layout wählen Sie die Layout-Variante Standard aus.

Dokumente: Als Dokument wählen Sie z.B. einen Standardartikel unter /standardlsg/DE/zzz_Beispiele/_Doctypes/Standardartikel aus. Es gibt verschiedene Wege, das Dokument anzusteuern und auszuwählen: Sie können sich durch den Navigator klicken, die Suche benutzen oder, sofern Sie das Dokument zur Ablage hingefügt hatten, es aus der Ablage auswählen.

Seitenlayout

Wählen Sie als Seitenlayout Inhalt mit Navigation (einspaltig) aus.

Geben Sie das Dokument zurück.

Anlegen eines Navigationsknotens

Navigieren Sie im Navigator oder Explorer zu dem Ordner, der den Navigationsknoten enthalten soll. Im Regelfall ist dies der gleiche Order, in dem auch das Navigationsziel angelegt wurde.

Navigationsknoten anlegen

In dem gleichen Ordner erstellen Sie nun ein neues Dokument vom Typ Navigationsknoten. Nennen Sie es mein_thema_node und öffnen Sie es zur Bearbeitung.

Navigationsknoten anlegen Navigationsknoten anlegen

Unter Hauptinhalte geben Sie folgende Informationen an:

  • Browser-Titel (Pflichtfeld): Mein Thema
  • Anzeigetext: Mein Thema
  • Standardnavigationsziel: mein_thema_target, d.h. das soeben angelegte Navigationsziel
  • Navigationsstil (Pflichtfeld): Tree

Unter Nebeninhalte geben Sie folgende Informationen an:

  • HTML-Metatag Beschreibung: Informationen zu meinem Thema

Geben Sie das Dokument zurück.

Navigationsknoten einhängen

Navigieren Sie im Explorer zu dem Knoten, der als Elternknoten dienen soll (z.B. /standardlsg/DE/Themen/themen_node). Öffnen Sie das Dokument zur Bearbeitung. Fügen Sie den neu erstellten Knoten als untergeordneten Knoten hinzu. Bei Bedarf können Sie hier auch die Position des Knotens innerhalb des Menüs ändern, oder auch andere Knoten aus dem Menü entfernen.

Geben Sie das Dokument zurück.

Klicken Sie auf die Dokumentenvorschau und prüfen Sie, ob Sie den neu erstellten Navigationspunkt in Ihrer Navigation wiederfinden.

Navigationspunkt und Inhalt anlegen

Seitenvorlagen kopieren

Im Folgenden wird beschrieben, wie Sie unter Verwendung von Vorlagen einen neuen Hauptnavigationspunkt mit Unterpunkten anlegen können. Es wird exemplarisch der neue Navigationspunkt "Neu" mit dem Unterpunkt "Einführung" angelegt.

Screenshot neuer Navigationsknoten Screenshot neuer Navigationsknoten

Rufen Sie, z. B. über den Navigator, den Seitenbaum auf und legen Sie unterhalb von "DE" einen neuen Ordner an, den Sie "Neu" nennen. Wechseln Sie dann in den Ordner "zzz_Seitenvorlagen". Hier finden Sie vorkonfigurierte Vorlagen, die Sie kopieren und an der gewünschten Stelle - in unserem Beispiel im neu angelegten Ordner "Neu" - einfügen und bearbeiten können. Um einen neuen Navigationsknoten anzulegen, benötigen Sie die Dokumente:

  • seitenvorlagen_node (Navigationsknoten)
  • seitenvorlagen_target (Navigationsziel)
  • seitenvorlagen (Standardartikel)
  • _suchordner (Konfigurationsdatei)

Unter dem Untermenüpunkt "Einführung" werden wir exemplarisch einen Standardartikel anlegen. Kopieren Sie hierfür den Ordner "Artikel". Fügen Sie sowohl den Ordner Artikel als auch die oben aufgeführten Dateien in den neu erstellen Ordner "Neu" ein.

Im nächsten Schritt können Sie die kopierten Dateien konfigurieren.

Navigationsknoten konfigurieren

Anpassung des Dokumentes seitenvorlagen_target

Der Übersichtlichkeit halber empfiehlt es sich, das Dokument umzubenennen in z. B. neu_target. Öffnen Sie das Dokument und prüfen Sie, an welchen Stellen Verweise auf den bisherigen Ablageort (zzz_Seitenvorlagen) vorhanden sind.

Navigationsziel anpassen Navigationsziel anpassen

Hier binden Sie nun statt des Vorlagendokumentes den Standardartikel ein, der sich ebenfalls im Ordner "Gesetze" befindet.

Anpassung des Dokumentes seitenvorlagen_node

Öffnen Sie das Dokument und prüfen Sie auch hier, an welchen Stellen Verweise auf den ursprünglichen Speicherort vorhanden sind. Binden Sie unter Standardnavigationsziel (1) das eben aktualisierte Dokument gesetze_target ein. Unter "Untergeordnete Knoten" (2) können Sie die Seiten einbinden, die als Unternavigationspunkt erscheinen sollen. Wir hatten als Vorlage für die neue Unterseite den Ordner "Artikel" aus den Seitenvorlagen kopiert. Fügen Sie die Datei artikel_node aus diesem Ordner als untergeordneten Knoten ein.

Navigationsknoten anpassen Navigationsknoten anpassen

Wenn Sie die Bearbeitung des Dokumentes abgeschlossen haben, speichern Sie die Änderungen oder geben das Dokument zurück.

Konfiguration des Unternavigationspunktes

Um den Unternavigationspunkt zu konfigurieren, verfahren Sie ähnlich wie bei der Konfiguration des Hauptnavigationspunktes.

Benennen Sie den kopierten Ordner "Artikel" sowie die darin enthaltenen Dokumente artikel_node, artikel_target und standardartikel aus Gründen der Übersichtlichkeit um, z. B. in einfuehrung_node, einfuehrung_target, einfuehrung_artikel. Rufen Sie die Datei einfuehrung_node auf. Unter Standardnavigationsziel ist das Vorlagendokument artikel_target enthalten. Da das Dokument unter diesem Namen nicht mehr existiert, muss hier das neue (umbenannte) Dokument einfuehrung_target eingebunden werden. Analog ändern Sie auch im Dokument einfuehrung_target den Verweis auf das Dokument standardartikel, der im Slot "content" enthalten ist, und binden hier das neue Dokument einfuehrung_artikel ein.

Hauptnavigationsknoten einhängen

Zuletzt hängen Sie den neu erstellen Navigationspunkt noch im übergeordneten Menü ein, um ihn in der Navigation sichtbar und ansteuerbar zu machen. Hierfür rufen Sie das Dokument home_node auf, das Sie entweder über die Suchfunktion finden können oder direkt über den Navigator oder Explorer ansteuern können. In der Standardlösung ist das Dokument im Ordner DE/Home zu finden. Hier fügen Sie bei den "Untergeordneten Navigationsknoten" den neu angelegten Knoten gesetze_node ein.

Navigationsknoten einhängen Navigationsknoten einhängen