@@ -1325,9 +1325,9 @@ and ConTeXt.
13251325Citations
13261326---------
13271327
1328−Pandoc can automatically generate citations and a bibliography in
1329−a number of styles. In order to use this feature, you will need
1330−a bibliographic database in one of the following formats:
1328+Pandoc can automatically generate citations and a bibliography in a number of
1329+styles (using Andrea Rossato's `hs-citeproc`). In order to use this feature,
1330+you will need a bibliographic database in one of the following formats:
13311331
13321332 Format File extension
13331333 ------------ --------------
@@ -1342,12 +1342,48 @@ a bibliographic database in one of the following formats:
13421342 Copac .copac
13431343 JSON citeproc .json
13441344
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+bibliographies).
13461348
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>.
13481354
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:
13501359
1360+ Blah blah [see @doe99, pp. 33-35; also @smith04, ch. 1].
1361+
1362+ Blah blah [@doe99, pp. 33-35, 38-39 and *passim*].
1363+
1364+ Blah blah [@smith04; @doe99].
1365+
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:
1369+
1370+ Smith says blah [-@smith04].
1371+
1372+You can also write an in-text citation, as follows:
1373+
1374+ @smith04 says blah.
1375+
1376+ @smith04 [p. 33] says blah.
1377+
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:
1381+
1382+ last paragraph...
1383+
1384+ # References
1385+
1386+The bibliography will be inserted after this header.
13511387
13521388Producing HTML slide shows with Pandoc
13531389======================================