From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.text.pandoc/28386 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Joseph Reagle Newsgroups: gmane.text.pandoc Subject: Re: Citation syntax description in manual Date: Tue, 18 May 2021 16:58:38 -0400 Message-ID: References: <28110ceb-e6ca-a40f-48ab-6e9a6d0137fd@reagle.org> Reply-To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8"; format=flowed Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="30520"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.0; rv:68.0) Gecko/20100101 Thunderbird/68.12.1 To: John MacFarlane , pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Original-X-From: pandoc-discuss+bncBD65ZAVVYEKRBA6VSCCQMGQE4QIVVUI-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Tue May 18 22:58:46 2021 Return-path: Envelope-to: gtp-pandoc-discuss@m.gmane-mx.org Original-Received: from mail-yb1-f183.google.com ([209.85.219.183]) by ciao.gmane.io with esmtps (TLS1.3:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.92) (envelope-from ) id 1lj6nd-0007ln-VJ for gtp-pandoc-discuss@m.gmane-mx.org; Tue, 18 May 2021 22:58:45 +0200 Original-Received: by mail-yb1-f183.google.com with SMTP id k186-20020a2524c30000b02905116c9c3759sf5109433ybk.4 for ; Tue, 18 May 2021 13:58:45 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1621371525; cv=pass; d=google.com; s=arc-20160816; b=bJtrb5uXOiqMJSUXJeICmnBXOXTBSjBFdjyZJf5NR0dszsEctcq9J3LuopbqXgGs5x 0FrdEiCi5u+Bv6fZthVd8nLRvgzFc3L4qLvjTC8F+BvSLHpz7l5pGp11dISS+RZLVnpF zRRtwmuOpbAC2Xp8UNIQl04qzuBbEiBxhRGZXZPmySF9ddY5zdcxCZ+as1GZC+w/RpPp hycNB1JihkdJQ+h1fQOkcMeFQb9G/HeGC3I3pXHuPPFjINr9cryYGes4rJvBA2vgAPve IoI6Xl+6vY6Y29pRA0RLCTI3E583EEDruHhMqKd7LMWVysC9+JspjrxuaCvtmuIzaLoE /haA== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:reply-to:content-language :in-reply-to:mime-version:user-agent:date:message-id:from:references :to:subject:sender:dkim-signature; bh=pWIgNqrs6zdjUvvflKSbuuxg4yBZ5xp4/rVfVVD4xR4=; b=sLgxjEs/19P9sA/MW1WMLqhwePDFWLP20MKQx1hdpTl6ANpm1Mb1TDCJHGsRPCPWHR aDSVMidPcABEQ22MhLdMi7FB/U3o1aYjyn5jrVKQ/FoZbMg0GatIuQ89Y30czOkoROlK xa6F3TEXSWhAD5eecwmwZtFj8WXxvbXZxPAWLLPHVllbB5DPwIQ9F+W5cFxAXesE4Q2/ 2BwPjgED6+x/qnPskzwO+TD6eCkfKDx2mxJgxxyOvftXS4+pkZapTshVYFlOdtOemQI2 1zrk5ZnT+vyPZJB7jd0YQZ12JMbzxf3UFchkgRFQP0jheNoQ7UkLW41TkbqptG4kYOwF ld4w== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@reagle.org header.s=default header.b=WjacfVX6; spf=pass (google.com: domain of joseph.2011-T1oY19WcHSwdnm+yROfE0A@public.gmane.org designates 23.83.209.27 as permitted sender) smtp.mailfrom=joseph.2011-T1oY19WcHSwdnm+yROfE0A@public.gmane.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20161025; h=sender:subject:to:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:x-original-sender :x-original-authentication-results:reply-to:precedence:mailing-list :list-id:list-post:list-help:list-archive:list-subscribe :list-unsubscribe; bh=pWIgNqrs6zdjUvvflKSbuuxg4yBZ5xp4/rVfVVD4xR4=; b=qYB4mvmzy8AuYScjr56r2B1PKXebrG5fSQtyhWqovqLg0/aqdXQMH7HX6uzOlXgCqb xd6Ae27nk/GHnwyekC2h81vwqmPw9UnCeUeamWBL1sIkrfm+Zhm2O9cVWYnsfYd7VuYN BWopM86cOufZl0qQk3Jm7gJ8vK4D2/KuEbPJrzHwn+BfYzrldKBekwAEobamh2N1/Y7y 8K86dKMZ3st4tqTd5emdJihnQPQrPVOf7Kq2osADPoVOqwh8ZVxt6Of8TqasiBEJj6hD wiqRFjItGRH3q9H5W0V2VSNMERhP8DBYMDPzJR9kU2w2zvG2t6cax60gN1xisdkIvGot b5bw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=sender:x-gm-message-state:subject:to:references:from:message-id :date:user-agent:mime-version:in-reply-to:content-language :x-original-sender:x-original-authentication-results:reply-to :precedence:mailing-list:list-id:x-spam-checked-in-group:list-post :list-help:list-archive:list-subscribe:list-unsubscribe; bh=pWIgNqrs6zdjUvvflKSbuuxg4yBZ5xp4/rVfVVD4xR4=; b=Pt3H7dSwRrShb+NBNKaT8TfUVOo15403t8/2nO4HZ7542bQjKTN7PaBHh7pWJYHXFG cZj1r4QpMPy4jAHvdaSgFPBGueQcTdI+2Sc34KaC55StSl9op9hBomVuF/TQQpjy45zm Qc8OzP1oin6y5wRborscdyPbzou/X8WXLAdfgIJNzOHORMb+c1SYlVjyBgYJwSKtFth3 GEa+VW36OaGCHvcSuj5y4+5l0fDZ+sO/zsAlZ8nBKDfBxjuIJGwJ8t+uz/a9b0b1giYl T3/RsRO3jkecpbgjP9kuZb2afhmHqWbNnzdLqVniygtZP++4jzgHZVpIutgb/P16p2K9 Original-Sender: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org X-Gm-Message-State: AOAM5301ZXQVZnh7qLHtQTwKRqbeyl2mLM+Wj5Igb63jIxFN6ZU/hJW1 8kFMZqfa+pERvols+yiVtCU= X-Google-Smtp-Source: ABdhPJzaoIt1QKYV87VSomqS6yRyvK75VG8n/6pLCAC6fYAN47tIGHq4ducZgagALux+Nr9ieGzYWw== X-Received: by 2002:a05:6902:1541:: with SMTP id r1mr9977548ybu.303.1621371525085; Tue, 18 May 2021 13:58:45 -0700 (PDT) X-BeenThere: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Original-Received: by 2002:a25:a045:: with SMTP id x63ls10619489ybh.1.gmail; Tue, 18 May 2021 13:58:43 -0700 (PDT) X-Received: by 2002:a05:6902:72b:: with SMTP id l11mr11093689ybt.331.1621371523308; Tue, 18 May 2021 13:58:43 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1621371523; cv=none; d=google.com; s=arc-20160816; b=NE6IYyNXQdQJIvAl9OrCruz29ILbPQdPGi/wv+hK2eaqiwAc8OXxU1EMPlWQ6V+27U ttUNVFg9RdtQp0kRyjQ8sNobTZiDqMvR8UShQ97lbsxJAY2pi5r9yhygtGQuOXj0GK+H HN3QyxDui1zVxPYVFjNifKVOgpn3a6cD7sZ7XBEIgzwin+xw6AbfToPKrH8WWJg9ZAtD PSxflXOqUmhjNvlLjSPptPLIm6skYM7XGVo2nucULoJqoUrb+f89fkMw011M5avdYthB 0xSHhxw3XJGyTj8roW3Ql1EvwQBTrsJGgu+DjABbVm1pVbyiXN8ew3GzycY9fOGHq0s3 GqAA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:content-language:in-reply-to:mime-version :user-agent:date:message-id:from:references:to:subject :dkim-signature; bh=zvXrVXUthqlAZJB8UpeRv/IIqKGaaGIVPJlPoN8wIZs=; b=DUABmMLJLd0UtNlEsy3UrtQ+hQR4TKFAZza/fT1f8Vd3/t67FnF+tcNEGcc8HiBLCf YJr/yUoigPOU0KnalVlgE+yF80o13ztwGkvCFq6vP5JawvwQ2Vi4DRvMnprNZJFlAa/+ Yz3zSYuFqlsnXMZr+o3p/IyED2x3QVSBuIVIHkthWyhUhxe1y+IAZDq3SKunkgWdFgwX IP8NSMGdF5kbUMqOvUjkrzn/YW9J3Qtxn9zSJubTdMSZY36GoR8Ym88d53IK8gHZT4Q4 +rKIlVL/31S23KbYqcIddGBAYwvzIv6/T49ov7qjbarAf4aq1NjhBEp7aHjtMFOi3MMB pbaA== ARC-Authentication-Results: i=1; gmr-mx.google.com; dkim=pass header.i=@reagle.org header.s=default header.b=WjacfVX6; spf=pass (google.com: domain of joseph.2011-T1oY19WcHSwdnm+yROfE0A@public.gmane.org designates 23.83.209.27 as permitted sender) smtp.mailfrom=joseph.2011-T1oY19WcHSwdnm+yROfE0A@public.gmane.org Original-Received: from butterfly.birch.relay.mailchannels.net (butterfly.birch.relay.mailchannels.net. [23.83.209.27]) by gmr-mx.google.com with ESMTPS id i15si85521ybk.2.2021.05.18.13.58.42 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Tue, 18 May 2021 13:58:43 -0700 (PDT) Received-SPF: pass (google.com: domain of joseph.2011-T1oY19WcHSwdnm+yROfE0A@public.gmane.org designates 23.83.209.27 as permitted sender) client-ip=23.83.209.27; X-Sender-Id: a2hosting|x-authuser|joseph-T1oY19WcHSwdnm+yROfE0A@public.gmane.org Original-Received: from relay.mailchannels.net (localhost [127.0.0.1]) by relay.mailchannels.net (Postfix) with ESMTP id 291F4541436; Tue, 18 May 2021 20:58:41 +0000 (UTC) Original-Received: from az1-ss21.a2hosting.com (100-96-133-103.trex.outbound.svc.cluster.local [100.96.133.103]) (Authenticated sender: a2hosting) by relay.mailchannels.net (Postfix) with ESMTPA id 5472A542126; Tue, 18 May 2021 20:58:40 +0000 (UTC) X-Sender-Id: a2hosting|x-authuser|joseph-T1oY19WcHSwdnm+yROfE0A@public.gmane.org Original-Received: from az1-ss21.a2hosting.com (az1-ss21.a2hosting.com [68.66.224.43]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384) by 100.96.133.103 (trex/6.2.1); Tue, 18 May 2021 20:58:41 +0000 X-MC-Relay: Neutral X-MailChannels-SenderId: a2hosting|x-authuser|joseph-T1oY19WcHSwdnm+yROfE0A@public.gmane.org X-MailChannels-Auth-Id: a2hosting X-Tasty-Whispering: 3753b744455e9441_1621371520859_3929576877 X-MC-Loop-Signature: 1621371520859:2976351675 X-MC-Ingress-Time: 1621371520859 Original-Received: from c-73-149-23-48.hsd1.ma.comcast.net ([73.149.23.48]:60005 helo=[192.168.0.50]) by az1-ss21.a2hosting.com with esmtpsa (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.94.2) (envelope-from ) id 1lj6nX-0005b7-IC; Tue, 18 May 2021 13:58:39 -0700 In-Reply-To: Content-Language: en-US X-AuthUser: joseph-T1oY19WcHSwdnm+yROfE0A@public.gmane.org X-Original-Sender: joseph.2011-T1oY19WcHSwdnm+yROfE0A@public.gmane.org X-Original-Authentication-Results: gmr-mx.google.com; dkim=pass header.i=@reagle.org header.s=default header.b=WjacfVX6; spf=pass (google.com: domain of joseph.2011-T1oY19WcHSwdnm+yROfE0A@public.gmane.org designates 23.83.209.27 as permitted sender) smtp.mailfrom=joseph.2011-T1oY19WcHSwdnm+yROfE0A@public.gmane.org Precedence: list Mailing-list: list pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org; contact pandoc-discuss+owners-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org List-ID: X-Google-Group-Id: 1007024079513 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , Xref: news.gmane.io gmane.text.pandoc:28386 Archived-At: 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. ... ?