diff --git a/.github/workflows/adoc_build.yml b/.github/workflows/adoc_build.yml
index b1273f77..8175a2b3 100644
--- a/.github/workflows/adoc_build.yml
+++ b/.github/workflows/adoc_build.yml
@@ -50,14 +50,16 @@ jobs:
- name: Set "final" tag and date-time formatting
if: github.event_name == 'release'
run: |
- echo "FINAL_TAG=-a final" >> "$GITHUB_ENV"; echo "DATE_FMT=+%d %B, %Y" >> "$GITHUB_ENV"
+ echo "DATE_FMT=+%d %B, %Y" >> "$GITHUB_ENV"
+ echo "DOI=$(tail -n 1: doi-catalog.txt |cut -d : -f 2)" >> $GITHUB_ENV
+ echo "FINAL_TAG=-a final" >> "$GITHUB_ENV";
# Build cf-conventions.html using the Analog-inc asciidoctor-action
- name: Build cf-conventions.html
uses: Analog-inc/asciidoctor-action@v1.2
with:
- shellcommand: 'asciidoctor --verbose ${FINAL_TAG} -a docprodtime=$(date -u ${DATE_FMT}) cf-conventions.adoc -D conventions_build; cp -r images conventions_build'
- # Patch the cfconventions.org link
- - run: sed -E -i 's+(See )(https://cfconventions.org)( for further information.)+\1\2\3+' ./conventions_build/cf-conventions.html
+ shellcommand: 'asciidoctor --verbose ${FINAL_TAG} -a doi=${DOI} -a docprodtime=$(date -u ${DATE_FMT}) cf-conventions.adoc -D conventions_build; cp -r images conventions_build'
+ # Remove the empty "Colophon" title and toc entry from the html version
+ - run: sed -i '/> {N;N;d;}' ./conventions_build/cf-conventions.html
# Build cf-conventions.pdf using the Analog-inc asciidoctor-action
- name: Build cf-conventions.pdf
uses: Analog-inc/asciidoctor-action@v1.2
diff --git a/cf-conventions.adoc b/cf-conventions.adoc
index 01e32322..f8b1ff97 100644
--- a/cf-conventions.adoc
+++ b/cf-conventions.adoc
@@ -1,13 +1,38 @@
include::version.adoc[]
= NetCDF Climate and Forecast (CF) Metadata Conventions
Brian{nbsp}Eaton; Jonathan{nbsp}Gregory; Bob{nbsp}Drach; Karl{nbsp}Taylor; Steve{nbsp}Hankin; Jon{nbsp}Blower; John{nbsp}Caron; Rich{nbsp}Signell; Phil{nbsp}Bentley; Greg{nbsp}Rappa; Heinke{nbsp}Höck; Alison{nbsp}Pamment; Martin{nbsp}Juckes; Martin{nbsp}Raspaud; Randy{nbsp}Horne; Timothy{nbsp}Whiteaker; David{nbsp}Blodgett; Charlie{nbsp}Zender; Daniel{nbsp}Lee; David{nbsp}Hassell; Alan{nbsp}D.{nbsp}Snow; Tobias{nbsp}Kölling; Dave{nbsp}Allured; Aleksandar{nbsp}Jelenak; Anders{nbsp}Meier{nbsp}Soerensen; Lucile{nbsp}Gaultier; Sylvain{nbsp}Herlédan; Fernando{nbsp}Manzano; Lars{nbsp}Bärring; Christopher{nbsp}Barker; Sadie{nbsp}Bartholomew
-Version{nbsp}{current-version},{nbsp}{nbsp}{docprodtime}: See{nbsp}https://cfconventions.org{nbsp}for{nbsp}further{nbsp}information.
+Version{nbsp}{current-version},{nbsp}{nbsp}{docprodtime}
:doctype: book
:pdf-folio-placement: physical
:sectanchors:
:toc: macro
:toclevels: 3
+[colophon:notitle]
+== {nbsp}
+Climate and Forecast Conventions version {current-version} {doi-text}
+
+image::images/cc-zero.svg[, 10%]
+This document is dedicated to the public domain following the link:https://creativecommons.org/publicdomain/zero/1.0/[Creative Commons CC0] Deed.
+
+The Climate and Forecasting Conventions website https://cfconventions.org/ contains additional resources and provides further information.
+ifdef::final[]
+ +
+ +
+ _Use the following reference to cite this version of the document:_ +
+Eaton B., Gregory J., Drach B., Taylor K., Hankin S., Blower J., Caron J., Signell R., Bentley P.,
+Rappa G., Höck H., Pamment A., Juckes M., Raspaud M., Horne R., Whiteaker T., Blodgett D., Zender C.,
+Lee D., Hassell D., Snow A. D., Kölling T., Allured D., Jelenak A., Soerensen A. M., Gaultier L.,
+Herlédan S., Manzano F., Bärring L., Barker C., Bartholomew S., 2023:
+NetCDF Climate and Forecast (CF) Metadata Conventions version {current-version}.
+XXXX XXXX XXXX XXXX XXXX XXXX +
+ +
+(The author list may be shortened and replaced by "_et al._" as appropriate.)
+endif::[]
+
+'''
+
+
toc::[]
:numbered!:
diff --git a/default-theme-CF-version.yml b/default-theme-CF-version.yml
index 6983f21b..88d7d913 100644
--- a/default-theme-CF-version.yml
+++ b/default-theme-CF-version.yml
@@ -21,6 +21,8 @@ page:
margin_inner: 0.75in
margin_outer: 0.59in
size: A4
+ numbering:
+ start-at: after-toc
base:
text_align: justify
font_color: 333333
diff --git a/doi-catalog.txt b/doi-catalog.txt
new file mode 100644
index 00000000..f4a44d28
--- /dev/null
+++ b/doi-catalog.txt
@@ -0,0 +1,7 @@
+# No DOIs before version 1.12
+# Format: last line MUST be the version to be released
+# and MUST provide the correct doi-string starting with 10
+# MUST NOT be any space before or after the colon
+# version:full doi-string
+1.11:
+1.12:TEST-DOI
diff --git a/images/cc-zero.svg b/images/cc-zero.svg
new file mode 100644
index 00000000..195592b7
--- /dev/null
+++ b/images/cc-zero.svg
@@ -0,0 +1,98 @@
+
+
+
+
diff --git a/version.adoc b/version.adoc
index be4d63de..49a834bf 100644
--- a/version.adoc
+++ b/version.adoc
@@ -12,8 +12,10 @@ or with the commandline switch `-a final`.
ifdef::final[]
:current-version: {version}
:current-version-as-attribute: {version}
+:doi-text: {nbsp}{nbsp}{nbsp}DOI: link:https://doi.org/{doi}[{doi}]
endif::[]
ifndef::final[]
:current-version: {version} draft
:current-version-as-attribute: {version}-draft
+:doi-text: has not yet a DOI assigned.
endif::[]