latex-wochenende/slides/literature.en.md

@slide(layout=chapter-slide)

@number
12

@title
Reference management


@slide(layout=preview-only)

@preview
![Citing in Alpha style (`[style=alphabetic,backend=biber]`)](svg/literature/bibtex-alpha-example-crop.svg){.large .thin-padding}


@slide(layout=preview-only)

@preview
![Citing in IEEE style (`[style=ieee,backend=biber]`)](svg/literature/bibtex-ieee-example-crop.svg){.large .thin-padding}


@slide(layout=content-only)

@title
What do we need?

@content
*	a **bibliography file** (hereafter `.bib` file) for storing references
*	**BibLaTeX** as an interface between the references and LaTeX


@slide(layout=wide-content)

@title
What is this mysterious `.bib` file?

@content
*	collection of references in BibTeX format¹
*	example content:

``` {.hljs .lang-tex}
@article{turing1990, % the type of the document and an identifier for the \cite command
    title={The chemical basis of morphogenesis}, % information
    author={Turing, Alan Mathison},              % about
    journal={Bulletin of mathematical biology},  % the
    volume={52},                                 % literature
    pages={153--197},                            % work
    date={1990},                                 % follows
    publisher={Springer}                         % …
}
```

[1] **Note**: Even though we are working with BibLaTeX, our bibliography file adheres to the conventions of BibTeX, which is an alternative program. The name has been established for all kinds of things related to LaTeX citations. This is similar to the way we refer to online search by the name of one popular search engine.

@slide(layout=content-only)

@title
BibLaTeX

@content
* Package for creating and designing bibliographies
* Uses **biber** as a backend

<div class="box warning">
**Some well-meaning advice**

You want the references to look professional?

Trust BibLaTeX’s default citation styles!

This conversely means: Avoid fiddling around with styles manually.
</div>


@slide(layout=content-only)

@title
What you need

@content

* Include the `BibLaTeX` package in the preamble:

``` {.lang-tex .hljs}
\usepackage[style=<citation-style>, 
backend=biber]{biblatex}
```

* Include the `.bib`-file in the preamble:

``` {.lang-tex .hljs}
\addbibresource{<bib-file>}
```

* Generate the bibliography:

``` {.lang-tex .hljs}
\printbibliography
```

* `BibLaTeX` documentation: [Link](https://ctan.org/pkg/biblatex?lang=de)
* `BibLaTeX` cheat sheet: [Link](https://tug.ctan.org/info/biblatex-cheatsheet/biblatex-cheatsheet.pdf)



@slide(layout=content-only)

@title
Changing the citation style

@content
* Built-in styles for direct use (z.B. `authoryear`, `numeric`, `alphabetic`)
* additionally options for configurations and other styles (z.B. `apa`, `ieee`, `chicago-authordate`)

``` {.lang-tex .hljs}
\usepackage[style=numeric, citestyle=ieee, 
backend=biber]{biblatex}
```

>	Two things are infinite: the universe and&nbsp;the&nbsp;assortment of citation styles.<cite>Unknown</cite>

@slide(layout=content-only)

@title
Sorting entries

@content

``` {.lang-tex .hljs}
\usepackage[style=numeric, citestyle=ieee, 
sorting=nty, backend=biber]{biblatex}
```
<table>
  <tr>
	<th>Code</th>
	<th>Description</th>
  </tr>
  <tr>
	<td>nty</td>
	<td>Name, Title, Year</td>
  </tr>
  <tr>
	<td>nyt</td>
	<td>Name, Year, Title</td>
  </tr>
  <tr>
	<td>nyvt</td>
	<td>Name, Year, Volume, Title</td>
  </tr>
    <tr>
	<td>ydtn</td>
	<td>Year (descending), Title, Name</td>
  </tr>
</table>


@slide(layout=content-only)

@title
How is it used?

@content
BibLaTeX adds some citation commands to LaTeX. In addition, we need the `natbib` package.

<table>
  <tr>
	<th>Code</th>
	<th>Description</th>
  </tr>
  <tr>
	<td>`\parencite{turing1990}`</td>
	<td>[Turing, 1990]</td>
  </tr>
  <tr class="fragment">
	<td>`\textcite{turing1990}`</td>
	<td>Turing (1990)</td>
  </tr>
  <tr class="fragment">
	<td>`\textcite[p. 159]`<br />`{turing1990}`</td>
	<td>Turing (1990, p. 159)</td>
  </tr>
</table>

++ Citing with additional text:<br/>`\cite[<prefix>][<suffix>]{<source>}`

@slide(layout=content-and-preview)

@title
An example

@content
``` {.lang-tex .hljs}
\usepackage[style=authoryear, 
maxnames=3, 
minnames=1, 
nohashothers=true, 
dashed=false, 
url=false, 
backend=biber]{biblatex}
```

An exemplary reference in the citation style above:

``` {.lang-tex .hljs}
… in parentheses \parencite{thatcher2002} 
or simply as \textcite{thatcher2002} …
```

@preview
![](svg/literature/example_citation_en-crop.svg)


@slide(layout=preview-only)

@preview
![Finding ready-made BibTeX entries – University of Bamberg Library](svg/literature/bamberg_catalogue_bibtex.png){.large}


@slide(layout=preview-only)

@preview
![Finding ready-made BibTeX entries – Google Scholar](svg/literature/google_bibtex1.jpg){.large}


@slide(layout=preview-only)

@preview
![Finding ready-made BibTeX entries – Google Scholar](svg/literature/google_bibtex2.jpg){.large}


@slide(layout=preview-only)

@preview
![Finding ready-made BibTeX entries – dblp.org](svg/literature/dblp.jpg){.large}


@slide(layout=wide-task)

@task-number
12

@title

Creating and inserting references

@content
* Create a new BibTeX file called `literature.bib` in the `exercises/literature` folder.
*	Use Google Scholar or dblp.org to retrieve BibTeX references for the following $\LaTeX$ handbooks:
	*	Dilip Datta (2017): $\LaTeX$ in 24 Hours. A Practical Guide for Scientific Writing.
	*	Frank Mittelbach / Michel Goossens (2010): Der $\LaTeX$-Begleiter.
* Add the BibTeX entries to the BibTeX file.
* Assign unique and meaningful BibTeX keys.
* Add the bibliography file to the project's preamble.
* Make use of the `alphabetic` bibliography style.
* Cite the two handbooks in the file `exercises/literature/literature.tex`.
* Ensure that the bibliography is listed.

:::{.box .warning}
**Not**: If the compilation fails, it may be helpful to remove all temporary files (`….aux/bbl/blg/loc/out/pdf/soc/toc`) and to compile again.
:::

@slide(layout=extra-content-only)

@title
The University Library recommends …

@content
* reference management software (esp. **[Zotero](https://www.zotero.org/)**) help to build a literature database, store quotations, and organize one's own notes
* ++ support available from the **library's own reference management team**: literaturverwaltung.ub@uni-bamberg.de
* ++ in Zotero: activate the plugin **["Better BibTeX"](https://retorque.re/zotero-better-bibtex/)** (applies also if you are using `biblatex`)

:::{.box .warning .fragment}
**💡 Further information**

There are plenty of resources about the setup available online.
:::


@slide(layout=extra-content-only)

@title
Setup for Zotero with Better BibTeX

@content
* **Zotero**: 
  * install **["Better BibTeX"](https://retorque.re/zotero-better-bibtex/)** 
  * Tools > Plugins > enable `Better BibTeX for Zotero`
  * export your library from Zotero, set `Better BibLaTex` as format, and set `keep updated` to true
  * save the library in your LaTeX project archive and use it as the `.bib`-file
* **TeXstudio**: 
  * Bibliography > set type to `BibLaTeX`
  * Options > Configure TeXstudio > Generate > set standard for bibliography to `Biber`

@slide(layout=extra-content-only)

@title
Demo: Referencing with Zotero and BibLaTeX

@content
* Hint: **["Zotero Connector for Firefox"](https://www.zotero.org/download/)** for easy import of BibTeX entries
* First set up Zotero with Better BibTeX (see previous slide)
* Open the reference source and click on the Firefox extensions
* Run Zotero Connector and import the BibTeX entry into Zotero
* Reference the source as usual according to the procedures already described