From: Jim Wisniewski <wisnij@gmail.com>
To: Ihor Radchenko <yantar92@posteo.net>
Cc: emacs-orgmode@gnu.org
Subject: Re: [PATCH] ox.el: Customize org-export-dispatch options
Date: Sat, 15 Apr 2023 16:36:27 -0400 [thread overview]
Message-ID: <CAAukYu0D3iem0-1yVJ=4MmyiR2oFJfgi+fgb9eK51yxAGuMEUw@mail.gmail.com> (raw)
In-Reply-To: <87bkjplbki.fsf@localhost>
[-- Attachment #1: Type: text/plain, Size: 340 bytes --]
On Sat, Apr 15, 2023 at 5:47 AM Ihor Radchenko <yantar92@posteo.net> wrote:
> Thanks! Looks like reasonable addition. See some minor comments below.
Ah, thanks for your feedback; this is my first time contributing to Emacs so I
appreciate the pointers. Okay, I've attached an updated patch per your review
comments.
--
JJW
[-- Attachment #2: 0001-ox.el-Customize-org-export-dispatch-options.patch --]
[-- Type: text/x-patch, Size: 4983 bytes --]
From 1a5f35c6dbea99cfca66ad5c4de098ba02c73306 Mon Sep 17 00:00:00 2001
From: Jim Wisniewski <wisnij@gmail.com>
Date: Fri, 14 Apr 2023 02:46:25 -0400
Subject: [PATCH] ox.el: Customize org-export-dispatch options
* lisp/ox.el (org-export-dispatch): Add customizable variables
`org-export-body-only', `org-export-visible-only', and
`org-export-force-publishing', and use them in `org-export-dispatch'.
* doc/org-manual.org (The Export Dispatcher): Document the new export
variables.
* etc/ORG-NEWS (New customization options for ~org-export-dispatch~):
Announce the new customization options.
Currently when calling `org-export-dispatch', two of the export
options can have their defaults specified with customizable variables:
"Export scope" (via `org-export-initial-scope') and "Async export"
(via `org-export-in-background'). This change adds customizable
variables for the "Body only", "Visible only", and "Force publishing"
options as well.
---
doc/org-manual.org | 22 ++++++++++++++++++++++
etc/ORG-NEWS | 8 ++++++++
lisp/ox.el | 28 ++++++++++++++++++++++++++++
3 files changed, 58 insertions(+)
diff --git a/doc/org-manual.org b/doc/org-manual.org
index a54bd6f35..2e98793bf 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -11773,6 +11773,24 @@ further alter what is exported, and how.
in the export. Affects only those back-end formats that have
sections like =<head>...</head>= in HTML.
+ #+vindex: org-export-body-only
+ To make body-only export the default, customize the variable
+ ~org-export-body-only~.
+
+- {{{kbd(C-f)}}} ::
+ #+kindex: C-c C-e C-f
+
+ Toggle force-publishing export. Publish functions normally only
+ publish changed files (see [[**Triggering Publication]]). Forced
+ publishing causes files to be published even if their timestamps do
+ not indicate the file has been changed.
+
+ #+vindex: org-export-force-publishing
+ To make forced publishing the default, customize the variable
+ ~org-export-force-publishing~. (This is similar to
+ ~org-publish-use-timestamps-flag~, but only affects the export
+ dispatcher.)
+
- {{{kbd(C-s)}}} ::
#+kindex: C-c C-e C-s
@@ -11794,6 +11812,10 @@ further alter what is exported, and how.
certain parts of an Org document by adjusting the visibility of
particular headings. See also [[*Sparse Trees]].
+ #+vindex: org-export-visible-only
+ To make visible-only export the default, customize the variable
+ ~org-export-visible-only~.
+
** Export Settings
:PROPERTIES:
:DESCRIPTION: Common export settings.
diff --git a/etc/ORG-NEWS b/etc/ORG-NEWS
index b6acafc3d..59a7498a0 100644
--- a/etc/ORG-NEWS
+++ b/etc/ORG-NEWS
@@ -168,6 +168,14 @@ backend used for evaluation of ClojureScript.
official [[https://clojure.org/guides/deps_and_cli][Clojure CLI tools]].
The command can be customized with ~ob-clojure-cli-command~.
+*** New customization options for ~org-export-dispatch~
+
+New custom variables ~org-export-body-only~,
+~org-export-visible-only~, and ~org-export-force-publishing~ allow the
+default settings of "Body only", "Visible only", and "Force
+publishing" in the ~org-export-dispatch~ UI to be customized,
+respectively.
+
** New features
*** Add support for ~logind~ idle time in ~org-user-idle-seconds~
diff --git a/lisp/ox.el b/lisp/ox.el
index 8be60985f..af5b0abe8 100644
--- a/lisp/ox.el
+++ b/lisp/ox.el
@@ -955,6 +955,31 @@ these cases."
:group 'org-export-general
:type 'boolean)
+(defcustom org-export-body-only nil
+ "The initial \"Body only\" setting when exporting with `org-export-dispatch'.
+Non-nil means only export body code, without the surrounding
+template."
+ :group 'org-export-general
+ :package-version '(Org . "9.7")
+ :type 'boolean
+ :safe #'booleanp)
+
+(defcustom org-export-visible-only nil
+ "The initial \"Visible only\" setting when exporting with `org-export-dispatch'.
+Non-nil means don't export the contents of hidden elements."
+ :group 'org-export-general
+ :package-version '(Org . "9.7")
+ :type 'boolean
+ :safe #'booleanp)
+
+(defcustom org-export-force-publishing nil
+ "The initial \"Force publishing\" setting when exporting with `org-export-dispatch'.
+Non-nil means force all files in the project to be published."
+ :group 'org-export-general
+ :package-version '(Org . "9.7")
+ :type 'boolean
+ :safe #'booleanp)
+
(defcustom org-export-in-background nil
"Non-nil means export and publishing commands will run in background.
Results from an asynchronous export are never displayed
@@ -7094,6 +7119,9 @@ asynchronous export stack."
(setq org-export-dispatch-last-action
(org-export--dispatch-ui
(list org-export-initial-scope
+ (and org-export-body-only 'body)
+ (and org-export-visible-only 'visible)
+ (and org-export-force-publishing 'force)
(and org-export-in-background 'async))
nil
org-export-dispatch-use-expert-ui)))
--
2.39.2
next prev parent reply other threads:[~2023-04-15 20:37 UTC|newest]
Thread overview: 14+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-04-15 4:48 [PATCH] ox.el: Customize org-export-dispatch options Jim Wisniewski
2023-04-15 9:49 ` Ihor Radchenko
2023-04-15 20:36 ` Jim Wisniewski [this message]
2023-04-16 13:00 ` Ihor Radchenko
2023-04-19 21:44 ` Jim Wisniewski
2023-04-20 8:48 ` Ihor Radchenko
2023-04-21 18:04 ` Jim Wisniewski
2023-04-22 12:40 ` Ihor Radchenko
2023-05-02 21:05 ` Jim Wisniewski
2023-05-03 11:46 ` Ihor Radchenko
2023-05-14 13:21 ` Bastien Guerry
2023-05-14 14:19 ` Ihor Radchenko
2023-05-14 18:35 ` Jim Wisniewski
2023-04-15 11:08 ` Max Nikulin
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to='CAAukYu0D3iem0-1yVJ=4MmyiR2oFJfgi+fgb9eK51yxAGuMEUw@mail.gmail.com' \
--to=wisnij@gmail.com \
--cc=emacs-orgmode@gnu.org \
--cc=yantar92@posteo.net \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).