Editing Publisher:Bibliography

[[User:Andre|Andre]] ([[User talk: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 ==

[https://www.zotero.org/ 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.

<source lang="bibtex">
@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},
}
</source>
'''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 <code>[@referenceID]</code>, such as <code>[@garrish_epub_2013]</code>. If you want to cite

A &quot;-&quot; before the &quot;@&quot; 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:
<pre>
---
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
</pre>
Pandoc command: pandoc -f markdown -t html5 test_essay.md --bibliography bibliography.bib -s -o test_essay.html

Output: <source lang="html4strict">
<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>
</source>
== 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 <code>--csl=sytlefile.csl</code>.

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

* create a bibliography - https://help.libreoffice.org/Writer/Creating_a_Bibliography
* insert a reference - https://help.libreoffice.org/Writer/Insert_Bibliography_Entry
* insert a bibliography - Insert &gt; Indexes and Tables &gt; Indexes and Tables - Type: Bibliography; To get numbers instead of ID keys check Numbered Entries. The Bibliography can be updated, with the entries by Mouse Right Clicking over the Bibliography: Update Index/Table



== 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]