LaTeX Template: add \linebreak to \CSLBlock

[denismaier]

Currently \CSLBlock adds a break after the command, but we may also want to have the entire block on its own line. I suggest we add a something along the lines of \newcommand{\CSLBlock}[1]{\linebreak#1\hfill\break}

[jgm]

---
references:
- type: article-journal
  id: WatsonCrick1953
  author:
  - family: Watson
    given: J. D.
  - family: Crick
    given: F. H. C.
  issued:
    date-parts:
    - - 1953
      - 4
      - 25
  title: 'Molecular structure of nucleic acids: a structure for
    deoxyribose nucleic acid'
  title-short: Molecular structure of nucleic acids
  container-title: Nature
  volume: 171
  issue: 4356
  page: 737-738
  DOI: 10.1038/171737a0
  URL: https://www.nature.com/articles/171737a0
  language: en-GB
  note: Note this!
nocite: |
  @*
...

Test with apa-annotated-bibliography.csl

[jgm]

With the change

-\newcommand{\CSLBlock}[1]{#1\hfill\break}
+\newcommand{\CSLBlock}[1]{\linebreak #1\hfill\break}

I get

Any advice?

[denismaier]

\linebreak is probably wrong. Perhaps better \\ or \hfill\break just like at the end. But we need to check what happens if we have two of these in a row.

[jgm]

I'm thinking \par will give good results.
But... the docs say

“block” - block stretching from margin to margin.

How does this interact with hanging-indent? IN a hanging-indent style, do we have a non-hanging annotation?

[denismaier]

I'm thinking \par will give good results.
But... the docs say

“block” - block stretching from margin to margin.

My understanding of this is that the "block" covers the whole textarea, not that the content itself should be stretched to fill the available space. See this example from Word/Zotero:

How does this interact with hanging-indent? IN a hanging-indent style, do we have a non-hanging annotation?

See above. I don't think a non-hanging annnotation would be wanted. I guess that's why whe have these hard line breaks in the Zotero/Word example from above.

cc @bwiernik What do you think about this?

[bwiernik]

@adam3smith or @rmzelle might be a better source here. I'll admit that I find the display attribute confusing. It's supposed to follow the logic of the CSS display attribute https://www.w3schools.com/CSSref/pr_class_display.asp

Following citeproc-js's behavior, I wrote apa-annotated-bibliography.csl expecting that a display="block" element would inherit the hanging indentation from the block above (that is, it's separated by a soft line break instead of a paragraph break). https://github.com/citation-style-language/styles/blob/3a2ff5f0370ab63ba962385bbc5a90de9badf9e8/apa-annotated-bibliography.csl#L1914

[bwiernik]

Also perhaps @fbennett ?

[adam3smith]

I also find display confusing. Note that citeproc-js's behavior is frequently inconsistent between HTML and RTF. So for example a hanging indent style with the abstract in a display="block" element appears in HTML like this (in contrast to the Word/RTF example above):

I don't know if this makes a ton of sense, but I don't think this is an unreasonable interpretation of the spec? For annotated bibliographies, the Spec specifically has display="indent" (some weird behavior there with hanging-indent, though, and also inconsistent between RTF and HTML with citeproc-js.)
Sorry this isn't terribly helpful -- might be a candidate for clarification & more formalization in 1.1?

[bwiernik]

Yes, this sounds like a good thing for clarification in CSL 1.1.

[jpcirrus]

Since the change to using \bibitem in the bibliography in 353177f, changing \newcommand{\CSLBlock}[1]{#1\hfill\break}, which outputs:

to \newcommand*{\CSLBlock}[1]{\\#1}, outputs:

using:

---
csl: apa-annotated-bibliography
references:
- type: article-journal
  id: WatsonCrick1953
  author:
  - family: Watson
    given: J. D.
  - family: Crick
    given: F. H. C.
  issued:
    date-parts:
    - - 1953
      - 4
      - 25
  title: 'Molecular structure of nucleic acids: a structure for
    deoxyribose nucleic acid'
  title-short: Molecular structure of nucleic acids
  container-title: Nature
  volume: 171
  issue: 4356
  page: 737-738
  DOI: 10.1038/171737a0
  URL: https://www.nature.com/articles/171737a0
  language: en-GB
  note: Note this!
- id: francois2014
  type: article-journal
  title: >-
    ‘Exercise snacks’ before meals: a novel strategy to improve glycaemic
    control in individuals with insulin resistance
  container-title: Diabetologia
  page: 1437-1445
  volume: '57'
  issue: '7'
  DOI: 10.1007/s00125-014-3244-6
  author:
    - family: Williams
      given: Michael J. A.
    - family: Francois
      given: Monique E.
    - family: Baldi
      given: James C.
    - family: Manning
      given: Patrick J.
    - family: Lucas
      given: Samuel J. E.
    - family: Hawley
      given: John A.
    - family: Cotter
      given: James D.
  issued:
    date-parts:
      - - 2014
nocite: |
  @*
...

[jgm]

\newcommand*{\CSLBlock}[1]{\\#1} won't work when the block is the first thing in the entry ("No line to end").
But this works I think:

-\newcommand{\CSLBlock}[1]{#1\hfill\break}
+\newcommand{\CSLBlock}[1]{\hfill\break#1\hfill\break}