ORG-README.qmd

---
format: gfm
wrap: preserve
execute: 
  echo: false
  warning: false
---

# Quarto Journal Templates

The `quarto-journals` organization collects a curated set of journal templates for Quarto. 

Use a journal template with the command:

`quarto use template quarto-journals/<template-name>`

```{r}
#| message: false

library(gh)
library(purrr)
library(dplyr)

res <- gh::gh("/orgs/{org}/repos", org = "quarto-journals") 

tab <- res |> 
    # remove non extension
    discard(~ .x$name %in% c(".github", "article-format-template")) |>
    # remove private
    discard(~ .x$private) |>
    map_df(~ tibble::tibble(
        name = .x$name,
        full_name = .x$full_name,
        description = .x$description,
        license = .x$license$name,
        url = .x$html_url
    )) 
    
tab <- tab |> mutate(
        journal = gsub("^Quarto template for (?:the )?(.*)$", "\\1", description, perl = TRUE)
    )

tab_formatted <- tab |>
    arrange(name) |>
    transmute(
        'Journal / Publisher ' = journal,
        'Name' = glue::glue("[{name}]({url})"),
        'Install' = glue::glue("`quarto use template {full_name}`")
    )

knitr::kable(tab_formatted)
```

### Using a Template

These templates require features in Quarto 1.2, so you will currently need [pre-release versions of Quarto](https://quarto.org/docs/download/prerelease.html).

### Creating a Template

Learn more about creating your own journal templates here: <https://quarto.org/docs/journals/>

An easy way to start is to use the quarto-journals Github repo template at <https://github.com/quarto-journals/article-format-template>.