Skip to content

Commit 268c860

Browse files
authored
Add legacy sdpub migration (#85)
1 parent a7be2cb commit 268c860

12 files changed

Lines changed: 881 additions & 406 deletions

File tree

data/help/commands/legacy.jinja

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
Help Type: command
2+
Command: wikigraph legacy
3+
4+
Purpose:
5+
Low-frequency migration tools for old released archive formats.
6+
7+
Usage:
8+
wikigraph legacy migrate <path.sdpub> [--output <path.wikg>]
9+
10+
Commands:
11+
migrate Convert a released legacy archive into the current `.wikg` format.
12+
13+
Examples:
14+
wikigraph legacy migrate ./book.sdpub
15+
wikigraph legacy migrate ./book.sdpub --output ./book.wikg
16+
17+
See Also:
18+
wikigraph legacy migrate --help
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
Help Type: command
2+
Command: wikigraph legacy migrate
3+
4+
Purpose:
5+
Convert a released legacy `.sdpub` archive into the current `.wikg` format.
6+
7+
Usage:
8+
wikigraph legacy migrate <path.sdpub> [--output <path.wikg>]
9+
10+
Input:
11+
Supports `.sdpub` archives produced by released SpineDigest v0.1.8 or v0.2.2.
12+
13+
Output:
14+
If `--output` is omitted, the output path is the input path with `.sdpub` replaced by `.wikg`.
15+
The input archive is not modified.
16+
17+
Examples:
18+
wikigraph legacy migrate ./book.sdpub
19+
wikigraph legacy migrate ./book.sdpub --output ./book.wikg

data/help/commands/root.jinja

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,7 @@ Help contract:
6969
- Append `--help` to commands and subcommands to see command-specific usage.
7070
- Use `wikigraph help <topic>` for cross-command concepts, constraints, and runtime behavior.
7171
- Treat `wikigraph --help` as the root page of the same help system.
72+
- Old archive migration: `wikigraph legacy --help`.
7273

7374
Help topics:
7475
{% for topic in helpTopics %}

0 commit comments

Comments
 (0)