From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.text.pandoc/30705 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: John MacFarlane Newsgroups: gmane.text.pandoc Subject: Re: Is there a YAML metadata option for `--shift-heading-level-by` on the command line? Date: Tue, 07 Jun 2022 06:58:28 -0700 Message-ID: References: <884ca060-dab6-8730-fe09-a46d66238883@gmail.com> 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="23787"; mail-complaints-to="usenet@ciao.gmane.io" To: "R (Chandra) Chandrasekhar" , pandoc-discuss Original-X-From: pandoc-discuss+bncBCJZJHG45QDBBCNT7WKAMGQE5CB6FNY-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Tue Jun 07 15:58:36 2022 Return-path: Envelope-to: gtp-pandoc-discuss@m.gmane-mx.org Original-Received: from mail-oa1-f58.google.com ([209.85.160.58]) by ciao.gmane.io with esmtps (TLS1.3:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.92) (envelope-from ) id 1nyZjA-0005x5-Jx for gtp-pandoc-discuss@m.gmane-mx.org; Tue, 07 Jun 2022 15:58:36 +0200 Original-Received: by mail-oa1-f58.google.com with SMTP id 586e51a60fabf-f32f6522c6sf10340460fac.18 for ; Tue, 07 Jun 2022 06:58:36 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1654610315; cv=pass; d=google.com; s=arc-20160816; b=LOQhezZ0wRUU4KnR3GUddF4HFXp0TxZ9zRvXXfkYQfv4tH2r9/um/UeII0P7wGkrek 2PD9ezXh3f3FUlcsmZUi4TVy4rr9blyEn3/KJYQEvavC4S1M6wv/5CLSM4CAEhjW2NoS K22/+bgrzrZtDw51d/nmEQGt1I0uqmHdDhtyuCy6CqnnJNoE5VyCGH7S1KWR56solAOb 5pxvFjW6IBlE4Lg1xnhstFAe3VHbgMsWTYIgsoMq4WmBhGAAODfGCDwBs0OMQy68RX0V Qg2XO5FaIAoVTZU2sopGc32JoZmvUCpK77ZaYRA6IvT1QeUJCNTej3b1RIvmKwjbEBlE fuOQ== 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=KwsoHQL4TaLRzC5AYZQwGk6sDdkAxPgU9XRk5WBtUNs=; b=yYnKRoCOKWF3KkDxpaRzM4gHMKQSE7V0fOPQRyBrpGOwKpTdKGBdNQ1xIL9uWO+Uf8 0/qE3TtHCX5oAoZCKLR7B8Y4VrxAoIDGJVW47vTtL6v6hnYsRoWL4qXsfQvxGP69JJVO 12CRasaFqBgvvyENLG5syQIYj3qJFuNuvhViUzWf6MvgL7IkrvWfZ8WFjYj3lIoZ4nJG HnwY8l6dU3Xu4PrZgcBVWn7133bf0Mu2FEWSlsMF4uBvc05O+rbLXRNm5l19lFDAyf1N 1AKJ3LfhMffLx4iqdXy5R0ohIY/D2ISVhvvRujicODLek4ylysihXhTLXyFZmrMJpsg2 iOyw== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@berkeley.edu header.s=google header.b=NnjcyjpF; spf=pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:4864:20::52f as permitted sender) smtp.mailfrom=jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=berkeley.edu DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20210112; 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=KwsoHQL4TaLRzC5AYZQwGk6sDdkAxPgU9XRk5WBtUNs=; b=PZ6pYMzzBid9j7eoJ43dgM+a0hWPCov8prjyvwED7zfJDVvYxYixr20Q227nkyLL97 1Ho/YdPB1cm2Tz9jL+55F7SLBTTZ7j+78i/HDQVyk6rtVWmYRGtTSA7deCbgY2NYKtTt pDvbqr7kKQFVbQYHl5n9GP9ngVYQmgm/HfQ2Hi7fMuK41pa9Cp6Y4HCpceOdzbn2b5TF Vvzta9v+78hs6zV4fBDwJ7w+80yDlFajg32Bx5ZqIubuc6k2KrTP8H5PoPmJNHc2D7TW S7/6E4w75P90zfJAhIk5RdjydYCFbpgcyvH2lccsXOAqw9REuHUFuwbtDR+xj9n/sMxF W0wA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; 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=KwsoHQL4TaLRzC5AYZQwGk6sDdkAxPgU9XRk5WBtUNs=; b=f0hnJmzBOvtY8SmwFYyuiEvelqoIKsEeS5iVxWuiEvmUlPzH6OxduqHetjO/Zt9Lot tbZHFWu6jwJVpV/mJhZ9lP3+WByQS9JSVv6fR352/qKY5a0bCDE2hmv+7CoJ6fNX9Xpk BNa3oAyJMCAgg8e3XUbmHXRRtnszDBKQMdFQcpzSGQUXX4BXof2dnTFcWZHcbVcevV1G obZd0zSfLK+2W/o/idP42sEO+uoK3kymBbIE/oNMz6BP8XEx2PxJ3Ls3K+dB7MazM/on cLL223jrERePEhalfvZrkkpn+IPZuIKpTK+bw9uUcpnRAuHe/CBa0fWKYV9wzXdDiHL5 ZeYg== Original-Sender: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org X-Gm-Message-State: AOAM532C/IPI2pA6TwuGuclYHYMJ5h36o0XHT1rT+s3O2ovCoz9MLpbQ lj1iGW+XX0fYY6FbLcuWujA= X-Google-Smtp-Source: ABdhPJyeJc3joJD5v0QiMkjwHWzSpD08Xo8Lc7Hc1OekfLk72wjoK7qRCerznIcy1hJzxNhWFbJbww== X-Received: by 2002:a05:6830:1e54:b0:60b:fd89:7ccf with SMTP id e20-20020a0568301e5400b0060bfd897ccfmr3905868otj.107.1654610315402; Tue, 07 Jun 2022 06:58:35 -0700 (PDT) X-BeenThere: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Original-Received: by 2002:a05:6808:16a9:b0:32e:4091:d608 with SMTP id bb41-20020a05680816a900b0032e4091d608ls5403221oib.4.gmail; Tue, 07 Jun 2022 06:58:32 -0700 (PDT) X-Received: by 2002:a05:6808:2005:b0:32e:bf1c:34e0 with SMTP id q5-20020a056808200500b0032ebf1c34e0mr920773oiw.2.1654610312689; Tue, 07 Jun 2022 06:58:32 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1654610312; cv=none; d=google.com; s=arc-20160816; b=eC6xHL3chrKhuFiAiPCD6V5I9A/mt5zVwTOLmYmZqXqQfQTw3sOmn5humAgVRpb7Yg Itx0lR+Q0DLPwNyLPAuyv4zSyjNywudSt42XuB75hnmHRsCaCCzZ+9chd9nmMmg6wp08 cxsNbaxKv4Wrrru01EVJuM2hG6b/T27Mm2HtG3P1USFIZxrRxK0Pj4CfO4+uXj8tAdmW c6qZdUmBVMuqlqrBO8uGYx2QjlQ9B8gSEvA3pOITRC2Uk+CtSXfvcsz/evcSsd/SlVK0 pkAZidBaMVji3o1BzWRh6OgfCOmp4fbCW8NSbLGYmldBHhFJTutki4Ln8X8SslbJP6J/ 41xA== 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=MKG4GN9w2cnTiNpx4tQa/m4lrqwpI3WVA3NnvSuvZMk=; b=SHHjd9+97AEnoiMgCf2a9XKMXDSjrAa051SzC1Qgi4XVdmmt2OK+EQnWAPEEGM8mdO hACb93ro0h/RAFk8ROGBRP+Rs1PbnuqSxbr2E7ncSmH2MeOxQRaSadtW1wF8AGhRoUox JVF7JPDzkdfV95LDbQYybaqJKqrjqloSvCpSu39zVKrqSIH7A0OVIISoE+FS98W1VfD/ rAJjm0czIbvhhY/7GFHVzKWAeq/EY5SdZErWeGG838QIQUgZGPZz5iwjRu5xKMmQSzAs v1oMzno3XT6ukDqmQ5TAB5E/mLyS6E7DLpoUU8M9dwfXcJ+Tezh9B8HjuRRnHnoC6pih KWcA== ARC-Authentication-Results: i=1; gmr-mx.google.com; dkim=pass header.i=@berkeley.edu header.s=google header.b=NnjcyjpF; spf=pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:4864:20::52f as permitted sender) smtp.mailfrom=jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=berkeley.edu Original-Received: from mail-pg1-x52f.google.com (mail-pg1-x52f.google.com. [2607:f8b0:4864:20::52f]) by gmr-mx.google.com with ESMTPS id bq10-20020a05680823ca00b003222fdff9aesi1436334oib.0.2022.06.07.06.58.32 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 07 Jun 2022 06:58:32 -0700 (PDT) Received-SPF: pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:4864:20::52f as permitted sender) client-ip=2607:f8b0:4864:20::52f; Original-Received: by mail-pg1-x52f.google.com with SMTP id q140so879915pgq.6 for ; Tue, 07 Jun 2022 06:58:32 -0700 (PDT) X-Received: by 2002:a05:6a02:117:b0:3fa:de2:357a with SMTP id bg23-20020a056a02011700b003fa0de2357amr25705278pgb.169.1654610311610; Tue, 07 Jun 2022 06:58:31 -0700 (PDT) Original-Received: from hermes.johnmacfarlane.net ([45.32.92.108]) by smtp.gmail.com with ESMTPSA id y17-20020a170903011100b00163ef7be14csm12369071plc.89.2022.06.07.06.58.29 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 07 Jun 2022 06:58:30 -0700 (PDT) Original-Received: by hermes.johnmacfarlane.net (sSMTP sendmail emulation); Tue, 07 Jun 2022 06:58:28 -0700 In-Reply-To: <884ca060-dab6-8730-fe09-a46d66238883-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> X-Original-Sender: jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org X-Original-Authentication-Results: gmr-mx.google.com; dkim=pass header.i=@berkeley.edu header.s=google header.b=NnjcyjpF; spf=pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:4864:20::52f as permitted sender) smtp.mailfrom=jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=berkeley.edu 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:30705 Archived-At: "R (Chandra) Chandrasekhar" writes: > So far, I have succeeded in getting the desired numbering by: > > 1. Adding > > shift-heading-level-by: -1 > > after the line specifying the reader in my defaults file. > > 2. Adding > > numbersections: true This works, because of the way it is implemented for your output format, but this is not the documented way to set this option, and it won't work for all output formats. Instead, use number-sections: true in your defaults files. > However, if I move the line > > shift-heading-level-by: -1 > > from the defaults file to the YAML metadata block in my source file, the > numbering starts at 0.1 rather than 1 for the first level-2 heading. You can't, in general, set command line options from YAML metadata. Options are one thing, metadata is another. Defaults files are where you set options. > Finally, I have found that there are three ways to turn numbering on or off: > > (a) to turn section numbering on in the > > command line, I need to use > > `--number-sections` > > (b) to turn it on in the defaults file I need to specify > > `number-sections: true` > > (c) but to turn it on in the YAML metadata block, I need to specify > > `numbersections: true` without an intervening hyphen. > > Is this deliberate or an artefact of history? The last method works because of an implementation detail, but this is not a documented or supported way of doing it.