manual: Embed the build version on the second page

Since these will be printed on real dead paper and sent out in the
world, it seems like it may be a very good idea if we can identify what
version they were built from.
This commit is contained in:
Simon Howard 2025-06-03 13:35:54 -04:00
parent 42a8b9aa18
commit 6772452d6a
4 changed files with 11 additions and 1 deletions

View file

@ -8,7 +8,8 @@
# es Spanish # es Spanish
# fr French # fr French
ASCIIDOCTOR_FLAGS = -a pdf-page-size=A5 BUILD_VERSION=$(shell git describe --abbrev=8 --dirty 2>/dev/null)
ASCIIDOCTOR_FLAGS = -a pdf-page-size=A5 -a build-version=$(BUILD_VERSION)
MANUAL_ADOC_FILES=$(wildcard freedoom-manual-??.adoc) MANUAL_ADOC_FILES=$(wildcard freedoom-manual-??.adoc)
MANUAL_PDF_FILES=$(subst .adoc,.pdf,$(MANUAL_ADOC_FILES)) MANUAL_PDF_FILES=$(subst .adoc,.pdf,$(MANUAL_ADOC_FILES))
PRINT_PDF_FILES=$(subst .adoc,-print.pdf,$(MANUAL_ADOC_FILES)) PRINT_PDF_FILES=$(subst .adoc,-print.pdf,$(MANUAL_ADOC_FILES))

View file

@ -3,6 +3,7 @@
:toc: macro :toc: macro
:toc-title: :toc-title:
:showtitle!: :showtitle!:
:build-version: (unknown)
// This is the title page; it looks weird in Asciidoc but makes more // This is the title page; it looks weird in Asciidoc but makes more
// sense in the PDF output. // sense in the PDF output.
@ -30,6 +31,8 @@ This manual is licensed under the 3-clause BSD license.
This is the English version of the Freedoom manual. Translations into other This is the English version of the Freedoom manual. Translations into other
languages can be found on the Freedoom website. languages can be found on the Freedoom website.
This is version {build-version} of the manual.
<<< <<<
// Note this is not a heading, so the ToC does not appear in itself. // Note this is not a heading, so the ToC does not appear in itself.

View file

@ -3,6 +3,7 @@
:toc: macro :toc: macro
:toc-title: :toc-title:
:showtitle!: :showtitle!:
:build-version: (desconocida)
// This is the title page; it looks weird in Asciidoc but makes more // This is the title page; it looks weird in Asciidoc but makes more
// sense in the PDF output. // sense in the PDF output.
@ -26,6 +27,8 @@ image::images/freedoom-logo.svg[Freedoom Logo,align="center",width=500,pdfwidth=
Copyright © 2001-2025 Contributors to the Freedoom project. Copyright © 2001-2025 Contributors to the Freedoom project.
Este manual está licenciado bajo la licencia BSD de 3 cláusulas. Este manual está licenciado bajo la licencia BSD de 3 cláusulas.
Esta es la versión {build-version} del manual.
<<< <<<
[big]*Sumario* [big]*Sumario*

View file

@ -3,6 +3,7 @@
:toc: macro :toc: macro
:toc-title: :toc-title:
:showtitle!: :showtitle!:
:build-version: (inconnue)
// This is the title page; it looks weird in Asciidoc but makes more // This is the title page; it looks weird in Asciidoc but makes more
// sense in the PDF output. // sense in the PDF output.
@ -23,6 +24,8 @@ image::images/freedoom-logo.svg[Freedoom Logo,align="center",width=500,pdfwidth=
Copyright © 2001-2025 Contributors to the Freedoom project. Copyright © 2001-2025 Contributors to the Freedoom project.
Ce manuel est sous licence BSD-3-Clause. Ce manuel est sous licence BSD-3-Clause.
Il s'agit de la version {build-version} du manuel.
<<< <<<
[big]*Sommaire* [big]*Sommaire*