@@ -1325,9 +1325,9 @@ and ConTeXt.
1325Citations
1325Citations
1326---------
1326---------
1328−Pandoc can automatically generate citations and a bibliography in
1328+Pandoc can automatically generate citations and a bibliography in a number of
1329−a number of styles. In order to use this feature, you will need
1329+styles (using Andrea Rossato's `hs-citeproc`). In order to use this feature,
1330−a bibliographic database in one of the following formats:
1330+you will need a bibliographic database in one of the following formats:
1332 Format File extension
1332 Format File extension
1333 ------------ --------------
1333 ------------ --------------
@@ -1342,12 +1342,48 @@ a bibliographic database in one of the following formats:
1342 Copac .copac
1342 Copac .copac
1343 JSON citeproc .json
1343 JSON citeproc .json
1345−- also CSL - tho default -
1345+You will need to specify the bibliography file using the `--bibliography`
1346+command-line option (which may be repeated if you have several
1347−- how to write citations - citation syntax -
1349+By default, pandoc will use a Chicago author-date format for citations
1350+and references. To use another style, you will need to use the
1351+`--csl` option to specify a [CSL] 1.0 style file. A primer on
1352+creating and modifying CSL styles can be found at
1353+<http://citationstyles.org/downloads/primer.html>.
1349−- where the biblio will be placed -
1355+Citations go inside square brackets and are separated by semicolons.
1356+Each citation must have a key, composed of '@' + the citation
1357+identifier from the database, and may optionally have a prefix,
1358+a locator, and a suffix. Here are some examples:
1360+ Blah blah [see @doe99, pp. 33-35; also @smith04, ch. 1].
1362+ Blah blah [@doe99, pp. 33-35, 38-39 and *passim*].
1364+ Blah blah [@smith04; @doe99].
1366+A minus sign (`-`) before the `@` will suppress mention of
1367+the author in the citation. This can be useful when the
1368+author is already mentioned in the text:
1370+ Smith says blah [-@smith04].
1372+You can also write an in-text citation, as follows:
1374+ @smith04 says blah.
1376+ @smith04 [p. 33] says blah.
1378+If the style calls for a list of works cited, it will be placed
1379+at the end of the document. Normally, you will want to end your
1380+document with an appropriate header:
1386+The bibliography will be inserted after this header.
1352Producing HTML slide shows with Pandoc
1388Producing HTML slide shows with Pandoc
1353======================================
1389======================================