Assets
Manchmal möchten Sie direkt aus Themen heraus auf Assets (z. B. DOCX-Dateien, Bilder usw.) verlinken. docStatic verwaltet dies über den Ordner „static/“.
Alle Inhalte, die in diesem Ordner abgelegt werden, sind über das Stammverzeichnis der veröffentlichten Website verfügbar. Beispiel:
# Ihr Dokument
/website/docs/myFeature.mdx
# Einige Assets, die Sie verwenden möchten
/website/assets/docstatic-asset-example.docx
/website/img/docstastic-asset-example-banner.png
Bilder
DocStatic bietet zwei Möglichkeiten, Bilder zu Themen hinzuzufügen. Für Inline-Bilder können Sie auf das Symbol Bild klicken, um ein Bild in ein Thema einzufügen. Dies eignet sich am besten für Symbole (
) und kleine Bilder. Symbole sollten als vorab skalierte SVG-Dateien gespeichert werden. Diese werden im Dunkelmodus invertiert und ihr Farbraum wird um 180° gedreht.
Sie können Librsvg verwenden, um SVGs zu skalieren. Beispielsweise legt rsvg-convert example.svg -h 12 -f svg -o example.svg eine Höhe von 12 Punkten fest.
Verwenden Sie für größere Bilder stattdessen die Komponente Abbildung. Sie fügt eine Bildunterschrift hinzu – die auch als Alt-Text für Bildschirmleser dient –, passt sich der Seite an und öffnet sich beim Anklicken in voller Größe in einem Leuchtkasten.
Beispiel
Weitere Informationen zum Medienmanager finden Sie unter Medienübersicht in der TinaCMS-Dokumentation.
Dateien
Auf die gleiche Weise können Sie auf vorhandene Assets verlinken, indem Sie den Pfad aus dem Ordner static/ in der URL verwenden. Beispiel:
./assets/docstatic-asset-example.docx
Weitere Informationen finden Sie unter Statische Assets in der Docusaurus-Dokumentation.