From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.text.pandoc/14749 Path: news.gmane.org!not-for-mail From: John MacFarlane Newsgroups: gmane.text.pandoc Subject: Re: Use of YAML metadata block Date: Sat, 9 Apr 2016 10:18:19 -0700 Message-ID: <20160409171819.GA64852@MacBook-Air-2.local> References: <57090C95.6050607@gmail.com> Reply-To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed X-Trace: ger.gmane.org 1460222314 27452 80.91.229.3 (9 Apr 2016 17:18:34 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 9 Apr 2016 17:18:34 +0000 (UTC) To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Original-X-From: pandoc-discuss+bncBCJZJHG45QDBBZ7SUS4AKGQEYL6YEHA-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Sat Apr 09 19:18:34 2016 Return-path: Envelope-to: gtp-pandoc-discuss@m.gmane.org Original-Received: from mail-ig0-f190.google.com ([209.85.213.190]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1aowWm-0004DI-VM for gtp-pandoc-discuss@m.gmane.org; Sat, 09 Apr 2016 19:18:33 +0200 Original-Received: by mail-ig0-f190.google.com with SMTP id nt3sf7174888igb.0 for ; Sat, 09 Apr 2016 10:18:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20120806; h=sender:from:date:to:subject:message-id:references:mime-version :content-disposition:in-reply-to:user-agent: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=CkN8+u+Hovp3LuGSX7zEt7e4nYwBYXSM46Gu9v0BXSM=; b=pAaDfebmno9xOQgPmhQHl2TQSZKMugrLwap2djIAT/gpQRSgQ2ydUoGskZZTxTfYAX kLvLG9bx7oR/RFlnftsbSjQ3O4Ct6Rj17Ni4BIjzv2eEhmr6QgH//HXhSp6USZezbCBE G/IMLjKek9xnggE+QJG76I7Yo1f30c3uizoXf/pZ+3Hyao6RR1s19Mu+UNhuT9ry52UA uj7hduK8RRStFBkaBVEnRp0mgA9LBp7H/TRwBo2UUCOlzkBo1iB49xLvMeQK7zXhJZCw kfdz7QwM2tLIiKnfLRK70YNaiA41IRwEmqiPL0pRMDf3jJ0VLFpEFEANrxqKKf4rHGHG WeCQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=sender:x-gm-message-state:from:date:to:subject:message-id :references:mime-version:content-disposition:in-reply-to:user-agent :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=CkN8+u+Hovp3LuGSX7zEt7e4nYwBYXSM46Gu9v0BXSM=; b=X1P+wT7iU3KYj8GZnxBIslhe7PCX9K0Jtgednt4iLZagGr9Vu7nJR3xdAedV5PxBvn ow/003wXmF4jwDXELojguS3tdpxF70cxxcdS7TqWa+24V8FO4DFTBQwheGgEUPXcO8V0 j2GVcOr46np85L3AvNvmF3xAFGUtqpt2zLh13UqJFM2g3DQ5re7jUSkfrtSU10ZRMk92 QeuS9FGAKLYrhDby08+LAIyW2Myn/QimBm0WKIgHl/EFh/cP/4JtdPuDWLjxf+wWgM44 GJYDUcqa8Tm2wiRjSzSG5UTAXCKyrQNkt1lIod4YuetTiQ63qu22noQsTaIW4Ut+qG9p Original-Sender: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org X-Gm-Message-State: AD7BkJLqXfXguwf8bDsARR1hntX/tNwazdY3ZxHj85vFUk9wRdzYnDDXdSUL7MwEvb++kA== X-Received: by 10.157.45.117 with SMTP id v108mr157429ota.10.1460222312175; Sat, 09 Apr 2016 10:18:32 -0700 (PDT) X-BeenThere: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Original-Received: by 10.182.173.104 with SMTP id bj8ls52307obc.63.gmail; Sat, 09 Apr 2016 10:18:31 -0700 (PDT) X-Received: by 10.182.118.169 with SMTP id kn9mr9517348obb.11.1460222311552; Sat, 09 Apr 2016 10:18:31 -0700 (PDT) Original-Received: from mail-pf0-x232.google.com (mail-pf0-x232.google.com. [2607:f8b0:400e:c00::232]) by gmr-mx.google.com with ESMTPS id yr8si732005pac.0.2016.04.09.10.18.31 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 09 Apr 2016 10:18:31 -0700 (PDT) Received-SPF: pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:400e:c00::232 as permitted sender) client-ip=2607:f8b0:400e:c00::232; Original-Received: by mail-pf0-x232.google.com with SMTP id e128so95164304pfe.3 for ; Sat, 09 Apr 2016 10:18:31 -0700 (PDT) X-Received: by 10.98.16.93 with SMTP id y90mr21286837pfi.155.1460222311330; Sat, 09 Apr 2016 10:18:31 -0700 (PDT) Original-Received: from johnmacfarlane.net (li55-134.members.linode.com. [74.82.3.134]) by smtp.gmail.com with ESMTPSA id u21sm26124188pfa.60.2016.04.09.10.18.29 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 09 Apr 2016 10:18:30 -0700 (PDT) Original-Received: by johnmacfarlane.net (Postfix, from userid 1000) id 3C10AA5B3; Sat, 9 Apr 2016 13:18:19 -0400 (EDT) Content-Disposition: inline In-Reply-To: <57090C95.6050607-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> X-PGP-Key: http://johnmacfarlane.net/jgm.asc User-Agent: Mutt/1.5.23 (2014-03-12) 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; spf=pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:400e:c00::232 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-Spam-Checked-In-Group: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org X-Google-Group-Id: 1007024079513 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , Xref: news.gmane.org gmane.text.pandoc:14749 Archived-At: +++ R (Chandra) Chandrasekhar [Apr 09 16 19:37 ]: >I am a little unsure of the boundaries of what a YAML metadata block >can contain in order for it to be correctly interpreted as a command >line option. > >While there is a certain allure to having all compile-time options >sitting in a metadata block in the document itself to make it >self-contained, Pandoc's versatility in format support makes this >difficult to achieve. > >My understanding is that key-value options to --variable and >--metadata can be included in a YAML metadata block, but not standard >command line options like --bibliography or --filter or >--highlight-style (with title, author, date being exceptions.) > >Is this correct? Yes, but with one qualification: some command-line options, like `--bibliography`, do nothing but set a metadata value. So that's a case where you can put it in your YAML metadata. The section of the User's Guide/man page/README entitled Variables is the best place to look for what can be set in YAML metadata.