Lesson5
This commit is contained in:
parent
7eeba14b44
commit
6f7787c286
10
Lesson3.md
10
Lesson3.md
@ -182,15 +182,15 @@ Such delimiters are useful when one wants to graphically separate parts of a tex
|
|||||||
---
|
---
|
||||||
|
|
||||||
|
|
||||||
We have now covered the most basic syntactic elements of the markdown language. In most cases these are enough to write great texts and even write entire books. All of the above syntax is suited for the content of texts, however you are yet to introduce how to layout and style the output of a markdown text file.
|
We have now covered the most basic syntactic elements of the markdown language. In most cases, these are enough to write great texts and even write entire books. All of the above syntax is suited for the content of texts, however, we are yet to introduce how to layout and style the output of a markdown input file. The idea of behind markup languages is to create a clear division between _content_ and _style_. Here we have covered the content side . Document conversion is covered in [Lesson 4](Lesson4.html) while [Lesson 6](Lesson6.html) introduces how styling can be applied to the output of such conversion.
|
||||||
|
|
||||||
The idea of behind markup languages is to create a clear division between _content_ and _style_. Here we have covered the content side . Document conversion is covered in [Lesson 4](Lesson4.html) while [Lesson 6](Lesson6.html) introduces how styling can be applied to the output of such conversion.
|
|
||||||
|
|
||||||
### Extra
|
### Extra
|
||||||
|
|
||||||
|
[Online markdown editor](http://dillinger.io)
|
||||||
|
|
||||||
[Pandoc markdown primer](http://johnmacfarlane.net/pandoc/demo/example9/pandocs-markdown.html)
|
[Pandoc markdown primer](http://johnmacfarlane.net/pandoc/demo/example9/pandocs-markdown.html)
|
||||||
|
|
||||||
[A thorough list of all markdown syntax](http://rmarkdown.rstudio.com/authoring_pandoc_markdown.html)
|
[A thorough list of all pandoc style markdown syntax](http://rmarkdown.rstudio.com/authoring_pandoc_markdown.html)
|
||||||
|
|
||||||
A very handy functionality of [Sublime Text](http://www.sublimetext.com) is its syntax highlighting for markdown. To enable such feature:
|
A very handy functionality of [Sublime Text](http://www.sublimetext.com) is its syntax highlighting for markdown. To enable such feature:
|
||||||
|
|
||||||
@ -198,8 +198,6 @@ Menu --> Syntax --> Markdown --> Markdown
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
[^1]: Not to mention that you can directly open and read this file "Lesson3.md" and see how it is written.
|
[^1]: Not to mention that you can directly open and read this file "Lesson3.md" and see how it is written.
|
||||||
|
|
||||||
[^2]: And I hope you will do so very soon!
|
[^2]: And I hope you will do so very soon!
|
||||||
|
|||||||
@ -10,7 +10,7 @@ Assuming that you have a basic knowledge of the Markdown language, in this lesso
|
|||||||
The goals of this lesson are:
|
The goals of this lesson are:
|
||||||
|
|
||||||
1. Acquire the basic understanding of how to employ pandoc to produce both HTML and EPUB output.
|
1. Acquire the basic understanding of how to employ pandoc to produce both HTML and EPUB output.
|
||||||
2. Acquire the basic knoeledge of how pandoc can be tailored to produce other types of output.
|
2. Acquire the basic knowledge of how pandoc can be tailored to produce other types of output.
|
||||||
|
|
||||||
### How
|
### How
|
||||||
|
|
||||||
@ -108,13 +108,13 @@ Also notice the
|
|||||||
|
|
||||||
--epub-cover-image=img/DSP6.png
|
--epub-cover-image=img/DSP6.png
|
||||||
|
|
||||||
which tells pandoc to use the specified image as cover for the EPUB.
|
which tells pandoc to use the specified image as cover page for the EPUB.
|
||||||
|
|
||||||
Finally the argument
|
Finally the argument
|
||||||
|
|
||||||
--toc
|
--toc
|
||||||
|
|
||||||
is a feature that instructs pandoc to generate a "Table Of Content" (toc) out of the various markdown Headings (symbol '#' [Lesson3](Lesson3.html)) present in the input files.
|
is a feature that instructs pandoc to generate a "Table Of Content" (toc) out of the various markdown Headings (symbol '#' [Lesson3](Lesson3.html)) present in the input file(s).
|
||||||
|
|
||||||
Let's now have a look at the EPUB output!
|
Let's now have a look at the EPUB output!
|
||||||
|
|
||||||
|
|||||||
153
Lesson5.html
Normal file
153
Lesson5.html
Normal file
@ -0,0 +1,153 @@
|
|||||||
|
<!DOCTYPE html>
|
||||||
|
<html>
|
||||||
|
<head>
|
||||||
|
<meta charset="utf-8">
|
||||||
|
<meta name="generator" content="pandoc">
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
||||||
|
<title></title>
|
||||||
|
<style type="text/css">code{white-space: pre;}</style>
|
||||||
|
<!--[if lt IE 9]>
|
||||||
|
<script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
|
||||||
|
<![endif]-->
|
||||||
|
<link rel="stylesheet" href="style/html5.css">
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<content>
|
||||||
|
<h1 id="bibliographer">Bibliographer</h1>
|
||||||
|
<p>Compiling and producing a bibliography is an central part in writing academic texts. One can derive an overview of a text solely by glimpsing its bibliography. Being able to reference work in a standard fashion is usually required for most publications. However, the practice of manually writing a bibliography may at times be quite laborious. Because bibliographic standards (citation styles) vary depending on disciplines, and because various formats can change depending on the type of work that is referenced, it is easy to make mistakes and omit to include information here and there. Yet since bibliographic citation styles each have clear rules, it is rather trivial to implement bibliographic reading and writing systems using computers. Such systems certainly exists and are used to (1) gather bibliographic information into a database and (2) to output information in text format following whichever bibliographic standard it is instructed to – in short, they are capable of reading and writing such peculiar type of text.</p>
|
||||||
|
<h3 id="goals">Goals</h3>
|
||||||
|
<p>This lessons introduces how to use software to produce bibliographies for texts written in the markdown format and using pandoc as document converter. <a href="https://www.zotero.org">Zotero</a> is the program which will be demonstrated, yet other programs having the functionality of producing <a href="http://www.bibtex.org">BibTeX</a> formatted bibliographies (.bib) may also be used in conjunction with pandoc.<a href="#fn1" class="footnoteRef" id="fnref1"><sup>1</sup></a></p>
|
||||||
|
<p>In short, the objectives of this lesson are:</p>
|
||||||
|
<ol style="list-style-type: decimal">
|
||||||
|
<li>Acquire the basic understanding on how to use Zotero in gathering bibliographical information.</li>
|
||||||
|
<li>Acquire the basic understanding on how to use Zotero to manage research references.</li>
|
||||||
|
<li>Learn how to compile and export a BibTeX bibliography (and possibly other formats) using Zotero.</li>
|
||||||
|
<li>Learn how to reference work within markdown and pandoc linked to information found in an exported BibTeX file (.bib).</li>
|
||||||
|
</ol>
|
||||||
|
<p>To install Zotero, please follow this <a href="https://www.zotero.org/download/">link</a> and install the <strong>Standalone version</strong> and related <strong>browser extension</strong>.</p>
|
||||||
|
<h3 id="how">How</h3>
|
||||||
|
<div class="figure">
|
||||||
|
<img src="img/z1.png" />
|
||||||
|
</div>
|
||||||
|
<p>Zotero brands itself as a "research organiser", meaning that it can collect and arrange academic research information under a simple interface. As you can see from the above image, in a nutshell, Zotero is a list of works (books, blog posts, chapters, journal articles, etc.) augmented with meta-data (notes, tags, relations, etc.). Each work has, of course, a formal description adequate to the type of work it represents. For example, a blog post has an URL while a journal article may have a volume identifier. The goal here is not to delve into the details of each formats relating to each types of work that can be represented in Zotero, but rather to make use of it and see how it proceeds in formalising types of work.</p>
|
||||||
|
<p>If it is the first time you ever used Zotero, your works list should be empty. Here are two common ways to populate your database:</p>
|
||||||
|
<p><strong>1. Add an Item by Identifier</strong></p>
|
||||||
|
<div class="figure">
|
||||||
|
<img src="img/z2.png" />
|
||||||
|
</div>
|
||||||
|
<p>Identifiers such as <a href="https://www.isbn-international.org">ISBN</a> and <a href="http://www.doi.org">DOI</a> can be utilised to add items to Zotero using the special "add" button on the top menu bar. Each of ISBN and DOI are unique identifiers that refer to a specific work. Such identifiers are common and can be found on websites as as Amazon or a library website or simply directly printed in a book.</p>
|
||||||
|
<p><strong>2. Add an Item with browser extension</strong></p>
|
||||||
|
<div class="figure">
|
||||||
|
<img src="img/z3.png" />
|
||||||
|
</div>
|
||||||
|
<p>When you installed the standalone version of Zotero, an extension (plug-in) for your web browser was also available to install. Using this plug-in on your browser helps you collect bibliographical items on the web. Depending on your type of browser (Safari, Chrome, Firefox) you should see a small Zotero icon near your address bar. When an web page presents an bibliographical item that can be added to Zotero, the icon will change aspect (or literately appear) signifying that when clicked, the item will automatically be inserted in Zotero's database. This comes very handy when browsing journals' websites for example. Adding an article to Zotero becomes very easy (as exemplified in the image above).</p>
|
||||||
|
<p>You should now be able to populate your Zotero database in a click.</p>
|
||||||
|
<div class="figure">
|
||||||
|
<img src="img/z4.png" />
|
||||||
|
</div>
|
||||||
|
<p>Compiling a bibliography and / or exporting Zotero items it is as easy. Zotero let's you select individual items that can be exported in various formats (such as BibTeX) or even compiled into a formatted bibliography.</p>
|
||||||
|
<div class="figure">
|
||||||
|
<img src="img/z5.png" />
|
||||||
|
</div>
|
||||||
|
<p>For the purpose of this lesson, exporting selected Zotero items in the BibTeX format allows for referencing work from a markdown text using pandoc. This should produce a .bib file with all the information needed to produce a bibliography. The content of the file should look like the following.</p>
|
||||||
|
<pre><code>@book{lazzarato_signs_2014,
|
||||||
|
address = {Los Angeles, CA},
|
||||||
|
series = {Semiotext(e) foreign agents series},
|
||||||
|
title = {Signs and machines: capitalism and the production of subjectivity},
|
||||||
|
isbn = {1584351306},
|
||||||
|
shorttitle = {Signs and machines},
|
||||||
|
publisher = {Semiotext(e)},
|
||||||
|
author = {Lazzarato, M.},
|
||||||
|
collaborator = {Jordan, Joshua David},
|
||||||
|
year = {2014},
|
||||||
|
keywords = {Capitalism, Philosophy, Subjectivity}
|
||||||
|
}
|
||||||
|
|
||||||
|
@book{kirschenbaum_mechanisms_2012,
|
||||||
|
address = {Cambridge, Mass.; London},
|
||||||
|
title = {Mechanisms: new media and the forensic imagination},
|
||||||
|
isbn = {9780262517409 026251740X},
|
||||||
|
shorttitle = {Mechanisms},
|
||||||
|
language = {English},
|
||||||
|
publisher = {MIT Press},
|
||||||
|
author = {Kirschenbaum, Matthew G.},
|
||||||
|
year = {2012},
|
||||||
|
keywords = {wwwriting}
|
||||||
|
}
|
||||||
|
|
||||||
|
@article{hansen_technics_2012,
|
||||||
|
title = {Technics {Beyond} the {Temporal} {Object}},
|
||||||
|
volume = {77},
|
||||||
|
doi = {10.3898/NEWF.77.03.2012},
|
||||||
|
number = {1},
|
||||||
|
journal = {New Formations},
|
||||||
|
author = {Hansen, Mark B. N.},
|
||||||
|
month = dec,
|
||||||
|
year = {2012},
|
||||||
|
keywords = {Computation, Erlebnis, Husserl, Microtemporal Experience, Sensibility, Technical Contamination, Temporal Object, Time-Consciousness},
|
||||||
|
pages = {44--62}
|
||||||
|
}
|
||||||
|
|
||||||
|
@book{guattari_soft_2009,
|
||||||
|
address = {Los Angeles : Cambridge, Mass},
|
||||||
|
series = {Semiotext(e) foreign agents series},
|
||||||
|
title = {Soft subversions: texts and interviews 1977-1985},
|
||||||
|
isbn = {9781584350736},
|
||||||
|
shorttitle = {Soft subversions},
|
||||||
|
publisher = {Semiotext(e) ; Distributed by the MIT Press},
|
||||||
|
author = {Guattari, Félix},
|
||||||
|
collaborator = {Lotringer, Sylvère},
|
||||||
|
year = {2009},
|
||||||
|
keywords = {20th century, Criticism, History, Psychoanalysis and literature, Psychological aspects}
|
||||||
|
}
|
||||||
|
|
||||||
|
@article{guattari_machines_1995,
|
||||||
|
series = {Journal of {Philosophy} and the {Visual} {Arts}},
|
||||||
|
title = {On {Machines}},
|
||||||
|
number = {6},
|
||||||
|
journal = {Complexity: architecture, art, philosophy},
|
||||||
|
author = {Guattari, Félix},
|
||||||
|
editor = {Benjamin, Andrew},
|
||||||
|
year = {1995},
|
||||||
|
pages = {96}
|
||||||
|
}</code></pre>
|
||||||
|
<p>The BibTeX is yet another text-based human-readable format that accounts for all information needed in producing a proper bibliography. As you can see, the information is a kind of median representation of works, meaning that it is not yet formatted according to particular standard citation style<a href="#fn2" class="footnoteRef" id="fnref2"><sup>2</sup></a>. Instead it arranges and orders each work's information in a standard structure with tags that can easily be parsed by a citation processor such as the one included in pandoc.</p>
|
||||||
|
<p>Citing with pandoc is straight forward.</p>
|
||||||
|
<p>Pandoc must first be instructed to link the generated .bib file with the specific markdown input file when creating an output document. This is done with a single parameter on the CLI. For example, the above BibTeX has been added to this site's <em>wwwrite.bib</em> and used to generated this page usign the following command:</p>
|
||||||
|
<pre><code>pandoc -s Lesson5.md --template=style/template.html5 -c style/html5.css --bibliography=wwwrite.bib -o Lesson5.html</code></pre>
|
||||||
|
<p>The important argument here being</p>
|
||||||
|
<pre><code>--bibliography=wwwrite.bib</code></pre>
|
||||||
|
<p>Now let's cite a source from the BibTeX.</p>
|
||||||
|
<p>For example, let's cite the work of Guattari who says "Since then, I have tried to nurture this machinic object, although I admit it is not something I control, rather it is a kind of core to which I am repeatedly led back."<span class="citation">(Guattari 1995)</span></p>
|
||||||
|
<p>In markdown, the citation is written:</p>
|
||||||
|
<pre><code>"Since then, I have tried to nurture this machinic object, although I admit it is not something I control, rather it is a kind of core to which I am repeatedly led back."[@guattari_machines_1995]</code></pre>
|
||||||
|
<p>Easy. To reference a work "in-text", one only has to specify an item's entry identifier form the .bib file (here "guattari_machines_1995") and prefix it with a '@' symbol and bracketed with both opening '[' and closing ']'. Not only pandoc will "signposts" the citation in-text (at the specific text location) but also formats and appends the citation's reference at the end of the output file (see the References section of this document).</p>
|
||||||
|
<p>You can also reference multiple authors such as the ones listed above <span class="citation">(Lazzarato 2014; Kirschenbaum 2012; Hansen 2012; Guattari 2009)</span> and look up their referenced works below.</p>
|
||||||
|
<pre><code>[@lazzarato_signs_2014; @kirschenbaum_mechanisms_2012; @hansen_technics_2012; @guattari_soft_2009]</code></pre>
|
||||||
|
<h3 id="extra">Extra</h3>
|
||||||
|
<p><a href="https://www.zotero.org/support/">Zotero Documentation</a></p>
|
||||||
|
<p><a href="http://johnmacfarlane.net/pandoc/README.html">Citation Section of Pandoc's User Guide</a></p>
|
||||||
|
<h3 id="references">References</h3>
|
||||||
|
<!-- Notes -->
|
||||||
|
|
||||||
|
<!-- CSL: Citation Style Language -->
|
||||||
|
|
||||||
|
<!-- Citation styles other than Pandoc's default Chicago (re: CSL file input) -->
|
||||||
|
|
||||||
|
<div class="references">
|
||||||
|
<p>Guattari, Félix. 1995. “On Machines.” Edited by Andrew Benjamin. <em>Complexity: architecture, Art, Philosophy, Journal of Philosophy and the Visual Arts</em>, no. 6: 96.</p>
|
||||||
|
<p>———. 2009. <em>Soft Subversions: texts and Interviews 1977-1985</em>. Semiotext(E) Foreign Agents Series. Los Angeles : Cambridge, Mass: Semiotext(e) ; Distributed by the MIT Press.</p>
|
||||||
|
<p>Hansen, Mark B. N. 2012. “Technics Beyond the Temporal Object.” <em>New Formations</em> 77 (1): 44–62. doi:<a href="http://dx.doi.org/10.3898/NEWF.77.03.2012">10.3898/NEWF.77.03.2012</a>.</p>
|
||||||
|
<p>Kirschenbaum, Matthew G. 2012. <em>Mechanisms: new Media and the Forensic Imagination</em>. Cambridge, Mass.; London: MIT Press.</p>
|
||||||
|
<p>Lazzarato, M. 2014. <em>Signs and Machines: capitalism and the Production of Subjectivity</em>. Semiotext(E) Foreign Agents Series. Los Angeles, CA: Semiotext(e).</p>
|
||||||
|
</div>
|
||||||
|
<div class="footnotes">
|
||||||
|
<hr />
|
||||||
|
<ol>
|
||||||
|
<li id="fn1"><p><a href="https://en.wikipedia.org/wiki/Mendeley">Mendeley</a>, <a href="http://endnote.com">EndNote</a>, <a href="http://www.refworks.com">RefWorks</a>, etc. - <a href="https://www.zotero.org">Zotero</a> is presented because it is an open source project developed by the academic community.<a href="#fnref1">↩</a></p></li>
|
||||||
|
<li id="fn2"><p>There is many citation styles used in various disciplines. For a list of styles according to their disciplines, please refer to <a href="http://subjectguides.library.american.edu/citation">this guide</a>.<a href="#fnref2">↩</a></p></li>
|
||||||
|
</ol>
|
||||||
|
</div>
|
||||||
|
</content>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
151
Lesson5.md
151
Lesson5.md
@ -1,9 +1,158 @@
|
|||||||
# Bibliographer
|
# Bibliographer
|
||||||
|
|
||||||
|
Compiling and producing a bibliography is an central part in writing academic texts. One can derive an overview of a text solely by glimpsing its bibliography. Being able to reference work in a standard fashion is usually required for most publications. However, the practice of manually writing a bibliography may at times be quite laborious. Because bibliographic standards (citation styles) vary depending on disciplines, and because various formats can change depending on the type of work that is referenced, it is easy to make mistakes and omit to include information here and there. Yet since bibliographic citation styles each have clear rules, it is rather trivial to implement bibliographic reading and writing systems using computers. Such systems certainly exists and are used to (1) gather bibliographic information into a database and (2) to output information in text format following whichever bibliographic standard it is instructed to – in short, they are capable of reading and writing such peculiar type of text.
|
||||||
|
|
||||||
### Goals
|
### Goals
|
||||||
|
|
||||||
### History
|
This lessons introduces how to use software to produce bibliographies for texts written in the markdown format and using pandoc as document converter. [Zotero](https://www.zotero.org) is the program which will be demonstrated, yet other programs having the functionality of producing [BibTeX](http://www.bibtex.org) formatted bibliographies (.bib) may also be used in conjunction with pandoc.[^1]
|
||||||
|
|
||||||
|
In short, the objectives of this lesson are:
|
||||||
|
|
||||||
|
1. Acquire the basic understanding on how to use Zotero in gathering bibliographical information.
|
||||||
|
2. Acquire the basic understanding on how to use Zotero to manage research references.
|
||||||
|
3. Learn how to compile and export a BibTeX bibliography (and possibly other formats) using Zotero.
|
||||||
|
4. Learn how to reference work within markdown and pandoc linked to information found in an exported BibTeX file (.bib).
|
||||||
|
|
||||||
|
To install Zotero, please follow this [link](https://www.zotero.org/download/) and install the __Standalone version__ and related __browser extension__.
|
||||||
|
|
||||||
### How
|
### How
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
Zotero brands itself as a "research organiser", meaning that it can collect and arrange academic research information under a simple interface. As you can see from the above image, in a nutshell, Zotero is a list of works (books, blog posts, chapters, journal articles, etc.) augmented with meta-data (notes, tags, relations, etc.). Each work has, of course, a formal description adequate to the type of work it represents. For example, a blog post has an URL while a journal article may have a volume identifier. The goal here is not to delve into the details of each formats relating to each types of work that can be represented in Zotero, but rather to make use of it and see how it proceeds in formalising types of work.
|
||||||
|
|
||||||
|
If it is the first time you ever used Zotero, your works list should be empty. Here are two common ways to populate your database:
|
||||||
|
|
||||||
|
__1. Add an Item by Identifier__
|
||||||
|
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
Identifiers such as [ISBN](https://www.isbn-international.org) and [DOI](http://www.doi.org) can be utilised to add items to Zotero using the special "add" button on the top menu bar. Each of ISBN and DOI are unique identifiers that refer to a specific work. Such identifiers are common and can be found on websites as as Amazon or a library website or simply directly printed in a book.
|
||||||
|
|
||||||
|
__2. Add an Item with browser extension__
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
When you installed the standalone version of Zotero, an extension (plug-in) for your web browser was also available to install. Using this plug-in on your browser helps you collect bibliographical items on the web. Depending on your type of browser (Safari, Chrome, Firefox) you should see a small Zotero icon near your address bar. When an web page presents an bibliographical item that can be added to Zotero, the icon will change aspect (or literately appear) signifying that when clicked, the item will automatically be inserted in Zotero's database. This comes very handy when browsing journals' websites for example. Adding an article to Zotero becomes very easy (as exemplified in the image above).
|
||||||
|
|
||||||
|
You should now be able to populate your Zotero database in a click.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
Compiling a bibliography and / or exporting Zotero items it is as easy. Zotero let's you select individual items that can be exported in various formats (such as BibTeX) or even compiled into a formatted bibliography.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
For the purpose of this lesson, exporting selected Zotero items in the BibTeX format allows for referencing work from a markdown text using pandoc. This should produce a .bib file with all the information needed to produce a bibliography. The content of the file should look like the following.
|
||||||
|
|
||||||
|
~~~~
|
||||||
|
@book{lazzarato_signs_2014,
|
||||||
|
address = {Los Angeles, CA},
|
||||||
|
series = {Semiotext(e) foreign agents series},
|
||||||
|
title = {Signs and machines: capitalism and the production of subjectivity},
|
||||||
|
isbn = {1584351306},
|
||||||
|
shorttitle = {Signs and machines},
|
||||||
|
publisher = {Semiotext(e)},
|
||||||
|
author = {Lazzarato, M.},
|
||||||
|
collaborator = {Jordan, Joshua David},
|
||||||
|
year = {2014},
|
||||||
|
keywords = {Capitalism, Philosophy, Subjectivity}
|
||||||
|
}
|
||||||
|
|
||||||
|
@book{kirschenbaum_mechanisms_2012,
|
||||||
|
address = {Cambridge, Mass.; London},
|
||||||
|
title = {Mechanisms: new media and the forensic imagination},
|
||||||
|
isbn = {9780262517409 026251740X},
|
||||||
|
shorttitle = {Mechanisms},
|
||||||
|
language = {English},
|
||||||
|
publisher = {MIT Press},
|
||||||
|
author = {Kirschenbaum, Matthew G.},
|
||||||
|
year = {2012},
|
||||||
|
keywords = {wwwriting}
|
||||||
|
}
|
||||||
|
|
||||||
|
@article{hansen_technics_2012,
|
||||||
|
title = {Technics {Beyond} the {Temporal} {Object}},
|
||||||
|
volume = {77},
|
||||||
|
doi = {10.3898/NEWF.77.03.2012},
|
||||||
|
number = {1},
|
||||||
|
journal = {New Formations},
|
||||||
|
author = {Hansen, Mark B. N.},
|
||||||
|
month = dec,
|
||||||
|
year = {2012},
|
||||||
|
keywords = {Computation, Erlebnis, Husserl, Microtemporal Experience, Sensibility, Technical Contamination, Temporal Object, Time-Consciousness},
|
||||||
|
pages = {44--62}
|
||||||
|
}
|
||||||
|
|
||||||
|
@book{guattari_soft_2009,
|
||||||
|
address = {Los Angeles : Cambridge, Mass},
|
||||||
|
series = {Semiotext(e) foreign agents series},
|
||||||
|
title = {Soft subversions: texts and interviews 1977-1985},
|
||||||
|
isbn = {9781584350736},
|
||||||
|
shorttitle = {Soft subversions},
|
||||||
|
publisher = {Semiotext(e) ; Distributed by the MIT Press},
|
||||||
|
author = {Guattari, Félix},
|
||||||
|
collaborator = {Lotringer, Sylvère},
|
||||||
|
year = {2009},
|
||||||
|
keywords = {20th century, Criticism, History, Psychoanalysis and literature, Psychological aspects}
|
||||||
|
}
|
||||||
|
|
||||||
|
@article{guattari_machines_1995,
|
||||||
|
series = {Journal of {Philosophy} and the {Visual} {Arts}},
|
||||||
|
title = {On {Machines}},
|
||||||
|
number = {6},
|
||||||
|
journal = {Complexity: architecture, art, philosophy},
|
||||||
|
author = {Guattari, Félix},
|
||||||
|
editor = {Benjamin, Andrew},
|
||||||
|
year = {1995},
|
||||||
|
pages = {96}
|
||||||
|
}
|
||||||
|
~~~~
|
||||||
|
|
||||||
|
The BibTeX is yet another text-based human-readable format that accounts for all information needed in producing a proper bibliography. As you can see, the information is a kind of median representation of works, meaning that it is not yet formatted according to particular standard citation style[^2]. Instead it arranges and orders each work's information in a standard structure with tags that can easily be parsed by a citation processor such as the one included in pandoc.
|
||||||
|
|
||||||
|
Citing with pandoc is straight forward.
|
||||||
|
|
||||||
|
Pandoc must first be instructed to link the generated .bib file with the specific markdown input file when creating an output document. This is done with a single parameter on the CLI. For example, the above BibTeX has been added to this site's _wwwrite.bib_ and used to generated this page usign the following command:
|
||||||
|
|
||||||
|
pandoc -s Lesson5.md --template=style/template.html5 -c style/html5.css --bibliography=wwwrite.bib -o Lesson5.html
|
||||||
|
|
||||||
|
The important argument here being
|
||||||
|
|
||||||
|
--bibliography=wwwrite.bib
|
||||||
|
|
||||||
|
|
||||||
|
Now let's cite a source from the BibTeX.
|
||||||
|
|
||||||
|
For example, let's cite the work of Guattari who says "Since then, I have tried to nurture this machinic object, although I admit it is not something I control, rather it is a kind of core to which I am repeatedly led back."[@guattari_machines_1995]
|
||||||
|
|
||||||
|
In markdown, the citation is written:
|
||||||
|
|
||||||
|
"Since then, I have tried to nurture this machinic object, although I admit it is not something I control, rather it is a kind of core to which I am repeatedly led back."[@guattari_machines_1995]
|
||||||
|
|
||||||
|
Easy. To reference a work "in-text", one only has to specify an item's entry identifier form the .bib file (here "guattari_machines_1995") and prefix it with a '@' symbol and bracketed with both opening '[' and closing ']'. Not only pandoc will "signposts" the citation in-text (at the specific text location) but also formats and appends the citation's reference at the end of the output file (see the References section of this document).
|
||||||
|
|
||||||
|
You can also reference multiple authors such as the ones listed above [@lazzarato_signs_2014; @kirschenbaum_mechanisms_2012; @hansen_technics_2012; @guattari_soft_2009] and look up their referenced works below.
|
||||||
|
|
||||||
|
[@lazzarato_signs_2014; @kirschenbaum_mechanisms_2012; @hansen_technics_2012; @guattari_soft_2009]
|
||||||
|
|
||||||
|
|
||||||
### Extra
|
### Extra
|
||||||
|
|
||||||
|
[Zotero Documentation](https://www.zotero.org/support/)
|
||||||
|
|
||||||
|
[Citation Section of Pandoc's User Guide](http://johnmacfarlane.net/pandoc/README.html)
|
||||||
|
|
||||||
|
### References
|
||||||
|
|
||||||
|
|
||||||
|
[^1]: [Mendeley](https://en.wikipedia.org/wiki/Mendeley), [EndNote](http://endnote.com), [RefWorks](http://www.refworks.com), etc. - [Zotero](https://www.zotero.org) is presented because it is an open source project developed by the academic community.
|
||||||
|
|
||||||
|
[^2]: There is many citation styles used in various disciplines. For a list of styles according to their disciplines, please refer to [this guide](http://subjectguides.library.american.edu/citation).
|
||||||
|
|
||||||
|
<!-- Notes -->
|
||||||
|
|
||||||
|
<!-- CSL: Citation Style Language -->
|
||||||
|
|
||||||
|
<!-- Citation styles other than Pandoc's default Chicago (re: CSL file input) -->
|
||||||
BIN
img/z1.png
Normal file
BIN
img/z1.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 241 KiB |
BIN
img/z2.png
Normal file
BIN
img/z2.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 186 KiB |
BIN
img/z3.png
Normal file
BIN
img/z3.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 204 KiB |
BIN
img/z4.png
Normal file
BIN
img/z4.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 42 KiB |
BIN
img/z5.png
Normal file
BIN
img/z5.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 166 KiB |
@ -41,7 +41,7 @@
|
|||||||
<p>Introduces a markup language (<a href="http://daringfireball.net/projects/markdown/">Markdown</a>) that is used to format and annotate text.</p></li>
|
<p>Introduces a markup language (<a href="http://daringfireball.net/projects/markdown/">Markdown</a>) that is used to format and annotate text.</p></li>
|
||||||
<li><p><a href="Lesson4.html">Lesson 4: (Text/Document) Processor</a></p>
|
<li><p><a href="Lesson4.html">Lesson 4: (Text/Document) Processor</a></p>
|
||||||
<p>Introduces a text / document processor (<a href="http://johnmacfarlane.net/pandoc/">Pandoc</a>) which converts files written in a format into another.</p></li>
|
<p>Introduces a text / document processor (<a href="http://johnmacfarlane.net/pandoc/">Pandoc</a>) which converts files written in a format into another.</p></li>
|
||||||
<li><p><a href="/">Lesson 5: Bibliographer</a></p>
|
<li><p><a href="Lesson5.html">Lesson 5: Bibliographer</a></p>
|
||||||
<p>Looks at how to compile and maintain a bibliography using open source software (<a href="https://www.zotero.org">Zotero</a>) and export references into a document.</p></li>
|
<p>Looks at how to compile and maintain a bibliography using open source software (<a href="https://www.zotero.org">Zotero</a>) and export references into a document.</p></li>
|
||||||
<li><p><a href="/">Lesson 6: Styling</a></p>
|
<li><p><a href="/">Lesson 6: Styling</a></p>
|
||||||
<p>Discuss how to style (colour, margins, cover image, etc.) a given output from the text / document processor</p></li>
|
<p>Discuss how to style (colour, margins, cover image, etc.) a given output from the text / document processor</p></li>
|
||||||
|
|||||||
2
index.md
2
index.md
@ -44,7 +44,7 @@ The current site is segmented in six lessons covering the (very) basics of writi
|
|||||||
|
|
||||||
Introduces a text / document processor ([Pandoc](http://johnmacfarlane.net/pandoc/)) which converts files written in a format into another.
|
Introduces a text / document processor ([Pandoc](http://johnmacfarlane.net/pandoc/)) which converts files written in a format into another.
|
||||||
|
|
||||||
* [Lesson 5: Bibliographer](/)
|
* [Lesson 5: Bibliographer](Lesson5.html)
|
||||||
|
|
||||||
Looks at how to compile and maintain a bibliography using open source software ([Zotero](https://www.zotero.org)) and export references into a document.
|
Looks at how to compile and maintain a bibliography using open source software ([Zotero](https://www.zotero.org)) and export references into a document.
|
||||||
|
|
||||||
|
|||||||
62
wwwrite.bib
62
wwwrite.bib
@ -86,4 +86,66 @@
|
|||||||
keywords = {wwwriting},
|
keywords = {wwwriting},
|
||||||
pages = {87--101},
|
pages = {87--101},
|
||||||
file = {IEEE Xplore Abstract Record:/Users/gauthiier/docs/~~~/texts/_systems/zozo/storage/SWZK9CWM/articleDetails.html:text/html}
|
file = {IEEE Xplore Abstract Record:/Users/gauthiier/docs/~~~/texts/_systems/zozo/storage/SWZK9CWM/articleDetails.html:text/html}
|
||||||
|
}
|
||||||
|
|
||||||
|
@book{lazzarato_signs_2014,
|
||||||
|
address = {Los Angeles, CA},
|
||||||
|
series = {Semiotext(e) foreign agents series},
|
||||||
|
title = {Signs and machines: capitalism and the production of subjectivity},
|
||||||
|
isbn = {1584351306},
|
||||||
|
shorttitle = {Signs and machines},
|
||||||
|
publisher = {Semiotext(e)},
|
||||||
|
author = {Lazzarato, M.},
|
||||||
|
collaborator = {Jordan, Joshua David},
|
||||||
|
year = {2014},
|
||||||
|
keywords = {Capitalism, Philosophy, Subjectivity}
|
||||||
|
}
|
||||||
|
|
||||||
|
@book{kirschenbaum_mechanisms:_2012,
|
||||||
|
address = {Cambridge, Mass.; London},
|
||||||
|
title = {Mechanisms: new media and the forensic imagination},
|
||||||
|
isbn = {9780262517409 026251740X},
|
||||||
|
shorttitle = {Mechanisms},
|
||||||
|
language = {English},
|
||||||
|
publisher = {MIT Press},
|
||||||
|
author = {Kirschenbaum, Matthew G.},
|
||||||
|
year = {2012},
|
||||||
|
keywords = {wwwriting}
|
||||||
|
}
|
||||||
|
|
||||||
|
@article{hansen_technics_2012,
|
||||||
|
title = {Technics {Beyond} the {Temporal} {Object}},
|
||||||
|
volume = {77},
|
||||||
|
doi = {10.3898/NEWF.77.03.2012},
|
||||||
|
number = {1},
|
||||||
|
journal = {New Formations},
|
||||||
|
author = {Hansen, Mark B. N.},
|
||||||
|
month = dec,
|
||||||
|
year = {2012},
|
||||||
|
keywords = {Computation, Erlebnis, Husserl, Microtemporal Experience, Sensibility, Technical Contamination, Temporal Object, Time-Consciousness},
|
||||||
|
pages = {44--62}
|
||||||
|
}
|
||||||
|
|
||||||
|
@book{guattari_soft_2009,
|
||||||
|
address = {Los Angeles : Cambridge, Mass},
|
||||||
|
series = {Semiotext(e) foreign agents series},
|
||||||
|
title = {Soft subversions: texts and interviews 1977-1985},
|
||||||
|
isbn = {9781584350736},
|
||||||
|
shorttitle = {Soft subversions},
|
||||||
|
publisher = {Semiotext(e) ; Distributed by the MIT Press},
|
||||||
|
author = {Guattari, Félix},
|
||||||
|
collaborator = {Lotringer, Sylvère},
|
||||||
|
year = {2009},
|
||||||
|
keywords = {20th century, Criticism, History, Psychoanalysis and literature, Psychological aspects}
|
||||||
|
}
|
||||||
|
|
||||||
|
@article{guattari_machines_1995,
|
||||||
|
series = {Journal of {Philosophy} and the {Visual} {Arts}},
|
||||||
|
title = {On {Machines}},
|
||||||
|
number = {6},
|
||||||
|
journal = {Complexity: architecture, art, philosophy},
|
||||||
|
author = {Guattari, Félix},
|
||||||
|
editor = {Benjamin, Andrew},
|
||||||
|
year = {1995},
|
||||||
|
pages = {96}
|
||||||
}
|
}
|
||||||
Loading…
x
Reference in New Issue
Block a user