Public-Verzeichnis

Das Public-Verzeichnis #

Was ist das Public-Verzeichnis? #

Das public/-Verzeichnis enthält die fertige, generierte statische Website. Es wird automatisch von Hugo erstellt, wenn Sie den Befehl hugo (ohne server) ausführen.

public/
├── index.html        # Generierte Homepage
├── css/              # Generierte/kopierte CSS-Dateien
├── js/               # Generierte/kopierte JavaScript-Dateien
├── images/           # Kopierte Bilder
└── blog/             # Generierte Blog-Seiten
    ├── index.html    # Blog-Übersichtsseite
    └── post1/        # Einzelner Beitrag
        └── index.html

Lokales Lesen ohne Hugo-Server #

Sie können die Inhalte des public/-Verzeichnisses auch lokal im Browser ohne Hugo-Server lesen:

  1. Öffnen der HTML-Dateien: Navigieren Sie zum public/-Verzeichnis und öffnen Sie die HTML-Dateien direkt im Browser:

    D:\PO\Online\wissen4vertrieb.de\Hugo\public\index.html
    

    oder

    D:\PO\Online\wissen4vertrieb.de\hugo-docs\public\index.html
    
  2. Vollständiger Pfad wichtig: Verwenden Sie immer den vollständigen Pfad zur HTML-Datei, z.B.:

    D:\PO\Online\wissen4vertrieb.de\hugo-docs\public\docs\grundlagen\struktur\index.html
    

Einschränkungen beim direkten Öffnen #

Beim direkten Öffnen der HTML-Dateien aus dem public/-Verzeichnis gibt es einige Einschränkungen:

  1. Einige Links funktionieren nicht: Relative Links können Probleme verursachen
  2. Keine dynamischen Funktionen: JavaScript-Funktionen wie die Suche funktionieren möglicherweise nicht korrekt
  3. Keine automatische Aktualisierung: Änderungen an den Quelldateien werden nicht automatisch angezeigt
  4. Pfadprobleme: Einige Ressourcen (CSS, Bilder) werden möglicherweise nicht korrekt geladen

Wann ist das direkte Öffnen sinnvoll? #

Das direkte Öffnen der Dateien aus dem public/-Verzeichnis kann in folgenden Situationen sinnvoll sein:

  1. Offline-Zugriff: Wenn Sie die Dokumentation ohne laufenden Hugo-Server lesen möchten
  2. Überprüfung der generierten Dateien: Um zu sehen, was Hugo tatsächlich generiert hat
  3. Testen vor dem Deployment: Um zu prüfen, wie die Website nach dem Hochladen aussehen würde

Empfehlung #

Für die Entwicklung und das Bearbeiten Ihrer Inhalte sollten Sie immer den Hugo-Server verwenden:

hugo server -D

Für das einfache Lesen der Dokumentation können Sie die HTML-Dateien direkt öffnen, sollten aber die genannten Einschränkungen beachten.