Merge pull request #13 from royal-statistical-society/pdf-gh-actions

Render PDF with GitHub actions

.github/workflows/render_pdf.yaml

@@ -0,0 +1,45 @@
+name: Render PDF
+
+on:
+  push:
+    branches: main
+
+  workflow_dispatch:
+
+
+jobs:
+  render:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v3
+
+      - name: Set up Quarto
+        uses: quarto-dev/quarto-actions/setup@v2
+        with:
+          tinytex: true
+
+      - name: Set up R
+        uses: r-lib/actions/setup-r@v2
+        with:
+          use-public-rspm: true
+
+      - name: Install R packages
+        run: |
+          install.packages(c("knitr", "rmarkdown", "quarto", "stringr"))
+        shell: Rscript {0}
+
+      - name: Render PDF
+        run: |
+          quarto::quarto_render("_make_pdf.qmd")
+        shell: Rscript {0}
+
+      - name: Commit files
+        run: |
+          git config --local user.email "actions@github.com"
+          git config --local user.name "GitHub Actions"
+          git add RSS-data-vis-guide.pdf
+          git commit -m "Render PDF"
+          git push
+        env:
+          github_token: ${{ secrets.GITHUB_TOKEN }}

_make_pdf.qmd

@@ -2,6 +2,9 @@
 title: Best Practices for Data Visualisation
 subtitle: Insights, advice, and examples (with code) to make data outputs more readable, accessible, and impactful
 author: "Andreas Krause, Nicola Rennie, & Brian Tarran"
+bibliography: references.bib
+nocite: |
+  @*
 format:
   pdf:
     toc: true
@@ -10,6 +13,10 @@ format:
     number-depth: 2
     output-file: "RSS-data-vis-guide"
     output-ext:  "pdf"
+    linkcolor: RSSblue
+    urlcolor: RSSblue
+    include-in-header: 
+       - "styles.tex"
 editor: source
 ---
 

about.qmd

@@ -6,7 +6,7 @@ editor: source
 ## Andreas Krause
 
 ::: grid
-::: {.g-col-12 .g-col-md-6}
+::: {.g-col-12 .g-col-md-8}
 Andreas Krause holds a PhD and an MSc in statistics and computer science. His current position is senior director, data science, modeling and simulation, at Idorsia Pharmaceuticals Ltd in Basel, Switzerland. His group provides clinical drug development teams with statistics and model-based analysis and predictions to support decision making. His works include more than 100 peer-reviewed [scientific publications](https://scholar.google.com/citations?hl=en&user=9a--8FUAAAAJ&view_op=list_works&sortby=pubdate).
 
 Andreas' scientific activities include positions as co-editor of the American Statistical Association's section on [Statistical Computing and Graphics](https://community.amstat.org/jointscsg-section/home), book review editor and board member of [*Computational Statistics*](https://www.springer.com/journal/180), associate editor and editor-in-chief of [*Pharmaceutical Statistics*](https://onlinelibrary.wiley.com/page/journal/15391612/homepage/editorialboard.html), and, currently, advisory board member of *Pharmaceutical Statistics* and the [*Journal of Pharmacokinetics and Pharmacodynamics*](https://doi.org/10.1007/s10928-023-09855-x).
@@ -19,15 +19,17 @@ Graphics and visualisation are long-standing topics for him, including numerous
 -   ORCID: [orcid.org/0000-0002-4686-976X](https://orcid.org/0000-0002-4686-976X)
 :::
 
-::: {.g-col-12 .g-col-md-6}
-![](images/andreas.png){fig-align="center" fig-alt="Image of Andreas Krause" width="70%"}
+::: {.content-visible unless-format="pdf"}
+::: {.g-col-12 .g-col-md-4}
+![](images/andreas.png){fig-align="center" fig-alt="Image of Andreas Krause"}
+:::
 :::
 :::
 
 ## Nicola Rennie
 
 ::: grid
-::: {.g-col-12 .g-col-md-6}
+::: {.g-col-12 .g-col-md-8}
 Nicola Rennie is an academic, data scientist, and educator with a passion for effectively communicating data. She is a Lecturer in Health Data Science at Lancaster Medical School, where her research focuses on the use of statistical models to improve health outcomes. Her teaching experience covers topics including data visualisation, programming in R and Python, and how to effectively communicate the results of statistical analyses. Nicola is the author and maintainer of multiple R packages, and an active member of the R community - regularly presenting at R User Group Meetups and mentoring new members of the community.
 
 -   Website: [nrennie.rbind.io](https://nrennie.rbind.io/)
@@ -37,15 +39,17 @@ Nicola Rennie is an academic, data scientist, and educator with a passion for ef
 -   ORCID: [orcid.org/0000-0003-4797-557X](https://orcid.org/0000-0003-4797-557X)
 :::
 
-::: {.g-col-12 .g-col-md-6}
-![](images/nicola.jpg){fig-align="center" fig-alt="Image of Nicola Rennie wearing a red jacket" width="70%"}
+::: {.content-visible unless-format="pdf"}
+::: {.g-col-12 .g-col-md-4}
+![](images/nicola.jpg){fig-align="center" fig-alt="Image of Nicola Rennie wearing a red jacket"}
+:::
 :::
 :::
 
 ## Brian Tarran
 
 ::: grid
-::: {.g-col-12 .g-col-md-6}
+::: {.g-col-12 .g-col-md-8}
 Brian Tarran is a writer and editor with 20 years of experience covering the research and data space. He has worked for the Royal Statistical Society (RSS) for the past 8 years, and was editor of [*Significance* Magazine](https://www.significancemagazine.com/) (a joint publication of the RSS, the American Statistical Association and the Statistical Society of Australia) prior to the launch of [Real World Data Science](https://realworlddatascience.net/). Brian is a former editor of Research-Live.com and was launch editor of Impact magazine, both published by the Market Research Society.
 
 -   Twitter: [\@brtarran](https://twitter.com/brtarran)
@@ -54,7 +58,9 @@ Brian Tarran is a writer and editor with 20 years of experience covering the res
 -   GitHub: [github.com/brtarran](https://github.com/brtarran)
 :::
 
-::: {.g-col-12 .g-col-md-6}
-![](images/brian.png){fig-align="center" fig-alt="Image of Brian Tarran" width="70%"}
+::: {.content-visible unless-format="pdf"}
+::: {.g-col-12 .g-col-md-4}
+![](images/brian.png){fig-align="center" fig-alt="Image of Brian Tarran"}
+:::
 :::
 :::

docs/index.qmd

@@ -57,7 +57,7 @@ toc: true
 :::
 
 ::: {.g-col-12 .g-col-md-4 style="background-color:#f8f9fa; padding-left:1rem; padding-right:1rem;"}
-#### [References and resources](/docs/references.qmd){style="text-decoration:none;"} 
+#### [References and resources](/docs/references.qmd){style="text-decoration:none;"}
 
 -   Primary sources
 -   Further reading