Doesn’t work with pandoc-citeproc

[dbaynard]

Ignoring the metadata from included files means the references aren’t included in the final document.

Inserting references

This is the case both for

• Explicit references
• A reference to a bibliography

See the manual for instructions on pandoc-citeproc.

Inserting bibliography

Inserting a bibliography is a separate concern. There are two options,

1. Single combined bibliography
2. Per-include bibliographies

There are difficulties, especially if the individual included files are to work on their own, too.

• pandoc-include needs to handle the reference-section-title field somehow. Likewise, if the last part of a document is a section header (which pandoc-citeproc will treat as a
• If an header element is present with an id of refs the corresponding section will be used for the bibliography; multiple bibliographies are unlikely to work in this case.

Recommendations

Introduce a class input for including a file and merging displayed bibliographies

c.f. \input vs \include in LaTex.

This will remove any headers in the document with label refs, or the final header if it is the last entry in the file.

With include. run pandoc-citeproc on each included file first

Process the included files recursively with pandoc-citeproc, before including their outputs into the parent document.

(Note that pandoc-crossref must be called before pandoc-citeproc.)

[dbaynard]

Bibliography printing seems to work best if there’s a reference-section-title option in the metadata, rather than a heading at the end of a file.