Skip to content

Commit

Permalink
Built site for gh-pages
Browse files Browse the repository at this point in the history
  • Loading branch information
Quarto GHA Workflow Runner committed Dec 1, 2024
1 parent 7ec98a3 commit b83b1c3
Show file tree
Hide file tree
Showing 4 changed files with 40 additions and 22 deletions.
2 changes: 1 addition & 1 deletion .nojekyll
Original file line number Diff line number Diff line change
@@ -1 +1 @@
3b3be60e
d9ed6d1d
16 changes: 11 additions & 5 deletions citations_in_quarto.html
Original file line number Diff line number Diff line change
Expand Up @@ -374,7 +374,7 @@ <h2 class="anchored" data-anchor-id="what-are-references.bib-files">What are <co
<span id="cb1-3"><a href="#cb1-3" aria-hidden="true" tabindex="-1"></a><span class="fu">bibliography</span><span class="kw">:</span><span class="at"> references.bib</span></span>
<span id="cb1-4"><a href="#cb1-4" aria-hidden="true" tabindex="-1"></a><span class="pp">---</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<p>Note that you can name the file something other than <code>references.bib</code>, but you must ensure that the name of the file you specify in the YAML header matches the name of the file you have saved in your project directory.</p>
<p>You will rarely need to edit the <code>references.bib</code> file directly, but you can open it in a text editor to see the structure of the file. An example of a citation inside of a <code>references.bib</code> file might look like this:</p>
<p>You will rarely need to edit the <code>references.bib</code> file directly, but you can open it in a text editor to see the structure of the file. An example of an entry inside of a <code>references.bib</code> file might look like this:</p>
<div class="sourceCode" id="cb2"><pre class="sourceCode bibtex code-with-copy"><code class="sourceCode bibtex"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a><span class="va">@article</span>{<span class="ot">horst2022</span>,</span>
<span id="cb2-2"><a href="#cb2-2" aria-hidden="true" tabindex="-1"></a> <span class="dt">title</span> = {Palmer Archipelago Penguins Data in the palmerpenguins R Package - An Alternative to Anderson's Irises},</span>
<span id="cb2-3"><a href="#cb2-3" aria-hidden="true" tabindex="-1"></a> <span class="dt">author</span> = {Horst, Allison M. and Hill, Alison Presmanes and Gorman, Kristen B.},</span>
Expand All @@ -392,8 +392,8 @@ <h2 class="anchored" data-anchor-id="what-are-references.bib-files">What are <co
<section id="what-is-a-citation-key" class="level2">
<h2 class="anchored" data-anchor-id="what-is-a-citation-key">What is a Citation Key?</h2>
<p>Citation keys are unique identifiers for each reference in your bibliography. They are used to insert citations in your document and are typically generated automatically by your text editor. These keys are necessary because they connect your citations to the correct entry in the <code>references.bib</code> file.</p>
<p>For example, if you have a reference in your bibliography for the Palmer Penguins data set from 2022 by Allison Horst, the citation key for this reference might be <code>@horst2022</code>. You would use this citation key in your document to insert a citation to this reference.</p>
<p>The citation keys used in RStudio use Pandoc citation syntax. You can find more information on Pandoc citation syntax in the Pandoc documentation on <a href="https://pandoc.org/MANUAL.html#citations">citations</a> and <a href="https://pandoc.org/MANUAL.html#citation-syntax">citation syntax</a>.</p>
<p>Extending the <code>references.bib</code> example, you would cite the Palmer Penguins data set from 2022 by Allison Horst with the citation key <code>@horst2022</code>. You would use this citation key in your document to insert a citation to this reference.</p>
<p>RStudio generates a citation key for each new item you include in a document, and they typically follow the format <code>@authorYear</code> or <code>@authorYearLetter</code> when there are multiple references matching the format. <a href="#fn1" class="footnote-ref" id="fnref1" role="doc-noteref"><sup>1</sup></a> These keys can be customized to your liking, <strong>but this should be done only prior to using them the first time</strong>.<a href="#fn2" class="footnote-ref" id="fnref2" role="doc-noteref"><sup>2</sup></a></p>
</section>
</section>
<section id="inserting-citations" class="level1">
Expand All @@ -414,7 +414,6 @@ <h1>Inserting Citations</h1>
<section id="referencing-by-citation-key" class="level2">
<h2 class="anchored" data-anchor-id="referencing-by-citation-key">Referencing by Citation Key</h2>
<p>When you insert a citation in your document, you will use the citation key of the reference you want to cite.</p>
<p>RStudio generates a citation key for each new item you include in a document, and they typically follow the format <code>@authorYear</code> or <code>@authorYearLetter</code> when there are multiple matches. These keys can be customized to your liking, <strong>but only prior to using them the firs time</strong>.</p>
<p>If you <em>export</em> a library from Zotero, however, a different default method for generating the citation keys will be used. These differences will be discussed in the following sub-sections, <a href="#rstudio-visual-editor">RStudio Visual Editor</a> and <a href="#manual-entry">Manual Entry</a>.</p>
<p>You can insert a citation in your document by using the <code>@</code> symbol followed by the citation key of the reference you want to cite. For example, I have saved the Zotero Quick Start guide to my Zotero library for this tutorial, and in order to to cite this guide, I would use the citation key <code>[@zotero]</code> in my document. The text would look like this:</p>
<blockquote class="blockquote">
Expand Down Expand Up @@ -569,7 +568,14 @@ <h1>References</h1>

</section>

<a onclick="window.scrollTo(0, 0); return false;" role="button" id="quarto-back-to-top"><i class="bi bi-arrow-up"></i> Back to top</a></main> <!-- /main -->

<a onclick="window.scrollTo(0, 0); return false;" role="button" id="quarto-back-to-top"><i class="bi bi-arrow-up"></i> Back to top</a><div id="quarto-appendix" class="default"><section id="footnotes" class="footnotes footnotes-end-of-document" role="doc-endnotes"><h2 class="anchored quarto-appendix-heading">Footnotes</h2>

<ol>
<li id="fn1"><p>The citation keys used in RStudio use Pandoc citation syntax. You can find more information on Pandoc citation syntax in the Pandoc documentation on <a href="https://pandoc.org/MANUAL.html#citations">citations</a> and <a href="https://pandoc.org/MANUAL.html#citation-syntax">citation syntax</a>.<a href="#fnref1" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn2"><p>If needed, you can edit the citation keys in the <code>references.bib</code> file directly. However, you must ensure that the citation key is unique and does not contain any spaces or special characters.<a href="#fnref2" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
</ol>
</section></div></main> <!-- /main -->
<script id="quarto-html-after-body" type="application/javascript">
window.document.addEventListener("DOMContentLoaded", function (event) {
const toggleBodyColorMode = (bsSheetEl) => {
Expand Down
18 changes: 15 additions & 3 deletions search.json
Original file line number Diff line number Diff line change
Expand Up @@ -215,7 +215,7 @@
"href": "citations_in_quarto.html#what-are-references.bib-files",
"title": "Citations in Quarto",
"section": "What are references.bib Files?",
"text": "What are references.bib Files?\nA references.bib file is a BibTeX file that contains all of the references you want to cite in your document. This file is used to generate the bibliography at the end of your document, and it is necessary to include this file in your project directory in order to insert citations. You can create this file manually, but it is generally easier to export your references from a citation manager or allow RStudio to manage the creation of the file for you.\nWhen using a references.bib file with a Quarto document, you must specify the name of the file in the YAML header of your document like this:\n---\ntitle: \"Your project title\"\nbibliography: references.bib\n---\nNote that you can name the file something other than references.bib, but you must ensure that the name of the file you specify in the YAML header matches the name of the file you have saved in your project directory.\nYou will rarely need to edit the references.bib file directly, but you can open it in a text editor to see the structure of the file. An example of a citation inside of a references.bib file might look like this:\n@article{horst2022,\n title = {Palmer Archipelago Penguins Data in the palmerpenguins R Package - An Alternative to Anderson's Irises},\n author = {Horst, Allison M. and Hill, Alison Presmanes and Gorman, Kristen B.},\n year = {2022},\n month = {06},\n date = {2022-06-21},\n journal = {The R Journal},\n pages = {244--254},\n volume = {14},\n number = {1},\n doi = {10.32614/RJ-2022-020},\n url = {https://doi.org/10.32614/RJ-2022-020/}\n}",
"text": "What are references.bib Files?\nA references.bib file is a BibTeX file that contains all of the references you want to cite in your document. This file is used to generate the bibliography at the end of your document, and it is necessary to include this file in your project directory in order to insert citations. You can create this file manually, but it is generally easier to export your references from a citation manager or allow RStudio to manage the creation of the file for you.\nWhen using a references.bib file with a Quarto document, you must specify the name of the file in the YAML header of your document like this:\n---\ntitle: \"Your project title\"\nbibliography: references.bib\n---\nNote that you can name the file something other than references.bib, but you must ensure that the name of the file you specify in the YAML header matches the name of the file you have saved in your project directory.\nYou will rarely need to edit the references.bib file directly, but you can open it in a text editor to see the structure of the file. An example of an entry inside of a references.bib file might look like this:\n@article{horst2022,\n title = {Palmer Archipelago Penguins Data in the palmerpenguins R Package - An Alternative to Anderson's Irises},\n author = {Horst, Allison M. and Hill, Alison Presmanes and Gorman, Kristen B.},\n year = {2022},\n month = {06},\n date = {2022-06-21},\n journal = {The R Journal},\n pages = {244--254},\n volume = {14},\n number = {1},\n doi = {10.32614/RJ-2022-020},\n url = {https://doi.org/10.32614/RJ-2022-020/}\n}",
"crumbs": [
"Home",
"Integrating Zotero",
Expand All @@ -227,7 +227,7 @@
"href": "citations_in_quarto.html#what-is-a-citation-key",
"title": "Citations in Quarto",
"section": "What is a Citation Key?",
"text": "What is a Citation Key?\nCitation keys are unique identifiers for each reference in your bibliography. They are used to insert citations in your document and are typically generated automatically by your text editor. These keys are necessary because they connect your citations to the correct entry in the references.bib file.\nFor example, if you have a reference in your bibliography for the Palmer Penguins data set from 2022 by Allison Horst, the citation key for this reference might be @horst2022. You would use this citation key in your document to insert a citation to this reference.\nThe citation keys used in RStudio use Pandoc citation syntax. You can find more information on Pandoc citation syntax in the Pandoc documentation on citations and citation syntax.",
"text": "What is a Citation Key?\nCitation keys are unique identifiers for each reference in your bibliography. They are used to insert citations in your document and are typically generated automatically by your text editor. These keys are necessary because they connect your citations to the correct entry in the references.bib file.\nExtending the references.bib example, you would cite the Palmer Penguins data set from 2022 by Allison Horst with the citation key @horst2022. You would use this citation key in your document to insert a citation to this reference.\nRStudio generates a citation key for each new item you include in a document, and they typically follow the format @authorYear or @authorYearLetter when there are multiple references matching the format. 1 These keys can be customized to your liking, but this should be done only prior to using them the first time.2",
"crumbs": [
"Home",
"Integrating Zotero",
Expand All @@ -239,7 +239,7 @@
"href": "citations_in_quarto.html#referencing-by-citation-key",
"title": "Citations in Quarto",
"section": "Referencing by Citation Key",
"text": "Referencing by Citation Key\nWhen you insert a citation in your document, you will use the citation key of the reference you want to cite.\nRStudio generates a citation key for each new item you include in a document, and they typically follow the format @authorYear or @authorYearLetter when there are multiple matches. These keys can be customized to your liking, but only prior to using them the firs time.\nIf you export a library from Zotero, however, a different default method for generating the citation keys will be used. These differences will be discussed in the following sub-sections, RStudio Visual Editor and Manual Entry.\nYou can insert a citation in your document by using the @ symbol followed by the citation key of the reference you want to cite. For example, I have saved the Zotero Quick Start guide to my Zotero library for this tutorial, and in order to to cite this guide, I would use the citation key [@zotero] in my document. The text would look like this:\n\n“Items can be assigned tags. Tags are named by the user. An item can be assigned as many tags as is needed.”[@zotero]\n\nThis will insert a citation that is displayed in your document like this:\n\n“Items can be assigned tags. Tags are named by the user. An item can be assigned as many tags as is needed.”(Zotero, n.d.)\n\nNote that the citation key can be inserted in two ways: with or without brackets [], which yield formatting differences. A citation without brackets, @zotero, will appear inline as “Zotero (n.d.)”, while a citation with brackets, [@zotero], will appear as “(Zotero, n.d.)”.",
"text": "Referencing by Citation Key\nWhen you insert a citation in your document, you will use the citation key of the reference you want to cite.\nIf you export a library from Zotero, however, a different default method for generating the citation keys will be used. These differences will be discussed in the following sub-sections, RStudio Visual Editor and Manual Entry.\nYou can insert a citation in your document by using the @ symbol followed by the citation key of the reference you want to cite. For example, I have saved the Zotero Quick Start guide to my Zotero library for this tutorial, and in order to to cite this guide, I would use the citation key [@zotero] in my document. The text would look like this:\n\n“Items can be assigned tags. Tags are named by the user. An item can be assigned as many tags as is needed.”[@zotero]\n\nThis will insert a citation that is displayed in your document like this:\n\n“Items can be assigned tags. Tags are named by the user. An item can be assigned as many tags as is needed.”(Zotero, n.d.)\n\nNote that the citation key can be inserted in two ways: with or without brackets [], which yield formatting differences. A citation without brackets, @zotero, will appear inline as “Zotero (n.d.)”, while a citation with brackets, [@zotero], will appear as “(Zotero, n.d.)”.",
"crumbs": [
"Home",
"Integrating Zotero",
Expand Down Expand Up @@ -306,6 +306,18 @@
"Citations in Quarto"
]
},
{
"objectID": "citations_in_quarto.html#footnotes",
"href": "citations_in_quarto.html#footnotes",
"title": "Citations in Quarto",
"section": "Footnotes",
"text": "Footnotes\n\n\nThe citation keys used in RStudio use Pandoc citation syntax. You can find more information on Pandoc citation syntax in the Pandoc documentation on citations and citation syntax.↩︎\nIf needed, you can edit the citation keys in the references.bib file directly. However, you must ensure that the citation key is unique and does not contain any spaces or special characters.↩︎",
"crumbs": [
"Home",
"Integrating Zotero",
"Citations in Quarto"
]
},
{
"objectID": "citations_in_word.html",
"href": "citations_in_word.html",
Expand Down
26 changes: 13 additions & 13 deletions sitemap.xml
Original file line number Diff line number Diff line change
Expand Up @@ -2,54 +2,54 @@
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://lmu-osc.github.io/introduction-to-zotero/zotero_groups.html</loc>
<lastmod>2024-12-01T20:11:01.262Z</lastmod>
<lastmod>2024-12-01T21:24:17.456Z</lastmod>
</url>
<url>
<loc>https://lmu-osc.github.io/introduction-to-zotero/exercise_2.html</loc>
<lastmod>2024-12-01T20:11:01.262Z</lastmod>
<lastmod>2024-12-01T21:24:17.456Z</lastmod>
</url>
<url>
<loc>https://lmu-osc.github.io/introduction-to-zotero/citation_style_language.html</loc>
<lastmod>2024-12-01T20:11:01.258Z</lastmod>
<lastmod>2024-12-01T21:24:17.456Z</lastmod>
</url>
<url>
<loc>https://lmu-osc.github.io/introduction-to-zotero/zotero_basics.html</loc>
<lastmod>2024-12-01T20:11:01.262Z</lastmod>
<lastmod>2024-12-01T21:24:17.456Z</lastmod>
</url>
<url>
<loc>https://lmu-osc.github.io/introduction-to-zotero/zotero_usage.html</loc>
<lastmod>2024-12-01T20:11:01.262Z</lastmod>
<lastmod>2024-12-01T21:24:17.456Z</lastmod>
</url>
<url>
<loc>https://lmu-osc.github.io/introduction-to-zotero/exercise_1.html</loc>
<lastmod>2024-12-01T20:11:01.262Z</lastmod>
<lastmod>2024-12-01T21:24:17.456Z</lastmod>
</url>
<url>
<loc>https://lmu-osc.github.io/introduction-to-zotero/LICENSE-CODE.html</loc>
<lastmod>2024-12-01T20:11:01.158Z</lastmod>
<lastmod>2024-12-01T21:24:17.356Z</lastmod>
</url>
<url>
<loc>https://lmu-osc.github.io/introduction-to-zotero/citations_in_quarto.html</loc>
<lastmod>2024-12-01T20:11:01.258Z</lastmod>
<lastmod>2024-12-01T21:24:17.456Z</lastmod>
</url>
<url>
<loc>https://lmu-osc.github.io/introduction-to-zotero/citations_in_word.html</loc>
<lastmod>2024-12-01T20:11:01.258Z</lastmod>
<lastmod>2024-12-01T21:24:17.456Z</lastmod>
</url>
<url>
<loc>https://lmu-osc.github.io/introduction-to-zotero/about.html</loc>
<lastmod>2024-12-01T20:11:01.158Z</lastmod>
<lastmod>2024-12-01T21:24:17.356Z</lastmod>
</url>
<url>
<loc>https://lmu-osc.github.io/introduction-to-zotero/LICENSE.html</loc>
<lastmod>2024-12-01T20:11:01.158Z</lastmod>
<lastmod>2024-12-01T21:24:17.356Z</lastmod>
</url>
<url>
<loc>https://lmu-osc.github.io/introduction-to-zotero/index.html</loc>
<lastmod>2024-12-01T20:11:01.262Z</lastmod>
<lastmod>2024-12-01T21:24:17.456Z</lastmod>
</url>
<url>
<loc>https://lmu-osc.github.io/introduction-to-zotero/zotero_plugins.html</loc>
<lastmod>2024-12-01T20:11:01.262Z</lastmod>
<lastmod>2024-12-01T21:24:17.456Z</lastmod>
</url>
</urlset>

0 comments on commit b83b1c3

Please sign in to comment.