Projektstruktur#

Die Struktur eines easyWebsite-Projekts:

In dem Ordner dokument findest du alle Dateien und Unterordner, die deine Webseite ausmachen. Darin befinden sich unter anderem:

1. Verschiedene Markdown- oder MDX-Dateien (.md oder .mdx)
   • Beinhalten die Inhalte deiner Webseite.
   • Dateien, die index.mdx heißen, werden automatisch als Startseite des jeweiligen Ordners erkannt — der Ordnertitel in der Seitenleiste wird dadurch zu einem klickbaren Link. Alternativ kannst du eine Datei mit demselben Namen wie der Ordner daneben ablegen (z.B. anleitungen.mdx neben anleitungen/). Beide Varianten sind gleichwertig.
     Hinweis

     Wie du Ordnern eine Startseite zuweist und das Auf- und Zuklappen der Navigation steuerst, erfährst du in der Anleitung zur Menü-Struktur.

     Zur Anleitung
2. Verschiedene YAML-Dateien
   • _meta.yaml-Dateien
     • In diesen Dateien kannst du die Metadaten zu einem jeweiligen Ordner und dessen Unterseiten hinterlegen
     • Weiterhin bestimmst du hier, wie genau deine Seiten in der Seitenleiste der Webseite dargestellt werden (z.B. unter welcher Überschrift eine Seite angezeigt wird).
   • abkuerzungen.yaml oder glossar.yaml
     • In diesen Dateien kannst du Abkürzungen und Glossar-Einträge hinterlegen, die dann automatisch auf deiner Webseite angezeigt werden.
     • Entsprechende Begriffe werden in deinen Texten hervorgehoben und deine Definitionen tauchen dann in einem Popup auf, wenn du mit der Maus über den Begriff fährst.
       Hinweis

       Hier findest du eine Anleitung zur Syntax von YAML-Dateien.

       Zur YAML-Syntax Anleitung (extern)
3. Der Ordner assets
   • Hier kannst du Bilder und andere Medien ablegen, die du in deinen Markdown-Seiten verwenden möchtest.