From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id uJceBaau12KjfwAAbAwnHQ (envelope-from ) for ; Wed, 20 Jul 2022 09:28:38 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id yGAEBaau12IqigAAauVa8A (envelope-from ) for ; Wed, 20 Jul 2022 09:28:38 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id B3AD837B09 for ; Wed, 20 Jul 2022 09:28:37 +0200 (CEST) Received: from localhost ([::1]:57174 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oE48K-0001D1-Vc for larch@yhetil.org; Wed, 20 Jul 2022 03:28:36 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:40134) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oE47t-0001Ck-ON for emacs-orgmode@gnu.org; Wed, 20 Jul 2022 03:28:09 -0400 Received: from mail-pf1-x42d.google.com ([2607:f8b0:4864:20::42d]:38722) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oE47s-00035o-2U for emacs-orgmode@gnu.org; Wed, 20 Jul 2022 03:28:09 -0400 Received: by mail-pf1-x42d.google.com with SMTP id o12so15790979pfp.5 for ; Wed, 20 Jul 2022 00:28:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:in-reply-to:references:date:message-id :mime-version:content-transfer-encoding; bh=AgRJ7JIo/V5a4Ks8wLPyd0IOwFFHkNW8x/L/RfWOoWw=; b=b7CDJrS0dZKiJEfUP/+yrBgM9FXQ0UVgArZgGy8wj84eGNVHIlyE0zHBcs+OD8P40p evWcgE6aYsNgGAIR41YDG3Tv08xErn35FhiUb1LjFpsUfcEb2s7+bB/4Fz/f9qWZb79Y j6fDAKxdSha+I+GoipX9QPt4MfoRv5O3LFT9plVCB1bAqTiC3wz5ihbfF8cUFRovJEGJ sjxz4GbCLtwdlfSoLrH8rZYupcbz9LWYqpWhcYFKyLGeuhy67uTYfKURDuN7rQ21doWM rFqvaZSdO/yejZuJTvCPwTeiaY3hG3jxLVJCs+ef1PKfkSbnIb8iedvLJIrt+8P4+bFQ 6jyg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:in-reply-to:references:date :message-id:mime-version:content-transfer-encoding; bh=AgRJ7JIo/V5a4Ks8wLPyd0IOwFFHkNW8x/L/RfWOoWw=; b=wSXAjnt78Un/S8qlLNB1UmOt8bBMEiOQm0FXFZ31QU+ouPugc+lFwZ7McJ09JbrGzj 0GZfelDiX1347YjlKASkTQZ3KODXlMLY3j15bXPRAOHV/ewE7LnOik0cpJQo6a4fj0a/ DB1hHpZG0MtKWqQZzLHuy8p4F9Uxzajf6wkw4nRK4boOMmxDswxhePk59QQiEE/OWh2E sLvWwO6IDq6AFVOQ7fqtFHQKdM2/v3Et9a+6JswaPmHMwUh4S7PNG+LthP9BeTLlakZZ dIBWw4+vTSaUNhMVtQ/5hjYQ4SRbneFiSKjR79q4uGk8xm9Nj1GsdwR2mh4VyY47WHX0 nB/g== X-Gm-Message-State: AJIora9KFvD4GjVyMxwoyGmmt9Y7matSVj/cl0HSQy5XEvnwPcGv+DOw r+qa7S6pwO0Jq2Vi6085d+w= X-Google-Smtp-Source: AGRyM1umjaCk1ICWmwCbv6o7Gs4B6Z1a0OsZDB54PAey3jtT6heFdpVOT8mAJ65f0llRr4Ye9IBSlg== X-Received: by 2002:a62:b514:0:b0:525:1ccd:4506 with SMTP id y20-20020a62b514000000b005251ccd4506mr37406524pfe.8.1658302086538; Wed, 20 Jul 2022 00:28:06 -0700 (PDT) Received: from localhost ([115.154.175.57]) by smtp.gmail.com with ESMTPSA id i11-20020a170902c94b00b0016cdfcdcff2sm8731305pla.19.2022.07.20.00.28.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 20 Jul 2022 00:28:06 -0700 (PDT) From: Ihor Radchenko To: alain.cochard@unistra.fr Cc: kevinbanjo , emacs-orgmode Subject: Re: discovering export (and other) keywords? In-Reply-To: <25302.22006.8135.337019@gargle.gargle.HOWL> References: <25302.22006.8135.337019@gargle.gargle.HOWL> Date: Wed, 20 Jul 2022 15:29:11 +0800 Message-ID: <87sfmw2qew.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2607:f8b0:4864:20::42d; envelope-from=yantar92@gmail.com; helo=mail-pf1-x42d.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1658302117; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=AgRJ7JIo/V5a4Ks8wLPyd0IOwFFHkNW8x/L/RfWOoWw=; b=U1VLEAB3BZJ+XIdQ1K4IYC+kUb0mmvce/JDd3YIhGq3xXYcgxempDFOp5RjQkHLbfCUXM1 ylVRA565VwPGbQSmdNoZGOfsvvLpxHLr08R2JcsXBUbvqw1Px9ZdTRPtdgRUDLG8TVqicU 84Z3kSEokoQI4XDQOPTTj/WVJX8utTVbn+tvAZqYAZL6U+M2TdIU0ZthhLGHTn2lM2eZAc gBo27NJWDKHrOHgkferwDpQlsv2GJub3O3o7UeZles2EdqeGxgw3I8IuYACPs14cFpbDKr TS4bANxJNOeouoWgthWWpyGj/fBwBqi2UTYz2rde7iZY93u9IiGnKDRwsx3aAA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1658302117; a=rsa-sha256; cv=none; b=gfYevkVDx9WY7iX+45k3TkbjJXWubD4v+361gmPt+/tRszfLMhltKDTa+SVe9ksJcuddLI mnp9eQ521SfqRV5tVfUfgESb63I1XgIFhHW6UpM6W7dY+Py7WH7y6t+DzyAMR2+MNUeARi xprRs9d3gow+QgllzMaGC69xBJvnmmLNp9zD6Jtxkf/ZTGUqHfXbPZLeCTgIFlYBjwTJho IVNJRaYvLIalrLoJK7T5Jc7wwdLtIaqsh+RhxgiwhCEyrqGyHmAYcJjcz/lKTXqdLrMTWY aJDGLunKq8eOOkrv2j5f3mUlvlQ8c4ZrFEaAtbJJ2k4IpNgr8anl2nKs1VEVOg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=b7CDJrS0; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -2.44 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=b7CDJrS0; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: B3AD837B09 X-Spam-Score: -2.44 X-Migadu-Scanner: scn1.migadu.com X-TUID: FKKhQdERB4FX Alain.Cochard@unistra.fr writes: > kevinbanjo writes on Mon 18 Jul 2022 05:10: > > this page: > >=20 > > https://orgmode.org/manual/Macro-Replacement.html#index-macro-replacem= ent_002c-during-export > >=20 > > says: > >=20 > > Org also recognizes macro references in keywords, such as =E2=80=98CAP= TION=E2=80=99, =E2=80=98TITLE=E2=80=99, > > =E2=80=98AUTHOR=E2=80=99, =E2=80=98DATE=E2=80=99, *and for some back-e= nd specific export options.* > >=20 > > How do I discover what those back end specific options are? > > I am guessing it would be difficult to maintain a list of these > options. On the other hand it should be quick for you to check for a > specific one. We actually do. For example, "Beamer specific export settings" section of the manual lists all the settings for ox-beamer. If something is missing from the manual, let us know, and we will fix it. Meanwhile, I think that we can clarify what "some back-end specific export options" refer to: Org also recognizes macro references in keywords, such as =E2=80=98CAPTION= =E2=80=99, =E2=80=98TITLE=E2=80=99, =E2=80=98AUTHOR=E2=80=99, =E2=80=98DATE=E2=80=99, = and for some back-end specific export options (detailed in the relevant sections of the manual). Will it be more clear? Another possibility could be changing the format of options alist when defining export backend. We may allow an optional (but recommended) docstring field to be provided when defining a backend and its options. Such docstring can then be used in hypothetical org-export-describe-backend command that will generate something similar to M-x describe-mode documentation. This new command cal also be added to the export menu for easy access. WDYT? > > Also, for various elements (e.g. begin_src emacs-lisp, begin_export ht= ml, > > etc...) how do I discover what the acceptable keywords are, preferably > > without only having to go thru the manual pages? > > I don't think you can avoid going through the manual. My experience > is that it is painful anyway. I would advise you to start from the > few examples provided in the manual and try to adapt to your case; > when an (as simple as possible) example does not work as you would > expect, ask the list; there is a good chance that a good Samaritan > will have pity for you and answer. Because keywords may be specific to a backend and there are also third-party backends, we cannot easily provide such information on-the-fly - Org has no idea about the intended export backend when you type in an Org document; not to mentioned that there may be multiple intended backends. Best, Ihor