From 79a479ce0507602023c773ca5583e3ea09f77576 Mon Sep 17 00:00:00 2001
From: John Swinbank <swinbank@astron.nl>
Date: Mon, 23 Nov 2020 13:04:24 +0100
Subject: [PATCH] Add skeletal bibliography support

---
 example/Makefile                  |  2 ++
 example/example.tex               |  5 +++++
 texmf/bibtex/bib/astron.bib       | 12 ++++++++++
 texmf/bibtex/bib/lofar.bib        | 12 ++++++++++
 texmf/bibtex/bib/sdc.bib          | 37 +++++++++++++++++++++++++++++++
 texmf/ls-R                        | 11 ++++++++-
 texmf/tex/latex/astron/astron.cls |  6 +++++
 7 files changed, 84 insertions(+), 1 deletion(-)
 create mode 100644 texmf/bibtex/bib/astron.bib
 create mode 100644 texmf/bibtex/bib/lofar.bib
 create mode 100644 texmf/bibtex/bib/sdc.bib

diff --git a/example/Makefile b/example/Makefile
index 88c63c8..1a00b96 100644
--- a/example/Makefile
+++ b/example/Makefile
@@ -11,6 +11,8 @@ endif
 $(DOCNAME).pdf: $(DOCNAME).tex meta.tex
 	xelatex $(DOCNAME)
 	makeglossaries $(DOCNAME)
+	biber $(DOCNAME)
+	xelatex $(DOCNAME)
 	xelatex $(DOCNAME)
 
 .FORCE:
diff --git a/example/example.tex b/example/example.tex
index 6a13ec3..ea35022 100644
--- a/example/example.tex
+++ b/example/example.tex
@@ -11,6 +11,7 @@
 \setDocChangeRecord{
   \addChangeRecord{1.0}{2020-11-15}{Initial release}
   \addChangeRecord{2.0}{2020-11-18}{Add list of abbreviations}
+  \addChangeRecord{3.0}{2020-11-18}{Add list of references}
 }
 
 \setDocAuthors{
@@ -40,9 +41,13 @@
 \setglossarystyle{altlist}
 \printglossary[title=List of abbreviations]
 \clearpage
+\printbibliography
+\clearpage
 
 Check that abbreviations are working properly: \gls{SDC}, \gls{SKA}.
 
+Check that citations are working properly: \autocite{SDC-001}, \autocite{SDC-002}.
+
 \section{First section}
 
 Lorem ipsum dolor sit amet, consectetur adipiscing elit.
diff --git a/texmf/bibtex/bib/astron.bib b/texmf/bibtex/bib/astron.bib
new file mode 100644
index 0000000..16c713b
--- /dev/null
+++ b/texmf/bibtex/bib/astron.bib
@@ -0,0 +1,12 @@
+% General ASTRON documents
+
+@TechReport{2020-Kruithof-Vision,
+    author = "Gert {Kruithof}",
+    title = "Vision on {LOFAR} and the {SDC}",
+    institution = "ASTRON",
+    year = 2020,
+    month = "jan",
+    day = 30,
+    version = 1,
+    url = {https://edu.nl/afu73},
+}
diff --git a/texmf/bibtex/bib/lofar.bib b/texmf/bibtex/bib/lofar.bib
new file mode 100644
index 0000000..c3c5531
--- /dev/null
+++ b/texmf/bibtex/bib/lofar.bib
@@ -0,0 +1,12 @@
+% LOFAR and LOFAR2.0 documents
+
+@TechReport{2020-Gunst-SDC-L2-Architecture,
+    author = "A.W. {Gunst} and H. {Holties} and R. {Pizzo} and J.D. {Mol}",
+    title = "Architectural Design of {SDC} and {LOFAR2.0} Interaction",
+    institution = "ASTRON",
+    year = 2020,
+    month = sep,
+    day = 16,
+    version = 1.2,
+    url = {https://edu.nl/xfa7k},
+}
diff --git a/texmf/bibtex/bib/sdc.bib b/texmf/bibtex/bib/sdc.bib
new file mode 100644
index 0000000..a778aa0
--- /dev/null
+++ b/texmf/bibtex/bib/sdc.bib
@@ -0,0 +1,37 @@
+% SDC-series documents
+
+@TechReport{SDC-001,
+    author = "John D. {Swinbank} and Jasper {Annyas}",
+    title = "{SDC} Software Maintenance in an Agile Environment",
+    institution = "ASTRON",
+    year = 2020,
+    version = draft,
+    url = {https://git.astron.nl/swinbank/doc-sdc-001}
+}
+
+@TechReport{SDC-002,
+    author = "John D. {Swinbank}",
+    title = "{ASTRON Science Data Centre} Program Management Plan",
+    institution = "ASTRON",
+    year = 2020,
+    version = draft,
+    url = {https://git.astron.nl/swinbank/doc-sdc-002}
+}
+
+@TechReport{SDC-003,
+    author = "John D. {Swinbank}",
+    title = "{FuSE} Project Management Plan",
+    institution = "ASTRON",
+    year = 2020,
+    version = draft,
+    url = {https://git.astron.nl/swinbank/doc-sdc-003}
+}
+
+@TechReport{SDC-004,
+    author = "John D. {Swinbank}",
+    title = "{ASTRON Science Data Centre} Vision",
+    institution = "ASTRON",
+    year = 2020,
+    version = draft,
+    url = {https://git.astron.nl/swinbank/doc-sdc-004}
+}
diff --git a/texmf/ls-R b/texmf/ls-R
index c9e1b40..2d4c1a5 100644
--- a/texmf/ls-R
+++ b/texmf/ls-R
@@ -1,9 +1,18 @@
 % ls-R -- filename database for kpathsea; do not change this line.
 ./:
 .:
+bibtex
 ls-R
 tex
 
+./bibtex:
+bib
+
+./bibtex/bib:
+astron.bib
+lofar.bib
+sdc.bib
+
 
 ./tex:
 latex
@@ -12,6 +21,6 @@ latex
 astron
 
 ./tex/latex/astron:
-astron-acronyms.tex
+astron-abbreviations.tex
 astron-logo.pdf
 astron.cls
diff --git a/texmf/tex/latex/astron/astron.cls b/texmf/tex/latex/astron/astron.cls
index e51b5a7..8da485d 100644
--- a/texmf/tex/latex/astron/astron.cls
+++ b/texmf/tex/latex/astron/astron.cls
@@ -15,6 +15,7 @@
 \setlength{\sideMargin}{2cm}
 
 \RequirePackage[absolute]{textpos}
+\RequirePackage{biblatex}
 \RequirePackage{fancyhdr}
 \RequirePackage{geometry}
 \RequirePackage[pdfborder={0 0 0}]{hyperref}
@@ -26,6 +27,11 @@
 \RequirePackage{parskip}
 \RequirePackage{tabularx}
 
+% Standard bibliography files included in this package
+\addbibresource{astron.bib}
+\addbibresource{lofar.bib}
+\addbibresource{sdc.bib}
+
 \geometry{tmargin=\topMargin,
           bmargin=\bottomMargin,
           lmargin=\sideMargin,
-- 
GitLab