目錄結構

目錄簡介

預設情況下,Qiandu是基於Hugo維護的,所以內容在 content 目錄中搜尋 Markdown 文件,目錄的結構決定了網站的最終輸出結構。 如範例:

    • _index.md
      • _index.md
      • getting-started.md
        • _index.md
        • organize-files.md
      • _index.md
      • post-1.md
  • 每個 _index.md 檔案都是對應部分的索引頁,其他 Markdown 檔案則是常規頁面。

    content
    ├── _index.md // <- /
    ├── docs
    │   ├── _index.md // <- /docs/
    │   ├── getting-started.md // <- /docs/getting-started/
    │   └── guide
    │       ├── _index.md // <- /docs/guide/
    │       └── organize-files.md // <- /docs/guide/organize-files/
    └── blog
        ├── _index.md // <- /blog/
        └── post-1.md // <- /blog/post-1/

    側邊欄導航

    側邊欄導覽是根據內容組織的字母順序自動產生的。若要手動設定側邊欄順序,可以在 Markdown 檔案的 frontmatter 中使用 weight 設定。

    content/docs/guide/_index.md
    ---
    title: Guide
    weight: 2
    ---
    ℹ️
    建議側邊欄不要太深。如果內容太多,請考慮 將它們分成多個部分

    配置内容目录

    如果需要為的內容使用不同的目錄,可以聯絡管理員在網站設定檔中設定 contentDir 來實作。