From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.text.pandoc/23476 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: John MacFarlane Newsgroups: gmane.text.pandoc Subject: Re: Options, extensions, variables : what can be specified in the YAML header of a Markdown file and what has to be on the command line ? Date: Sat, 28 Sep 2019 11:14:28 -0700 Message-ID: References: <5ddf18fd-b35f-4bf2-99d0-03ca657adb28@googlegroups.com> Reply-To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="268112"; mail-complaints-to="usenet@blaine.gmane.org" To: Emmanuel Charpentier , pandoc-discuss Original-X-From: pandoc-discuss+bncBCJZJHG45QDBBEOGX3WAKGQEZCWHW2Q-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Sat Sep 28 20:14:44 2019 Return-path: Envelope-to: gtp-pandoc-discuss@m.gmane.org Original-Received: from mail-oi1-f188.google.com ([209.85.167.188]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.89) (envelope-from ) id 1iEHEx-0017cK-Kg for gtp-pandoc-discuss@m.gmane.org; Sat, 28 Sep 2019 20:14:43 +0200 Original-Received: by mail-oi1-f188.google.com with SMTP id f80sf4486610oig.8 for ; Sat, 28 Sep 2019 11:14:43 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1569694482; cv=pass; d=google.com; s=arc-20160816; b=wq9AprAgBKQzvP+hRMQ513MWe9X2HUj3E+UsgMc7Odl61GztMyZdTsNzSFoXo+FmBw xQ4/b3FldXEldEkEqb1viZt4KpJRRIaHk3X6YF0x69UW+mREUsbW2rqhw895MevMgnt/ HivrcT2O6aXlm4zdYiH+YIaoHoUXdpo/gAG8St92qS8OBms/IdJ11BSkLC7Rkx2JpoSB UUrnKR21T4xfMyXsKDD6FKxhLQlJNTRlF9E0fh9GexsIETuGtvQnSmZ9aVnj8+ibIqns dUGUHpthbnRiaxi4vCOPJ3PCuqAadXsc93cuql1K0PrdvAzRp5DZPr56YpHgupBubzzH /yHA== 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=FyehncyUbcw+D44Qm8ei6pQytMwV2nqUCK4yEPInvH0=; b=TucVfKH1K2i9qcvrv/NjkkfTWwzk3P+T6xWRWSSodIniaog4VJh2vpYO1l/U0IFk81 yYzvyCLEge0z5k2/ViJ5jov53GfzE9Ig5ec/5ihWuMvl2qLJxwdGgTTrsAN+Pid4mKWi cUlj74eq28sPcDJTcgp0PnR6PxEE+8W6MaKWBk/zlofC2EHNpZPzmOzfcRpZgqnvy54Z 5gYWftKc4KaR/xPtclOWBglQftor9fSZ8+vnCKTR4gLv7y/FAgsRFOlVdi7+WLn7mtrg uehY65cFkxxc5m3oBOMwI75MLSCFPBliRjQT+QE3v1+ZDsvzTxNKx0gUYL6B3JhxF6I3 hw6Q== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@berkeley-edu.20150623.gappssmtp.com header.s=20150623 header.b=IJLVmlYg; spf=pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:4864:20::532 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=FyehncyUbcw+D44Qm8ei6pQytMwV2nqUCK4yEPInvH0=; b=af1A748dV8sLuLipsZ0jtBQr7R8lY6KYWqyyDGJYDhdcPCbkIi9MS1G9veImgThI2R 0406vUzDHZ2NIoq9d41e6wrAWnX2NPMuY0QzJ56iwn952OzZnpNRKp6r8hZDkWhAbBZu 1k2ULNL9f1oT/54nhjE2x5HoGh7wECwKGRs7nYdgNqOdal1kj3L/dlVIi+MSIMXc3IBq fS9UYeuqAaewXmvkiFOcEdTKqPohHJxxtWEhFj+ovjazio8QuMIIH2qsWZiSbaDzyQ5o Xdr/Zc3Gs2vFTNl5dyH9O1SScMJ405GaY7jbdcLI9WDDgeTYXzYHbXmMLic6733Dq0J2 azTA== 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=FyehncyUbcw+D44Qm8ei6pQytMwV2nqUCK4yEPInvH0=; b=h2abmamdPqOubp9pCm51MqTPLpwF8gBbBenYUzPmjcF3/LjHfWc9HiQ8VjsKRkdPlD GWWGjRNu7GREBzJMo62/zw8Fj04z1FLYtLXMzZb/2OY4gZ9S3RE6p1CsuAV4c36toKf1 4pEEVMNHfKpPpuV42VWUeEhhQwlLQq/8jd10pghk+A7o69z7ahD0rWTP07yDqXHMEUMx YNGDfR7aGb1fwKkjwA1IHes9G/3UQE5FJ9XcI/uy9TjWrPU4c70uoWRvmCA3j87J7tUA /WaxR7Zufh6F4e5dvvG/57E6tRd/0uNvI48lpAF/BuU9dA6qserPaQjgz+FpyVsnI5JV ZOaQ== Original-Sender: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org X-Gm-Message-State: APjAAAWpPzZF9T7VLF8+/x5njqyTDFwI05GUvzNF8DeA3n2BeoQlgHUZ XMbYJXD5i76UTdJhqlBikm8= X-Google-Smtp-Source: APXvYqxhAh1j6HjtRbUvSVlJgiGGARU/BK5zG4p96EXIiK3ucfcNIVSvRnw10RZKKckm2BT7EAAzvA== X-Received: by 2002:a9d:670:: with SMTP id 103mr8036352otn.105.1569694482043; Sat, 28 Sep 2019 11:14:42 -0700 (PDT) X-BeenThere: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Original-Received: by 2002:aca:bd44:: with SMTP id n65ls1656726oif.6.gmail; Sat, 28 Sep 2019 11:14:40 -0700 (PDT) X-Received: by 2002:aca:cf51:: with SMTP id f78mr11985332oig.8.1569694480945; Sat, 28 Sep 2019 11:14:40 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1569694480; cv=none; d=google.com; s=arc-20160816; b=CF56bXo3E3zfqAirDv/t5t2SfLEgYKsuboUqOLCqH2fRRui/PwNyk6jxHGtWg5VelF LZg5CCshm3sdqqGR2GFhC0yohR/dkkxRcxLOnaej6innFoIGhT6xgHOqtV6yxpzJa4wF JOqLF9CERmwh/vp6nPZ13UcNW4I26qfAivd3N15fQ+Zs2VyW+5q6XXpsZAmMNwwEiqQP k4YzR1CFWBwRtzomaQ7+VS1E8yTFtm6z+bqBahf6v3IZxS9ib2IOlpF6Jsko2cngHdvL 118WDIRQ1qPFqQYv7ixrXhIUAVLkXiqkD/38bEYijR1SevDHzWCrd3fTpxvCg2SGV4ke BzIw== 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=8yj80iVLeiQBwHHDBCuNYE9i8iZzyoVDtx6/wUFPf7I=; b=IfKWa6iZNjAaZZinwVADCxXqKARPzeofTS3YUOwVmmse8gc3XD6SpQSTSShoX8kADe kKAPo/0VrLD9iY1mBF/bieV/cmxJg3gQj+oS3DWEARzntEYtOOoBZ3mjW9UFxGRfD5cP WYWAAxzaCD4GX5iTZj+K/zd/PzcE9vD9Mna9Da3W7z5KLfykRHf2Mrj5MKFYoNQiGqym z8abWDJeoFx/m44sbaPODlLQNk8gMcQRwSGjZboRA3cc+hGlZBUvgutxDcpxNJb73Jsz +Viycbvr/QxFKGO3yywZyvr2XpKHkVT0LYPEQ7LnBKeBXj0fAsXxwNCQfJUKm3d7ne1W P2LA== ARC-Authentication-Results: i=1; gmr-mx.google.com; dkim=pass header.i=@berkeley-edu.20150623.gappssmtp.com header.s=20150623 header.b=IJLVmlYg; spf=pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:4864:20::532 as permitted sender) smtp.mailfrom=jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org Original-Received: from mail-pg1-x532.google.com (mail-pg1-x532.google.com. [2607:f8b0:4864:20::532]) by gmr-mx.google.com with ESMTPS id c67si417936oig.1.2019.09.28.11.14.40 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sat, 28 Sep 2019 11:14:40 -0700 (PDT) Received-SPF: pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:4864:20::532 as permitted sender) client-ip=2607:f8b0:4864:20::532; Original-Received: by mail-pg1-x532.google.com with SMTP id c17so5138225pgg.4 for ; Sat, 28 Sep 2019 11:14:40 -0700 (PDT) X-Received: by 2002:a65:6285:: with SMTP id f5mr16653505pgv.238.1569694480144; Sat, 28 Sep 2019 11:14:40 -0700 (PDT) Original-Received: from johnmacfarlane.net (li55-134.members.linode.com. [74.82.3.134]) by smtp.gmail.com with ESMTPSA id k71sm16999292pga.16.2019.09.28.11.14.39 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 28 Sep 2019 11:14:39 -0700 (PDT) Original-Received: by johnmacfarlane.net (Postfix, from userid 1000) id 73DC7A258; Sat, 28 Sep 2019 14:14:28 -0400 (EDT) In-Reply-To: <5ddf18fd-b35f-4bf2-99d0-03ca657adb28-/JYPxA39Uh5TLH3MbocFFw@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.20150623.gappssmtp.com header.s=20150623 header.b=IJLVmlYg; spf=pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:4864:20::532 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.org gmane.text.pandoc:23476 Archived-At: Emmanuel Charpentier writes: > I wondered what part of the options, extensions and template variables can > be specified in the YAML header of a Markdown file, thus ensuring that the > "right" set of options is used at compilation. However, I have been unable > to find a description of what can be specified at command line. It wouldn't make sense to put formats and extensions in the YAML header: after all, whether a document can even HAVE a YAML header is dependent on extensions. What would you do if the YAML header said to disable the yaml_metadata extension? You'd have a paradoxical document! All template variables can be set via YAML metadata, because the writers populate variables from metadata values. Command-line options can never be set via YAML metadata, in general, though in some cases it may seem as if they can. For example, you can specify `toc: true`; but this only works in formats where the only thing the `--toc` option has to do is set a `toc` template variable. Rather than adding a comment to the source with installation instructions, I usually use a simple Makefile: output.html: input.md pandoc $< -o $@ --my-options-here... This way, I don't have to remember what options to use. I just type 'make' and it's done.