* section subtitle in latex export
@ 2013-05-02 1:49 Masataro Asai
2013-05-02 3:26 ` Masataro Asai
0 siblings, 1 reply; 9+ messages in thread
From: Masataro Asai @ 2013-05-02 1:49 UTC (permalink / raw)
To: emacs-orgmode
Hi all,
I am currently writing a journal thesis in org-mode and exporting it
to a LaTeX file. It worked well until recently I have updated the
org-mode version
to the latest one.
My problem is that the specified class file for the journal fails to
interpret the subtitle
of the sectioning command e.g.) \section[subtitle]{title} . Is it
possible to turn off that subtitle?
I looked into the source code of ox-latex.el but org-latex-section tells
nothing about it.
I have also checked org-latex-classes but curiously
the sectioning format is just "\\section{%s}" and so on. no subtitle.
org-mode version is the latest devel in the git repository, after 8.0.2,
git commit hash is 00badf1
and the emacs version is 23.3.1
--
Masataro Asai
Department of General Systems Studies
Graduate School of Arts and Sciences, The University of Tokyo
Tel: (81)-44-856-9009
Twitter/github id: guicho271828
^ permalink raw reply [flat|nested] 9+ messages in thread* Re: section subtitle in latex export 2013-05-02 1:49 section subtitle in latex export Masataro Asai @ 2013-05-02 3:26 ` Masataro Asai 2013-05-02 4:46 ` Aaron Ecay 2013-05-02 8:26 ` Nicolas Goaziou 0 siblings, 2 replies; 9+ messages in thread From: Masataro Asai @ 2013-05-02 3:26 UTC (permalink / raw) To: emacs-orgmode Reply to myself: I edebugged the ox-latex and studied what's happening. Who wrote this code? you shouldn't do things like this... The code is overwriting the defcustom'ed sectioning format, no one knows. the best answer for this problem would be changing the structure of org-latex-classes but I dont want to do that right now. so I just gave an option for alternative-heading. diff --git a/lisp/ox-latex.el b/lisp/ox-latex.el index 2a315ef..95e96f0 100644 --- a/lisp/ox-latex.el +++ b/lisp/ox-latex.el @@ -303,6 +303,12 @@ a format string in which the section title will be added." (string :tag "Closing (unnumbered)")) (function :tag "Hook computing sectioning")))))) +(defcustom org-latex-alternative-section-title-enabled t + "Output alternative section title such as +\\section[short title]{Long long very long title}." + :group 'org-export-latex + :type 'boolean) + (defcustom org-latex-inputenc-alist nil "Alist of inputenc coding system names, and what should really be used. For example, adding an entry @@ -1442,7 +1448,7 @@ holding contextual information." (org-export-data (org-export-get-alt-title headline info) info) (and (eq (plist-get info :with-tags) t) tags)))) - (if (and numberedp opt-title + (if (and numberedp opt-title org-latex-alternative-section-title-enabled (string-match "\\`\\\\\\(.*?[^*]\\){" section-fmt)) (format (replace-match "\\1[%s]" nil nil section-fmt 1) ;; Replace square brackets with parenthesis On 2013年05月02日 10:49, Masataro Asai wrote: > Hi all, > > I am currently writing a journal thesis in org-mode and exporting it > to a LaTeX file. It worked well until recently I have updated the > org-mode version > to the latest one. > > My problem is that the specified class file for the journal fails to > interpret the subtitle > of the sectioning command e.g.) \section[subtitle]{title} . Is it > possible to turn off that subtitle? > I looked into the source code of ox-latex.el but org-latex-section tells > nothing about it. > I have also checked org-latex-classes but curiously > the sectioning format is just "\\section{%s}" and so on. no subtitle. > > org-mode version is the latest devel in the git repository, after 8.0.2, > git commit hash is 00badf1 > and the emacs version is 23.3.1 > -- Masataro Asai Department of General Systems Studies Graduate School of Arts and Sciences, The University of Tokyo Tel: (81)-44-856-9009 Twitter/github id: guicho271828 ^ permalink raw reply related [flat|nested] 9+ messages in thread
* Re: section subtitle in latex export 2013-05-02 3:26 ` Masataro Asai @ 2013-05-02 4:46 ` Aaron Ecay 2013-05-02 8:06 ` Rasmus 2013-05-02 8:29 ` Nicolas Goaziou 2013-05-02 8:26 ` Nicolas Goaziou 1 sibling, 2 replies; 9+ messages in thread From: Aaron Ecay @ 2013-05-02 4:46 UTC (permalink / raw) To: Masataro Asai; +Cc: emacs-orgmode [-- Attachment #1: Type: text/plain, Size: 1004 bytes --] Hi Masataro, I agree that it is weird for org to insert the alternate header when it is identical to the regular header. I think it is unnecessary complication to introduce a new option to control this, though – it can be automatic. Try the patch attached to this email. It simply avoids inserting the alternate heading whenever it is identical to the standard one. (Nicolas, I’m waiting to see if you have any thoughts before pushing this patch to the org repo.) 2013ko maiatzak 1an, Masataro Asai-ek idatzi zuen: [...] > @@ -1442,7 +1448,7 @@ holding contextual information." > (org-export-data > (org-export-get-alt-title headline info) info) > (and (eq (plist-get info :with-tags) t) tags)))) > - (if (and numberedp opt-title > + (if (and numberedp opt-title > org-latex-alternative-section-title-enabled It looks like your patch got line-wrapped here. Better to send patches as attachments to avoid this. [-- Attachment #2: 0001-ox-latex.el-org-latex-headline-Don-t-insert-alternat.patch --] [-- Type: text/x-patch, Size: 1643 bytes --] From f84800fb82d432112a06918bbe389a00968773bc Mon Sep 17 00:00:00 2001 From: Aaron Ecay <aaronecay@gmail.com> Date: Thu, 2 May 2013 00:36:44 -0400 Subject: [PATCH] =?UTF-8?q?ox-latex.el=20(org-latex-headline):=20Don?= =?UTF-8?q?=E2=80=99t=20insert=20alternate=20title=20if=20identical=20to?= =?UTF-8?q?=20regular=20one?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * lisp/ox-latex.el (org-latex-headline): Don’t insert alternate title if identical to regular one. --- lisp/ox-latex.el | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/lisp/ox-latex.el b/lisp/ox-latex.el index 2a315ef..66eefa1 100644 --- a/lisp/ox-latex.el +++ b/lisp/ox-latex.el @@ -1435,7 +1435,8 @@ holding contextual information." (format "\n\\\\end{%s}" (if numberedp 'enumerate 'itemize)) low-level-body))) ;; This is a standard headline. Export it as a section. Add - ;; an alternative heading when possible. + ;; an alternative heading when possible, and when this is not + ;; identical to the usual heading. (let ((opt-title (funcall org-latex-format-headline-function todo todo-type priority @@ -1443,6 +1444,7 @@ holding contextual information." (org-export-get-alt-title headline info) info) (and (eq (plist-get info :with-tags) t) tags)))) (if (and numberedp opt-title + (not (equal opt-title full-text)) (string-match "\\`\\\\\\(.*?[^*]\\){" section-fmt)) (format (replace-match "\\1[%s]" nil nil section-fmt 1) ;; Replace square brackets with parenthesis -- 1.8.2.2 [-- Attachment #3: Type: text/plain, Size: 16 bytes --] -- Aaron Ecay ^ permalink raw reply related [flat|nested] 9+ messages in thread
* Re: section subtitle in latex export 2013-05-02 4:46 ` Aaron Ecay @ 2013-05-02 8:06 ` Rasmus 2013-05-02 8:29 ` Nicolas Goaziou 1 sibling, 0 replies; 9+ messages in thread From: Rasmus @ 2013-05-02 8:06 UTC (permalink / raw) To: emacs-orgmode Aaron Ecay <aaronecay@gmail.com> writes: > Try the patch attached to this email. It simply avoids > inserting the alternate heading whenever it is identical to the > standard > one. Sounds good to me. Aesthetically, the insertion of \section[·]{·} has bothered me. . . –Rasmus -- ⠠⠵ ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: section subtitle in latex export 2013-05-02 4:46 ` Aaron Ecay 2013-05-02 8:06 ` Rasmus @ 2013-05-02 8:29 ` Nicolas Goaziou 2013-05-03 8:18 ` Aaron Ecay 1 sibling, 1 reply; 9+ messages in thread From: Nicolas Goaziou @ 2013-05-02 8:29 UTC (permalink / raw) To: Masataro Asai; +Cc: emacs-orgmode Hello, Aaron Ecay <aaronecay@gmail.com> writes: > (Nicolas, I’m waiting to see if you have any thoughts before pushing > this patch to the org repo.) That's good. Please push it into maint branch. Regards, -- Nicolas Goaziou ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: section subtitle in latex export 2013-05-02 8:29 ` Nicolas Goaziou @ 2013-05-03 8:18 ` Aaron Ecay 0 siblings, 0 replies; 9+ messages in thread From: Aaron Ecay @ 2013-05-03 8:18 UTC (permalink / raw) To: Nicolas Goaziou; +Cc: Masataro Asai, emacs-orgmode Hello Nicolas, 2013ko maiatzak 2an, Nicolas Goaziou-ek idatzi zuen: > That's good. Please push it into maint branch. Done. I then merged the patch into the master branch. Thanks, -- Aaron Ecay ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: section subtitle in latex export 2013-05-02 3:26 ` Masataro Asai 2013-05-02 4:46 ` Aaron Ecay @ 2013-05-02 8:26 ` Nicolas Goaziou 2013-05-02 11:05 ` Masataro Asai 1 sibling, 1 reply; 9+ messages in thread From: Nicolas Goaziou @ 2013-05-02 8:26 UTC (permalink / raw) To: Masataro Asai; +Cc: emacs-orgmode Hello, Masataro Asai <guicho2.71828@gmail.com> writes: > Reply to myself: > > I edebugged the ox-latex and studied what's happening. > Who wrote this code? Obviously, not you. > you shouldn't do things like this... The code is overwriting the > defcustom'ed sectioning format, no one knows. Doing what? Would you mind giving an example of that overwriting thing? > the best answer for this problem would be changing the structure of > org-latex-classes Really? > but I dont want to do that right now. so I just gave an option for > alternative-heading. Why would you want to remove every optional title? That would break things like tags:not-in-toc and ALT_TITLE properties. Regards, -- Nicolas Goaziou ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: section subtitle in latex export 2013-05-02 8:26 ` Nicolas Goaziou @ 2013-05-02 11:05 ` Masataro Asai 2013-05-02 14:00 ` Nicolas Goaziou 0 siblings, 1 reply; 9+ messages in thread From: Masataro Asai @ 2013-05-02 11:05 UTC (permalink / raw) To: Nicolas Goaziou; +Cc: emacs-orgmode [-- Attachment #1: Type: text/plain, Size: 2114 bytes --] Nicolas, sorry for my offending remarks in the second message. i was just a little nervous about that unexpected behavior for me. org latex classes can be considererd as a template. template is somewhat similer to lambda. you wouldnt want any function to be modified by another function which recieved it as its argument. so if something may be inserted in the template without notice, instead it should be better if it has more arguments. say additional %s. if only there is two of them in the template you can add alternative title, this may be an option. amother option is, giving altered version explicitly. which may make it accept four templates per sectioning, numbered,unnumbered,alternative numbered, altered unnumbered. some people, at least not me, may want this feature. if user can modify that behavior it would be definitrly better. well, that may inflate the list of vars in customs, but thats another ploblem. the reason of cancelling the alt title, the situation im in is written in the first message. one journal template throws an error because it does not recognize altered titles. maybe i can write a script which regex all alt titles out, but i wanted to contribute to the development of org. sorry for many typos, im currentry wrting on android. masataro 2013/05/02 17:26 "Nicolas Goaziou" <n.goaziou@gmail.com>: > Hello, > > Masataro Asai <guicho2.71828@gmail.com> writes: > > > Reply to myself: > > > > I edebugged the ox-latex and studied what's happening. > > Who wrote this code? > > Obviously, not you. > > > you shouldn't do things like this... The code is overwriting the > > defcustom'ed sectioning format, no one knows. > > Doing what? Would you mind giving an example of that overwriting thing? > > > the best answer for this problem would be changing the structure of > > org-latex-classes > > Really? > > > but I dont want to do that right now. so I just gave an option for > > alternative-heading. > > Why would you want to remove every optional title? That would break > things like tags:not-in-toc and ALT_TITLE properties. > > > Regards, > > -- > Nicolas Goaziou > [-- Attachment #2: Type: text/html, Size: 2616 bytes --] ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: section subtitle in latex export 2013-05-02 11:05 ` Masataro Asai @ 2013-05-02 14:00 ` Nicolas Goaziou 0 siblings, 0 replies; 9+ messages in thread From: Nicolas Goaziou @ 2013-05-02 14:00 UTC (permalink / raw) To: Masataro Asai; +Cc: emacs-orgmode Masataro Asai <guicho2.71828@gmail.com> writes: > org latex classes can be considererd as a template. template is somewhat > similer to lambda. you wouldnt want any function to be modified by another > function which recieved it as its argument. Of course, `org-latex-classes' is a template. But it doesn't apply on table of contents. However, Org needs some ways to control them. Therefore it needs to handle optional arguments in \section macros and alike. > so if something may be inserted in the template without notice, instead it > should be better if it has more arguments. say additional %s. if only there > is two of them in the template you can add alternative title, There are already other ways to control the alternative title. See below. > this may be an option. amother option is, giving altered version > explicitly. There is the ALT_TITLE property, which allows to set an alternate title for a given headline. [...] > the reason of cancelling the alt title, the situation im in is written in > the > first message. one journal template throws an error because it does not > recognize altered titles. > maybe i can write a script which regex all alt titles out, You can indeed write a filter for headlines which would remove every optional title (see `org-export-filter-headline-functions'). Though, Aaron Ecay's patch should solve most of the cases: no alternate title will be added if you don't use ALT_TITLE or tags:not-in-toc option. > but i wanted to contribute to the development of org. You're welcome. But for the problem at hand, your patch isn't, IMO, an acceptable solution. Regards, -- Nicolas Goaziou ^ permalink raw reply [flat|nested] 9+ messages in thread
end of thread, other threads:[~2013-05-03 8:18 UTC | newest] Thread overview: 9+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2013-05-02 1:49 section subtitle in latex export Masataro Asai 2013-05-02 3:26 ` Masataro Asai 2013-05-02 4:46 ` Aaron Ecay 2013-05-02 8:06 ` Rasmus 2013-05-02 8:29 ` Nicolas Goaziou 2013-05-03 8:18 ` Aaron Ecay 2013-05-02 8:26 ` Nicolas Goaziou 2013-05-02 11:05 ` Masataro Asai 2013-05-02 14:00 ` Nicolas Goaziou
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).