From 2a6e7d63dedec49fb5b96a60c741c2d785243926 Mon Sep 17 00:00:00 2001 From: "James A. Fellows Yates" Date: Fri, 12 Apr 2024 06:11:11 +0200 Subject: [PATCH 1/3] Specify caveats of book-project bibliographies --- docs/authoring/footnotes-and-citations.qmd | 2 +- docs/books/book-structure.qmd | 2 ++ 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/authoring/footnotes-and-citations.qmd b/docs/authoring/footnotes-and-citations.qmd index b5cc1ff0c5..4210af08ec 100644 --- a/docs/authoring/footnotes-and-citations.qmd +++ b/docs/authoring/footnotes-and-citations.qmd @@ -90,7 +90,7 @@ By default, Pandoc will automatically generate a list of works cited and place i ::: ``` -If no such div is found, the works cited list will be placed at the end of the document. +If no such div is found, the works cited list will be placed at the end of the document. Book project must explicitly specify the div. If your bibliography is being generated using BibLaTeX or natbib (@sec-biblatex), the bibliography will always appear at the end of the document and the `#refs` div will be ignored. diff --git a/docs/books/book-structure.qmd b/docs/books/book-structure.qmd index 45a5f02d99..39d97bc53b 100644 --- a/docs/books/book-structure.qmd +++ b/docs/books/book-structure.qmd @@ -75,6 +75,8 @@ You should include a `div` with the id `#refs` at the location in your book wher ::: ``` +Here, the bibliography of all cited works in the project will be placed. It is not possible in the Book project type to have per-page bibliographies, even if an explicit file specified in the `bibliography:` section of the markdown header of that page. + Note that you can change the chapter title to whatever you like, remove `.unnumbered` to have it be numbered like other chapters, and add other content before or after the bibliography as necessary. ## Creating an Index From 591a5de5c0cd9328053dcce537595fff7671d433 Mon Sep 17 00:00:00 2001 From: "James A. Fellows Yates" Date: Mon, 15 Apr 2024 16:02:16 +0200 Subject: [PATCH 2/3] Improve phrasing based on new understanding --- docs/books/book-structure.qmd | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/books/book-structure.qmd b/docs/books/book-structure.qmd index 39d97bc53b..6fd4621bab 100644 --- a/docs/books/book-structure.qmd +++ b/docs/books/book-structure.qmd @@ -66,7 +66,11 @@ Note that `toc-depth` is independent of `number-depth` (i.e. you can have unnumb ## References -You should include a `div` with the id `#refs` at the location in your book where you'd like the bibliography to be generated. For example the `references.qmd` file generated by `quarto create project book` includes this: +By default, the references of any citations in a page will be rendered at the bottom of each file. + +If you want the entire bibliography in a single location such as on a dedicated 'references' file., you should include a `div` with the id `#refs` at the location in your book where you'd like the bibliography to be generated. + +For example the `references.qmd` file generated by `quarto create project book` includes this: ``` markdown # References {.unnumbered} @@ -75,7 +79,9 @@ You should include a `div` with the id `#refs` at the location in your book wher ::: ``` -Here, the bibliography of all cited works in the project will be placed. It is not possible in the Book project type to have per-page bibliographies, even if an explicit file specified in the `bibliography:` section of the markdown header of that page. +Here, the bibliography of all cited works in the project will be placed. + +Note that if you have specified a `.qmd` file-specific bibliography references in the file's header (with `bibliography:`), the references in this file will still be displayed in where the `div` is specified, irregardless of the the location the `bibliography:` was specified. Note that you can change the chapter title to whatever you like, remove `.unnumbered` to have it be numbered like other chapters, and add other content before or after the bibliography as necessary. From dcb04ba8407af82a2cec46eadb2edf8783b0aba5 Mon Sep 17 00:00:00 2001 From: "James A. Fellows Yates" Date: Mon, 15 Apr 2024 16:04:48 +0200 Subject: [PATCH 3/3] Update footnotes-and-citations.qmd --- docs/authoring/footnotes-and-citations.qmd | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/authoring/footnotes-and-citations.qmd b/docs/authoring/footnotes-and-citations.qmd index 4210af08ec..63db8a4c8a 100644 --- a/docs/authoring/footnotes-and-citations.qmd +++ b/docs/authoring/footnotes-and-citations.qmd @@ -81,7 +81,7 @@ You can find CSL files or learn more about using styles at the [CSL Project](htt ### Bibliography Generation -By default, Pandoc will automatically generate a list of works cited and place it in the document if the style calls for it. It will be placed in a div with the id `refs` if one exists: +By default, Pandoc will automatically generate a list of works cited if the style calls for it. If it exists, the bibliography will be explicitly placed where a div with the id `refs` is specified: ``` markdown ### References @@ -90,7 +90,7 @@ By default, Pandoc will automatically generate a list of works cited and place i ::: ``` -If no such div is found, the works cited list will be placed at the end of the document. Book project must explicitly specify the div. +If no such div is found, the works cited list will be placed at the end of the document. Book projects that desire a bibliography of the entire project on a single page should explicitly place the `div`. If your bibliography is being generated using BibLaTeX or natbib (@sec-biblatex), the bibliography will always appear at the end of the document and the `#refs` div will be ignored.