@chengzhao-dev/dsh-quarto-book 0.6.0 → 0.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/README.en.md +6 -5
  2. package/README.md +6 -5
  3. package/locale/en.json +2 -2
  4. package/locale/zh.json +2 -2
  5. package/package.json +4 -4
  6. package/skills/designing-theme/SKILL.md +1 -1
  7. package/skills/designing-theme/assets/theme/palettes/hill-light/tokens.css +1 -1
  8. package/skills/writing-quarto/SKILL.md +6 -4
  9. package/skills/writing-quarto/examples/02-structure-shape.md +28 -0
  10. package/skills/writing-quarto/examples/05-sentence-reference.md +14 -0
  11. package/skills/writing-quarto/examples/06-wording-cases.md +14 -0
  12. package/skills/writing-quarto/examples/{03-layout-list.md → 07-layout-list.md} +14 -0
  13. package/skills/writing-quarto/examples/08-appendix.md +1 -1
  14. package/skills/writing-quarto/quarto/basics.md +1 -1
  15. package/skills/writing-quarto/quarto/prose.md +35 -3
  16. package/skills/writing-quarto/quarto/readability.md +55 -0
  17. package/skills/writing-quarto/quarto/render.md +17 -0
  18. package/skills/writing-quarto/scripts/checking-links.py +4 -1
  19. package/skills/writing-quarto/scripts/checking-prose.py +163 -0
  20. package/skills/writing-quarto/scripts/testing-content.py +3 -1
  21. package/skills/writing-quarto/scripts/verifying-content.py +5 -0
  22. package/skills/writing-quarto/steps/01-task.md +1 -1
  23. package/skills/writing-quarto/steps/02-structure.md +9 -26
  24. package/skills/writing-quarto/steps/03-blocks.md +14 -14
  25. package/skills/writing-quarto/steps/04-paragraphs.md +16 -16
  26. package/skills/writing-quarto/steps/05-sentences.md +24 -14
  27. package/skills/writing-quarto/steps/06-wording.md +1 -0
  28. package/skills/writing-quarto/steps/07-layout.md +11 -12
  29. package/skills/writing-quarto/steps/08-reread.md +8 -4
  30. package/skills/writing-quarto/steps/09-check.md +4 -4
  31. package/templates/quarto-book-project/SKILL.md +2 -0
  32. package/templates/quarto-book-project/writing/chapter-map.md +3 -0
package/templates/quarto-book-project/SKILL.md CHANGED
@@ -16,7 +16,9 @@ description: 记录某一本 Quarto Book 的项目级约定：书名、读者、
16
16
  - 书名：
17
17
  - 一句话定位：
18
18
  - 目标读者与前置知识：
19
+ - 读者完成后能独立完成：
19
20
  - 本书不覆盖的内容：
21
+ - 术语首次解释的落点（就近术语卡 / 章首术语表）：
20
22
 
21
23
  ## 章节对照
22
24
 
package/templates/quarto-book-project/writing/chapter-map.md CHANGED
@@ -17,6 +17,9 @@ YAML `title` 与二级标题。类章与能力章的定义、一章一个关键
17
17
  不写英文类名，除非关键对象本身只有一个英文名。
18
18
  - 二级标题是这一章关键的部分，顺序与「关键」一列对应；成员函数可以做三级标题，
19
19
  不能做章标题。
20
+ - 本表是章题契约：`title`、`关键`、二级标题三列与正文同轮同步；改 title 或任务节
21
+ 时同轮改本表，表与正文不一致按章题脱节处理。项目有检查脚本时，让它逐章核对
22
+ `title` 与 `##` 顺序。
20
23
  - 固定收尾 `常见错误`、`自测问题`、`本章回顾` 不改名，不升成关键。
21
24
  - 类型章的文件名镜像关键类；改文件名时同轮同步 `_quarto.yml`、本表、`title`、
22
25
  已有链接与内容检查脚本里的章关键键，不留旧名孤儿。