* Citation syntax description in manual @ 2021-05-18 15:49 Joseph Reagle [not found] ` <28110ceb-e6ca-a40f-48ab-6e9a6d0137fd-T1oY19WcHSwdnm+yROfE0A@public.gmane.org> 0 siblings, 1 reply; 5+ messages in thread From: Joseph Reagle @ 2021-05-18 15:49 UTC (permalink / raw) To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw I was reviewing the citation syntax documentation in light of the new curly-bracket syntax [1] and wonder if the description has gotten crufty? It does reflect the evolution of the citation syntax: simple bracket citations, then no bracket "in-text" citations, then curly brackets enclosing complex pagination, and now curly brackets to enclose complex identifiers. [1]: https://github.com/jgm/pandoc/commit/3f09f53459b877f53072efbf57dec21fa37280b5 If this were to be re-written, should the start of the documentation focus be on "@" and not square brackets? -- You received this message because you are subscribed to the Google Groups "pandoc-discuss" group. To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/28110ceb-e6ca-a40f-48ab-6e9a6d0137fd%40reagle.org. ^ permalink raw reply [flat|nested] 5+ messages in thread
[parent not found: <28110ceb-e6ca-a40f-48ab-6e9a6d0137fd-T1oY19WcHSwdnm+yROfE0A@public.gmane.org>]
* Re: Citation syntax description in manual [not found] ` <28110ceb-e6ca-a40f-48ab-6e9a6d0137fd-T1oY19WcHSwdnm+yROfE0A@public.gmane.org> @ 2021-05-18 18:54 ` John MacFarlane [not found] ` <m28s4blvnx.fsf-jF64zX8BO08an7k8zZ43ob9bIa4KchGshsV+eolpW18@public.gmane.org> 0 siblings, 1 reply; 5+ messages in thread From: John MacFarlane @ 2021-05-18 18:54 UTC (permalink / raw) To: Joseph Reagle, pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw You're right I think. If you want to propose a structure for rewriting this, I'd consider it! Joseph Reagle <joseph.2011-T1oY19WcHSwdnm+yROfE0A@public.gmane.org> writes: > I was reviewing the citation syntax documentation in light of the new curly-bracket syntax [1] and wonder if the description has gotten crufty? It does reflect the evolution of the citation syntax: simple bracket citations, then no bracket "in-text" citations, then curly brackets enclosing complex pagination, and now curly brackets to enclose complex identifiers. > > [1]: https://github.com/jgm/pandoc/commit/3f09f53459b877f53072efbf57dec21fa37280b5 > > If this were to be re-written, should the start of the documentation focus be on "@" and not square brackets? > > -- > You received this message because you are subscribed to the Google Groups "pandoc-discuss" group. > To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org > To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/28110ceb-e6ca-a40f-48ab-6e9a6d0137fd%40reagle.org. -- You received this message because you are subscribed to the Google Groups "pandoc-discuss" group. To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/m28s4blvnx.fsf%40MacBook-Pro.hsd1.ca.comcast.net. ^ permalink raw reply [flat|nested] 5+ messages in thread
[parent not found: <m28s4blvnx.fsf-jF64zX8BO08an7k8zZ43ob9bIa4KchGshsV+eolpW18@public.gmane.org>]
* Re: Citation syntax description in manual [not found] ` <m28s4blvnx.fsf-jF64zX8BO08an7k8zZ43ob9bIa4KchGshsV+eolpW18@public.gmane.org> @ 2021-05-18 20:58 ` Joseph Reagle [not found] ` <d9397afc-78cb-9c47-5bb8-f5a88d096226-T1oY19WcHSwdnm+yROfE0A@public.gmane.org> 0 siblings, 1 reply; 5+ messages in thread From: Joseph Reagle @ 2021-05-18 20:58 UTC (permalink / raw) To: John MacFarlane, pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw On 21-05-18 14:54, John MacFarlane wrote: > You're right I think. If you want to propose a structure for > rewriting this, I'd consider it! I tried, but stopped short because I don't know the parsing logic that well. I had something like this: - Markdown citations begin with an "@" followed by an identifier; a sequence of citations are separated by semi-colons. (Does this ever conflict with numbered examples? I've never used the latter.) - A citation may be followed by optional pagination. - When citations appear within square brackets: - They are taken as in-text or a note citation, depending on the style. - Each citation within the semi-colon delimited list may have a prefix, locator, and suffix. - Citations that appear without brackets always render the names of the authors in-text. - pagination and a suffix may still follow within brackets. - complex identifiers and locators may be protected by inclusion within curly brackets. ... ? ^ permalink raw reply [flat|nested] 5+ messages in thread
[parent not found: <d9397afc-78cb-9c47-5bb8-f5a88d096226-T1oY19WcHSwdnm+yROfE0A@public.gmane.org>]
* Re: Citation syntax description in manual [not found] ` <d9397afc-78cb-9c47-5bb8-f5a88d096226-T1oY19WcHSwdnm+yROfE0A@public.gmane.org> @ 2021-05-19 17:21 ` John MacFarlane [not found] ` <m2r1i2iqra.fsf-jF64zX8BO08an7k8zZ43ob9bIa4KchGshsV+eolpW18@public.gmane.org> 0 siblings, 1 reply; 5+ messages in thread From: John MacFarlane @ 2021-05-19 17:21 UTC (permalink / raw) To: Joseph Reagle, pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw I gave it a try here: https://github.com/jgm/pandoc/commit/d452155bcf158b790b0087d6d5c02cc3212c921c Joseph Reagle <joseph.2011-T1oY19WcHSwdnm+yROfE0A@public.gmane.org> writes: > On 21-05-18 14:54, John MacFarlane wrote: >> You're right I think. If you want to propose a structure for >> rewriting this, I'd consider it! > > I tried, but stopped short because I don't know the parsing logic that well. I had something like this: > > - Markdown citations begin with an "@" followed by an identifier; a > sequence of citations are separated by semi-colons. (Does this ever > conflict with numbered examples? I've never used the latter.) > - A citation may be followed by optional pagination. > - When citations appear within square brackets: > - They are taken as in-text or a note citation, depending on the > style. > - Each citation within the semi-colon delimited list may have a > prefix, locator, and suffix. > - Citations that appear without brackets always render the names of the > authors in-text. > - pagination and a suffix may still follow within brackets. > - complex identifiers and locators may be protected by inclusion within > curly brackets. > ... ? ^ permalink raw reply [flat|nested] 5+ messages in thread
[parent not found: <m2r1i2iqra.fsf-jF64zX8BO08an7k8zZ43ob9bIa4KchGshsV+eolpW18@public.gmane.org>]
* Re: Citation syntax description in manual [not found] ` <m2r1i2iqra.fsf-jF64zX8BO08an7k8zZ43ob9bIa4KchGshsV+eolpW18@public.gmane.org> @ 2021-05-19 17:32 ` Joseph Reagle 0 siblings, 0 replies; 5+ messages in thread From: Joseph Reagle @ 2021-05-19 17:32 UTC (permalink / raw) To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw On 21-05-19 13:21, John MacFarlane wrote: > I gave it a try here: > > https://github.com/jgm/pandoc/commit/d452155bcf158b790b0087d6d5c02cc3212c921c Looks goods. I left two comments (lines 4979 and 4980; never did that on github before) for subject singular agreement. ^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2021-05-19 17:32 UTC | newest] Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2021-05-18 15:49 Citation syntax description in manual Joseph Reagle [not found] ` <28110ceb-e6ca-a40f-48ab-6e9a6d0137fd-T1oY19WcHSwdnm+yROfE0A@public.gmane.org> 2021-05-18 18:54 ` John MacFarlane [not found] ` <m28s4blvnx.fsf-jF64zX8BO08an7k8zZ43ob9bIa4KchGshsV+eolpW18@public.gmane.org> 2021-05-18 20:58 ` Joseph Reagle [not found] ` <d9397afc-78cb-9c47-5bb8-f5a88d096226-T1oY19WcHSwdnm+yROfE0A@public.gmane.org> 2021-05-19 17:21 ` John MacFarlane [not found] ` <m2r1i2iqra.fsf-jF64zX8BO08an7k8zZ43ob9bIa4KchGshsV+eolpW18@public.gmane.org> 2021-05-19 17:32 ` Joseph Reagle
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for NNTP newsgroup(s).