Difference between revisions of "Publisher:Bibliography"

From Publication Station
 
m (1 revision)
 
(No difference)

Latest revision as of 10:33, 5 June 2015

Andre (talk) 20:47, 14 April 2015 (CEST) is working on this

Aims

  • facilitate the formating of bibliographies
  • managing large bibliographies
  • include them in docx, markdown and Mediawiki
  • use zotero (common tool)
  • use bibtext

Technologies

Zotero

Zotero is a tool for collect, organize, cite, and share your research sources. It can either exist as browser plugin or stand-alone program. One of its killer features is the possibility to add web resources, by clicking on the icon that appears on the browser url box.

Zotero stored items can be exported into different formats BibTex, Wikipedia Citation Templates, Evernote Export, etc; Or made into a Bibligraphy or citations into different styles (Chicago, Harvard).

BibTex/BibLaTex

Is a reference management software for formatting lists of references and it its use if often related to the use of LaTex (document preparation tool), but it is not exclusive to it.

BibTeX uses a plain-text file format (.bib) for lists of bibliography items. A .bib consists of a list of reference entries, each with several possible field the user might ever hope to use.

@book{mcguire_book:_2012, 
title = {Book: {A} {Futurist}'s {Manifesto}}, 
volume = {1}, 
isbn = {978-14-4930-559-8}, 
publisher = {O'Reilly Media}, 
editor = {McGuire, Hugh and O'Leary, Brian}, 
month = nov, 
year = {2012},
}

What is the purpose to use BibTex? BibTex can be include in Pandoc conversions to form a Bibliograhy and references.

How?

Bibliography and Reference in Pandoc + Markdown

In a Markdown file a (.bib, .mods, EndNote XML, or JSON citeproc) bibliography file can be associated with a Markdown file, by indicating it in the conversion command. Only the bibliography references which are reference in the text will be turned into references at the end of the converted text.

To cite a reference place the id of that reference in .bib file inside [@referenceID], such as [@garrish_epub_2013]. If you want to cite

A "-" before the "@" will suppress mention of the author in the citation. This can be useful when the author is already mentioned in the text:

To include reference entries which are not cited , you can define a dummy nocite metadata field and put the citations there.

Markdown source:

---
nocite: |
    @felix_kapul_pictorial_2009
...

# Test essay
BibTeX [@garrish_epub_2013] formats bibliographic items according to a style file, typically by generating TeX or LaTeX formatting commands[-@garrish_epub_2013]. However, style files for generating HTML output also exist. BibTeX style files, for which the suffix .bst is common, are written in a simple, stack-based programming language (dubbed "BibTeX Anonymous Forth-Like Language", or "BAFLL", by Drew McDermott) that describes how bibliography items should be formatted. There are some packages which can generate[@mcguire_book:_2012; @collective_print_2014] .bst files automatically (like custom-bib or Bib-it). [@mcguire_book:_2012, pp. 33-35]

# References

Pandoc command: pandoc -f markdown -t html5 test_essay.md --bibliography bibliography.bib -s -o test_essay.html

Output:

<div class="references">

<h1 id="references" class="unnumbered">
References
</h1>
<p>
Collective, D. P. T., Marc de Bruijn, Liz Castro, Florian Cramer, Joost Kircz, Silvio Lorusso, Michael Murtaugh, Pia Pol, Miriam Rasch, and Margreet Riphagen. 2014. <em>From Print to Ebooks: A Hybrid Publishing Toolkit for the Arts</em>. Vol. 1. Institute of Network Cultures.
</p>
<p>
Garrish, Matt, and Markus Gylling. 2013. <em>EPUB 3 Best Practices</em>. Vol. 1. O’Reilly Media, Inc.
</p>
<p>
McGuire, Hugh, and Brian O’Leary, eds. 2012. <em>Book: A Futurist’s Manifesto</em>. Vol. 1. O’Reilly Media.
</p>
<p>
“Pictorial Webster’s Inspiration to Completion-by John Carrera.” 2009. <a href="https://www.youtube.com/watch?v=vj4zL4UN0Gc&amp;feature=youtube_gdata_player" class="uri">https://www.youtube.com/watch?v=vj4zL4UN0Gc&amp;feature=youtube_gdata_player</a>.
</p>

</div>

Citation and Reference Style

By default, Pandoc will use a Chicago author-date format for citations and references. To use another style, you will need to specify a CSL 1.0 style file with Pandoc argument --csl=sytlefile.csl.

A repository of CSL styles can be found at https://github.com/citation-style-language/styles.

What style will be used in the Publication Station



Text Processors and Bibliographies

Libre Office

(All this might be deprecated with Zotero integration for LibreOffice )

https://wiki.documentfoundation.org/Referencing_Systems_in_LibreOffice


Zotero integration for LibreOffice

Need to use LibreOffice integration https://download.zotero.org/integration/Zotero-LibreOffice-Plugin-3.5.9.xpi to achieve desired result

Export a bibliography from Libre Office to Zotero or Bibtex ???


.... The BIG issue seems to be that references and bibliography in LibreOffice/MS Word are this monolytical animals, that exist only in their words. A conversion from a .docx to markdown will translate the reference literaly, rather than symbolically.

Is there anyway of symbolically translating the references to Markdown? Maybe, if the .docx reference key is something like [@refkey]