summaryrefslogtreecommitdiff
path: root/paper/lua-filters/multiple-bibliographies/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'paper/lua-filters/multiple-bibliographies/README.md')
-rw-r--r--paper/lua-filters/multiple-bibliographies/README.md33
1 files changed, 33 insertions, 0 deletions
diff --git a/paper/lua-filters/multiple-bibliographies/README.md b/paper/lua-filters/multiple-bibliographies/README.md
new file mode 100644
index 0000000..0111ee6
--- /dev/null
+++ b/paper/lua-filters/multiple-bibliographies/README.md
@@ -0,0 +1,33 @@
+# multiple-bibliographies
+
+This filter allows to create multiple bibliographies using
+`pandoc-citeproc`. The content of each bibliography is controlled
+via YAML values and the file in which a bibliographic entry is
+specified.
+
+## Usage
+
+Instead of using the usual *bibliography* metadata field, all
+bibliographies must be defined via a separate field of the scheme
+*bibliographyX*, e.g.
+
+ ---
+ bibliography_main: main-bibliography.bib
+ bibliography_software: software.bib
+ ---
+
+The placement of bibliographies is controlled via special divs.
+
+ # References
+
+ ::: {#refs_main}
+ :::
+
+ # Software
+
+ ::: {#refs_software}
+ :::
+
+Each refsX div should have a matching bibliographyX entry in the
+header. These divs are filled with citations from the respective
+bib-file.