專案結構

最後更新


本頁說明 repo 的目錄配置與範例資料夾的命名規則。

目錄配置


路徑內容
index.html首頁:以 PDRenderKit 初始化、PDMarkdownKit 1.6.0 渲染 README.md
README.md首頁內容來源:專案概覽、功能與架構
target/<YYYYMMDD>/單一範例,資料夾名即製作日期
image/<YYYYMMDD>.jpg範例預覽截圖,與資料夾同名
image/website.jpg首頁 Open Graph 圖片
css/index.css首頁樣式
sitemap.xml首頁與 37 個範例(20230313 以外)的 URL 清單,網址位於 https://pardn.io/web-template
.gitattributes將 .md/.scss/.css 標為文件,GitHub 語言統計只計 .html 與 .js

範例資料夾組成


路徑說明
index.html範例入口;部分範例另含多個 HTML(如 20240625 的 login.html、search.html)
view/、views/以框架動態載入的 HTML 片段(如 20230616、20230719)
css/SCSS 編譯產物,index.html 實際載入的檔案
sass/樣式原始碼,入口檔加上 _*.scss partial
js/範例互動邏輯與範例資料(29 個範例)
image/範例自身素材(20 個範例)

TemplateMo(620+ 款 HTML CSS 模板,純 CSS 與 Bootstrap 版型)、HTML5 UP(響應式 HTML5/CSS3 網站模板)、Start Bootstrap(Bootstrap 5 主題與模板)與 learning-zone/website-templates(GitHub 上 150+ 款 HTML5 模板)這類大型模板庫提供的是可直接下載的成品。demo-web 規模較小、以觀摩為目的:38 個以日期命名的範例都不使用 Bootstrap,每個資料夾的 sass/ 原始碼與實際載入的 css/ 編譯產物並存,其中 32 個範例示範 PDRenderKit 或 QuickUI 在實際頁面中的用法。

首頁與範例的關係


首頁與範例彼此獨立:index.html 只渲染 README.md,每個範例直接以資料夾網址開啟。
graph TB
    I[index.html] -->|fetch| R[README.md]
    I --> K[PDRenderKit 1.5.2]
    I --> M[PDMarkdownKit 1.6.0]
    R --> M
    M --> O[專案概覽頁]
    U[瀏覽器] -->|"target/YYYYMMDD/"| T[範例 index.html]
    T --> C[css/ 編譯產物]
    T --> J[js/ 互動邏輯]
    T --> F["PDRenderKit/QuickUI CDN"]
    S[sass/] -->|Dart Sass| C
  1. graph TB
  2. I[index.html] -->|fetch| R[README.md]
  3. I --> K[PDRenderKit 1.5.2]
  4. I --> M[PDMarkdownKit 1.6.0]
  5. R --> M
  6. M --> O[專案概覽頁]
  7. U[瀏覽器] -->|"target/YYYYMMDD/"| T[範例 index.html]
  8. T --> C[css/ 編譯產物]
  9. T --> J[js/ 互動邏輯]
  10. T --> F["PDRenderKit/QuickUI CDN"]
  11. S[sass/] -->|Dart Sass| C

相關頁面


EN