README.qmd

---
format: gfm
---

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

```{r, include=FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>"
)
```

# Hikmah Quarto templates

> ḥikmah (حكمة): Arabic; n. [wisdom](https://en.wikipedia.org/wiki/Hikmah); cf. [House of Wisdom](https://en.wikipedia.org/wiki/House_of_Knowledge)

---

I've been using custom LaTeX templates (based in part on [Kieran Healy's template](https://github.com/kjhealy/latex-custom-kjh)) for years. With the advent of Quarto, I decided to clean up [my templates](https://github.com/andrewheiss/portable-pandoc-magic), simplify them, and Quarto-ify them. Yay.

Eventually this repository will hold all my templates:

- Nice fancy PDF (`hikmah-pdf`) [Done!]
- Manuscripty double-spaced PDF (`hikmah-manuscript-pdf`) [Done!]
- Nice fancy HTML [Not here yet]
- Manuscripty double-spaced Word (`hikmah-manuscript-docx`) [Done!]
- Manuscripty double-spaced OpenDocument (`hikmah-manuscript-pdf`) [Done!]

This repository is *really* meant as an example of how to create Quarto templates and formats. Fork it, copy it, and adjust it all you want! Use it as a way to learn how to make your own templates.


## Installation

Run this command to install the templates in your Quarto project:

```bash
quarto install extension andrewheiss/hikmah-academic-quarto
```

## Features

(will be documented better soon!)

- Bibliography generation with both `biblatex` and `biblatex-chicago`
- Support for Quarto's complex [author/affiliation schema](https://quarto.org/docs/journals/authors.html)
- Fancy title block
- Epigraphs
- Title page in manuscripty PDF
- Ability to move floats and notes to the end of the document in manuscripty PDF
- Styles for peer review response memos
- Lots of other stuff that I'll document later


## Examples

- Default version of `template.qmd`:
  - [template.qmd](template.qmd)
  - Fancy PDF version: [examples/hikmah-testing-default.pdf](examples/hikmah-testing-default.pdf)
  - Manuscripty double spaced version: [examples/hikmah-testing-default-manuscript.pdf](examples/hikmah-testing-default-manuscript.pdf)
  - Manuscripty double spaced APA-like .docx version: [examples/hikmah-testing-default-manuscript.docx](examples/hikmah-testing-default-manuscript.docx)
  - Manuscripty double spaced APA-like .odt version (open with [LibreOffice](https://www.libreoffice.org/)): [examples/hikmah-testing-default-manuscript.odt](examples/hikmah-testing-default-manuscript.odt)

- Custom fonts + `biblatex-chicago`:
  - [hikmah-testing-custom.qmd](hikmah-testing-custom.qmd)
  - Fancy PDF version: [examples/hikmah-testing-custom.pdf](examples/hikmah-testing-custom.pdf)
  - Manuscripty double spaced version: [examples/hikmah-testing-custom-manuscript.pdf](examples/hikmah-testing-custom-manuscript.pdf)


### Fancy PDF, default settings

```{r fig.width=4, out.width="100%", echo=FALSE}
#| fig-link: examples/thumbnails/hikmah-testing-default-pdf.png
knitr::include_graphics("examples/thumbnails/hikmah-testing-default-pdf.png", dpi = 600)
```

### Fancy PDF, custom fonts + `biblatex-chicago`

```{r fig.width=4, out.width="100%", echo=FALSE}
#| fig-link: examples/thumbnails/hikmah-testing-custom-pdf.png
knitr::include_graphics("examples/thumbnails/hikmah-testing-custom-pdf.png", dpi = 600)
```

### Manuscripty PDF, default settings

```{r fig.width=4, out.width="100%", echo=FALSE}
#| fig-link: examples/thumbnails/hikmah-testing-default-manuscript-pdf.png
knitr::include_graphics("examples/thumbnails/hikmah-testing-default-manuscript-pdf.png", dpi = 600)
```

### Manuscripty PDF, custom fonts + `biblatex-chicago`

```{r fig.width=4, out.width="100%", echo=FALSE}
#| fig-link: examples/thumbnails/hikmah-testing-custom-manuscript-pdf.png
knitr::include_graphics("examples/thumbnails/hikmah-testing-custom-manuscript-pdf.png", dpi = 600)
```

### Manuscripty Word (.docx), default settings

```{r fig.width=4, out.width="100%", echo=FALSE}
#| fig-link: examples/thumbnails/hikmah-testing-default-manuscript-docx.png
knitr::include_graphics("examples/thumbnails/hikmah-testing-default-manuscript-docx.png", dpi = 600)
```

### Manuscripty OpenDocument (.odt), default settings

```{r fig.width=4, out.width="100%", echo=FALSE}
#| fig-link: examples/thumbnails/hikmah-testing-default-manuscript-odt.png
knitr::include_graphics("examples/thumbnails/hikmah-testing-default-manuscript-odt.png", dpi = 600)
```