Skip to content

Commit 4af5736

Browse files
feat(standard): switch source of truth to Texinfo — v1.29 (#8)
The_Steelbore_Standard.texi is now the canonical source. The_Steelbore_Standard.md and .html are generated outputs (make md / make html). .docx/.odt on request only (make docx). Makefile + spacecraft.css added. .gitignore extended with generated output patterns and TeX aux files. REUSE.toml updated to cover .texi with override annotation. Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 6e4db5d commit 4af5736

6 files changed

Lines changed: 3420 additions & 457 deletions

File tree

.gitignore

Lines changed: 24 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,28 @@
1-
# Derived deliverables — uploaded as release assets, not version-controlled
2-
The_Steelbore_Standard.odt
1+
# Generated outputs — produced from The_Steelbore_Standard.texi via `make`
2+
# Run: make info → .info make html → .html make md → .md make pdf → .pdf
3+
# On request only: make docx → .docx
4+
The_Steelbore_Standard.info
5+
The_Steelbore_Standard.html
6+
The_Steelbore_Standard.pdf
37
The_Steelbore_Standard.docx
8+
The_Steelbore_Standard.odt
9+
10+
# TeX auxiliary files
11+
*.aux
12+
*.log
13+
*.toc
14+
*.cp
15+
*.cps
16+
*.fn
17+
*.fns
18+
*.ky
19+
*.kys
20+
*.pg
21+
*.pgs
22+
*.tp
23+
*.tps
24+
*.vr
25+
*.vrs
426

527
# Agent-local guidance and exports (not for publication)
628
CLAUDE.md

Makefile

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# SPDX-FileCopyrightText: 2026 Mohamed Hammad <Mohamed.Hammad@SpacecraftSoftware.org>
2+
# SPDX-License-Identifier: GPL-3.0-or-later
3+
4+
TEXI = The_Steelbore_Standard.texi
5+
INFO = The_Steelbore_Standard.info
6+
HTML = The_Steelbore_Standard.html
7+
MD = The_Steelbore_Standard.md
8+
PDF = The_Steelbore_Standard.pdf
9+
DOCX = The_Steelbore_Standard.docx
10+
CSS = spacecraft.css
11+
12+
all: info html md
13+
14+
info: $(INFO)
15+
$(INFO): $(TEXI)
16+
makeinfo --no-split $(TEXI)
17+
18+
html: $(HTML)
19+
$(HTML): $(TEXI) $(CSS)
20+
texi2any --html --no-split --css-include=$(CSS) $(TEXI)
21+
22+
md: $(MD)
23+
$(MD): $(TEXI)
24+
texi2any --docbook $(TEXI) -o /tmp/std_docbook.xml
25+
pandoc -f docbook -t gfm /tmp/std_docbook.xml -o $(MD)
26+
27+
pdf: $(PDF)
28+
$(PDF): $(TEXI)
29+
texi2pdf --texinfo=@afourpaper $(TEXI)
30+
31+
docx: $(DOCX)
32+
$(DOCX): $(TEXI)
33+
texi2any --docbook $(TEXI) -o /tmp/std_docbook.xml
34+
pandoc -f docbook -t docx /tmp/std_docbook.xml -o $(DOCX)
35+
36+
clean:
37+
rm -f $(INFO) $(HTML) $(PDF) *.aux *.log *.toc *.cp *.cps \
38+
*.fn *.fns *.ky *.kys *.pg *.pgs *.tp *.tps *.vr *.vrs
39+
40+
.PHONY: all info html md pdf docx clean

REUSE.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ version = 1
33
# override: the Standard text contains *example* SPDX headers (in §4.3) that must not be
44
# parsed as real license tags — the REUSE.toml annotation is authoritative for these files.
55
[[annotations]]
6-
path = ["The_Steelbore_Standard.md", ".gitignore", "REUSE.toml"]
6+
path = ["The_Steelbore_Standard.texi", "The_Steelbore_Standard.md", ".gitignore", "REUSE.toml"]
77
precedence = "override"
88
SPDX-FileCopyrightText = "2026 Mohamed Hammad <Mohamed.Hammad@SpacecraftSoftware.org>"
99
SPDX-License-Identifier = "CC-BY-SA-4.0"

0 commit comments

Comments
 (0)