Skip to main content

Diese Version von GitHub Enterprise Server wurde eingestellt am 2024-07-09. Es wird keine Patch-Freigabe vorgenommen, auch nicht für kritische Sicherheitsprobleme. Für bessere Leistung, verbesserte Sicherheit und neue Features aktualisiere auf die neueste Version von GitHub Enterprise Server. Wende dich an den GitHub Enterprise-Support, um Hilfe zum Upgrade zu erhalten.

Erstellen von wiederverwendbarem Inhalt

Du kannst wiederverwendbare Inhalte erstellen, auf die in mehreren Inhaltsdateien verwiesen werden kann.

Informationen zu wiederverwendbaren Elementen

Wiederverwendbare Elemente sind lange Zeichenfolgen mit wiederverwendbarem Text, z. B. Absätze oder prozedurale Listen, auf die in mehreren Inhaltsdateien verwiesen werden kann.

Wir verwenden Markdown (anstelle von YAML) für wiederverwendbare Elemente. Markdown ermöglicht es unserer Lokalisierungspipeline, die Zeichenfolgen in kleinere übersetzbare Segmente aufzuteilen, was zu weniger Übersetzungsfehlern und weniger Churn führt, wenn sich der englische Quellinhalt ändert.

Jedes wiederverwendbare Element befindet sich in einer eigenen Markdowndatei.

Der Pfad und der Dateiname jeder Markdowndatei bestimmt, welche Pfade im Datenobjekt enthalten sind. Beispielsweise kann auf eine Datei mit dem Namen /data/reusables/foo/bar.md seitenweise wie auf {% data reusables.foo.bar %} zugegriffen werden.

Wiederverwendbare Dateien werden in der Regel nach Aufgabe in Verzeichnisse unterteilt. Wenn du beispielsweise eine wiederverwendbare Zeichenfolge für Artikel zu GitHub-Benachrichtigungen erstellst, füge sie im Verzeichnis data/reusables/notifications/ in einer Datei mit dem Namen data/reusables/notifications/YOUR-REUSABLE-NAME.mdhinzu. Der Inhaltsverweis, den du der Quelle hinzufügst, würde wie {% data reusables.notifications.YOUR-REUSABLE-NAME %} aussehen.

Anwenden der Versionsverwaltung auf wiederverwendbare Elemente

Wiederverwendbare Elemente können Liquid-Bedingungen enthalten, um Inhalte abhängig von der aktuellen angezeigten Version bedingt zu rendern.

Informationen zu Variablen

Variablen sind kurze Zeichenfolgen aus wiederverwendbarem Text.

Wir verwenden YAML-Dateien für Variablen.

Der Pfad, der Dateiname und die Schlüssel in jeder YAML-Datei bestimmen, welcher Pfad für sie im Datenobjekt verwendet wird.

Die YAML-Datei data/variables/foo/bar.yml enthält beispielsweise zwei Variablen:

# the YAML file can contain multiple short strings in one file
meaning_of_life: 42

# the strings can also be nested if needed
nested:
  values:
    too: Yes!

Die Werte wären als {% data foo.bar.meaning_of_life %} und {% data foo.bar.nested.values.too %} zugänglich.