Skip to content

A Quarto Extension for AAGI Themed Products, e.g., PDF, Word, revealjs, and PPT for AAGI staff

License

Notifications You must be signed in to change notification settings

AAGI-AUS/AAGIQuarto

Repository files navigation

AAGI Extension For Quarto

The AAGIQuarto Quarto extension provides official Analytics for the Australian Grains Industry (AAGI) project theming for Quarto documents. If you prefer to use R Markdown, please see the excellent {AAGIThemes} package, which AAGIQuarto has feature parity with and shares the same underlying AAGI templates for the individual AAGI documents so that the outputs should be similiar if not identical between these two tools. AAGIQuarto was developed to provide next-generation literate programming tools for AAGI's reporting and presentation needs that support R, Python and Julia languages.

Template Formats

See the included template and demo file for each format here:

Report Formats

Presentation Formats

Installing

You can obtain a copy of the extension by using:

cd your_quarto_project_folder
quarto use template AAGI-AUS/AAGIQuarto

This will install the extension and create an example qmd file that you can use as a starting place for your LaTeX PDF, MS Word .docx or reveal.js presentation slides.

Using

For documentation on using reveal.js slides in Quarto, please see, https://quarto.org/docs/presentations/revealjs/.

To use the formatted output, save your qmd file into the extension folder that you created using the command above. Then, in the output format use:

  • aagi-docx+report, for a full length MS Word report
  • aagi-docx+short+report, for a short MS Word report
  • aagi-pptx, for MS PPT output
  • aagi-revealjs, for a revealjs presentation
  • aagi-pdf+report, for a full length PDF report
  • aagi-pdf+short+report, for a short PDF report

Template

If you use the bash command above to install the extension and create a sub directory following the command prompt, there will be a .qmd file created using the name that you input for the sub directory.

By default, these templates use {AAGIThemes} and {AAGIPalettes} for R graphical and tabular outputs.

Updating

As we continue to improve this extension through bug fixes or adding new functionality, you can update it easily like so:

cd your_quarto_project_folder
quarto update AAGI-AUS/AAGIQuarto