diff --git a/FrontPages/AffiliatesPage.png b/FrontPages/AffiliatesPage.png new file mode 100644 index 0000000..61f967c Binary files /dev/null and b/FrontPages/AffiliatesPage.png differ diff --git a/README.md b/README.md index 9df632a..aaeecfe 100644 --- a/README.md +++ b/README.md @@ -10,12 +10,12 @@ Staff starting a new report need to "clone the `grattex` repository on Github" ( If **you do not have a Github account** that is connected to the Grattan organisation: * Create a Github account at [github.com](https://github.com) using your @grattaninstitute email address and a username that makes it easy to identify yourself (and remember). *[Skip if you already have a Github account]* - * Ask Will to add you to the Grattan Github organisation. + * Ask Mia or Alan to add you to the Grattan Github organisation. If **you do not have an Overleaf account**: * Create an Overleaf account at [overleaf.com](https://overleaf.com) using your `@grattaninstitute` email address. - * Ask Will to add you to the Grattan Institute premium account. + * Ask Mia or Alan to add you to the Grattan Institute premium account. * Under 'Account Settings', ensure your account is linked to both Dropbox and Github. @@ -33,7 +33,7 @@ If **you do not have an Overleaf account**: 10. Locate the repository you just created, and click `Import to Overleaf`. 11. Once imported the document will open and attempt to compile. 12. At the top right, click `Share` and: - + add collaborators via their email address. *Please add all the LaTeXnicians (Nick)*, as well as the members of your team, plus Paul and Kat. + + add collaborators via their email address. Please add Mia, as well as the members of your team, plus Paul and Kat. + copy the `Anyone with this link can edit the project` link and paste it just under `\documentclass{grattan}` as a comment, *i.e.:* ```latex @@ -55,12 +55,12 @@ Now you can write almost as easily as you would in more user-friendly text edito For anything more advanced (footnotes, referencing, tables, figures and other miscellaneous troubleshooting), there are three resources that might help. 1. __*Using LaTeX in reports at Grattan*__ is a more-than-one-hundred page document that should contain the answer. It lives in the Grattan Dropbox under `Grattan Team > Templates > LaTeX > grattexDocumentation.pdf`. While super helpful and comprehensive, the document is very long -- the best strategy is to `ctrl+F` for whatever you need assistance with. - 2. The __latexShowcase__ project in Overleaf contains many examples of code that you might find useful, including how to use boxes and complex tables. Ask Will Mackey to invite you to this project if you didn't already receive the invite during your induction. - 3. Your colleagues have probably encountered any issues you might have. Breaking a Latex document can be unnerving and frustrating, but the fix usually takes only a few seconds. Ask around! __Nick__ is the designated 'Latexnician' as of September 2023, and is more than happy to help. + 2. The __latexShowcase__ project in Overleaf contains many examples of code that you might find useful, including how to use boxes and complex tables. Ask Mia to invite you to this project if you didn't already receive the invite during your induction. + 3. Your colleagues have probably encountered any issues you might have. Breaking a Latex document can be unnerving and frustrating, but the fix usually takes only a few seconds. Ask around! __Mia__ is the designated 'Latexnician' as of January 2026, and is more than happy to help. *** -## Publishing a Grattan report: what to do in the final week -The purpose of using LaTeX is to improve the quality of our final publications. One of the main ways this happens is by running the document through a series of checks. Here's how it works: + + -### One week out + ### To release a report -Releasing a report involves adding the front cover, updating the logos/affiliates on page 2, adding the ISBN and report number, and running the report through `checkGrattanReport` again -- but this time with some extra checks. - - 1. To add the front cover, ensure that there is a folder in the Overleaf project called `FrontPage`, which must contain the front cover as a PDF with the name `FrontPage.pdf`. In `Report.tex`, change the first line of code from `\documentclass[embargoed]{grattan}` to `\documentclass[FrontPage]{grattan}`. - 2. Check with Central Services what ISBN and report number your report should have. Replace whatever ISBN/report number is currently in `Report.tex` with the correct one. - 3. Now download your Overleaf project again -- just as you did one week ago, it's time to run `checkGrattanReport()`, ensuring that your team is not trying to make any final changes to the document. - 4. This time, however, we're going to add some extra arguments to `checkGrattanReport()`. These extra arguments will check that `\CenturyFootnote` is used correctly (see `grattexDocumentation.pdf`), and will build the final PDF for us. +Releasing a report involves adding the front cover, updating the logos/affiliates on page 2, and adding the ISBN and report number + + + 1. To add the front cover, ensure that there is a folder in the Overleaf project called `FrontPages`, which must contain the front cover as a PDF with the name `FrontPage.pdf`. In `Report.tex`, change the first line of code from `\documentclass[embargoed]{grattan}` to `\documentclass[FrontPage]{grattan}`. + 2. Check with Central Services what ISBN and report number your report should have, and ask for a png of the current Affiliates page. Replace whatever ISBN/report number is currently in `Report.tex` with the correct one. Save the affiliates page in the folder `Frontpages` with the file name `AffiliatesPage.png`. + 3. Check that `\CenturyFootnote` is between the 99th and 100th footnote (this will fix the spacing on subsequent footnotes, making sure three-digit footnotes still have a space between the full stop and the footnote content.) + Now download your Overleaf project again -- just as you did one week ago, it's time to run `checkGrattanReport()`, ensuring that your team is not trying to make any final changes to the document. + --> *** ## Changelog +## 2026-01-09 +* Updated documentation to reflect current processes, including new affiliates page process + ## 2024-09-13 * Changed affiliates page. diff --git a/Report.tex b/Report.tex index 17b0d79..0493408 100644 --- a/Report.tex +++ b/Report.tex @@ -13,6 +13,8 @@ % Final report publication: % - \documentclass[FrontPage]{grattan} % - Remove \EmbargoText{} +% - Save report cover in a folder 'FrontPage' with the file name 'FrontPage.pdf' +% - Check that 'AffiliatesPage.png' is up-to-date % Working paper: % - \documentclass{grattan} @@ -398,5 +400,6 @@ \chapter{Appendices and back matter}\label{chap:appendices} \printbibliography +\acknowledgementspage \end{document} diff --git a/grattan.cls b/grattan.cls index 95f01a8..17e06a3 100644 --- a/grattan.cls +++ b/grattan.cls @@ -651,14 +651,14 @@ numbers=noenddot, % Alternatively, if FrontPage is declared, the file there is used as the frontpage picture \DeclareOption{FrontPage}{ - \IfFileExists{./FrontPage/FrontPage.pdf}{% - %\includegraphics[width=\paperwidth,keepaspectratio]{./FrontPage/FrontPage}% + \IfFileExists{./FrontPages/FrontPage.pdf}{% + %\includegraphics[width=\paperwidth,keepaspectratio]{./FrontPages/FrontPage}% }{ \ClassError{grattan}{% - './FrontPage/FrontPage.pdf' does not exist + './FrontPages/FrontPage.pdf' does not exist }{% You have asked for a fullpicture option, but we can't find - a file at './FrontPage/FrontPage.pdf'. Try placing the image + a file at './FrontPages/FrontPage.pdf'. Try placing the image there or not using the fullpicture option. } } @@ -668,14 +668,14 @@ numbers=noenddot, \vfill \centering % Amend - \IfFileExists{./FrontPage/FrontPage.pdf}{% - \includegraphics[width=\paperwidth,keepaspectratio]{./FrontPage/FrontPage.pdf}% + \IfFileExists{./FrontPages/FrontPage.pdf}{% + \includegraphics[width=\paperwidth,keepaspectratio]{./FrontPages/FrontPage.pdf}% }{ \ClassError{grattan}{% - './FrontPage/FrontPage' does not exist + './FrontPages/FrontPage' does not exist }{% You have asked for a fullpicture option, but we can't find - a file at './FrontPage/FrontPage'. Try placing the image + a file at './FrontPages/FrontPage'. Try placing the image there or not using the fullpicture option. } } @@ -693,101 +693,16 @@ numbers=noenddot, \counterwithout{table}{chapter} } -\newcommand{\Vshiftacknowledgements}{-5mm} -\newcommand{\Hshiftacknowledgements}{-10mm} - \newcommand*{\@pagetwo}{% - \onecolumn - \begin{minipage}[t][0.85\textheight][t]{0.55\textwidth + \Hshiftacknowledgements} - \vspace{\Vshiftacknowledgements} - \subsection*{Grattan Institute Support} - \setlength{\columnsep}{0.75cm} - \begin{multicols}{2} - \setlength{\parskip}{3.5pt plus 6pt minus 4pt} - \textbf{\textcolor{theGrey}{\normalsize Founding members (2009)}}\hfill\par - {\centering - - \IfFileExists{aus-gov-logo-stacked-black.pdf}% - {\includegraphics[width=3.75cm]{aus-gov-logo-stacked-black}}% - {\includegraphics[width=3.75cm]{./logos/aus-gov-logo-stacked-black}} - - \IfFileExists{Vic_Gov_Logo-2016.pdf}% - {\includegraphics[width=3.25cm]{Vic_Gov_Logo-2016}}% - {\includegraphics[width=3.25cm]{./logos/Vic_Gov_Logo-2016}} - - \IfFileExists{UOM-Pos_S_PMS.pdf}% - % Too much whitespace on top: - % l t r b - {\includegraphics[trim = {0 2cm 0 2cm}, clip, width=3.5cm]{UOM-Pos_S_PMS}}% - {\includegraphics[trim = {0 2cm 0 2cm}, clip, width=3.5cm]{./logos/UOM-Pos_S_PMS}}% - - - \IfFileExists{Bhp.pdf}% - {\includegraphics[width=3.25cm]{Bhp}}% - {\includegraphics[width=3.25cm]{./logos/Bhp}}% - % par is necessary to centre the last logo - \par} - \vspace{2cm} - \columnbreak\par - \footnotesize - \textbf{\textcolor{theGrey}{\normalsize Endowment Supporters}} - \vspace{4pt} - - McKinnon - - The Myer Foundation - - National Australia Bank - - Scanlon Foundation - - Summer Foundation - - \vspace{10pt} - - \textbf{\textcolor{theGrey}{\normalsize Affiliate Partners}} - \vspace{4pt} - - Third Link Growth Fund - - Origin Energy Foundation - - UTS - - \vspace{10pt} - - \textbf{\textcolor{theGrey}{\normalsize Senior Affiliates}} - \vspace{4pt} - - Cuffe Family Foundation - - Medibank Private - - Wesfarmers - - \vspace{10pt} - - \textbf{\textcolor{theGrey}{\normalsize Affiliates}} - \vspace{4pt} - - Allens - - Ashurst - - Maddocks - - Urbis - - Westpac\rule[-1.5ex]{0pt}{0pt} % for BHp - \end{multicols} - \end{minipage} - \normalsize - \begin{minipage}[t][0.85\textheight][t]{0.45\textwidth - \Hshiftacknowledgements} - \vspace{\Vshiftacknowledgements} - \subsection*{Grattan Institute \@Report\ No. \@GrattanReportNumber, \@MONTH\ \@YEAR} - \setlength{\parskip}{5.5pt plus 2pt} - \raggedright\@acknowledgements - \end{minipage} + \clearpage + \begingroup + \onecolumn + \thispagestyle{scrheadings}% + \begin{center} + \vspace*{-2em} + \includegraphics[width=0.825\paperwidth,height=0.825\paperheight,keepaspectratio]{FrontPages/AffiliatesPage.png}% + \end{center} + \endgroup \twocolumn } @@ -1188,6 +1103,20 @@ numbers=noenddot, % Helpful for determining which labels are causing infinite reruns. % https://tex.stackexchange.com/questions/154594/how-to-diagnose-a-permanent-labels-may-have-changed-warning?noredirect=1&lq=1 +\newcommand{\acknowledgementspage}{% +\onecolumn + \begin{minipage}[t][0.85\textheight][t] {0.45\textwidth - {-10mm}} + \vspace{\Vshiftacknowledgements} + \subsection*{Grattan Institute \@Report\ No. \@GrattanReportNumber, \@MONTH\ \@YEAR} + \setlength{\parskip}{5.5pt plus 2pt} + \raggedright\@acknowledgements + \end{minipage}% + \twocolumn + } + +\newcommand{\Vshiftacknowledgements}{-5mm} +\newcommand{\Hshiftacknowledgements}{-10mm} + \def\@testdef #1#2#3{% \def\reserved@a{#3}\expandafter \ifx \csname #1@#2\endcsname \reserved@a \else diff --git a/logos/Better-targeting-super-breaks.pdf b/logos/Better-targeting-super-breaks.pdf deleted file mode 100644 index c4fb52f..0000000 Binary files a/logos/Better-targeting-super-breaks.pdf and /dev/null differ diff --git a/logos/Bhp.pdf b/logos/Bhp.pdf deleted file mode 100644 index 02fbbbb..0000000 Binary files a/logos/Bhp.pdf and /dev/null differ diff --git a/logos/TMF_logo_green-eps-converted-to.pdf b/logos/TMF_logo_green-eps-converted-to.pdf deleted file mode 100644 index 69c92e5..0000000 Binary files a/logos/TMF_logo_green-eps-converted-to.pdf and /dev/null differ diff --git a/logos/TMF_logo_green.pdf b/logos/TMF_logo_green.pdf deleted file mode 100644 index 2a6627f..0000000 Binary files a/logos/TMF_logo_green.pdf and /dev/null differ diff --git a/logos/UOM-Pos_S_PMS.pdf b/logos/UOM-Pos_S_PMS.pdf deleted file mode 100644 index 4f00717..0000000 Binary files a/logos/UOM-Pos_S_PMS.pdf and /dev/null differ diff --git a/logos/Vic_Gov_Logo-2016.pdf b/logos/Vic_Gov_Logo-2016.pdf deleted file mode 100644 index a56da6c..0000000 Binary files a/logos/Vic_Gov_Logo-2016.pdf and /dev/null differ diff --git a/logos/aus-gov-logo-stacked-black.pdf b/logos/aus-gov-logo-stacked-black.pdf deleted file mode 100644 index c3c6d8c..0000000 Binary files a/logos/aus-gov-logo-stacked-black.pdf and /dev/null differ diff --git a/logos/grattex-2018-09-07.tex b/logos/grattex-2018-09-07.tex deleted file mode 100644 index 291af47..0000000 --- a/logos/grattex-2018-09-07.tex +++ /dev/null @@ -1,2 +0,0 @@ -% Used to indicate the version in effect -% viz: penalties