hikmah-academic-quarto/README.qmd at main · andrewheiss/hikmah-academic-quarto · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
---
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.

- Nice fancy PDF (`hikmah-pdf`)
- Nice fancy PDF through Typst (`hikmah-typst`)
- Manuscripty double-spaced PDF (`hikmah-manuscript-pdf`)
- Manuscripty double-spaced PDF through Typst (`hikmah-manuscript-typst`)
- Manuscripty double-spaced Word (`hikmah-manuscript-docx`)
- Manuscripty double-spaced OpenDocument (`hikmah-manuscript-pdf`)
- Reviewer response memo through Typst (`hikmah-response-typst`)

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 add andrewheiss/hikmah-academic-quarto
```

## Features

(will be documented better soon!)

- Bibliography generation with either (1) `citeproc` or (2) `biblatex` and `biblatex-chicago`
- Support for Quarto's complex [author/affiliation schema](https://quarto.org/docs/journals/authors.html)
- Fancy title block
- ~~Epigraphs~~ Use [`fancy-epigraphs`](https://github.com/andrewheiss/fancy-epigraphs-quarto) for epigraph support
- 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)
  - Fancy PDF version through Typst: [examples/hikmah-testing-default-typst.pdf](examples/hikmah-testing-default-typst.pdf)
  - Manuscripty double spaced version: [examples/hikmah-testing-default-manuscript.pdf](examples/hikmah-testing-default-manuscript.pdf)
  - Manuscripty double spaced version through Typst: [examples/hikmah-testing-default-manuscript-typst.pdf](examples/hikmah-testing-default-manuscript-typst.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)
  - Fancy PDF version through Typst: [examples/hikmah-testing-custom-typst.pdf](examples/hikmah-testing-custom-typst.pdf)
  - Manuscripty double spaced version: [examples/hikmah-testing-custom-manuscript.pdf](examples/hikmah-testing-custom-manuscript.pdf)
  - Manuscripty double spaced version through Typst: [examples/hikmah-testing-custom-manuscript-typst.pdf](examples/hikmah-testing-custom-manuscript-typst.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)
```

### Fancy PDF through typst, default settings

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

### Fancy PDF through typst, custom fonts

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

### Manuscripty PDF through Typst, default settings

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

### Manuscripty PDF through Typst, custom fonts

```{r fig.width=4, out.width="100%", echo=FALSE}
#| fig-link: examples/thumbnails/hikmah-testing-custom-manuscript-typst-pdf.png
knitr::include_graphics("examples/thumbnails/hikmah-testing-custom-manuscript-typst-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)
```

### Reviewer response memo, default settings

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