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.
- package/CHANGELOG.md +29 -4
- package/README.md +1 -1
- package/dist/runtime/adoc-books.mjs +597 -30
- package/package.json +4 -3
- package/templates/default-workspace/README.md +2 -2
- package/templates/default-workspace/books/07-structured-writing-conventions/backmatter/appendix-a.adoc +28 -14
- package/templates/default-workspace/books/07-structured-writing-conventions/backmatter/glossary.adoc +5 -1
- package/templates/default-workspace/books/07-structured-writing-conventions/backmatter/index.adoc +1 -0
- package/templates/default-workspace/books/07-structured-writing-conventions/book.adoc +10 -10
- package/templates/default-workspace/books/07-structured-writing-conventions/frontmatter/abstract.adoc +1 -1
- package/templates/default-workspace/books/07-structured-writing-conventions/frontmatter/preface.adoc +9 -2
- package/templates/default-workspace/books/07-structured-writing-conventions/parts/010-source-surface/010-source-and-projection.adoc +83 -0
- package/templates/default-workspace/books/07-structured-writing-conventions/parts/010-source-surface/020-default-semantics.adoc +48 -0
- package/templates/default-workspace/books/07-structured-writing-conventions/parts/010-source-surface/030-source-order-notation.adoc +36 -0
- package/templates/default-workspace/books/07-structured-writing-conventions/parts/020-identity-and-relation/010-role-identity.adoc +35 -0
- package/templates/default-workspace/books/07-structured-writing-conventions/parts/020-identity-and-relation/020-relation-predicate.adoc +24 -0
- package/templates/default-workspace/books/07-structured-writing-conventions/parts/020-identity-and-relation/_partintro.adoc +1 -0
- package/templates/default-workspace/books/07-structured-writing-conventions/parts/{300-fields-and-lookup → 030-fields-and-lookup}/010-surface-fields.adoc +1 -1
- package/templates/default-workspace/package.json.template +2 -2
- package/templates/default-workspace/books/07-structured-writing-conventions/parts/100-source-surface/010-source-and-projection.adoc +0 -44
- package/templates/default-workspace/books/07-structured-writing-conventions/parts/100-source-surface/020-default-semantics.adoc +0 -26
- package/templates/default-workspace/books/07-structured-writing-conventions/parts/100-source-surface/030-source-order-notation.adoc +0 -23
- package/templates/default-workspace/books/07-structured-writing-conventions/parts/200-identity-and-relation/010-role-identity.adoc +0 -37
- package/templates/default-workspace/books/07-structured-writing-conventions/parts/200-identity-and-relation/020-relation-predicate.adoc +0 -22
- package/templates/default-workspace/books/07-structured-writing-conventions/parts/200-identity-and-relation/_partintro.adoc +0 -1
- /package/templates/default-workspace/books/07-structured-writing-conventions/parts/{100-source-surface → 010-source-surface}/_partintro.adoc +0 -0
- /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
- /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
|
|
8
|
-
- Add a browser fallback that opens the
|
|
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
|
|
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,
|
|
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
|
-
-
|
|
66
|
+
- `asciidoc-abundant-tree`
|
|
67
67
|
- `asciidoctor-kroki`
|
|
68
68
|
|
|
69
69
|
The generated scripts are:
|