From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.text.pandoc/28392 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: John MacFarlane Newsgroups: gmane.text.pandoc Subject: Re: Citation syntax description in manual Date: Wed, 19 May 2021 10:21:13 -0700 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" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="4445"; mail-complaints-to="usenet@ciao.gmane.io" To: Joseph Reagle , pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Original-X-From: pandoc-discuss+bncBCJZJHG45QDBBFUSSWCQMGQEWOW572Y-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Wed May 19 19:21:29 2021 Return-path: Envelope-to: gtp-pandoc-discuss@m.gmane-mx.org Original-Received: from mail-il1-f190.google.com ([209.85.166.190]) by ciao.gmane.io with esmtps (TLS1.3:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.92) (envelope-from ) id 1ljPsu-0000yU-Pv for gtp-pandoc-discuss@m.gmane-mx.org; Wed, 19 May 2021 19:21:28 +0200 Original-Received: by mail-il1-f190.google.com with SMTP id h8-20020a92c2680000b02901646ecac1e5sf13605321ild.20 for ; Wed, 19 May 2021 10:21:28 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1621444887; cv=pass; d=google.com; s=arc-20160816; b=TfXnR5WJCke4lsygEH9O+lTtJCEovmIWpGqf/wFDModem4h7Da0doLkGcjb+xxmCYf naeQOQtK19KOkbg/MXrqEBWS4c391F50OiyN9pEaRJdsCIxczySF/aEsxWatPFjEStov JQE49uFVFjgT7ey/M+i0Rq/GznRd8EwqkSg7r83U62SSKsUMVJZmPrrW6lN+scm+cxAD zxKPJy7ZA1+B79Q173TVTYuslltpFW2MvyQX1wvzb+zVrZ+0WIQDyU4wh7orUGPsuetl tixPyJKj12xtytAs0D0mWq6a7HYMAD2RELqgsKZIibf3peOxo1lAu7BLHfFhtpe1338q cMaA== 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:mime-version:message-id :date:references:in-reply-to:subject:to:from:sender:dkim-signature; bh=+1P68AF1amZ35McRV2+serjXEZU2nnftL9BhRhCV/I0=; b=dcz2NHuF9XXrD8ax2NDdseaOb7A0cDLTrQr8mU2dd54hqp61Rbip2/i5D1LhkVBIU6 bBq9A13tUnBTMKA3f+j2KOHrvb5FepTDjato29VJjd2nEi9ECb+RTLEb1ryqk+6hfwCP 03aJ1Gm2rNmlfkQqAsO7EIW9vNt1uwQwpfE+mvLZXRWVvoLICU1sZxFsZkH1q9Qe/moi LGyPofVW8FJLgLnvN8aKLPZEV7AGzs7XGT64i18/UiQShlnAmpVoG/mfPhAeMSdHrDOu CeT8HYSar1KiQtAnitud4n9zfENWTrrPx85AEvWg+W/HO/pf4Ms+Jr+F9ZXY9jIUTbr3 e/nw== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@berkeley-edu.20150623.gappssmtp.com header.s=20150623 header.b=wd+iHskG; spf=pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:4864:20::52a as permitted sender) smtp.mailfrom=jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20161025; h=sender:from:to:subject:in-reply-to:references:date:message-id :mime-version: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=+1P68AF1amZ35McRV2+serjXEZU2nnftL9BhRhCV/I0=; b=jVWc1jFt1BKCgQoRcVJ8/cM5nI8wjf/PO3RzBhmyuuawLuKG8S0qlhqGwHHLnTmL/U F2nesG+MB7yLt3VOml7Jwoe+JzldnBfsNNh1Z8303iHWn1wVhxE1E5sB8RuYlJDVehjD 5mGLn68Emfwvi4JOrTWaODEmjMV52S3qXZsTIZlK1md9f41NOHVxMw6TP76y38RBrfch erchCIuKxA9lSAXVPuBkGcVGWMubZDh480pqeaoMx8Ny15JrolEeQ7hcFIUoFzHA5t7a cx1wdNeB8eYAV6HDURYQWQe5czIOCukZhVRQ8mb768MfpzJh7+mDiFIsyorUgkUemYQs 0fxg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=sender:x-gm-message-state:from:to:subject:in-reply-to:references :date:message-id:mime-version: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=+1P68AF1amZ35McRV2+serjXEZU2nnftL9BhRhCV/I0=; b=uM4zXA2QA195NgxRNaFVxm4W6vdy0NVtxf0QVPaohMIIXAfZbikKeyE8edjy8hN6Bh EJSNDSk3YvGD3A7pUXWXRCW9on2erOZgGyJgUlBGN25MyWbJt4J+iZfwR8HXR5ItF/Qu DqGduQ6ozLqLoJAjm21BJGozdkBri5xZfC2F51Us6moQCFU5dabhwic0xxjMVK/JBO50 +fd8Bar4e/HGvVCOH5zGiqMeEdmlOUlPoHBpdZxrCQzDmVRiLakgxpwQITb+Cz+4wQ6y NVDD95xHY5NXXgFIqE16T0xC9KhuMKoEd7LSiyklVaolfwAnlj/jZAlUdYF7SWPKE/9m Z1Ww== Original-Sender: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org X-Gm-Message-State: AOAM533gnaiXLyE2XngxQU2hwGi/nRIqOhv5pSq7fTCbDo+E0x5iIGt0 wRD1OuBwVGpuu8I5GbsvIqA= X-Google-Smtp-Source: ABdhPJxwDdjNd6GO8CUzGU/PjA08TcFfQgnj8wcxjrXUdhCS7ImSQYNuwsLWJ2OmhGR3uqQabrVumw== X-Received: by 2002:a92:3610:: with SMTP id d16mr71969ila.16.1621444887805; Wed, 19 May 2021 10:21:27 -0700 (PDT) X-BeenThere: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Original-Received: by 2002:a6b:d002:: with SMTP id x2ls3823275ioa.11.gmail; Wed, 19 May 2021 10:21:26 -0700 (PDT) X-Received: by 2002:a5d:818b:: with SMTP id u11mr563358ion.36.1621444886240; Wed, 19 May 2021 10:21:26 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1621444886; cv=none; d=google.com; s=arc-20160816; b=orl5J7oyDXUgQlcbRPWn7MK2KvjxfM4/UmqO0SIn8G0lHPwwVr02yHSiN/GkiCwt/O iCDPIEUQQh0w2mrK4C4dS5g9tayFaJVlVkEJ64yv2GvnPJNFHtSb/mqAniFWIMTXnT5q MHUptsrozCzIOz3UVGEgUyEw2jaBubSWYIaVmD06WcawiizurJgLiJinSP6lqHykmYJX zPnYLI0NSvro1+06UmlZ29jkTC3HhdTihtbGnpLUBlfI78KUv6cgoomWM4iEjEtQzi9+ kW/AWi6YbwMoPQRDdzp+paXXtjLX3t2gUo4P/rL1oZ9nKpUFABudyjx7Bup0OcukSwph Ykxw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=mime-version:message-id:date:references:in-reply-to:subject:to:from :dkim-signature; bh=H4wT/TACqzjbp1RPlgbaunNijyocbS+M9Zrhbaar/m8=; b=h3+iqa6zs2z3FkRqTUXop+S3DmlKvdEPD1tmWnlFPQOi2hecTbxIp4fkmAsqlogfys uSuRMXAqUsTILFKYFiMCyPxC9Dg807P/21/PZWZGCE0wxuzVGieAeJTO4xmbehrb3TBe U9eZJbVvo46A1PpZ5jz3VqEPNUxnN6ejepQw2VH5zBLGL1WtiYYrBkV/Fu0lj/NpChQK G2Wh27iIqolWZWZKlKMCcA84cowj9xvDDI81RqyBPm8bJGjFZz3Y+JJP9BeVlsi8eyTc KTWcwUJLTfzpN09vgaPDVguYNhC4jUyP2YYVpKHegB0MdHGQ1Sn5qH26AGGCZ+sRDNDf Yh2A== ARC-Authentication-Results: i=1; gmr-mx.google.com; dkim=pass header.i=@berkeley-edu.20150623.gappssmtp.com header.s=20150623 header.b=wd+iHskG; spf=pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:4864:20::52a as permitted sender) smtp.mailfrom=jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org Original-Received: from mail-pg1-x52a.google.com (mail-pg1-x52a.google.com. [2607:f8b0:4864:20::52a]) by gmr-mx.google.com with ESMTPS id y9si13351ill.1.2021.05.19.10.21.26 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 19 May 2021 10:21:26 -0700 (PDT) Received-SPF: pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:4864:20::52a as permitted sender) client-ip=2607:f8b0:4864:20::52a; Original-Received: by mail-pg1-x52a.google.com with SMTP id m124so9915723pgm.13 for ; Wed, 19 May 2021 10:21:26 -0700 (PDT) X-Received: by 2002:a05:6a00:ac6:b029:27b:5d2:6e66 with SMTP id c6-20020a056a000ac6b029027b05d26e66mr171072pfl.14.1621444884985; Wed, 19 May 2021 10:21:24 -0700 (PDT) Original-Received: from johnmacfarlane.net (li55-134.members.linode.com. [74.82.3.134]) by smtp.gmail.com with ESMTPSA id q24sm82728pjp.6.2021.05.19.10.21.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 19 May 2021 10:21:24 -0700 (PDT) Original-Received: by johnmacfarlane.net (Postfix, from userid 1000) id 5C877A231; Wed, 19 May 2021 13:21:13 -0400 (EDT) In-Reply-To: X-Original-Sender: jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org X-Original-Authentication-Results: gmr-mx.google.com; dkim=pass header.i=@berkeley-edu.20150623.gappssmtp.com header.s=20150623 header.b=wd+iHskG; spf=pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:4864:20::52a as permitted sender) smtp.mailfrom=jgm-TVLZxgkOlNX2fBVCVOL8/A@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:28392 Archived-At: I gave it a try here: https://github.com/jgm/pandoc/commit/d452155bcf158b790b0087d6d5c02cc3212c921c Joseph Reagle 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. > ... ?