README.md

+# astron-texmf
+
+LaTeX class that generates documents that look vaguely like ASTRON “standard” MS Word documents.
+Comes bundled with a similar template for [ESCAPE Project](https://www.projectescape.eu/) documents.
+
+Provides a bunch of niceties, including Git integration (automatically stamp documents with version numbers, generate change records based on tags, etc) and an extensive (does this mean unwieldy?) set of acronyms.
+
+See the example directory in this repository for a brief example or refer to e.g. [ESCAPE D5.4](https://git.astron.nl/astron-sdc/escape-wp5/docs/escape-d5.4) for a more comprehensive demo.

bin/gen_change_record.py

+#!/usr/bin/env python3
+
+# Generate a change record for inclusion in an astron-texmf style LaTeX
+# document.
+# Assumes that all the relevant versions in the document have tags which match
+# \d+\.\d+.
+import subprocess
+from dataclasses import dataclass
+from datetime import datetime
+from io import StringIO
+from re import match
+
+
+@dataclass
+class Tag(object):
+    """Represent a git tag"""
+
+    name: str
+    message: str
+
+    @property
+    def rev(self):
+        return subprocess.check_output(["git", "rev-parse", self.name]).decode().strip()
+
+    @property
+    def date(self):
+        for line in (
+            subprocess.check_output(["git", "cat-file", "-p", self.rev])
+            .decode()
+            .strip()
+            .split("\n")
+        ):
+            if line.startswith("tagger"):
+                return datetime.fromtimestamp(int(line.split()[-2]))
+
+
+def escape_latex(text):
+    return text.strip().replace("#", r"\#").replace("&", r"\&")
+
+
+def get_all_tags():
+    try:
+        tags = [
+            Tag(*tag.split(None, 1))
+            for tag in subprocess.check_output(["git", "tag", "-n99", "--merged"])
+            .decode()
+            .strip()
+            .split("\n")
+            if tag
+        ]
+    except:
+        tags = []
+    return tags
+
+
+def generate_change_record(tags):
+    output = StringIO()
+    if tags:
+        output.write("\setDocChangeRecord{\n")
+        for tag in sorted(tags, key=lambda x: x.name, reverse=True):
+            if match(r"\d+\.\d+", tag.name):
+                output.write(f"    \\addChangeRecord{{{escape_latex(tag.name)}}}")
+                output.write(f"{{{tag.date.strftime('%Y-%m-%d')}}}")
+                output.write(f"{{{escape_latex(tag.message)}}}\n")
+        output.write("}")
+    return output.getvalue()
+
+
+if __name__ == "__main__":
+    print(generate_change_record(get_all_tags()))

example/.gitignore

@@ -11,3 +11,4 @@ example.out
 example.pdf
 example.run.xml
 meta.tex
+changes.tex

example/Makefile

 DOCNAME=example
 export TEXMFHOME ?= ../texmf
 
-GITVERSION := $(shell git log -1 --date=short --pretty=%h)
-GITDATE := $(shell git log -1 --date=short --pretty=%ad)
-GITSTATUS := $(shell git status --porcelain)
-ifneq "$(GITSTATUS)" ""
-	GITDIRTY = -dirty
-endif
-
 $(DOCNAME).pdf: $(DOCNAME).tex meta.tex
 	xelatex $(DOCNAME)
 	makeglossaries $(DOCNAME)
@@ -15,10 +8,5 @@ $(DOCNAME).pdf: $(DOCNAME).tex meta.tex
 	xelatex $(DOCNAME)
 	xelatex $(DOCNAME)
 
-.FORCE:
-
-meta.tex: Makefile .FORCE
-	rm -f $@
-	printf "%s\n" "% GENERATED FILE -- edit this in the Makefile" >>$@
-	printf "%s\n" "\newcommand{\vcsRevision}{$(GITVERSION)$(GITDIRTY)}" >>$@
-	printf "%s\n" "\newcommand{\vcsDate}{$(GITDATE)}" >>$@
+include $(TEXMFHOME)/../make/vcs-meta.make
+include $(TEXMFHOME)/../make/changes.make

example/example.tex

@@ -5,7 +5,6 @@
 \setDocNumber{1}
 \setDocRevision{\vcsRevision}
 \setDocDate{\vcsDate}
-\setDocClass{Limited}
 \setDocProgram{SDC}
 
 \setDocChangeRecord{
@@ -32,9 +31,6 @@
   \addPerson{A person}{An institute}{A date}
 }
 
-\input{astron-abbreviations}
-\makeglossaries
-
 \begin{document}
 \maketitle
 
@@ -44,7 +40,7 @@
 \printbibliography
 \clearpage
 
-Check that abbreviations are working properly: \gls{SDC}, \gls{SKA}.
+Check that abbreviations are working properly: \gls{SDC}, \gls{ESCAPE}.
 
 Check that citations are working properly: \autocite{SDC-001}, \autocite{SDC-002}.
 

make/changes.make

+.FORCE:
+
+changes.tex: Makefile .FORCE
+	rm -f $@
+	printf "%s\n" "% GENERATED FILE -- do not edit" >>$@
+	$(TEXMFHOME)/../bin/gen_change_record.py >>$@

make/vcs-meta.make

+GITVERSION := $(shell git describe --always --dirty)
+GITDATE := $(shell git log -1 --date=short --pretty=%ad)
+GITFIRSTYEAR := $(shell git log --reverse --date=short --pretty=%ad | head -1 | cut -d- -f1)
+GITLASTYEAR := $(shell git log -1 --date=short --pretty=%ad | cut -d- -f1)
+
+.FORCE:
+
+meta.tex: Makefile .FORCE
+	rm -f $@
+	printf "%s\n" "% GENERATED FILE -- do not edit" >>$@
+	printf "%s\n" "\newcommand{\vcsRevision}{$(GITVERSION)}" >>$@
+	printf "%s\n" "\newcommand{\vcsDate}{$(GITDATE)}" >>$@
+	printf "%s\n" "\newcommand{\vcsFirstYear}{$(GITFIRSTYEAR)}" >>$@
+	printf "%s\n" "\newcommand{\vcsLastYear}{$(GITLASTYEAR)}" >>$@
+	printf "%s\n" "\newcommand{\docHandle}{$(DOCHANDLE)}" >>$@

texmf/bibtex/bib/apertif.bib

+@INPROCEEDINGS{2018wtfa.confE..16O,
+       author = {{Oosterloo}, T. and {van Leeuwen}, J. and {Van Cappellen}, W. and {Kruithof}, G. and {Jackson}, C.},
+        title = "{Apertif; the next stage}",
+    booktitle = {Westerbork Telescope 50th Anniversary},
+         year = 2018,
+       volume = {361},
+        month = sep,
+          eid = {16},
+        pages = {16},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2018wtfa.confE..16O},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}

texmf/bibtex/bib/astron.bib

@@ -7,6 +7,30 @@
     year = 2020,
     month = 1,
     day = 30,
-    version = 1,
+    version = "1",
     url = {https://edu.nl/afu73},
 }
+
+@Misc{2019-FuSE-Proposal,
+    author = "{FuSE} Team",
+    title = "{FuSE: Fundamental Sciences E-infrastructre}",
+    year = 2019,
+    howpublished = "{Grant application, National Roadmap for Large-Scale Research Infrastructure 2019--2020}",
+}
+
+@Misc{dijkema_tammo_jan_2018_3479829,
+  author       = {Dijkema, Tammo Jan and
+                  Grange, Yan and
+                  Gunst, André and
+                  Halfwerk, Ronald and
+                  Jürges, Thomas and
+                  Nijboer, Ronald and
+                  Beukema, Ruud},
+  title        = {ASTRON Open Source Policy},
+  month        = oct,
+  year         = 2018,
+  publisher    = {Zenodo},
+  version      = {1.3},
+  doi          = {10.5281/zenodo.3479829},
+  url          = {https://doi.org/10.5281/zenodo.3479829}
+}

texmf/bibtex/bib/escape.bib

+% General ASTRON documents
+
+@Misc{ESCAPE-GA,
+    title = "Grant Agreement Number 824064 --- {ESCAPE}",
+    institution = "European Commission Directorate-General Research \& Innovation",
+    year = 2018,
+    month = 11,
+    day = 6
+}
+
+@TechReport{ESCAPE-D5.1,
+    author = {Meyer-Zhao (ASTRON), Zheng and
+              Grange (ASTRON), Yan and
+              van Haarlem (ASTRON), Michiel and
+              Groep (Nikhef), David and
+              Bolton (SKAO), Rosie and
+              Dickinson (Open University), Hugh and
+              Sánchez-Expósito (IAA-CSIC), Susana and
+              Ramón Rodón (IAA-CSIC), José},
+    title = "D5.1: Preliminary Report on Requirements for {ESFRI} Science Analysis Use Cases",
+    institution = "{ESCAPE}",
+    year = 2019,
+    month = 7,
+    day = 30,
+    version = "1.1",
+    url = {https://projectescape.eu/deliverables-and-reports/d51-preliminary-report-requirements-esfri-science-analysis-use-cases}
+}
+
+@TechReport{ESCAPE-D5.2,
+    author = {Meyer-Zhao (ASTRON), Zheng and
+              Grange (ASTRON), Yan and
+              van Haarlem (ASTRON), Michiel and
+              Szomoru (Nikhef), Arpad and
+              Voutsinas (UEDIN), Stelios and
+              Taffoni (INAF), Giuliano and
+              Sánchez-Expósito (IAA-CSIC), Susana and
+              Chanial (EGO), Pierre and
+              Dickinson (Open University), Hugh and
+              Matthias (CTAO), Füßling},
+    title = "D5.2: Detailed Project Plan",
+    institution = "{ESCAPE}",
+    year = 2019,
+    month = 10,
+    day = 31,
+    version = "1.0",
+    url = {https://projectescape.eu/deliverables-and-reports/d52-detailed-project-plan}
+}
+
+@TechReport{ESCAPE-D5.3,
+    author = {Swinbank (ASTRON), John D. and
+             Bird (CNRS‐LAPP), Ian and
+             Dickinson (Open University), Hugh and
+             Garrido (IAA‐CSIC), Rafael and
+             Hughes (CTAO) Gareth, and
+             Ramón Rodón (IAA‐CSIC), José and
+             Sánchez Expósito (IAA‐CSIC), Susana and
+             Taffoni (INAF), Giuliano and
+             Verdes‐Montenegro (IAA‐CSIC), Lourdes and
+             Verkouter (JIVE), Harro and
+             Vermaas (ASTRON), Nico and
+             Voutsinas (U. Edinburgh), Stelios},
+    title = "D5.3: Performance Assessment of Initial Science Platform Prototype",
+    institution = "{ESCAPE}",
+    year = 2021,
+    month = 08,
+    day = 27,
+    version = "1.0",
+}
+
+@TechReport{2018-EC-FAIR,
+    author = {European Commission Expert Group on FAIR Data},
+    title = "Turning {FAIR} into Reality",
+    institution = "{E}uropean {C}ommission",
+    url = {https://op.europa.eu/s/pCqN}
+}
+
+@Software{vuillaume_thomas_2022_6826881,
+  author       = {Vuillaume, Thomas and
+                  Garcia, Enrique and
+                  Tacke, Christian and
+                  Gál, Tamás},
+  title        = {eossr},
+  month        = jul,
+  year         = 2022,
+  note         = {Release Notes:},
+  publisher    = {Zenodo},
+  version      = {v0.6.1},
+  doi          = {10.5281/zenodo.6826881},
+  url          = {https://doi.org/10.5281/zenodo.6826881}
+}
+
+@InProceedings{gammapy:2017,
+  author = {{Deil}, C. and {Zanin}, R. and {Lefaucheur}, J. and {Boisson}, C. and
+           {Khelifi}, B. and {Terrier}, R. and {Wood}, M. and {Mohrmann}, L. and
+           {Chakraborty}, N. and {Watson}, J. and {Lopez-Coto}, R. and
+           {Klepser}, S. and {Cerruti}, M. and {Lenain}, J.~P. and {Acero}, F. and
+           {Djannati-Ata{\"\i}}, A. and {Pita}, S. and {Bosnjak}, Z. and
+           {Trichard}, C. and {Vuillaume}, T. and {Donath}, A. and
+           {Consortium}, CTA and {King}, J. and {Jouvin}, L. and {Owen}, E. and
+           {Sipocz}, B. and {Lennarz}, D. and {Voruganti}, A. and
+           {Spir-Jacob}, M. and {Ruiz}, J. Enrique and {Arribas}, M. Paz},
+  title = "{Gammapy - A prototype for the CTA science tools}",
+  keywords = {Astrophysics - Instrumentation and Methods for Astrophysics},
+  booktitle = {35th International Cosmic Ray Conference (ICRC2017)},
+  year = 2017,
+  series = {International Cosmic Ray Conference},
+  volume = {301},
+  month = jan,
+  eid = {766},
+  pages = {766},
+  archivePrefix = {arXiv},
+  eprint = {1709.01751},
+  primaryClass = {astro-ph.IM},
+  adsurl = {https://ui.adsabs.harvard.edu/abs/2017ICRC...35..766D},
+  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@ARTICLE{2022A&A...660A..18N,
+       author = {{Nigro}, C. and {Sitarek}, J. and {Gliwny}, P. and {Sanchez}, D. and {Tramacere}, A. and {Craig}, M.},
+        title = "{agnpy: An open-source python package modelling the radiative processes of jetted active galactic nuclei}",
+      journal = {Astronomy \& Astrophysics},
+     keywords = {radiation mechanisms: general, radiation mechanisms: non-thermal, methods: numerical, galaxies: active, galaxies: jets, Astrophysics - Instrumentation and Methods for Astrophysics, Astrophysics - Astrophysics of Galaxies, Astrophysics - High Energy Astrophysical Phenomena},
+         year = 2022,
+        month = apr,
+       volume = {660},
+          eid = {A18},
+        pages = {A18},
+          doi = {10.1051/0004-6361/202142000},
+archivePrefix = {arXiv},
+       eprint = {2112.14573},
+ primaryClass = {astro-ph.IM},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2022A&A...660A..18N},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@ARTICLE{2022A&C....4100648R,
+       author = {{Russo}, S.~A. and {Bertocco}, S. and {Gheller}, C. and {Taffoni}, G.},
+        title = "{Rosetta: A container-centric science platform for resource-intensive, interactive data analysis}",
+      journal = {Astronomy and Computing},
+     keywords = {Science platforms, Data analysis, Reproducibility, Software containers, Big data, HPC, Astrophysics - Instrumentation and Methods for Astrophysics, Computer Science - Distributed, Parallel, and Cluster Computing},
+         year = 2022,
+        month = oct,
+       volume = {41},
+          eid = {100648},
+        pages = {100648},
+          doi = {10.1016/j.ascom.2022.100648},
+archivePrefix = {arXiv},
+       eprint = {2209.02003},
+ primaryClass = {astro-ph.IM},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2022A&C....4100648R},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}

texmf/bibtex/bib/ivoa.bib

 % IVOA documents
 
+@Misc{2010ivoa.rept.1123A,
+       author = {{Arviset}, Christophe and {Gaudet}, Severin and {IVOA Technical Coordination Group}},
+        title = "{IVOA Architecture Version 1.0}",
+ howpublished = {IVOA Note},
+         year = 2010,
+        month = nov,
+        pages = {1123},
+          doi = {10.5479/ADS/bib/2010ivoa.rept.1123A},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2010ivoa.rept.1123A},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@Misc{2012ivoa.spec.1104T,
+       author = {{Taylor}, M. and {Boch}, T. and {Fitzpatrick}, M. and {Allan}, A. and {Fay}, J. and {Paioro}, L. and {Taylor}, J. and {Tody}, D.},
+        title = "{Simple Application Messaging Protocol Version 1.3}",
+ howpublished = {IVOA Recommendation},
+         year = 2012,
+        month = apr,
+        pages = {1104},
+          doi = {10.5479/ADS/bib/2012ivoa.spec.1104T},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2012ivoa.spec.1104T},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
 @Misc{2017ivoa.spec.0509L,
-    author = {{Louys}, Mireille and {Tody}, Doug and {Dowler}, Patrick and {Durand}, Daniel and {Michel}, Laurent and {Bonnarel}, Francos and {Micol}, Alberto and {IVOA DataModel Working Group}},
-    title = "{Observation Data Model Core Components, its Implementation in the Table Access Protocol Version 1.1}",
-    howpublished = {IVOA Recommendation},
-    year = 2017,
-    month = may,
-    day  = 9,
-    doi = {10.5479/ADS/bib/2017ivoa.spec.0509L},
-    adsurl = {https://ui.adsabs.harvard.edu/abs/2017ivoa.spec.0509L},
-    adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+       author = {{Louys}, Mireille and {Tody}, Doug and {Dowler}, Patrick and {Durand}, Daniel and {Michel}, Laurent and {Bonnarel}, Francos and {Micol}, Alberto and {IVOA DataModel Working Group}},
+        title = "{Observation Data Model Core Components, its Implementation in the Table Access Protocol Version 1.1}",
+ howpublished = {IVOA Recommendation},
+         year = 2017,
+        month = may,
+         day  = 9,
+          doi = {10.5479/ADS/bib/2017ivoa.spec.0509L},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2017ivoa.spec.0509L},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@Misc{2011ivoa.spec.0711S,
+       author = {{Seaman}, Rob and {Williams}, Roy and {Allan}, Alasdair and {Barthelmy}, Scott and {Bloom}, Joshua and {Brewer}, John and {Denny}, Robert and {Fitzpatrick}, Mike and {Graham}, Matthew and {Gray}, Norman and {Hessman}, Frederic and {Marka}, Szabolcs and {Rots}, Arnold and {Vestrand}, Tom and {Wozniak}, Przemyslaw},
+        title = "{Sky Event Reporting Metadata Version 2.0}",
+     keywords = {Astrophysics - Instrumentation and Methods for Astrophysics},
+ howpublished = {IVOA Recommendation},
+         year = 2011,
+        month = jul,
+        pages = {711},
+          doi = {10.5479/ADS/bib/2011ivoa.spec.0711S},
+archivePrefix = {arXiv},
+       eprint = {1110.0523},
+ primaryClass = {astro-ph.IM},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2011ivoa.spec.0711S},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@Misc{2019ivoa.spec.1021O,
+       author = {{Ochsenbein}, Francois and {Taylor}, Mark and {Donaldson}, Tom and {Williams}, Roy and {Davenhall}, Clive and {Demleitner}, Markus and {Durand}, Daniel and {Fernique}, Pierre and {Giaretta}, David and {Hanisch}, Robert and {McGlynn}, Tom and {Szalay}, Alex and {Wicenec}, Andreas},
+        title = "{VOTable Format Definition Version 1.4}",
+ howpublished = {IVOA Recommendation},
+         year = 2019,
+        month = oct,
+        pages = {1021},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2019ivoa.spec.1021O},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@Misc{2016ivoa.spec.1024H,
+       author = {{Harrison}, P.~A. and {Rixon}, G.},
+        title = "{Universal Worker Service Pattern Version 1.1}",
+ howpublished = {IVOA Recommendation},
+         year = 2016,
+        month = oct,
+        pages = {1024},
+          doi = {10.5479/ADS/bib/2016ivoa.spec.1024H},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2016ivoa.spec.1024H},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@Misc{2021ivoa.rept.ExecPlanner,
+       author = {{Morris}, Dave and {Bertocco}, Sara},
+        title = "{IVOA Execution Planner - design outline}",
+ howpublished = {IVOA Note},
+         year = 2021,
+        month = oct,
+        pages = {1123},
 }

texmf/bibtex/bib/lofar.bib

@@ -10,3 +10,109 @@
     version = "1.2",
     url = {https://edu.nl/xfa7k},
 }
+
+@Article{2022A&A...659A...1S,
+       author = {{Shimwell}, T.~W. and {Hardcastle}, M.~J. and {Tasse}, C. and {Best}, P.~N. and {R{\"o}ttgering}, H.~J.~A. and {Williams}, W.~L. and {Botteon}, A. and {Drabent}, A. and {Mechev}, A. and {Shulevski}, A. and {van Weeren}, R.~J. and {Bester}, L. and {Br{\"u}ggen}, M. and {Brunetti}, G. and {Callingham}, J.~R. and {Chy{\.z}y}, K.~T. and {Conway}, J.~E. and {Dijkema}, T.~J. and {Duncan}, K. and {de Gasperin}, F. and {Hale}, C.~L. and {Haverkorn}, M. and {Hugo}, B. and {Jackson}, N. and {Mevius}, M. and {Miley}, G.~K. and {Morabito}, L.~K. and {Morganti}, R. and {Offringa}, A. and {Oonk}, J.~B.~R. and {Rafferty}, D. and {Sabater}, J. and {Smith}, D.~J.~B. and {Schwarz}, D.~J. and {Smirnov}, O. and {O'Sullivan}, S.~P. and {Vedantham}, H. and {White}, G.~J. and {Albert}, J.~G. and {Alegre}, L. and {Asabere}, B. and {Bacon}, D.~J. and {Bonafede}, A. and {Bonnassieux}, E. and {Brienza}, M. and {Bilicki}, M. and {Bonato}, M. and {Calistro Rivera}, G. and {Cassano}, R. and {Cochrane}, R. and {Croston}, J.~H. and {Cuciti}, V. and {Dallacasa}, D. and {Danezi}, A. and {Dettmar}, R.~J. and {Di Gennaro}, G. and {Edler}, H.~W. and {En{\ss}lin}, T.~A. and {Emig}, K.~L. and {Franzen}, T.~M.~O. and {Garc{\'\i}a-Vergara}, C. and {Grange}, Y.~G. and {G{\"u}rkan}, G. and {Hajduk}, M. and {Heald}, G. and {Heesen}, V. and {Hoang}, D.~N. and {Hoeft}, M. and {Horellou}, C. and {Iacobelli}, M. and {Jamrozy}, M. and {Jeli{\'c}}, V. and {Kondapally}, R. and {Kukreti}, P. and {Kunert-Bajraszewska}, M. and {Magliocchetti}, M. and {Mahatma}, V. and {Ma{\l}ek}, K. and {Mandal}, S. and {Massaro}, F. and {Meyer-Zhao}, Z. and {Mingo}, B. and {Mostert}, R.~I.~J. and {Nair}, D.~G. and {Nakoneczny}, S.~J. and {Nikiel-Wroczy{\'n}ski}, B. and {Orr{\'u}}, E. and {Pajdosz-{\'S}mierciak}, U. and {Pasini}, T. and {Prandoni}, I. and {van Piggelen}, H.~E. and {Rajpurohit}, K. and {Retana-Montenegro}, E. and {Riseley}, C.~J. and {Rowlinson}, A. and {Saxena}, A. and {Schrijvers}, C. and {Sweijen}, F. and {Siewert}, T.~M. and {Timmerman}, R. and {Vaccari}, M. and {Vink}, J. and {West}, J.~L. and {Wo{\l}owska}, A. and {Zhang}, X. and {Zheng}, J.},
+        title = "{The LOFAR Two-metre Sky Survey. V. Second data release}",
+      journal = {Astronomy \& Astrophysics},
+     keywords = {surveys, catalogs, radio continuum: general, techniques: image processing, Astrophysics - Astrophysics of Galaxies, Astrophysics - Cosmology and Nongalactic Astrophysics, Astrophysics - High Energy Astrophysical Phenomena, Astrophysics - Instrumentation and Methods for Astrophysics},
+         year = 2022,
+        month = mar,
+       volume = {659},
+          eid = {A1},
+          doi = {10.1051/0004-6361/202142484},
+archivePrefix = {arXiv},
+       eprint = {2202.11733},
+ primaryClass = {astro-ph.GA},
+}
+
+@TechReport{2019:vanCapellen:LOFAR2MasterPlan,
+    author = "{van~Capellen}, W.A.",
+    title = "{LOFAR 2.0 Master Plan}",
+    institution = "ASTRON",
+    year = 2019,
+    month = 1,
+    day = 10,
+    version = "1.0"
+}
+
+@Misc{2021:LOFAR2WhitePaper,
+    title = "{LOFAR2.0: A premier low-frequency radio telescope for the 2020s}",
+    year = 2021,
+    month = 10,
+    day = 6,
+    version = "Draft"
+}
+
+@Article{2021A&A...648A...1T,
+       author = {{Tasse}, C. and {Shimwell}, T. and {Hardcastle}, M.~J. and {O'Sullivan}, S.~P. and {van Weeren}, R. and {Best}, P.~N. and {Bester}, L. and {Hugo}, B. and {Smirnov}, O. and {Sabater}, J. and {Calistro-Rivera}, G. and {de Gasperin}, F. and {Morabito}, L.~K. and {R{\"o}ttgering}, H. and {Williams}, W.~L. and {Bonato}, M. and {Bondi}, M. and {Botteon}, A. and {Br{\"u}ggen}, M. and {Brunetti}, G. and {Chy{\.z}y}, K.~T. and {Garrett}, M.~A. and {G{\"u}rkan}, G. and {Jarvis}, M.~J. and {Kondapally}, R. and {Mandal}, S. and {Prandoni}, I. and {Repetti}, A. and {Retana-Montenegro}, E. and {Schwarz}, D.~J. and {Shulevski}, A. and {Wiaux}, Y.},
+        title = "{The LOFAR Two-meter Sky Survey: Deep Fields Data Release 1. I. Direction-dependent calibration and imaging}",
+      journal = {Astronomy \& Astrophysics},
+     keywords = {techniques: interferometric, techniques: image processing, surveys, galaxies: active, galaxies: starburst, radio continuum: galaxies, Astrophysics - Instrumentation and Methods for Astrophysics},
+         year = 2021,
+        month = apr,
+       volume = {648},
+          eid = {A1},
+        pages = {A1},
+          doi = {10.1051/0004-6361/202038804},
+archivePrefix = {arXiv},
+       eprint = {2011.08328},
+ primaryClass = {astro-ph.IM},
+}
+
+@Article{2022NatAs...6..350S,
+       author = {{Sweijen}, F. and {van Weeren}, R.~J. and {R{\"o}ttgering}, H.~J.~A. and {Morabito}, L.~K. and {Jackson}, N. and {Offringa}, A.~R. and {van der Tol}, S. and {Veenboer}, B. and {Oonk}, J.~B.~R. and {Best}, P.~N. and {Bondi}, M. and {Shimwell}, T.~W. and {Tasse}, C. and {Thomson}, A.~P.},
+        title = "{Deep sub-arcsecond wide-field imaging of the Lockman Hole field at 144 MHz}",
+      journal = {Nature Astronomy},
+     keywords = {Astrophysics - Instrumentation and Methods for Astrophysics, Astrophysics - Astrophysics of Galaxies},
+         year = 2022,
+        month = jan,
+       volume = {6},
+        pages = {350-356},
+          doi = {10.1038/s41550-021-01573-z},
+archivePrefix = {arXiv},
+       eprint = {2202.01608},
+ primaryClass = {astro-ph.IM},
+}
+
+@ARTICLE{2015A&C....11...25S,
+       author = {{Swinbank}, John D. and {Staley}, Tim D. and {Molenaar}, Gijs J. and {Rol}, Evert and {Rowlinson}, Antonia and {Scheers}, Bart and {Spreeuw}, Hanno and {Bell}, Martin E. and {Broderick}, Jess W. and {Carbone}, Dario and {Garsden}, Hugh and {van der Horst}, Alexander J. and {Law}, Casey J. and {Wise}, Michael and {Breton}, Rene P. and {Cendes}, Yvette and {Corbel}, St{\'e}phane and {Eisl{\"o}ffel}, Jochen and {Falcke}, Heino and {Fender}, Rob and {Grie{\ss}meier}, Jean-Mathias and {Hessels}, Jason W.~T. and {Stappers}, Benjamin W. and {Stewart}, Adam J. and {Wijers}, Ralph A.~M.~J. and {Wijnands}, Rudy and {Zarka}, Philippe},
+        title = "{The LOFAR Transients Pipeline}",
+      journal = {Astronomy and Computing},
+     keywords = {Astronomical transients, Time domain astrophysics, Techniques: image processing, Methods: data analysis, Astronomical databases, Astrophysics - Instrumentation and Methods for Astrophysics},
+         year = 2015,
+        month = jun,
+       volume = {11},
+        pages = {25--48},
+          doi = {10.1016/j.ascom.2015.03.002},
+archivePrefix = {arXiv},
+       eprint = {1503.01526},
+ primaryClass = {astro-ph.IM},
+}
+
+@ARTICLE{2016A&A...585A.128K,
+       author = {{Kondratiev}, V.~I. and {Verbiest}, J.~P.~W. and {Hessels}, J.~W.~T. and {Bilous}, A.~V. and {Stappers}, B.~W. and {Kramer}, M. and {Keane}, E.~F. and {Noutsos}, A. and {Os{\l}owski}, S. and {Breton}, R.~P. and {Hassall}, T.~E. and {Alexov}, A. and {Cooper}, S. and {Falcke}, H. and {Grie{\ss}meier}, J. -M. and {Karastergiou}, A. and {Kuniyoshi}, M. and {Pilia}, M. and {Sobey}, C. and {ter Veen}, S. and {van Leeuwen}, J. and {Weltevrede}, P. and {Bell}, M.~E. and {Broderick}, J.~W. and {Corbel}, S. and {Eisl{\"o}ffel}, J. and {Markoff}, S. and {Rowlinson}, A. and {Swinbank}, J.~D. and {Wijers}, R.~A.~M.~J. and {Wijnands}, R. and {Zarka}, P.},
+        title = "{A LOFAR census of millisecond pulsars}",
+      journal = {Astronomy and Astrophysics},
+     keywords = {telescopes, radio continuum: stars, stars: neutron, pulsars: general, Astrophysics - High Energy Astrophysical Phenomena, Astrophysics - Solar and Stellar Astrophysics},
+         year = 2016,
+        month = jan,
+       volume = {585},
+          eid = {A128},
+        pages = {A128},
+          doi = {10.1051/0004-6361/201527178},
+archivePrefix = {arXiv},
+       eprint = {1508.02948},
+ primaryClass = {astro-ph.HE},
+}
+
+@Misc{2023-LOFAR-ERIC-Data-Policy,
+    author = "Bonati, I. and Vermeulen, R.",
+    title = "Science data policy of {LOFAR} {ERIC}",
+    institution = "LOFAR ERIC",
+    year = 2023,
+    month = 4,
+    day = 25,
+    version = "1.0",
+    url = {https://www.lofar.eu/wp-content/uploads/2023/06/Data-policy_LOFAR-ERIC.pdf}
+}

texmf/bibtex/bib/sdc.bib

 % SDC-series documents
 
-@TechReport{2020-vanHaarlem-SDC-Vision,
+@Misc{2020-vanHaarlem-SDC-Vision,
     author = "Michiel {van Haarlem}",
     title = "{ASTRON}'s {S}cience {D}ata {C}entre Vision",
-    institution = "ASTRON",
+    organization = "ASTRON",
     year = 2020
 }
 
-@TechReport{SDC-001,
+@Misc{SDC-001,
     author = "John D. {Swinbank} and Jasper {Annyas}",
     title = "{SDC} Software Maintenance in an Agile Environment",
-    institution = "ASTRON",
+    organization = "ASTRON",
     year = 2020,
-    pubstate = "inpreparation",
     eprinttype = "sdc-handle",
-    eprint = "SDC-001"
+    eprint = "SDC-001",
+    version = "1.0"
 }
 
-@TechReport{SDC-002,
+@Misc{SDC-002,
     author = "John D. {Swinbank}",
-    title = "{ASTRON Science Data Centre} Program Management Plan",
-    institution = "ASTRON",
-    year = 2020,
-    pubstate = "inpreparation",
+    title = "SDC Program Organisation Framework",
+    organization = "ASTRON",
+    year = 2021,
+    version = "1.0",
     eprinttype = "sdc-handle",
-    eprint = "SDC-002"
+    eprint = "SDC-002",
 }
 
-@TechReport{SDC-003,
+@Misc{SDC-003,
     author = "John D. {Swinbank}",
     title = "{FuSE} Project Management Plan",
-    institution = "ASTRON",
+    organization = "ASTRON",
     year = 2020,
-    pubstate = "inpreparation",
+    version = "1.0",
     eprinttype = "sdc-handle",
     eprint = "SDC-003"
 }
 
-@TechReport{SDC-004,
-    author = "John D. {Swinbank}",
+@Misc{SDC-006,
+    author = "Roberto {Pizzo} and John D. {Swinbank}",
     title = "{ASTRON Science Data Centre} Vision",
-    institution = "ASTRON",
-    year = 2020,
+    organization = "ASTRON",
+    year = 2021,
+    version = "0.5",
+    pubstate = "inpreparation",
+    eprinttype = "sdc-handle",
+    eprint = "SDC-006"
+}
+
+@Misc{SDC-007,
+    author = "John D. {Swinbank}",
+    title = "{SDC} Software Release Plan",
+    organization = "ASTRON",
+    year = 2021,
+    pubstate = "inpreparation",
+    eprinttype = "sdc-handle",
+    eprint = "SDC-007"
+}
+
+@Misc{SDC-008,
+    author = "Hanno {Holties}",
+    title = "{SDC} System Architecture",
+    organization = "ASTRON",
+    year = 2021,
     pubstate = "inpreparation",
     eprinttype = "sdc-handle",
-    eprint = "SDC-004"
+    eprint = "SDC-008"
+}
+
+@Misc{SDC-009,
+    author = "Roberto {Pizzo} and John D. {Swinbank}",
+    title = "{SDC} Facility Governance",
+    organization = "ASTRON",
+    year = 2021,
+    version = "0.1",
+    pubstate = "inpreparation",
+    eprinttype = "sdc-handle",
+    eprint = "SDC-009"
+}
+
+@Misc{SDC-017,
+    author = "Roberto {Pizzo} and John D. {Swinbank}",
+    title = "{LOFAR2.0 Digital Services} Vision",
+    organization = "ASTRON",
+    year = 2023,
+    version = "2023-02-24",
+    eprinttype = "sdc-handle",
+    eprint = "SDC-017"
+}
+
+@Misc{SDC-022,
+    author = "Roberto {Pizzo} and John D. {Swinbank}",
+    title = "{LOFAR2.0 Digital Services}: Development Proposal to the ILT Board",
+    organization = "ASTRON",
+    year = 2023,
+    version = "2023-03-23",
+    eprinttype = "sdc-handle",
+    eprint = "SDC-022"
+}
+
+@Misc{SDC-029,
+    author = "Busy Week Participants",
+    title = "{LOFAR2.0 Data Processing \& Management Busy Week Report}",
+    organization = "LOFAR ERIC",
+    year = 2024,
+    version = "1.1",
+    eprinttype = "sdc-handle",
+    eprint = "SDC-029"
 }

texmf/bibtex/bib/sdco.bib

@@ -31,3 +31,11 @@
     year = 2020,
     url = {https://support.astron.nl/confluence/display/ROSDC/Federated+AAI}
 }
+
+@Misc{Pizzo:SDCOVision:2022,
+    author = {{Pizzo}, Roberto},
+    title = "{SDCO Vision}",
+    organization = "ASTRON",
+    year = 2020,
+    howpublished = "\url{https://support.astron.nl/confluence/pages/viewpage.action?pageId=73563778}"
+}

texmf/bibtex/bib/ska.bib

+% SDC-series documents
+
+@TechReport{2017-Chryostomou-SRC-background,
+    author = "Chrysostomou, {A.} and the SRCCG",
+    title = "SKA Regional Centres: Background and Framework",
+    organization = "SKAO",
+    year = 2017,
+    number = "SKA-TEL-SKO-0000706"
+}
+
+@TechReport{2021-Breen-SKAO-data-products,
+    author = "Breen, Shari and Bolton, Rosie and Chrysostomou, Antonio",
+    title = "SKAO Science Data Products: A Summary",
+    organization = "SKAO",
+    year = 2021,
+    number = "SKA-TEL-SKO-0001818"
+}
+
+@Misc{2020-SRC-White-Paper,
+    author = "Peter Quinn and Michiel {van Haarlem} and Tao An and Domingos Barbosa and Rosie Bolton and Antonio Chrysostomou and John Conway and Séverin Gaudet and Hans-Rainer Klöckner and Andrea Possenti and Simon Ratcliffe and Anna Scaife and Lourdes Verdes-Montenegro and Jean-Pierre Vilotte and Yogesh Wadadekar",
+    title = "{SKA Regional Centres: A White Paper}",
+    organization = "{SKA Regional Centre Steering Committee}",
+    month = may,
+    year = 2020,
+    version = "1.0",
+    howpublished = {\url{https://confluence.skatelescope.org/display/SRCSC/SRCSC+White+Paper+V1.0}}
+}
+
+@TechReport{2023:SkaPlatformVision,
+  author = {de Boer, J. and Cimpan, I. and Das, A. and Fabbro, S. and Grange, Y.G. and Hardcastle, M.J. and Sharma, R. and Skipper, C.J. and Swinbank, J.D. and Webster, B.},
+  title = "{SRC Science Analysis Platform Vision Document}",
+  organization = "{SKA Regional Centre Network}",
+  year = 2023
+}

texmf/ls-R

@@ -2,6 +2,7 @@
 ./:
 .:
 bibtex
+img
 ls-R
 tex
 
@@ -9,9 +10,16 @@ tex
 bib
 
 ./bibtex/bib:
+apertif.bib
 astron.bib
+escape.bib
+general.bib
+ivoa.bib
 lofar.bib
 sdc.bib
+sdco.bib
+
+./img:
 
 
 ./tex:
@@ -24,3 +32,8 @@ astron
 astron-abbreviations.tex
 astron-logo.pdf
 astron.cls
+common.tex
+escape-galaxy-mind.png
+escape-logo.png
+escape.cls
+flag-eu.png

texmf/tex/latex/astron/astron-abbreviations.tex

 \newacronym{AAAI}{AAAI}{Authentication, Authorization, and Accounting Infrastructure}
-\newacronym{ALTA}{ALTA}{Apertif Long Term Archive}
+\newacronym
+  [%
+    description={\acrshort{Apertif} Long Term Archive}%
+  ]{ALTA}{ALTA}{Apertif Long Term Archive}
+\newacronym{ADEX}{ADEX}{ASTRON Data Explorer}
+\newacronym{ANTARES}{ANTARES}{Astronomy with a Neutrino Telescope and Abyss environmental RESearch}
 \newacronym{AO}{A\&O}{Astronomy and Operations}
 \newacronym{API}{API}{Application Programming Interface}
 \newacronym{ASCL}{ASCL}{Astrophysics Source Code Library}
+\newacronym{Apertif}{Apertif}{APERture Tile In Focus}
+\newacronym{CASA}{CASA}{Common Astronomy Software Applications}
+\newacronym{CEP}{CEP}{CEntral Processing}
+\newacronym
+  [%
+    description={Connecting \acrshort{ESFRI} Projects to \acrshort{EOSC} through \acrshort{VO} framework}%
+  ]{CEVO}{CEVO}{Connecting ESFRI Projects to EOSC through VO framework}
 \newacronym{CPU}{CPU}{Central Processing Unit}
-\newacronym{CWL}{CW}{Common Workflow Language}
+\newacronym{CSP}{CSP}{Central Signal Processor}
+\newacronym{CWL}{CWL}{Common Workflow Language}
+\newacronym{CTA}{CTA}{Cherenkov Telescope Array}
+\newacronym{CTAO}{CTAO}{Cherenkov Telescope Array Observatory}
+\newacronym
+  [%
+    description={Data Infrastructure Capacity for \acrshort{EOSC}}%
+  ]{DICE}{DICE}{Data Infrastructure Capacity for EOSC}
+\newacronym{DIOS}{DIOS}{Data Infrastructure for Open Science}
+\newacronym{DLaaS}{DLaaS}{Data-Lake-as-a-Service}
 \newacronym{DOI}{DOI}{Digital Object Identifier}
-\newacronym{DUPLLO}{DUPLLO}{Digital Upgrade for Premier LOFAR Low-band Observing}
-\newacronym{EGI-ACE}{EGI-ACE}{EGI Advanced Computing for EOSC}
-\newacronym{EOSC}{EOSC}{European Open Science Cloud}
+\newacronym{DR2}{DR2}{Data Release 2}
+\newacronym
+  [%
+    description={Digital Upgrade for Premier \acrshort{LOFAR} Low-band Observing}%
+  ]{DUPLLO}{DUPLLO}{Digital Upgrade for Premier LOFAR Low-band Observing}
+\newacronym{ECO}{ECO}{Engagement and COmmunication}
+\newacronym{EC}{EC}{European Commission}
+\newacronym
+  [%
+    description={EGI Advanced Computing for \acrshort{EOSC}}%
+  ]{EGI-ACE}{EGI-ACE}{EGI Advanced Computing for EOSC}
+\newacronym{ERIC}{ERIC}{European Research Infrastructure Consortium}
+\newacronym
+  [%
+    prefixfirst={the\space}%
+  ]{EOSC}{EOSC}{European Open Science Cloud}
+\newacronym{EGO}{EGO}{European Gravitational Observatory}
 \newacronym{EPO}{EPO}{Education and Public Outreach}
-\newacronym{ESAP}{ESAP}{European Science Analysis Platform}
-\newacronym{ESCAPE}{ESCAPE}{European Science Cluster of Astronomy \& Particle physics ESFRI research infrastructures}
+\newacronym
+  [%
+    prefixfirst={the\space},%
+    description={\acrshort{ESFRI} Science Analysis Platform}%
+  ]{ESAP}{ESAP}{ESFRI Science Analysis Platform}
+\newacronym
+  [
+    description={European Science Cluster of Astronomy \& Particle physics \acrshort{ESFRI} research infrastructures}
+  ]{ESCAPE}{ESCAPE}{European Science Cluster of Astronomy \& Particle physics ESFRI research infrastructures}
 \newacronym{ESFRI}{ESFRI}{European Strategy Forum on Research Infrastructures}
+\newacronym{ESO}{ESO}{European Southern Observatory}
+\newacronym{EST}{EST}{European Solar Telescope}
+\newacronym
+  [%
+    description={European \acrshort{VLBI} Network}%
+  ]{EVN}{EVN}{European VLBI Network}
 \newacronym{FAIR}{FAIR}{Findable, Accessible, Interoperable, Reusable}
+\newacronym
+  [%
+    description={\acrshort{FAIR} for Research Software}%
+  ]{FAIR4RS}{FAIR4RS}{FAIR for Research Software}
+\newacronym{FAIR-ESFRI}{FAIR}{Facility for Antiproton and Ion Research}
 \newacronym{FPGA}{FPGA}{Field Programmable Gate Array}
 \newacronym{FTE}{FTE}{Full Time Equivalent}
+\newacronym{FTP}{FTP}{File Transfer Protocol}
 \newacronym{FuSE}{FuSE}{Fundamental Sciences E-infrastructure}
+\newacronym{FZJ}{FZJ}{Forschungszentrum Jülich}
+\newacronym{GB}{GB}{Gigabyte}
 \newacronym{GPU}{GPU}{Graphics Processing Unit}
+\newacronym{GUI}{GUI}{Graphical User Interface}
 \newacronym{HBA}{HBA}{High-Band Antenna}
+\newacronym
+  [%
+    description={High-Luminosity \acrshort{LHC}}%
+  ]{HL-LHC}{HL-LHC}{High-Luminosity LHC}
+\newacronym{HPC}{HPC}{High-Performance Computing}
+\newacronym{HTC}{HTC}{High-Throughput Computing}
+\newacronym{HTTP}{HTTP}{Hypertext Transfer Protocol}
+\newacronym{IAA-CSIC}{IAA-CSIC}{Instituto de Astrofísica de Andalucía, Consejo Superior de Investigaciones Científicas}
+\newacronym{IAM}{IAM}{Identity and Access Management}
 \newacronym{ICA}{ICA}{Internal Cooperation Agreement}
-\newacronym{ILT}{ILT}{International LOFAR Telescope}
+\newacronym{IDA}{IDA}{Interactive Data Analysis}
+\newacronym
+  [%
+    description={International \acrshort{LOFAR} Telescope}%
+  ]{ILT}{ILT}{International LOFAR Telescope}
+\newacronym{IDC}{IDC}{Instrument Development Committee}
+\newacronym
+  [%
+    description={International \acrshort{LOFAR} Two-metre Sky Survey}%
+  ]{ILoTSS}{ILoTSS}{International LOFAR Two-metre Sky Survey}
 \newacronym{IS}{I\&S}{Innovation and Systems}
 \newacronym{IVOA}{IVOA}{International Virtual Observatory Alliance}
+\newacronym
+  [%
+    description={Joint Institute for \acrshort{VLBI} \acrshort{ERIC}}%
+  ]{JIVE}{JIVE}{Joint Institute for VLBI ERIC}
+\newacronym{JSON}{JSON}{JavaScript Object Notation}
+\newacronym{KIS}{KIS}{Leibniz-Institute for Solar Physics}
 \newacronym{KSP}{KSP}{Key Science Project}
+\newacronym
+  [%
+    description={\acrshort{LOFAR}2.0 Digital Services}%
+  ]{L2DS}{L2DS}{LOFAR2.0 Digital Services}
 \newacronym{LBA}{LBA}{Low-Band Antenna}
+\newacronym
+  [%
+    description={\Acrshort{LOFAR} Data Valorisation}%
+  ]{LDV}{LDV}{LOFAR Data Valorisation}
+\newacronym{LHC}{LHC}{Large Hadron Collider}
+\newacronym{LINC}{LINC}{LOFAR INitial Calibration}
+\newacronym
+  [%
+    description={\acrshort{LBA} \acrshort{LOFAR} CommUnity Sky Survey}%
+  ]{LLoCuSS}{LLoCuSS}{LBA LOFAR CommUnity Sky Survey}
+\newacronym
+  [
+    description={\acrshort{LOFAR}2.0 Dark Matter eXperiment}
+  ]{LoDMaX}{LoDMaX}{LOFAR2.0 Dark Matter eXperiment}
+\newacronym{LOFAR}{LOFAR}{LOw Frequency ARray}
+\newacronym
+  [
+    description={\acrshort{LOFAR} Two-metre Sky Survey}
+  ]{LoTSS}{LoTSS}{LOFAR Two-metre Sky Survey}
+\newacronym{LSST}{LSST}{Legacy Survey of Space and Time}
 \newacronym{LTA}{LTA}{Long Term Archive}
-\newacronym{LUC}{LUC}{LOFAR Users Committee}
+\newacronym
+  [%
+    description={\acrshort{LOFAR} Users Committee}%
+  ]{LUC}{LUC}{LOFAR Users Committee}
+\newacronym{MIND}{MIND}{Management, Innovation, Networking, and Dissemination}
+\newacronym{MT}{MT}{Management Team}
 \newacronym{NWO}{NWO}{Nederlandse Organisatie voor Wetenschappelijk Onderzoek}
+\newacronym{OIDC}{OIDC}{OpenID Connect}
+\newacronym{ORP}{ORP}{OPTICON--RadioNet Pilot}
+\newacronym{OSSR}{OSSR}{Open-source scientific Software and Service Repository}
+\newacronym{PAF}{PAF}{Project Acquisition Form}
+\newacronym{PI}{PI}{Principal Investigator}
+\newacronym{PID}{PID}{Persistent Identifier}
+\newacronym{PM}{PM}{Person Month}
+\newacronym{PMT}{PMT}{Product Management Team}
+\newacronym{PSNC}{PSNC}{Poznań Supercomputing and Networking Center}
+\newacronym{QA}{QA}{Quality Assessment}
+\newacronym{QoS}{QoS}{Quality of Service}
+\newacronym{RuG}{RuG}{Rijksuniversiteit Groningen}
+\newacronym{RDMA}{RDMA}{Remote Direct Memory Access}
+\newacronym{RFI}{RFI}{radio-frequency interference}
+\newacronym{RUG}{RUG}{Rijksuniversiteit Groningen}
+\newacronym{REST}{REST}{Representational State Transfer}
+\newacronym{SAC}{SAC}{Science Advisory Committee}
+\newacronym{SAFe}{SAFe}{Scaled Agile Framework}
+\newacronym{SAMP}{SAMP}{Simple Application Messaging Protocol}
 \newacronym{SBe}{SBe}{Smart Backend}
-\newacronym{SDCO}{SDCO}{Science Data Centre Operations}
+\newacronym
+  [%
+    description={\acrshort{SDC} Operations}%
+  ]{SDCO}{SDCO}{SDC Operations}
+\newacronym
+  [%
+    description={\acrshort{SDC} Program}%
+  ]{SDCP}{SDCP}{SDC Program}
 \newacronym{SDC}{SDC}{Science Data Centre}
-\newacronym{SDF-PPE}{SDF-PPE}{Science Delivery Framework Production Pipeline Enhancement}
+\newacronym{SDF-PPE}{SDF-PPE}{Science Delivery Framework: Production Pipeline Enhancement}
 \newacronym{SDF}{SDF}{Science Delivery Framework}
+\newacronym{SDP}{SDP}{Science Data Processor}
 \newacronym{SD}{SD}{Software Delivery}
 \newacronym{SKAO}{SKAO}{SKA Observatory}
-\newacronym{SKARC}{SKARC}{Square Kilometre Array Regional Centre}
-\newacronym{SKA}{SKA}{Square Kilometre Array}
-\newacronym{SRCSC}{SRCSC}{SKA Regional Centres Steering Committee}
+\newacronym{SLA}{SLA}{Service Level Agreement}
+\newacronym{SQL}{SQL}{Structured Query Language}
 \newacronym{SRC}{SRC}{SKA Regional Centre}
+\newacronym{SRCNet}{SRCNet}{SKA Regional Centre Network}
+\newacronym{SRCSC}{SRCSC}{SKA Regional Centres Steering Committee}
+\newacronym{SRDP}{SRDP}{Science-Ready Data Product}
+\newacronym{SSH}{SSH}{Secure Shell}
+\newacronym{STFC}{STFC}{Science and Technology Facilities Council}
 \newacronym{TMSS}{TMSS}{Telescope Manager Specification System}
 \newacronym{TO}{TO}{Telescope Operations}
 \newacronym{TPU}{TPU}{Tensor Processing Unit}
+\newacronym{UWS}{UWS}{Universal Worker Service}
+\newacronym{VM}{VM}{Virtual Machine}
 \newacronym{VO}{VO}{Virtual Observatory}
+\newacronym{VLBI}{VLBI}{Very Long Baseline Interferometry}
+\newacronym
+  [%
+    description={Worldwide \acrshort{LHC} Computing Grid}%
+  ]{WLCG}{WLCG}{Worldwide LHC Computing Grid}
+\newacronym{WP}{WP}{Work Package}
+\newacronym{WSRT}{WSRT}{Westerbork Synthesis Radio Telescope}

texmf/tex/latex/astron/astron.cls

@@ -5,102 +5,130 @@
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesClass{astron}[ASTRON document class]
 
-\LoadClass[a4paper,12pt,twoside]{article}
-
 \newlength{\topMargin}
 \newlength{\bottomMargin}
 \newlength{\sideMargin}
+\newlength{\headHeight}
+\newlength{\footSkip}
+\newlength{\headSep}
 \setlength{\topMargin}{3.5cm}
 \setlength{\bottomMargin}{3.5cm}
 \setlength{\sideMargin}{2cm}
+\setlength{\headHeight}{52.05211pt}
+\setlength{\footSkip}{56.9055pt}
+\setlength{\headSep}{25.0pt}
+
+\newcommand{\changeRecordName}{Document History}
 
-\RequirePackage[absolute]{textpos}
-\RequirePackage{biblatex}
-\RequirePackage{fancyhdr}
-\RequirePackage{geometry}
-\RequirePackage[pdfborder={0 0 0}]{hyperref}
-\RequirePackage[nonumberlist,nogroupskip]{glossaries}
-\RequirePackage{graphicx}
-\RequirePackage{lastpage}
-\RequirePackage{libertinus}
-\RequirePackage{microtype}
-\RequirePackage{parskip}
-\RequirePackage{tabularx}
+% Handle various document types, adding appropriate warning messages.
+% Document type is specified as a class option; if none is specified, we use "undefined".
+\newif\if@hastype
+\@hastypefalse
+\newcommand{\docType}{Undefined}
 
-% Link to document repositories for appropriate e-prints in the bibliography
-\DeclareFieldFormat{eprint:sdc-handle}{%
-  Document handle\addcolon\space
-    \href{https://git.astron.nl/swinbank/doc-#1}{#1}%
+\DeclareOption{draftwm}{
+  \AtEndOfClass{\RequirePackage[firstpageonly]{draftwatermark}}
 }
 
-% Standard bibliography files included in this package
-\addbibresource{astron.bib}
-\addbibresource{ivoa.bib}
-\addbibresource{lofar.bib}
-\addbibresource{sdc.bib}
-\addbibresource{sdco.bib}
+\DeclareOption{note}{
+  \newcommand{\docTypeDescription}{
+    \fbox{%
+      \begin{minipage}{\dimexpr\linewidth-2\fboxrule-2\fboxsep}
+        \begin{center}
+          \begin{small}
+            This technical note expresses the opinions of the authors on the date of writing.\\
+            It is not binding on the SDC Program, and may not accurately reflect future developments.
+          \end{small}
+        \end{center}
+      \end{minipage}%
+    }
+  }
 
-% No need for a fancy font for the URL
-\urlstyle{same}
+  \renewcommand{\docType}{Tech. Note}
+  \@hastypetrue
+}
 
-\geometry{tmargin=\topMargin,
-          bmargin=\bottomMargin,
-          lmargin=\sideMargin,
-          rmargin=\sideMargin,
-          headheight=52.05211pt}
+\DeclareOption{proposed}{
+  \newcommand{\docTypeDescription}{
+    \fbox{%
+      \begin{minipage}{\dimexpr\linewidth-2\fboxrule-2\fboxsep}
+        \begin{center}
+          \begin{small}
+            This document proposes a change to the technical baseline of the SDC Program.\\
+            It is not binding on the Program until approved by a change control process.
+          \end{small}
+        \end{center}
+      \end{minipage}%
+    }
+  }
 
-\newcommand{\docTitle}{Set the document title with \texttt{\textbackslash{}setDocTitle}}
-\newcommand{\setDocTitle}[1]{
-   \renewcommand{\docTitle}{#1}
+  \renewcommand{\docType}{Proposed}
+  \@hastypetrue
 }
 
-\newcommand{\docNumber}{Set the document number with \texttt{\textbackslash{}setDocNumber}}
-\newcommand{\setDocNumber}[1]{
-   \renewcommand{\docNumber}{#1}
+\DeclareOption{baseline}{
+  \newcommand{\docTypeDescription}{
+    \fbox{%
+      \begin{minipage}{\dimexpr\linewidth-2\fboxrule-2\fboxsep}
+        \begin{center}
+          \begin{small}
+            This document is part of the technical baseline of the SDC Program.\\
+            It is binding on the activities of the Program.\\
+            It may only be modified through a formal change control process.
+          \end{small}
+        \end{center}
+      \end{minipage}%
+    }
+  }
+
+  \renewcommand{\docType}{Baseline}
+  \@hastypetrue
 }
 
-\newcommand{\docRevision}{Set the document revision with \texttt{\textbackslash{}setDocRevision}}
-\newcommand{\setDocRevision}[1]{
-   \renewcommand{\docRevision}{#1}
+% Default logo
+\newcommand{\logo}{\includegraphics[width=8cm]{astron-logo}}
+
+% 75th anniversary logo
+\DeclareOption{75}{
+  \renewcommand{\logo}{\includegraphics[width=4.85cm]{astron75-logo}}
 }
 
-\newcommand{\docDate}{Set the document date with \texttt{\textbackslash{}setDocDate}}
-\newcommand{\setDocDate}[1]{
-   \renewcommand{\docDate}{#1}
+% LOFAR documents (for now, this just means using the LOFAR logo).
+\DeclareOption{lofar}{
+  \renewcommand{\logo}{\includegraphics[width=6cm]{lofar-logo}}
 }
 
-\newcommand{\docClass}{Set the document class with \texttt{\textbackslash{}setDocClass}}
-\newcommand{\setDocClass}[1]{
-   \renewcommand{\docClass}{#1}
+\DeclareOption{lofar-eric}{
+  \renewcommand{\logo}{\includegraphics[width=2.15cm]{lofar-eric-logo}}
 }
 
-\newcommand{\docProgram}{Set the document program with \texttt{\textbackslash{}setDocProgram}}
-\newcommand{\setDocProgram}[1]{
-   \renewcommand{\docProgram}{#1}
+% No logo
+\DeclareOption{nologo}{
+  \renewcommand{\logo}{}
 }
 
+% Short documents don't have a title page; just stick the title next to the logo on the first page.
+\newif\if@shortDoc
+\@shortDocfalse
+\DeclareOption{short}{
+  \@shortDoctrue
+}
+
+\ProcessOptions\relax
+
 %
-% Document history
+% Standard Definitions
 %
-\providecommand{\addChangeRecord}[3]{ #1 & #2 & #3 \tabularnewline \hline}
-\newcommand{\docChangeRecord}{
-... & ... & ... \tabularnewline \hline
-}
-\newcommand{\setDocChangeRecord}[1]{\renewcommand{\docChangeRecord}
-{
-#1
-}}
-
-\newcommand{\changeRecord}{%
-  \clearpage
-  \section*{Document History}
-  \begin{tabularx}{\textwidth}{|X|p{0.13\textwidth}|p{0.68\textwidth}|X|}
-    \hline
-    \textbf{Revision} & \textbf{Date} & \textbf{Description} \tabularnewline
-    \hline\hline
-    \docChangeRecord
-  \end{tabularx}
-  \clearpage
+\input{common}
+
+\newcommand{\docRevision}{Set the document revision with \texttt{\textbackslash{}setDocRevision}}
+\newcommand{\setDocRevision}[1]{
+  \renewcommand{\docRevision}{#1}
+}
+
+\newcommand{\docProgram}{Set the document program with \texttt{\textbackslash{}setDocProgram}}
+\newcommand{\setDocProgram}[1]{
+  \renewcommand{\docProgram}{#1}
 }
 
 %
@@ -109,56 +137,56 @@
 \providecommand{\addPerson}[3]{ #1 & #2 & #3 \tabularnewline}
 
 \newcommand{\docAuthors}{
-... & ... & ... \tabularnewline
+  ... & ... & ... \tabularnewline
 }
 \newcommand{\setDocAuthors}[1]{\renewcommand{\docAuthors}
-{
-#1
-}}
+  {
+    #1
+  }}
 
 \newcommand{\docCheckers}{
-... & ... & ... \tabularnewline
+  ... & ... & ... \tabularnewline
 }
 \newcommand{\setDocCheckers}[1]{\renewcommand{\docCheckers}
-{
-#1
-}}
+  {
+    #1
+  }}
 
 \newcommand{\docApprovers}{
-... & ... & ... \tabularnewline
+  ... & ... & ... \tabularnewline
 }
 \newcommand{\setDocApprovers}[1]{\renewcommand{\docApprovers}
-{
-#1
-}}
+  {
+    #1
+  }}
 
 \newcommand{\docAuthorizers}{
-... & ... & ... \tabularnewline
+  ... & ... & ... \tabularnewline
 }
 \newcommand{\setDocAuthorizers}[1]{\renewcommand{\docAuthorizers}
-{
-#1
-}}
+  {
+    #1
+  }}
 
 \newcommand{\authorTable}{%
   \begin{tabularx}{\textwidth}{|p{0.35\textwidth}|p{0.35\textwidth}|X|}
     \cline{2-3} \cline{3-3}
-    \multicolumn{1}{c|}{} &
-    \textbf{\footnotesize{}Organisatie / Organization} &
+    \multicolumn{1}{c|}{}                                         &
+    \textbf{\footnotesize{}Organisatie / Organization}            &
     \textbf{\footnotesize{}Datum / Date} \tabularnewline
     \hline
-    \textbf{\footnotesize{}Auteur(s) / Author(s):\vspace{0.2cm}} & & \tabularnewline
+    \textbf{\footnotesize{}Auteur(s) / Author(s):\vspace{0.2cm}}  &   & \tabularnewline
     \docAuthors
     \hline
-    \textbf{\footnotesize{}Controle / Checked:\vspace{0.2cm}} & & \tabularnewline
+    \textbf{\footnotesize{}Controle / Checked:\vspace{0.2cm}}     &   & \tabularnewline
     \docCheckers
     \hline
-    \textbf{\footnotesize{}Goedkeuring / Approval:\vspace{0.2cm}} & & \tabularnewline
+    \textbf{\footnotesize{}Goedkeuring / Approval:\vspace{0.2cm}} &   & \tabularnewline
     \docApprovers
     \hline
-    \textbf{\footnotesize{}Autorisatie / Authorization:} & & \tabularnewline
+    \textbf{\footnotesize{}Autorisatie / Authorization:}          &   & \tabularnewline
     \docAuthorizers
-    \textbf{\footnotesize{}Handtekening / Signature:\vspace{1cm}} & & \tabularnewline
+    \textbf{\footnotesize{}Handtekening / Signature:\vspace{1cm}} &   & \tabularnewline
     \hline
   \end{tabularx}
 }
@@ -170,15 +198,16 @@
 \fancyhf{}
 \lfoot{\thepage \hspace{1pt} / \pageref{LastPage}}
 \rfoot{
-\begin{tabular}{>{\raggedright}ll}
- Doc. Nr.: & \docNumber{}\tabularnewline
- Rev.: & \docRevision{}\tabularnewline
- Date: & \docDate{}\tabularnewline
- Class & \docClass{}\tabularnewline
-\end{tabular}
+  \renewcommand{\arraystretch}{1}
+  \begin{tabular}{>{\raggedright}ll}
+    Doc. Nr.:  & \docNumber{}\tabularnewline
+    Rev.:      & \docRevision{}\tabularnewline
+    Date:      & \docDate{}\tabularnewline
+    Doc. Type: & \docType{}\tabularnewline
+  \end{tabular}
 }
 
-\rhead{\includegraphics[width=8cm]{astron-logo}}
+\rhead{\logo}
 \cfoot{\textbf{\large{}\docProgram{}}}
 \renewcommand{\headrulewidth}{0pt}
 \renewcommand{\footrulewidth}{1pt}
@@ -187,44 +216,77 @@
 %
 % Construct the title page, history, etc.
 %
-\renewcommand{\maketitle}{
-\vspace*{4cm}
-\begin{center}
-\begin{minipage}{0.7\textwidth}
-\centering\LARGE\textbf{\docTitle{}}
-\end{minipage}
-\end{center}
-
-% This position was determined by trial and error; a bit unsatisfying.
-\newlength{\copyrightBoxPosition}
-\setlength{\copyrightBoxPosition}{25.2cm}
-
-% Add the copyright notice towards the bottom of the page.
-\begin{textblock*}{1\textwidth}(\sideMargin, \copyrightBoxPosition)
-  \fbox{%
-    \begin{minipage}{\dimexpr\linewidth-2\fboxrule-2\fboxsep}
-      \begin{center}
-        \begin{small}
-          \textcopyright{} ASTRON 2020.\\
-          All rights are reserved. Reproduction in whole or in part is\\
-          prohibited without written consent of the copyright owner.
-        \end{small}
-      \end{center}
-    \end{minipage}%
+
+% How far should the title be position from the top of the page?
+\newlength{\titleDescent}
+\setlength{\titleDescent}{4cm}
+
+\if@shortDoc
+  \renewcommand{\maketitle}{
+    \begin{textblock*}{0.45\textwidth}(\sideMargin, 0.80cm)
+      \fbox{
+        \begin{minipage}[c][1.3cm]{\textwidth}
+          \centering
+          \Huge\textbf{\docTitle{}}
+        \end{minipage}
+      }
+    \end{textblock*}
   }
-\end{textblock*}
+\else
+  \renewcommand{\maketitle}{
+    \vspace*{\titleDescent}
+    \begin{center}
+      \begin{minipage}{0.7\textwidth}
+        \centering\LARGE\textbf{\docTitle{}}
+      \end{minipage}
+    \end{center}
 
-% We generate the author table once (but don't print it) to measure its height,
-% then use that to position the textblock* which ultimately contains the table.
-% Note the measured height is (approximately) half the full height.
-\newlength{\authorTableHalfHeight}
-\settoheight{\authorTableHalfHeight}{\authorTable}
-\begin{textblock*}{1\textwidth}(\sideMargin,
-                                \dimexpr\copyrightBoxPosition-2\authorTableHalfHeight+\fboxsep)
-\authorTable
-\end{textblock*}
+    % This position was determined by trial and error; a bit unsatisfying.
+    \newlength{\copyrightBoxPosition}
+    \setlength{\copyrightBoxPosition}{25.2cm}
 
-\clearpage
+    % Add the copyright notice towards the bottom of the page.
+    \begin{textblock*}{1\textwidth}(\sideMargin, \copyrightBoxPosition)
+      \fbox{%
+        \begin{minipage}{\dimexpr\linewidth-2\fboxrule-2\fboxsep}
+          \begin{center}
+            \begin{small}
+              \ifthenelse{\equal{\vcsFirstYear}{\vcsLastYear}}
+              {\textcopyright{} ASTRON \vcsFirstYear.\\}
+              {\textcopyright{} ASTRON \vcsFirstYear--\vcsLastYear.\\}
+              All rights are reserved. Reproduction in whole or in part is\\
+              prohibited without written consent of the copyright owner.
+            \end{small}
+          \end{center}
+        \end{minipage}%
+      }
+    \end{textblock*}
 
-\changeRecord
-}
+    % We generate the author table once (but don't print it) to measure its height,
+    % then use that to position the textblock* which ultimately contains the table.
+    % Note the measured height is (approximately) half the full height.
+    \newlength{\authorTableHalfHeight}
+    \settoheight{\authorTableHalfHeight}{\authorTable}
+
+    \if@hastype
+      \newlength{\docTypeHalfHeight}
+      \settoheight{\docTypeHalfHeight}{\docTypeDescription}
+      \begin{textblock*}{1\textwidth}(\sideMargin,
+        \dimexpr\copyrightBoxPosition-2\docTypeHalfHeight+\fboxsep)
+        \docTypeDescription
+      \end{textblock*}
+
+      \begin{textblock*}{1\textwidth}(\sideMargin,
+        \dimexpr\copyrightBoxPosition-2\docTypeHalfHeight-2\authorTableHalfHeight+2\fboxsep)
+        \authorTable
+      \end{textblock*}
+    \else
+      \begin{textblock*}{1\textwidth}(\sideMargin,
+        \dimexpr\copyrightBoxPosition-2\authorTableHalfHeight+\fboxsep)
+        \authorTable
+      \end{textblock*}
+    \fi
+    \clearpage
+    \changeRecord
+  }
+\fi