feat(gen-docs): add Hugo partials docs generation (#809)

* feat(gen-docs): add documentation generation package with SassDoc and TypeDoc support

Add new `@hugo-fixit/gen-docs` package that parses Hugo config (hugo.toml) and generates
documentation. Includes SassDoc annotations for SCSS variables and mixins, TypeDoc config
for TypeScript source docs, and a `.sassdocrc` configuration file.

* docs(readme): add browsers support section

* feat(gen-docs): add Hugo partials docs generation and fix config empty sections

- Add partial-parser.ts: parses Hugo partial comment blocks (@param/@return/@example)
- Add partials.ts renderer: generates grouped Markdown with param tables
- Add `partials` subcommand with -t/-o options for template injection
- Fix config-parser: empty TOML sections (library.js/library.css) now retain descriptions
- Fix config-parser: correctly distinguish section-level vs key-level comments
- Update README with partials subcommand documentation
This commit is contained in:
Cell
2026-07-21 12:19:07 +08:00
committed by GitHub
parent e07eefd506
commit 2c0b48370b
40 changed files with 2317 additions and 955 deletions
+4
View File
@@ -43,6 +43,9 @@
"version": "pnpm -F versioning start prod",
"changelog": "auto-changelog-plus --starting-date 2021-12-18",
"gen:lexers": "pnpm -F chroma-lexers start",
"gen:docs": "pnpm -F gen-docs start",
"gen:typedoc": "typedoc",
"gen:sassdoc": "npx sassdoc@2.7.2 assets/scss/ --dest ../fixit-docs/static/references/scss --config .sassdocrc",
"unocss": "unocss",
"unocss:watch": "unocss --watch",
"prepare": "simple-git-hooks"
@@ -61,6 +64,7 @@
"serve": "^14.2.6",
"simple-git-hooks": "^2.13.1",
"tsx": "^4.22.4",
"typedoc": "^0.28.20",
"typescript": "^6.0.3",
"unocss": "^66.7.4"
},