E25DX

E25DX

Ihr nächstes Dokumentationsthema...

Bildschirmaufnahme.12.03.2024 um 19.32.01 Uhr.mov

Inspiration

• Erstellen Sie eine einfache, modulare, aber anpassbare technische Dokumentation.

• Erstellen Sie die Website ohne Verwendung von Node/Npm oder externen Frameworks (CSS, JS, Symbol, Schriftart).

• Demo

Merkmale

• Responsive und adaptive Layouts.

• Integrierte Hell- und Dunkelmodi.

• Anpassbare Seitenleisten mithilfe von Hugo-Datenvorlagen.

• Unterstützung für mehrere Dokumentationssätze.

• Implementieren Sie ein Menü über Hugo-Konfigurationen.

• Integrieren Sie Such- oder KI-Assistenten.

Erste Schritte

1. Installieren Sie Hugo.

• Verwenden Sie vorgefertigte Binärdateien über https://github.com/gohugoio/hugo/releases/latest

• Überprüfen Sie die Installation über hugo version

2. Erstellen Sie eine neue Hugo-Site mit dem E25DX-Theme.

• Fügen Sie newsite/content/en/docs/_overview.md für eine Übersicht hinzu

   ---title: Overviewurl: „docs/overview“aliases:
  - "/docs"---

• Fügen Sie newsite/content/en/docs/a1.hello-world.md als erste Seite des ersten Abschnitts hinzu

   ---Titel: Hello Worldslug: hallo-Welt---

• Fügen Sie newsite/content/en/docs/b1.modules.md als erste Seite des zweiten Abschnitts hinzu

   ---Titel: Modulesslug: Module---

• Fügen Sie newsite/data/en/docs/sidebar.yml für Abschnittstitel und Seitentitel hinzu

   - Titel: Dokumentation
    Seiten: – Titel: Übersicht – Titel: Grundlagen
    Seiten: – Titel: Hello World – Titel: Beyond The Basics
    Seiten:- Titel: Module

• newsite/hugo.yaml

• newsite/static/sw.js

• newsite/static/manifest.json

• Sprachen: en:title und en:description

• Parameter: Projekt, Autor und Zuhause

• CacheName-Präfix: z. B. todo-

• Name, Kurzname, Beschreibung

1. Stiftung

    Hugo neue Seite newsitecd newsite
   
   git init
   Git-Submodul hinzufügen https://github.com/dumindu/E25DX.git themes/E25DX
   
   rm hugo.toml && cp themes/E25DX/hugo.yaml .cp themes/E25DX/static/sw.js ./static/
   cp themes/E25DX/static/manifest.json ./static/

   Wir benötigen keine generierten Ordner archetypes , assets , i18n und layouts im newsite -Ordner

2. Konfiguration

3. Beispielinhalt und Seitenleiste

4. Führen Sie hugo server aus

   Ändern Sie newsite/hugo.yaml -> enableGitInfo: false , wenn Sie hugo server ausführen möchten, bevor Sie die Änderungen festschreiben.