create-asciidoc-multi-book-workspace 0.1.7 → 0.1.9

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 (28) hide show
  1. package/CHANGELOG.md +29 -4
  2. package/README.md +1 -1
  3. package/dist/runtime/adoc-books.mjs +597 -30
  4. package/package.json +4 -3
  5. package/templates/default-workspace/README.md +2 -2
  6. package/templates/default-workspace/books/07-structured-writing-conventions/backmatter/appendix-a.adoc +28 -14
  7. package/templates/default-workspace/books/07-structured-writing-conventions/backmatter/glossary.adoc +5 -1
  8. package/templates/default-workspace/books/07-structured-writing-conventions/backmatter/index.adoc +1 -0
  9. package/templates/default-workspace/books/07-structured-writing-conventions/book.adoc +10 -10
  10. package/templates/default-workspace/books/07-structured-writing-conventions/frontmatter/abstract.adoc +1 -1
  11. package/templates/default-workspace/books/07-structured-writing-conventions/frontmatter/preface.adoc +9 -2
  12. package/templates/default-workspace/books/07-structured-writing-conventions/parts/010-source-surface/010-source-and-projection.adoc +83 -0
  13. package/templates/default-workspace/books/07-structured-writing-conventions/parts/010-source-surface/020-default-semantics.adoc +48 -0
  14. package/templates/default-workspace/books/07-structured-writing-conventions/parts/010-source-surface/030-source-order-notation.adoc +36 -0
  15. package/templates/default-workspace/books/07-structured-writing-conventions/parts/020-identity-and-relation/010-role-identity.adoc +35 -0
  16. package/templates/default-workspace/books/07-structured-writing-conventions/parts/020-identity-and-relation/020-relation-predicate.adoc +24 -0
  17. package/templates/default-workspace/books/07-structured-writing-conventions/parts/020-identity-and-relation/_partintro.adoc +1 -0
  18. package/templates/default-workspace/books/07-structured-writing-conventions/parts/{300-fields-and-lookup → 030-fields-and-lookup}/010-surface-fields.adoc +1 -1
  19. package/templates/default-workspace/package.json.template +2 -2
  20. package/templates/default-workspace/books/07-structured-writing-conventions/parts/100-source-surface/010-source-and-projection.adoc +0 -44
  21. package/templates/default-workspace/books/07-structured-writing-conventions/parts/100-source-surface/020-default-semantics.adoc +0 -26
  22. package/templates/default-workspace/books/07-structured-writing-conventions/parts/100-source-surface/030-source-order-notation.adoc +0 -23
  23. package/templates/default-workspace/books/07-structured-writing-conventions/parts/200-identity-and-relation/010-role-identity.adoc +0 -37
  24. package/templates/default-workspace/books/07-structured-writing-conventions/parts/200-identity-and-relation/020-relation-predicate.adoc +0 -22
  25. package/templates/default-workspace/books/07-structured-writing-conventions/parts/200-identity-and-relation/_partintro.adoc +0 -1
  26. /package/templates/default-workspace/books/07-structured-writing-conventions/parts/{100-source-surface → 010-source-surface}/_partintro.adoc +0 -0
  27. /package/templates/default-workspace/books/07-structured-writing-conventions/parts/{300-fields-and-lookup → 030-fields-and-lookup}/020-index-and-glossary.adoc +0 -0
  28. /package/templates/default-workspace/books/07-structured-writing-conventions/parts/{300-fields-and-lookup → 030-fields-and-lookup}/_partintro.adoc +0 -0
package/CHANGELOG.md CHANGED
@@ -1,15 +1,40 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.1.9 - 2026-06-17
4
+
5
+ ### Added
6
+
7
+ - Add design notes for the `0X0` source-order numbering scheme used by structured writing sample books.
8
+ - Add a reference note on book structure, front matter, body matter, and back matter for authors modeling AsciiDoc books.
9
+ - Expand the structured writing conventions sample with heading containment, generated projection IRI, stable address label, and xref edge examples.
10
+
11
+ ### Changed
12
+
13
+ - Use the same three-digit `0X0` numbering format for structured writing sample Part directories and Chapter files.
14
+ - Clarify when authors should declare stable IDs versus relying on globally unique, stable title text as the xref target.
15
+ - Tighten the sample guidance for role vocabularies, rel predicates, heading level continuity, pass macros, callouts, and large-scope xrefs.
16
+
17
+ ## 0.1.8 - 2026-06-14
18
+
19
+ ### Fixed
20
+
21
+ - Stop preview builds from emitting the Opal duplicate-load warning by loading Asciidoctor through the ESM `@asciidoctor/core` entry instead of mixing it with the CommonJS `asciidoctor` wrapper.
22
+
23
+ ### Changed
24
+
25
+ - Depend on `@asciidoctor/core` directly in generated workspaces and align `asciidoctor-kroki` with core 3.0.4 in the lockfile.
26
+ - Clarify the structured writing sample guidance for precisely referencing a source region with ordinary `xref` links.
27
+
3
28
  ## 0.1.7 - 2026-06-13
4
29
 
5
30
  ### Added
6
31
 
7
- - Add a `复制本书为纯文本` control to each generated book page so readers can copy the expanded single-file book text for saving, note-taking, or model analysis.
8
- - Add a browser fallback that opens the expanded book text as a UTF-8 plain-text page when clipboard access is unavailable.
32
+ - Add a `复制本书为纯文本` control to each generated book page so readers can copy the book source bundle for saving, note-taking, or model analysis.
33
+ - Add a browser fallback that opens the book source bundle as a UTF-8 plain-text page when clipboard access is unavailable.
9
34
 
10
35
  ### Changed
11
36
 
12
- - Keep the generated book page controls self-contained by embedding the already-reduced book text in the HTML instead of adding another published source file.
37
+ - Keep the generated book page controls self-contained by embedding the source bundle in the HTML instead of adding another published source file.
13
38
 
14
39
  ## 0.1.6 - 2026-06-09
15
40
 
@@ -91,5 +116,5 @@
91
116
  - Publish the project as `create-asciidoc-multi-book-workspace`, an npm initializer for complete AsciiDoc multi-book workspaces.
92
117
  - Generate user-owned workspaces with seven sample books, `catalog.adoc`, shared assets, explicit AsciiDoc dependencies, and an editable local `tools/adoc-books.mjs` runtime.
93
118
  - Keep maintainer-only files out of generated workspaces and the npm package, including tests, CI, TypeScript source, and `DESIGN.adoc`.
94
- - Build and check generated workspaces through a single Node runtime using Asciidoctor.js, reducer support, local resource checks, Kroki diagram URL rendering, and optional fetched diagram output.
119
+ - Build and check generated workspaces through a single Node runtime using Asciidoctor.js, local resource checks, Kroki diagram URL rendering, and optional fetched diagram output.
95
120
  - Validate that each default sample book can be deleted after removing its catalog entries, while user-authored real broken xrefs still fail checks.
package/README.md CHANGED
@@ -63,7 +63,7 @@ It does not include this repository's `test/`, `.github/`, `src/`, `dist/`, `DES
63
63
  The generated `package.json` directly lists the AsciiDoc toolchain:
64
64
 
65
65
  - `asciidoctor`
66
- - `@asciidoctor/reducer`
66
+ - `asciidoc-abundant-tree`
67
67
  - `asciidoctor-kroki`
68
68
 
69
69
  The generated scripts are: