README.qmd

---
format: gfm
---

<!-- README.md is generated from README.qmd. Please edit that file -->

# Quarto template for ANU Report

This repository contains the Quarto template for ANU report. 

## Getting started

1. Install [Quarto](https://quarto.org/docs/get-started/).
2. You may need to install Public Sans font if you do not have it. You can find it [here](https://github.com/anuopensci/quarto-anu-report/tree/main/_extensions/anu-report/assets/webfonts).
3. The easiest way to edit and render the document is using the [RStudio IDE](https://posit.co/download/rstudio-desktop/). If you prefer not to install R, then you can use VS Code instead.
4. From the Terminal run the following command

```bash
quarto use template anuopensci/quarto-anu-report
```

This will install the extension and create an example qmd file that you can use as a starting place for your report.

## Format Options

There are three formats available: pdf, html and docx. The docx only contains the styles.

```{r}
#| include: false

# Create pdf and png version of template
library(quarto)
library(magick)
# Render template
quarto_render(input = "template.qmd", output_format = "all")

webshot2::webshot("template.html",
                  file = "examples/template-html.png",
                  vwidth = 1000,
                  vheight = 900,
                  zoom = 0.7, 
                  cliprect = "viewport")

image_read("examples/template-html.png") |>
  image_montage(geometry = "x2000+25+35", 
                tile = "1x1", 
                bg = "grey92", 
                shadow = TRUE) |>
  image_convert(format = "png") |>
  image_write("examples/template-html.png")

## Code below inspired by Rob Hyndman


# Convert rendered PDF to PNG
image_read_pdf("template.pdf") |>
  image_montage(geometry = "x2000+25+35", 
                tile = "1x1", 
                bg = "grey92", 
                shadow = TRUE) |>
  image_convert(format = "png") |>
  image_write("examples/template-pdf.png")
# Move pdf to examples folder
fs::file_move("template.pdf", "examples/template.pdf")
```

### `anu-report-html`

![](examples/template-html.png)

### `anu-report-pdf`

[![](examples/template-pdf.png)](examples/template.pdf)


### `anu-report-docx`

This docx file mimics the style format supplied for the docx report template from the [ANU Brand Identity Hub](https://anu365.sharepoint.com/sites/ANUidentityHUB). Currently, it only copies the style and not the formatting (title page, footer, etc) so it is recommended that you copy the output to the docx template provided by the ANU Brand Identity Hub. See also [`officeverse`](https://ardata-fr.github.io/officeverse/).