Flesh out template

mikemahoney218 · mikemahoney218 · commit 21f550e542a7 · 2022-08-02T10:58:05.000-04:00
diff --git a/.gitignore b/.gitignore
@@ -1 +1,2 @@
 .DS_Store
+.Rproj.user
diff --git a/.quartoignore b/.quartoignore
@@ -1,3 +1,4 @@
 # Add files / folder that are useful to your repo
 # but should not be in the downloaded bundle after `quarto use template`
-style-guide
+style-guide
+quarto-arxiv.Rproj
diff --git a/README.md b/README.md
@@ -1,18 +1,19 @@
 # ArXiv Template
 
-This is a Quarto template that assists you in creating PDF outputs which closely match those published on arXiv. If you are intending to publish your article on arXiv, it is highly recommended you upload your TeX files (and supporting files, including generated `.bbl` and figure files) directly. However, this template supports rendering PDFs which resemble arXiv preprints for upload to other repositories either before or instead of submission to arXiv itself.
+This is a Quarto template that assists you in creating PDF outputs which closely match the arXiv template for the rticles package. If you are intending to publish your article on arXiv, it is highly recommended you upload your TeX files (and supporting files, including generated `.bbl` and figure files) directly. However, this template supports rendering decent looking PDFs for upload to other repositories either before or instead of submission to arXiv itself.
 
-There are currently a few differences between the PDFs generated by this template and those generated by arXiv:
+There are currently a few differences between the PDFs generated by this template and those generated by the arXiv rticles template:
 
 1. The fonts and spacings are not a perfect match. PRs to fix this are more than welcome.
-2. ORCiD IDs will be rendered as clickable logos next to author names.
-3. Emails will be displayed as hyperlinks, not in monospaced fonts.
+2. References and links are not currently hyperlinked. PRs to fix this also more than welcome.
+3. ORCiD IDs will be rendered as clickable logos next to author names. This is an intentional change.
+4. Emails will be displayed as hyperlinks, and not in monospaced font. This is also intentional.
 
 Any other differences are unintentional bugs -- please open an issue about anything you encounter!
 
 ## Creating a New Article
 
-You can use this as a template to create a preprint for ArXiv. To do this, use the following command:
+You can use this as a template to create a new article. To do this, use the following command:
 
 ```bash
 quarto use template mikemahoney218/quarto-arxiv
@@ -45,4 +46,4 @@ format:
     keep-tex: true    
 ```
 
-You can view a preview of the rendered template at <https://mikemahoney218.github.io/quarto-arxiv/template.pdf>.
+You can view a preview of the rendered template at <https://mikemahoney218.github.io/quarto-arxiv/template.pdf> (PDF output) and <https://mikemahoney218.github.io/quarto-arxiv/template> (HTML output).
diff --git a/_extensions/arxiv/_extension.yml b/_extensions/arxiv/_extension.yml
@@ -1,12 +1,12 @@
 title: ArXiV Template
 author: Mike Mahoney
-version: 0.1.2
+version: 0.1.3
 contributes:
   formats:
     common:
       # define below YAML configuration common to all formats
 #      filters:
-        # You can include here Lua filters from your extension format 
+        # You can include here Lua filters from your extension format
       shortcodes:
         # You can include here Lua filters defining shortcodes from your extension
         - shortcodes.lua
@@ -20,7 +20,6 @@ contributes:
       # Content to add in header that your format is using
       header-includes: |
         \usepackage{arxiv}
-        \usepackage{hyperref}
         \usepackage{orcidlink}
         \usepackage{amsmath}
         \usepackage[T1]{fontenc}
diff --git a/bibliography.bib b/bibliography.bib
@@ -1,8 +1,18 @@
-@book{CameronTrivedi2013,
-  author    = {A. Colin Cameron and Pravin K. Trivedi},
-  title     = {Regression Analysis of Count Data},
-  year      = {2013},
-  edition   = {2nd},
-  publisher = {Cambridge University Press},
-  address   = {Cambridge}
-}
+@Book{wickham2015,
+ author = {Wickham, Hadley},
+ title = {R Packages},
+ year = {2015},
+ isbn = {1491910593, 9781491910597},
+ edition = {1st},
+ publisher = {O'Reilly Media, Inc.},
+}
+@article{knuth1984,
+  title={Literate programming},
+  author={Knuth, Donald E.},
+  journal={The Computer Journal},
+  volume={27},
+  number={2},
+  pages={97--111},
+  year={1984},
+  publisher={British Computer Society}
+}
diff --git a/quarto-arxiv.Rproj b/quarto-arxiv.Rproj
@@ -0,0 +1,16 @@
+Version: 1.0
+
+RestoreWorkspace: Default
+SaveWorkspace: Default
+AlwaysSaveHistory: Default
+
+EnableCodeIndexing: Yes
+UseSpacesForTab: Yes
+NumSpacesForTab: 2
+Encoding: UTF-8
+
+RnwWeave: Sweave
+LaTeX: pdfLaTeX
+
+AutoAppendNewline: Yes
+StripTrailingWhitespace: Yes
diff --git a/sunflower.png b/sunflower.png
diff --git a/template.qmd b/template.qmd
@@ -34,17 +34,21 @@ bibliography: bibliography.bib
 
 # Introduction {#sec-intro}
 
-This is an example of how to use this template to render articles in the standard arXiv format. 
+This is an example of how to use this template to render journal articles. This template is inspired by the arXiv rticles template for rmarkdown, repurposed for the Quarto publishing system.
 
-This quarto extension format supports PDF and HTML outputs. `quarto-journals` is aiming at porting existing {{< latex >}} template from journals to be used with quarto. PDF format is what require the most work to fit the journals guideline, but Quarto offer a nice rendering for HTML output too. This template only uses basic HTML format without any customization for now.
+This quarto extension format supports PDF and HTML outputs. This template is primarily focused on generating acceptable {{< latex >}} outputs from Quarto, but renders an acceptable HTML output using the standard Quarto options.
 
-# Demo of some features found in this demo journal template
+# Quarto
 
-## Shortcode demo {#sec-shortcode}
+Quarto enables you to weave together content and executable code into a finished document. To learn more about Quarto see <https://quarto.org>.
 
-PDF are rendered using {{< latex >}} but it is best if one can use a Markdown syntax for cross format support.
+# Running Code
 
-## Code chunk {#sec-chunks}
+When you click the **Render** button a document will be generated that includes both content and the output of embedded code. You can embed code like this:
+
+```{r}
+1 + 1
+```
 
 This format hide chunks by default:
 
@@ -60,22 +64,154 @@ But you can set `echo` option to `true` locally in the chunk:
 
 ```{r}
 #| echo: true
+#| label: tbl-glm
 #| tbl-cap: "A table."
 
 # install.packages("broom")
 # install.packages("kableExtra")
 m_pois <- glm(Days ~ (Eth + Sex + Age + Lrn)^2, data = quine, family = poisson)
-kableExtra::kbl(broom::tidy(m_pois))
+kableExtra::kable_styling(
+  kableExtra::kbl(broom::tidy(m_pois))
+)
+```
+
+
+# Markdown Basics
+
+This section of the template is adapted from [Quarto's documentation on Markdown basics](https://quarto.org/docs/authoring/markdown-basics.html).
+
+## Text Formatting
+
++-----------------------------------+-------------------------------+
+| Markdown Syntax                   | Output                        |
++===================================+===============================+
+|     *italics* and **bold**        | *italics* and **bold**        |
++-----------------------------------+-------------------------------+
+|     superscript^2^ / subscript~2~ | superscript^2^ / subscript~2~ |
++-----------------------------------+-------------------------------+
+|     ~~strikethrough~~             | ~~strikethrough~~             |
++-----------------------------------+-------------------------------+
+|     `verbatim code`               | `verbatim code`               |
++-----------------------------------+-------------------------------+
+
+## Headings {#headings}
+
++---------------------+-----------------------------------+
+| Markdown Syntax     | Output                            |
++=====================+===================================+
+|     # Header 1      | # Header 1 {.heading-output}      |
++---------------------+-----------------------------------+
+|     ## Header 2     | ## Header 2 {.heading-output}     |
++---------------------+-----------------------------------+
+|     ### Header 3    | ### Header 3 {.heading-output}    |
++---------------------+-----------------------------------+
+
+## Equations
+
+Use `$` delimiters for inline math and `$$` delimiters for display math. For example:
+
++-------------------------------+-------------------------+
+| Markdown Syntax               | Output                  |
++===============================+=========================+
+|     inline math: $E = mc^{2}$ | inline math: $E=mc^{2}$ |
++-------------------------------+-------------------------+
+|     display math:             | display math:\          |
+|                               | $$E = mc^{2}$$          |
+|     $$E = mc^{2}$$            |                         |
++-------------------------------+-------------------------+
+
+If assigned an ID, display math equations will be automatically numbered:
+
+$$
+\frac{\partial \mathrm C}{ \partial \mathrm t } + \frac{1}{2}\sigma^{2} \mathrm S^{2}
+\frac{\partial^{2} \mathrm C}{\partial \mathrm C^2}
+  + \mathrm r \mathrm S \frac{\partial \mathrm C}{\partial \mathrm S}\ =
+  \mathrm r \mathrm C 
+$$ {#eq-black-scholes}
+
+## Other Blocks
+
++-----------------------------+--------------------------+
+| Markdown Syntax             | Output                   |
++=============================+==========================+
+|     > Blockquote            | > Blockquote             |
++-----------------------------+--------------------------+
+|     | Line Block            | | Line Block             |
+|     |   Spaces and newlines | |    Spaces and newlines |
+|     |   are preserved       | |    are preserved       |
++-----------------------------+--------------------------+
+
+## Cross-references {#sec-crf}
+
+![A sunflower](sunflower.png){#fig-sunflower}
+
++---------------------------------------+---------------------------------+
+| Markdown Format                       | Output                          |
++=======================================+=================================+
+|     @fig-sunflower is pretty.         | @fig-sunflower is pretty.       |
++---------------------------------------+---------------------------------+
+|     @tbl-glm was created from code.   | @tbl-glm was created from code. |
++---------------------------------------+---------------------------------+
+|     @sec-crf is this section.         | @sec-crf is this section.       |
++---------------------------------------+---------------------------------+
+|     @eq-black-scholes is above.       | @eq-black-scholes is above.     |
++---------------------------------------+---------------------------------+
+
+See the [Quarto documentation on cross-references for more](https://quarto.org/docs/authoring/cross-references.html).
+
+
+# Citations
+
+This section of the template is adapted from the [Quarto citation documentation](https://quarto.org/docs/authoring/footnotes-and-citations.html).
+
+Quarto supports bibliography files in a wide variety of formats including BibTeX and CSL. Add a bibliography to your document using the `bibliography` YAML metadata field. For example:
+
+``` yaml
+---
+title: "My Document"
+bibliography: references.bib
+---
 ```
 
-## Using references
+See the [Pandoc Citations](https://pandoc.org/MANUAL.html#citations) documentation for additional information on bibliography formats.
 
-I did not read this book [@CameronTrivedi2013] but it must be interesting.
+## Citation Syntax {#sec-citations}
+
+Quarto uses the standard Pandoc markdown representation for citations. Here are some examples:
+
++-------------------------------------------+---------------------------------------------------------------------+
+| Markdown Format                           | Output                                                              |
++===========================================+=====================================================================+
+|     Blah Blah [see @knuth1984, pp. 33-35; | Blah Blah [see @knuth1984, pp. 33-35; also @wickham2015, chap. 1]   |
+|     also @wickham2015, chap. 1]           |                                                                     |
++-------------------------------------------+---------------------------------------------------------------------+
+|     Blah Blah [@knuth1984, pp. 33-35,     | Blah Blah [@knuth1984, pp. 33-35, 38-39 and passim]                 |
+|     38-39 and passim]                     |                                                                     |
++-------------------------------------------+---------------------------------------------------------------------+
+|     Blah Blah [@wickham2015; @knuth1984]. | Blah Blah [@wickham2015; @knuth1984].                               |
++-------------------------------------------+---------------------------------------------------------------------+
+|     Wickham says blah [-@wickham2015]     | Wickham says blah [-@wickham2015]                                   |
++-------------------------------------------+---------------------------------------------------------------------+
+|     @knuth1984 says blah.                 | @knuth1984 says blah.                                               |
++-------------------------------------------+---------------------------------------------------------------------+
+|     @knuth1984 [p. 33] says blah.         | @knuth1984 [p. 33] says blah.                                       |
++-----------------------------------+-----------------------------------------------------------------------------+
+
+See the [Pandoc Citations](https://pandoc.org/MANUAL.html#citations) documentation for additional information on citation syntax.
+
+To provide a custom citation stylesheet, provide a path to a CSL file using the `csl` metadata field in your document, for example:
+
+``` yaml
+---
+title: "My Document"
+bibliography: references.bib
+csl: nature.csl
+---
+```
 
 {{< pagebreak >}}
 
 # References {.unnumbered}
 
-:::{#refs}
-
+::: {#refs}
 :::
