Christian Moe <[email protected]> writes: > Here's a patch to document citation styles in the manual, a lack > reported by yaca at Org meetup #23. The patch also covers locators.
Thanks! > Yaca referenced Tecosaur's blog post > (https://blog.tecosaur.com/tmio/2021-07-31-citations.html#cite-styles), > which is beautifully done, and I've relied on it myself for a long > while. But I think Worg rather than the manual might be the place to > reproduce and update his large table of styles/variants, so I've taken a > different tack here. +1 > +- CSL styles recognize "locators" such as page or chapter numbers in > + the suffixes to citation keys, and have rules for rendering them. A > + locator starts with a locator term and ends with the last comma or > + digit in the suffix, whichever comes last. Locator terms include > + "p.", "page", and "chap."; more terms are listed below. In the > + following example, the locator is =p. 3-4=, but it might be rendered > + "pp. 3--4" or just "3--4" in export, depending on the CSL style. > > + : [cite:see @Tarski1965 p. 3-4 for an example] I think it is worth clarifying that locators are only supported when using ob-csl processors. Otherwise, it may be confused, say, for oc-basic, that supports CSL bibliographies, but not locators. > +- =locators= (=l=) :: Provide the locator(s) only, e.g., the page > + number. Variant: =bare=. > + > +- =bibentry= (=b=) :: Provide full bibliographic information as an > + in-text citation. Variant: =bare=. These are not supported by all the citation processors. Maybe it is worth clarifying which processors support which styles. > +The following table gives some examples of how style variations can be > +used and how an citation export processor might render them: > + > +| =[cite:@dewaal06 p. 5]= | (de Waal et al. 2006, 5) | > +| =[cite//bc:@dewaal06 p. 5]= | De Waal et al. 2006, 5 | > +| =[cite/a:@dewaal06 p. 5]= | (de Waal et al., 5) | > +| =[cite/na:@dewaal06, p. 5]= | (2006, 5) | > +| =[cite/t/cf:@dewaal06 p. 5]= | De Waal, Jones, and Smith (2006, 5) | > +| =[cite/n:@dewaal06]= | | > +| =[cite/l:@dewaal06 p. 5]= | (5) | Maybe we should provide full style/variant names for better readability. -- Ihor Radchenko // yantar92, Org mode maintainer, Learn more about Org mode at <https://orgmode.org/>. Support Org development at <https://liberapay.com/org-mode>, or support my work at <https://liberapay.com/yantar92>
