* Re: Using Org for a dissertation
2012-05-12 18:23 Using Org for a dissertation Richard Lawrence
@ 2012-05-12 16:49 ` Eric Schulte
2012-05-15 5:02 ` Richard Lawrence
2012-06-14 12:39 ` Rasmus
2012-05-12 19:27 ` Thomas S. Dye
` (3 subsequent siblings)
4 siblings, 2 replies; 25+ messages in thread
From: Eric Schulte @ 2012-05-12 16:49 UTC (permalink / raw)
To: Richard Lawrence; +Cc: emacs-orgmode
Hi Richard,
Richard Lawrence <richard.lawrence@berkeley.edu> writes:
> Hi all,
>
> I am a graduate student in philosophy, and I am about to begin writing
> my dissertation. I am wondering about whether I should write it in Org,
> or stick to plain LaTeX.
>
> This question has been asked before:
> http://article.gmane.org/gmane.emacs.orgmode/22756
>
> But that was two years ago; Org has changed a fair bit, and I'm
> wondering if there are any updates to the advice given there. Moreover,
> I'm wondering if anyone has written a dissertation or other long
> documents in Org in the meantime, and what their experiences have been.
> (Henri-Paul, do you still read this list?)
>
I am currently writing my dissertation (proposal) in Org-mode. So far
it is working very well for me, I can export to both PDF for more formal
submissions to my adviser and to HTML for less formal posting to a web
page. I keep *all* of my reading notes as Org-bibtex headlines in a
single large reading.org file. I have a (somewhat complex) system
whereby I am able to reference these bibtex entries from the
dissertation and automatically generate the required .bib file as part
of my document export process. One nice side effect of this setup has
been the ability to do a fun graphical export of my references [1].
My entire dissertation directory is in a public git repository [2], you
may find my Makefile [3] useful (although again I should warn you that
my particular setup may be needlessly complex).
>
> I have used Org to write most of the shorter papers I have so far
> written as a graduate student, and been very happy with the results. I
> prefer most of Org's editing features and conventions to bare LaTeX. I
> haven't previously had much of a need to mix TODO items and writing, but
> imagine I will with a dissertation. I *have* been relying on Org's
> to-do list features for my reading: I enter new readings as TODO items
> via capture, and include the bibliographic fields that make them
> suitable to export via org-bibtex when it comes time to reference them.
> None of the writing I've done so far has had strict formatting
> requirements, however, and I have run into enough small formatting
> issues in the past that I want to avoid having them grow into large
> issues in the context of a dissertation.
>
> Since I am not in the sciences, I doubt that I will have many figures or
> complex tables, which I know can lead to headaches. Here are a few of
> the things I *am* worried about. I'm sure most of them can be dealt
> with; I am guessing that most of these issues reflect my ignorance or
> outdated knowledge of Org features. I'd be grateful for pointers or
> workarounds for them:
>
> 1) Section labels and other in-document references. It's nice that Org
> generates these on export, but I need to be able to assign and use
> labels that will not change if the document is reordered. I know I can
> simply add such labels via a \label command, but I am worried that using
> them in addition to Org's autogenerated labels might cause numbering
> problems in LaTeX.
>
I've not run into any such problems. I tend to construct all of my
labels through Org-mode (which works well for export to both HTML and
LaTeX).
>
> 2) Escaping/unrecognized commands. I have occassionally run into
> annoyances where Org escapes characters or commands that I intend to be
> exported literally ("~" and "$" are perennial offenders). Export also
> tends to break when fill-paragraph breaks a LaTeX command across a line,
> like:
>
> some preceding text up to the end of the line \cite{SomeAuthorReference,
> AnotherReference}.
>
I deal with the above by not placing spaces in such commands, so the
above becomes
\cite{SomeAuthorReference,AnotherReference}
>
> 3) Indentation around #+BEGIN_*/#+END_* environments. (I most often
> use QUOTE.) I usually have to explicitly control indentation in a way
> that I wouldn't have to in LaTeX, because Org inserts blank lines
> around them during export.
>
> 4) Inline footnotes. I usually prefer to use inline footnotes, but I
> think I have found in the past that Org's syntax for inline footnotes
> ([fn:: ...]) interacts badly with LaTeX commands, especially anything
> requiring a "]" in the footnote text.
>
again, I haven't run into either of the above, but working in Philosophy
you likely have more stringent footnotes needs than I do in CS.
>
> 5) Bibtex and bibliographies. I love keeping my reading list as Org
> TODO entries, but would like a more automated way to export (just) the
> entries I need for a particular document to a .bib file.
My setup is to keep a tasks.org file with reading related tasks which
holds Org-mode links to all of my references. As part of my document
export process I scan through that file, jumping to each link and
running `org-bibtex-export-to-kill-ring' at each reference. I then dump
all of these bibtex entries into a .bib file. By using a Makefile rule
the .bib file is only regenerated when I've changed my tasks.org file.
> I would also like to have more control over the bibliography as a
> section of my document. The \bibliography command must live under
> some Org heading or other, and as far I as know it can't live under
> its own without generating an extraneous heading, so I have to be
> careful that it ends up at the end of the last section.
>
This always feels hacky, but I just place this command at the end of the
document in whatever section (usually "conclusion") that may be.
>
> Are there other issues that people have run into when using Org to write
> a longer document with strict formatting requirements? Again, any and
> all advice is greatly appreciated!
>
When preparing a JSS paper for publication [4] we found that to satisfy
some of the Journal's specific formatting rules we had to add a new
document class, add a new link type, and post-process the generated
LaTeX. The entirety of this customization may be found here [5] -- the
Makefile in that directory may also be helpful.
In summary, I have very much enjoyed writing longer documents in
Org-mode (on those few occasions when all authors are Org-mode users).
With the ability to write in-line latex it is possible to meet any
stringent output requirements.
I hope this helps,
>
> Thanks,
> Richard
>
>
Footnotes:
[1] http://cs.unm.edu/~eschulte/dissertation/refs/force.html
[2] http://gitweb.adaptive.cs.unm.edu/dissertation.git/tree
[3] http://gitweb.adaptive.cs.unm.edu/dissertation.git/blob_plain/HEAD:/Makefile
[4] http://www.jstatsoft.org/v46/i03
[5] https://github.com/eschulte/org-mode-jss/blob/master/init.el
--
Eric Schulte
http://cs.unm.edu/~eschulte/
^ permalink raw reply [flat|nested] 25+ messages in thread* Re: Using Org for a dissertation
2012-05-12 16:49 ` Eric Schulte
@ 2012-05-15 5:02 ` Richard Lawrence
2012-06-14 12:39 ` Rasmus
1 sibling, 0 replies; 25+ messages in thread
From: Richard Lawrence @ 2012-05-15 5:02 UTC (permalink / raw)
To: Eric Schulte; +Cc: Richard Lawrence, emacs-orgmode
Hi Eric,
Eric Schulte <eric.schulte@gmx.com> wrote:
> I am currently writing my dissertation (proposal) in Org-mode. So far
> it is working very well for me, I can export to both PDF for more formal
> submissions to my adviser and to HTML for less formal posting to a web
> page. I keep *all* of my reading notes as Org-bibtex headlines in a
> single large reading.org file. I have a (somewhat complex) system
> whereby I am able to reference these bibtex entries from the
> dissertation and automatically generate the required .bib file as part
> of my document export process. One nice side effect of this setup has
> been the ability to do a fun graphical export of my references [1].
>
> My entire dissertation directory is in a public git repository [2], you
> may find my Makefile [3] useful (although again I should warn you that
> my particular setup may be needlessly complex).
Thanks for your helpful advice! Your org-bibtex setup in particular
looks like exactly what I need. (Your dissertation proposal looks very
interesting, too!)
I think what I will do is stick with Org for now, and try to be smarter
about a few things (like the #+LABEL command...which I must have read
about at some point but forgotten) so that, if I ever need to drop down
to straight LaTeX, it will be easy to make the switch. You've given me
a helpful example to follow.
Best,
Richard
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Using Org for a dissertation
2012-05-12 16:49 ` Eric Schulte
2012-05-15 5:02 ` Richard Lawrence
@ 2012-06-14 12:39 ` Rasmus
2012-06-14 16:13 ` Eric S Fraga
1 sibling, 1 reply; 25+ messages in thread
From: Rasmus @ 2012-06-14 12:39 UTC (permalink / raw)
To: Eric Schulte; +Cc: emacs-orgmode
Eric Schulte <eric.schulte@gmx.com> writes:
>> 1) Section labels and other in-document references. It's nice that
>> Org
>> generates these on export, but I need to be able to assign and use
>> labels that will not change if the document is reordered. I know I
>> can
>> simply add such labels via a \label command, but I am worried that
>> using
>> them in addition to Org's autogenerated labels might cause numbering
>> problems in LaTeX.
>>
>
> I've not run into any such problems. I tend to construct all of my
> labels through Org-mode (which works well for export to both HTML and
> LaTeX).
Could you describe how to do section links and references from within
Org. I have tried to figure this out for a while now. The only
solution I can find (on Worg) depends on precise section names, which is
not so stable. I use the new latex export engine
> [2] http://gitweb.adaptive.cs.unm.edu/dissertation.git/tree
This link is unfortunately dead.
–Rasmus
--
Send from my Emacs
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Using Org for a dissertation
2012-06-14 12:39 ` Rasmus
@ 2012-06-14 16:13 ` Eric S Fraga
0 siblings, 0 replies; 25+ messages in thread
From: Eric S Fraga @ 2012-06-14 16:13 UTC (permalink / raw)
To: Rasmus; +Cc: emacs-orgmode, Eric Schulte
[-- Attachment #1: Type: text/plain, Size: 977 bytes --]
Rasmus <rasmus@gmx.us> writes:
> Eric Schulte <eric.schulte@gmx.com> writes:
>
>>> 1) Section labels and other in-document references. It's nice that
>>> Org
>>> generates these on export, but I need to be able to assign and use
>>> labels that will not change if the document is reordered. I know I
>>> can
>>> simply add such labels via a \label command, but I am worried that
>>> using
>>> them in addition to Org's autogenerated labels might cause numbering
>>> problems in LaTeX.
>>>
>>
>> I've not run into any such problems. I tend to construct all of my
>> labels through Org-mode (which works well for export to both HTML and
>> LaTeX).
>
> Could you describe how to do section links and references from within
> Org. I have tried to figure this out for a while now. The only
> solution I can find (on Worg) depends on precise section names, which is
> not so stable. I use the new latex export engine
The attached is a simple example which works for latex.
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: t.org --]
[-- Type: text/org, Size: 134 bytes --]
* Introduction
# <<intro>>
This is some introductory text.
* Background
In section [[latex:ref][intro]], we introduced the topic.
[-- Attachment #3: Type: text/plain, Size: 102 bytes --]
--
: Eric S Fraga, GnuPG: 0xC89193D8FFFCF67D
: in Emacs 24.1.50.1 and Org release_7.8.11-69-ga2fd96
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Using Org for a dissertation
2012-05-12 18:23 Using Org for a dissertation Richard Lawrence
2012-05-12 16:49 ` Eric Schulte
@ 2012-05-12 19:27 ` Thomas S. Dye
2012-05-15 5:16 ` Richard Lawrence
2012-05-12 20:29 ` Using Org for a dissertation Peter Münster
` (2 subsequent siblings)
4 siblings, 1 reply; 25+ messages in thread
From: Thomas S. Dye @ 2012-05-12 19:27 UTC (permalink / raw)
To: Richard Lawrence; +Cc: emacs-orgmode
Richard Lawrence <richard.lawrence@berkeley.edu> writes:
> Hi all,
>
> I am a graduate student in philosophy, and I am about to begin writing
> my dissertation. I am wondering about whether I should write it in Org,
> or stick to plain LaTeX.
>
> This question has been asked before:
> http://article.gmane.org/gmane.emacs.orgmode/22756
>
> But that was two years ago; Org has changed a fair bit, and I'm
> wondering if there are any updates to the advice given there. Moreover,
> I'm wondering if anyone has written a dissertation or other long
> documents in Org in the meantime, and what their experiences have been.
> (Henri-Paul, do you still read this list?)
>
> I have used Org to write most of the shorter papers I have so far
> written as a graduate student, and been very happy with the results. I
> prefer most of Org's editing features and conventions to bare LaTeX. I
> haven't previously had much of a need to mix TODO items and writing, but
> imagine I will with a dissertation. I *have* been relying on Org's
> to-do list features for my reading: I enter new readings as TODO items
> via capture, and include the bibliographic fields that make them
> suitable to export via org-bibtex when it comes time to reference them.
> None of the writing I've done so far has had strict formatting
> requirements, however, and I have run into enough small formatting
> issues in the past that I want to avoid having them grow into large
> issues in the context of a dissertation.
>
> Since I am not in the sciences, I doubt that I will have many figures or
> complex tables, which I know can lead to headaches. Here are a few of
> the things I *am* worried about. I'm sure most of them can be dealt
> with; I am guessing that most of these issues reflect my ignorance or
> outdated knowledge of Org features. I'd be grateful for pointers or
> workarounds for them:
>
> 1) Section labels and other in-document references. It's nice that Org
> generates these on export, but I need to be able to assign and use
> labels that will not change if the document is reordered. I know I can
> simply add such labels via a \label command, but I am worried that using
> them in addition to Org's autogenerated labels might cause numbering
> problems in LaTeX.
>
> 2) Escaping/unrecognized commands. I have occassionally run into
> annoyances where Org escapes characters or commands that I intend to be
> exported literally ("~" and "$" are perennial offenders). Export also
> tends to break when fill-paragraph breaks a LaTeX command across a line,
> like:
>
> some preceding text up to the end of the line \cite{SomeAuthorReference,
> AnotherReference}.
>
> 3) Indentation around #+BEGIN_*/#+END_* environments. (I most often use
> QUOTE.) I usually have to explicitly control indentation in a way that
> I wouldn't have to in LaTeX, because Org inserts blank lines around them
> during export.
>
> 4) Inline footnotes. I usually prefer to use inline footnotes, but I
> think I have found in the past that Org's syntax for inline footnotes
> ([fn:: ...]) interacts badly with LaTeX commands, especially anything
> requiring a "]" in the footnote text.
>
> 5) Bibtex and bibliographies. I love keeping my reading list as Org
> TODO entries, but would like a more automated way to export (just) the
> entries I need for a particular document to a .bib file. I would also
> like to have more control over the bibliography as a section of my
> document. The \bibliography command must live under some Org heading or
> other, and as far I as know it can't live under its own without
> generating an extraneous heading, so I have to be careful that it ends
> up at the end of the last section.
>
> Are there other issues that people have run into when using Org to write
> a longer document with strict formatting requirements? Again, any and
> all advice is greatly appreciated!
>
> Thanks,
> Richard
>
>
>
Aloha Richard,
The current Org-mode LaTeX exporter is nifty, but it was designed to
export notes and not dissertations. It can be configured to do that,
but the extra translation step adds some complexity and potentially
introduces problems. In my work this potential downside is more than
made up for by the reproducible research facilities of Org-mode. When I
don't need these, I typically write in LaTeX. The AucTeX environment is
a terrific help to the author of a LaTeX document and in many ways it is
ideal for a dissertation writer.
That said, the new LaTeX exporter in Org-mode is being designed to
overcome some of the limitations of the old exporter, so it will
probably be the case that the translation step from Org-mode to LaTeX
will get easier. It would be good to have someone write a dissertation
using the new exporter because it might stretch the exporter in ways
that smaller, simpler documents do not. But I doubt if this will be the
path of least resistance to the finished dissertation.
I'm using ebib to manage BibTeX data now and I really like it. It works
well with both LaTeX and Org-mode, so I don't have to switch gears
completely to move from one authoring environment to the other.
hth,
Tom
--
Thomas S. Dye
http://www.tsdye.com
^ permalink raw reply [flat|nested] 25+ messages in thread* Re: Using Org for a dissertation
2012-05-12 19:27 ` Thomas S. Dye
@ 2012-05-15 5:16 ` Richard Lawrence
2012-05-15 17:08 ` Nicolas Goaziou
0 siblings, 1 reply; 25+ messages in thread
From: Richard Lawrence @ 2012-05-15 5:16 UTC (permalink / raw)
To: Thomas S. Dye; +Cc: Richard Lawrence, emacs-orgmode
Thomas S. Dye <tsd@tsdye.com> wrote:
> The current Org-mode LaTeX exporter is nifty, but it was designed to
> export notes and not dissertations. It can be configured to do that,
> but the extra translation step adds some complexity and potentially
> introduces problems. In my work this potential downside is more than
> made up for by the reproducible research facilities of Org-mode. When I
> don't need these, I typically write in LaTeX. The AucTeX environment is
> a terrific help to the author of a LaTeX document and in many ways it is
> ideal for a dissertation writer.
Thanks for your advice. This has been my experience so far as well.
> That said, the new LaTeX exporter in Org-mode is being designed to
> overcome some of the limitations of the old exporter, so it will
> probably be the case that the translation step from Org-mode to LaTeX
> will get easier. It would be good to have someone write a dissertation
> using the new exporter because it might stretch the exporter in ways
> that smaller, simpler documents do not. But I doubt if this will be the
> path of least resistance to the finished dissertation.
I have seen mention of the new exporter on this list a bit, but I don't
read the list enough to know where to find it. How can I try it, if I
want to see how it compares to the current exporter? Is it in a public
branch somewhere? Would feedback from me be helpful?
> I'm using ebib to manage BibTeX data now and I really like it. It works
> well with both LaTeX and Org-mode, so I don't have to switch gears
> completely to move from one authoring environment to the other.
Hmm, I hadn't heard of ebib, but I will have a look at it. Thanks for
the tip!
Best,
Richard
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Using Org for a dissertation
2012-05-15 5:16 ` Richard Lawrence
@ 2012-05-15 17:08 ` Nicolas Goaziou
2012-05-16 0:38 ` Richard Lawrence
2012-05-21 3:56 ` New exporter [was: Re: Using Org for a dissertation] François Pinard
0 siblings, 2 replies; 25+ messages in thread
From: Nicolas Goaziou @ 2012-05-15 17:08 UTC (permalink / raw)
To: Richard Lawrence; +Cc: emacs-orgmode, Thomas S. Dye
Hello,
Richard Lawrence <richard.lawrence@berkeley.edu> writes:
> I have seen mention of the new exporter on this list a bit, but I don't
> read the list enough to know where to find it. How can I try it, if I
> want to see how it compares to the current exporter? Is it in a public
> branch somewhere?
Assuming contrib directory is in your load-path, just evaluate
(require 'org-export)
Then, you can call the dispatcher with M-x org-export-dispatch.
> Would feedback from me be helpful?
Certainly.
Regards,
--
Nicolas Goaziou
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Using Org for a dissertation
2012-05-15 17:08 ` Nicolas Goaziou
@ 2012-05-16 0:38 ` Richard Lawrence
2012-05-21 3:56 ` New exporter [was: Re: Using Org for a dissertation] François Pinard
1 sibling, 0 replies; 25+ messages in thread
From: Richard Lawrence @ 2012-05-16 0:38 UTC (permalink / raw)
To: Nicolas Goaziou; +Cc: Richard Lawrence, emacs-orgmode, Thomas S. Dye
Tom and Nicolas,
Thanks! I will give the new exporter a shot when I have a chance and
let you know how it goes.
Best,
Richard
^ permalink raw reply [flat|nested] 25+ messages in thread
* New exporter [was: Re: Using Org for a dissertation]
2012-05-15 17:08 ` Nicolas Goaziou
2012-05-16 0:38 ` Richard Lawrence
@ 2012-05-21 3:56 ` François Pinard
2012-05-21 17:54 ` Nicolas Goaziou
1 sibling, 1 reply; 25+ messages in thread
From: François Pinard @ 2012-05-21 3:56 UTC (permalink / raw)
To: emacs-orgmode
Nicolas Goaziou <n.goaziou@gmail.coma> writes:
> Richard Lawrence <richard.lawrence@berkeley.edu> writes:
>> I have seen mention of the new exporter on this list a bit [...] How
>> can I try it [...]?
> Assuming contrib directory is in your load-path, just evaluate
> (require 'org-export)
It would be that simple? This is surely worth a try then!
Well, I'm quickly encountering a few problems. Are my tries premature,
or should I push to get it going nevertheless? In the latter case, I
would be reporting problems as a mere user, as I do not feel I have
enough free time to dive and debug myself (it is common nowadays that
maintainers, everywhere, are trying to pull users into maintenance). If
this is acceptable, should I report to this list or privately to
someone?
François
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: New exporter [was: Re: Using Org for a dissertation]
2012-05-21 3:56 ` New exporter [was: Re: Using Org for a dissertation] François Pinard
@ 2012-05-21 17:54 ` Nicolas Goaziou
2012-05-21 19:10 ` François Pinard
0 siblings, 1 reply; 25+ messages in thread
From: Nicolas Goaziou @ 2012-05-21 17:54 UTC (permalink / raw)
To: François Pinard; +Cc: emacs-orgmode
Hello,
François Pinard <pinard@iro.umontreal.ca> writes:
> Nicolas Goaziou <n.goaziou@gmail.coma> writes:
>> Assuming contrib directory is in your load-path, just evaluate
>> (require 'org-export)
>
> It would be that simple? This is surely worth a try then!
>
> Well, I'm quickly encountering a few problems. Are my tries
> premature,
No, org-export needs testing, and I'm ready to debug it.
> or should I push to get it going nevertheless? In the latter case, I
> would be reporting problems as a mere user, as I do not feel I have
> enough free time to dive and debug myself (it is common nowadays that
> maintainers, everywhere, are trying to pull users into maintenance).
I'd rather pull you into writing a Texinfo back-end for the export
engine ;)
I do not ask you to debug anything, but, if you can provide them, ECM
help a lot. In any case, please report the problems you get with it.
> If this is acceptable, should I report to this list or privately to
> someone?
I don't mind either way. I think reporting to this list is fine as it
may prevent users from encountering the same problems over and over.
Regards,
--
Nicolas Goaziou
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: New exporter [was: Re: Using Org for a dissertation]
2012-05-21 17:54 ` Nicolas Goaziou
@ 2012-05-21 19:10 ` François Pinard
2012-05-23 0:35 ` François Pinard
0 siblings, 1 reply; 25+ messages in thread
From: François Pinard @ 2012-05-21 19:10 UTC (permalink / raw)
To: emacs-orgmode; +Cc: Nicolas Goaziou
Nicolas Goaziou <n.goaziou@gmail.com> writes:
> No, org-export needs testing, and I'm ready to debug it. [...] I do
> not ask you to debug anything, but, if you can provide them, ECM help
> a lot. In any case, please report the problems you get with it.
> [...] I think reporting to this list is fine as it may prevent users
> from encountering the same problems over and over.
You might have to cope with me then. Bugs may be in my head just as
well, you know.
> I'd rather pull you into writing a Texinfo back-end for the export
> engine ;)
I should not *even* think about it, but I confess, I'm hesitating. It
happens that now would be a good time. I'm seeking a new job, and if it
works out as I would like, I do not have that many free days ahead (and
so many things to do in those free days). I might aim Python. I'll
write privately to see if its doable.
François
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: New exporter [was: Re: Using Org for a dissertation]
2012-05-21 19:10 ` François Pinard
@ 2012-05-23 0:35 ` François Pinard
0 siblings, 0 replies; 25+ messages in thread
From: François Pinard @ 2012-05-23 0:35 UTC (permalink / raw)
To: emacs-orgmode
François Pinard <pinard@iro.umontreal.ca> writes:
> Nicolas Goaziou <n.goaziou@gmail.com> writes:
>> I'd rather pull you into writing a Texinfo back-end for the export
>> engine ;)
Well, Nicolas has been much helpful at getting me started on this one.
> I might aim Python.
Nicolas' works are so nicely done that it would be rather insane not
using them. Even if Python is more fun and speedy to write than Emacs
Lisp, it has drawbacks in the context of Org. I'll stick to Lisp.
François
P.S. I should quickly get a rotten implementation; it will then take
forever to get it back on track! The usual story... :-)
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Using Org for a dissertation
2012-05-12 18:23 Using Org for a dissertation Richard Lawrence
2012-05-12 16:49 ` Eric Schulte
2012-05-12 19:27 ` Thomas S. Dye
@ 2012-05-12 20:29 ` Peter Münster
2012-05-15 12:26 ` suvayu ali
2012-05-21 13:21 ` Using Org for a dissertation Matt Lundin
4 siblings, 0 replies; 25+ messages in thread
From: Peter Münster @ 2012-05-12 20:29 UTC (permalink / raw)
To: emacs-orgmode
On Sat, May 12 2012, Richard Lawrence wrote:
> I am a graduate student in philosophy, and I am about to begin writing
> my dissertation. I am wondering about whether I should write it in Org,
> or stick to plain LaTeX.
Or in ConTeXt...
Sorry, I can't answer your questions about Org-mode. I just know, that
ConTeXt is a much better tool for writing dissertations than LaTeX is.
--
Peter
^ permalink raw reply [flat|nested] 25+ messages in thread* Re: Using Org for a dissertation
2012-05-12 18:23 Using Org for a dissertation Richard Lawrence
` (2 preceding siblings ...)
2012-05-12 20:29 ` Using Org for a dissertation Peter Münster
@ 2012-05-15 12:26 ` suvayu ali
2012-05-16 1:15 ` Richard Lawrence
2012-05-21 13:21 ` Using Org for a dissertation Matt Lundin
4 siblings, 1 reply; 25+ messages in thread
From: suvayu ali @ 2012-05-15 12:26 UTC (permalink / raw)
To: Richard Lawrence; +Cc: emacs-orgmode
[-- Attachment #1: Type: text/plain, Size: 1265 bytes --]
Hi Richard,
On Sat, May 12, 2012 at 8:23 PM, Richard Lawrence
<richard.lawrence@berkeley.edu> wrote:
> I am a graduate student in philosophy, and I am about to begin writing
> my dissertation. I am wondering about whether I should write it in Org,
> or stick to plain LaTeX.
Since others have added their bits, I'll just say I wrote my Master's
thesis in Physics last year with the then org-mode HEAD. I rather liked
the process and the end result[1]. Although I have to admit, I had to
hack around a bit because of buggy mandatory templates from my
university. Apart from that, everything was very smooth. If you are
interested, my org-mode setup is in a public repo[2]. However I haven't
had the time to make the org source for the thesis publicly available.
In case you are interested, I'm attaching some relevant bits. It has
examples on how to put in tables (with short and long captions),
figures, latex snippets and finally how I included a bibliography and
appendices.
Hope this will help.
Footnotes:
[1] <https://theses.lib.sfu.ca/sites/all/files/public_copies/etd6682_sali_pdf_11110.pdf>
[2] <https://github.com/suvayu/.emacs.d/blob/master/org-mode-config.el>
--
Suvayu
Open source is the future. It sets us free.
[-- Attachment #2: shortthesis.txt --]
[-- Type: text/plain, Size: 12741 bytes --]
# -*- mode: org; -*-
#+TITLE: Estimation and modelling of Standard Model backgrounds in the search for \(W'\) gauge bosons with ATLAS (\mu channel)
#+AUTHOR: Suvayu Ali
#+EMAIL: Suvayu.Ali@cern.ch
#+DATE: \today
#+DESCRIPTION:
#+KEYWORDS:
#+LANGUAGE: en
#+OPTIONS: H:4 num:4 toc:nil ::t |:t ^:t -:t f:t *:t <:nil
#+OPTIONS: TeX:t LaTeX:t skip:nil d:nil todo:nil pri:nil tags:nil
#+EXPORT_SELECT_TAGS: export
#+EXPORT_EXCLUDE_TAGS: noexport
#+STARTUP: content
#+BIND: org-confirm-babel-evaluate nil
#+BIND: org-export-latex-title-command ""
#+LaTeX_CLASS: book
#+LaTeX_CLASS_OPTIONS: [12pt,letterpaper,oneside]
#+LaTeX_HEADER: \usepackage{amsfonts}
#+LaTeX_HEADER: \usepackage{amsmath}
#+LaTeX_HEADER: \usepackage{appendix}
#+LaTeX_HEADER: \usepackage{varioref}
#+LaTeX_HEADER: \usepackage[nokeyprefix]{refstyle}
# more Physics specific packages
# LaTeX Macros
#+LaTeX_HEADER: \newcommand{\p}[1]{\phantom{#1}}
#+LaTeX_HEADER: \newcommand{\modulus}[1]{\ensuremath{\lvert #1 \rvert}}
# some more Physics specific macros
# University stuff
##+LaTeX_HEADER: \usepackage[headings]{thesisstyle}
# ...
# #+LaTeX_HEADER: \include{abstract}
# \include{preamble}
* Introduction
** The Standard Model :SM:
\label{chap:SMintro}
The Standard Model is a quantum field theoretical approach to
describe interactions in nature. The theory is primarily built upon
symmetry arguments supported by experimental data. It describes the
interactions between all fermions mediated by vector gauge bosons.
These include the electromagnetic, weak and strong interactions.
The formulation of the SM does not include gravity. There are
various approaches to include gravity in BSM theories which are
discussed elsewhere \cite{ArkaniHamed:1998rs,Randall:1999ee}.
#+CAPTION: [Interactions and particles described by the SM.]{The interactions and the participating particles described by the Standard Model are tabulated below. Although the $Z^0$ is listed both as force carrier and a particle interacting by the weak force, it should be noted it does not couple with another $Z^0$.}
#+LABEL: tbl:interactions
|----------+-----------------+----------------+---------------------------------|
| Charge | Force | Force carrier | Interacting particles |
|----------+-----------------+----------------+---------------------------------|
| Electric | Electromagnetic | \gamma | all charged fermions, \(W^\pm\) |
| Weak | Weak | \(W^\pm, Z^0\) | all fermions, \(W^\pm, Z^0\) |
| Colour | Strong | \(g\) | all quarks, anti-quarks, \(g\) |
|----------+-----------------+----------------+---------------------------------|
In the SM all particles carry various charges which describe all
the interactions they undergo: the electric charge is responsible
for all electromagnetic interactions, the weak charge for all weak
interactions and the colour charge for all strong interactions.
Since any quantum fields have bosonic exchange particles, all the
interactions discussed earlier are associated with different spin-1
bosons as force carriers. This has been summarised in
\Tabref{tbl:interactions}.
*** Production and Decay of the \(W'\) Boson :pdf:
\label{subsec:Wprod}
#+CAPTION: A representative diagram for \(W'\) production at the LHC.
#+LABEL: fig:LO-Wprime
#+ATTR_LaTeX: width=0.6\textwidth
[[file:figs/Wprime-s-channel.eps]]
\noindent *Production:* The $W'$ boson is assumed to have a
coupling constant that is the same as its lighter SM counterpart.
This is known as the sequential SM $W'$ boson. The diagrams[fn:1]
responsible for the production of $W'$ bosons at a hadron
collider are known as charged current (CC) processes. These are
flavour changing interactions occurring between up-like and
down-like quarks (or anti-quarks) where the weak current involved
is charged as the gauge bosons involved are charged.
\Figref{fig:LO-Wprime} shows a diagram responsible for $W'$
production at the LHC.
The production of a heavy $W'$ boson from a pp collision depends
strongly on the momenta of the initial state particles. Since
protons are composite particles made of (anti-)quarks and gluons,
knowledge about the momentum fraction carried by the initial
state particles is important. This is achieved by a /Parton
Distribution Function/ (PDF) determined from deep inelastic
scattering experiments with hadrons and leptons. In 1968--69,
Bjorken proposed a dimensionless quantity /x/ which is
independent of the momentum transfer during a hard scattering
event. They exhibit a scaling behaviour in the asymptotic limit
of very high energy collisions, known as /Bjorken scaling/. The
discovery of scaling behaviour as predicted by Bjorken led to the
modern formulation of the strong force as an asymptotically free
quantum field theory \cite{Tung:2009}. The scaling was later
shown to be only approximately true at low energies due to higher
order QCD corrections (scaling violations).
In 1969 Feynman proposed the /parton model/. It describes hadrons
as composite particles made of its constituent quarks,
anti-quarks and gluons \cite{PhysRevLett.23.1415}. The
constituent quarks can be either valence or sea quarks. If the
quark is one of the three quarks forming the hadron bound state
and responsible for the quantum number, then it is called the
/valence quark/. On the other hand if it is a virtual quark
formed by splitting of gluons, it is called a /sea quark/.
Modern QCD explains the interaction of hadrons in hard scattering
experiments using this parton model.
#+begin_src latex
\begin{equation}
\label{eq:partondistribfn}
\frac{d\sigma}{dm_T} = \sum\limits_{a,b} \int dx_A f_{a/A}(x_A,\mu) \int dx_B f_{b/B}(x_B,\mu) \frac{d\hat{\sigma}}{dm_T}
\end{equation}
#+end_src
The differential production cross section ($d\sigma/dm_T$) for
observing certain events in a channel in a hadron collider is
given by \Eqref{eq:partondistribfn}. $f_{a/A}$ and $f_{b/B}$ are
the parton distribution functions mentioned earlier. They are the
probability distributions of finding a parton of type /a/ (/b/)
originating from a hadron of type /A/ (/B/) with the momentum
fraction $x_A$ ($x_B$). $d\hat{\sigma}/dm_T$ is the parton level
cross section given by perturbative QCD. The Bjorken scaling
violations observed earlier could be incorporated into this
picture by including corrections to the PDFs from perturbative
QCD. These corrections introduce the dependence on the parameter
\mu in the PDFs. The parameter \mu is related to the
renormalisation of the strong coupling in the cross section
calculation and the QCD corrections to the PDFs. They are often
referred to separately as /renormalisation scale/ and
/factorisation scale/ \cite{Soper:1996sn}.
#+begin_src latex
\begin{figure}[p]
\centering
\begin{tabular}{c}
\includegraphics[width=0.7\textwidth,trim=0 150 0 150]{plots/PDF-upv.pdf} \\
\includegraphics[width=0.7\textwidth,trim=0 150 0 150]{plots/PDF-downv.pdf}
\end{tabular}
\caption[PDF for the proton at $Q^2 = 1$ TeV/c$^2$]{Proton PDFs
showing the probability distributions for up (top) and down
(bottom) quarks at $Q^2 = 1$ TeV/c$^2$. The valence quark PDF
(black) is compared with the sea quark (red) and gluon (green)
PDFs. A common choice for the factorisation scale when
calculating a PDF set is to set it to $Q^2$ of the process
\cite{website:HepData}.}
\label{fig:PDF}
\end{figure}
#+end_src
* Appendices :ignoreheading:
:PROPERTIES:
:VISIBILITY: folded
:END:
#+LaTeX: \newpage
#+LaTeX: \appendix
# Needs \usepackage{appendix}
#+LaTeX: \addappheadtotoc
#+LaTeX: \appendixpage
** Particle track parametrisation in ATLAS :trk:
\label{app:trackparam}
A particle track in ATLAS is represented by the perigee[fn:2] of the
track. The perigee is specified by the five parameters:
+ d_0 - transverse impact parameter, the distance of the closest
approach of helix to beam pipe,
+ z_0 - longitudinal impact parameter, the z value at the point of
closest approach,
+ \phi_0 - azimuth angle of the momentum at point of closest
approach, measured in the range $[-\pi,\pi)$,
+ \theta - polar angle in the range $[0,\pi]$,
+ q/p - charge over momentum magnitude.
In ATLAS the /z/-axis is parallel to the magnetic field (which is
parallel to the beam axis). \Figref{fig:trkperigee} shows the five
parameters split into transverse and longitudinal planes.
#+CAPTION: [Schematic showing all 5 track parameters]{The diagram shows the five parameters, the three longitudinal parameters in the x-y plane and two longitudinal parameters in the r-z plane.}
#+LABEL: fig:trkperigee
#+ATTR_LaTeX: width=0.6\textwidth placement=[p]
[[file:figs/Perigee.png]]
** Limit formalism :limits:
\label{app:limits}
The limits are set with the observed events in a bin with $m_T$ >
$m_{Tmin}$, where the lower bin threshold is determined by taking
the half of the $W'$ mass. The expected number of events are given
by \Eqref{eq:expevts}, where $\nbg$ is the expected number of
events from our background model and $N_{sig}$ is the predicted
number of signal events from \Eqref{eq:sigevts}. $L_{int}$ is the
integrated luminosity of the recorded data and $\epsilon_{sig}$ is
the event selection efficiency.
#+begin_src latex
\begin{align}
\label{eq:expevts}
N_{exp} &= N_{sig} + \nbg \\
\label{eq:sigevts}
N_{sig} &= L_{int} \epsilon_{sig} \SB
\end{align}
#+end_src
The likelihood function in \Eqref{eq:likelihood} is obtained from
Poisson statistics for $N_{obs}$ observed events. Uncertainties are
included as nuisance parameters in the analysis. They are assumed
to follow a Gaussian probability distribution. In this analysis we
consider uncertainties on $L_{int}$, $\epsilon_{sig}$ and $\nbg$ in
our calculations. Taking the above into consideration we get the
likelihood function shown in \Eqref{eq:llnuissance}.
#+begin_src latex
\begin{align}
\label{eq:likelihood}
\mathcal{L}(\SB) &= \frac{(L_{int}\SB + \nbg)^{N_{obs}}e^{-(L_{int}\epsilon_{sig}\SB+\nbg)}}{N_{obs}!} \\
\label{eq:llnuissance}
\mathcal{L}(\SB,\theta_1,\dotsc\theta_N) &= \frac{(L_{int}\SB + \nbg)^{N_{obs}}e^{-(L_{int}\epsilon_{sig}\SB+\nbg)}}{N_{obs}!} \prod g_i(\theta_i) \\
g_i(\theta_i) &= \frac{1}{\sqrt{2\pi}\sigma_i}e^{-\frac{(\theta -\bar{\theta}_i)^2}{2\sigma_i^2}} \nonumber
\end{align}
#+end_src
This likelihood function is used to calculate the log-likelihood
ratio (LLR) test statistic shown in \Eqref{eq:LLR}
\cite{Junk:1999kv}. The LLR is used to calculate /p/-values which
correspond to confidence levels for the signal + background
(CL_{s+b}) and background (CL_b) only hypotheses. These are
evaluated by conducting pseudo-experiments and integrating over the
corresponding LLR distributions.
#+begin_src latex
\begin{equation}
\label{eq:LLR}
LLR = -2 \ln \frac{\mathcal{L}(data\lvert s+b)}{\mathcal{L}(data\lvert b)}
\end{equation}
#+end_src
The CL_s method finally uses the ratio of the /p/-values to
determine the exclusion limits (\eqref[name=eq.~]{eq:CLs}). To set
the limits at 95% confidence level, the signal cross section is
increased until CL_s = 1 - \alpha where \alpha is 0.95. For a more
complete discussion of the limit setting procedure see the
referenced ATLAS internal note \cite{Adams:1317922}.
#+begin_src latex
\begin{equation}
\label{eq:CLs}
CL_s = \frac{CL_{s+b}}{CL_b}
\end{equation}
#+end_src
* Bibliography :ignoreheading:
#+LaTeX: \backmatter
#+LaTeX: \newpage
#+LaTeX: \addcontentsline{toc}{chapter}{\bibname}
#+LaTeX: \bibliographystyle{ieeetr}
#+LaTeX: \bibliography{master}
* Footnotes
[fn:1] Here and in the rest of this thesis /diagram/ refers to Feynman
diagrams unless otherwise specified.
[fn:2] The point where the track comes closest to the geometrical
centre of the detector is called the perigee of the track.
* COMMENT local setup
# Local Variables:
# org-export-allow-BIND: t
# org-latex-to-pdf-process: ("pdflatex -interaction nonstopmode %b" "/usr/bin/bibtex %b" "pdflatex -interaction nonstopmode %b" "pdflatex -interaction nonstopmode %b")
# End:
^ permalink raw reply [flat|nested] 25+ messages in thread* Re: Using Org for a dissertation
2012-05-15 12:26 ` suvayu ali
@ 2012-05-16 1:15 ` Richard Lawrence
2012-05-17 2:37 ` org-export-preprocess-hook and the new exporter (was Re: Using Org for a dissertation) Eric S Fraga
0 siblings, 1 reply; 25+ messages in thread
From: Richard Lawrence @ 2012-05-16 1:15 UTC (permalink / raw)
To: suvayu ali; +Cc: Richard Lawrence, emacs-orgmode
Hi Suvayu,
suvayu ali <fatkasuvayu+linux@gmail.com> wrote:
> In case you are interested, I'm attaching some relevant bits. It has
> examples on how to put in tables (with short and long captions),
> figures, latex snippets and finally how I included a bibliography and
> appendices.
>
> Hope this will help.
Thanks! This is definitely helpful. The ignoreheading tag is a nice
hack -- fixes one of those niggling issues I've had with LaTeX export.
Best,
Richard
^ permalink raw reply [flat|nested] 25+ messages in thread
* org-export-preprocess-hook and the new exporter (was Re: Using Org for a dissertation)
2012-05-16 1:15 ` Richard Lawrence
@ 2012-05-17 2:37 ` Eric S Fraga
2012-05-18 6:49 ` Bastien
2012-05-18 10:08 ` Nicolas Goaziou
0 siblings, 2 replies; 25+ messages in thread
From: Eric S Fraga @ 2012-05-17 2:37 UTC (permalink / raw)
To: Richard Lawrence; +Cc: emacs-orgmode
Richard Lawrence <richard.lawrence@berkeley.edu> writes:
> Hi Suvayu,
>
> suvayu ali <fatkasuvayu+linux@gmail.com> wrote:
>
>> In case you are interested, I'm attaching some relevant bits. It has
>> examples on how to put in tables (with short and long captions),
>> figures, latex snippets and finally how I included a bibliography and
>> appendices.
>>
>> Hope this will help.
>
> Thanks! This is definitely helpful. The ignoreheading tag is a nice
> hack -- fixes one of those niggling issues I've had with LaTeX export.
>
> Best,
> Richard
This is probably more for Nicolas... and apologies for hijacking the
thread slightly!
I was intrigued by the comment above regarding the ignoreheading
tag. Sounded just like what I needed. However, it doesn't do anything
with org /out-of-the-box/. A little searching led to Suvayu's posting
in stackoverflow [1] and that does the job nicely, but only for the
standard (read: old) export engine.
The question is: is there an equivalent hook for the new exporter?
Thanks,
eric
Footnotes:
[1] http://stackoverflow.com/questions/10295177/is-there-an-equivalent-of-org-modes-b-ignoreheading-for-non-beamer-documents
--
: Eric S Fraga (GnuPG: 0xC89193D8FFFCF67D) in Emacs 24.1.50.1
: using Org release_7.8.09-544-g505cc7
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: org-export-preprocess-hook and the new exporter (was Re: Using Org for a dissertation)
2012-05-17 2:37 ` org-export-preprocess-hook and the new exporter (was Re: Using Org for a dissertation) Eric S Fraga
@ 2012-05-18 6:49 ` Bastien
2012-05-18 10:08 ` Nicolas Goaziou
1 sibling, 0 replies; 25+ messages in thread
From: Bastien @ 2012-05-18 6:49 UTC (permalink / raw)
To: Richard Lawrence; +Cc: emacs-orgmode
Hi Eric,
Eric S Fraga <e.fraga@ucl.ac.uk> writes:
> I was intrigued by the comment above regarding the ignoreheading
> tag. Sounded just like what I needed. However, it doesn't do anything
> with org /out-of-the-box/. A little searching led to Suvayu's posting
> in stackoverflow [1] and that does the job nicely, but only for the
> standard (read: old) export engine.
stackoverflow.com is really great, and many questions are posted and
answered there. When it makes sense, we should try to backport useful
information from there to Worg (org-faq.org and org-hacks.org are the
two possible targets in general), so that we keep things centralized
a bit.
At least I try to keep this in mind when I reply to stuff on SO.
Thanks!
--
Bastien
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: org-export-preprocess-hook and the new exporter (was Re: Using Org for a dissertation)
2012-05-17 2:37 ` org-export-preprocess-hook and the new exporter (was Re: Using Org for a dissertation) Eric S Fraga
2012-05-18 6:49 ` Bastien
@ 2012-05-18 10:08 ` Nicolas Goaziou
2012-05-20 6:12 ` Eric Fraga
2012-05-28 22:44 ` org-export-preprocess-hook and the new exporter Thomas S. Dye
1 sibling, 2 replies; 25+ messages in thread
From: Nicolas Goaziou @ 2012-05-18 10:08 UTC (permalink / raw)
To: Richard Lawrence; +Cc: emacs-orgmode
Hello,
Eric S Fraga <e.fraga@ucl.ac.uk> writes:
> This is probably more for Nicolas... and apologies for hijacking the
> thread slightly!
>
> I was intrigued by the comment above regarding the ignoreheading
> tag. Sounded just like what I needed. However, it doesn't do anything
> with org /out-of-the-box/. A little searching led to Suvayu's posting
> in stackoverflow [1] and that does the job nicely, but only for the
> standard (read: old) export engine.
>
> The question is: is there an equivalent hook for the new exporter?
For heavy structure modifications (like headlines removal), there is
`org-export-before-parsing-hook' and the dynamically bound variable
`org-export-current-backend'.
Another way to solve the problem could be to implement your own headline
parser:
#+BEGIN_SRC emacs-lisp
(defun my-e-latex-headline (headline contents info)
(if (member "ignoreheading" (org-element-property :tags headline)) contents
(org-e-latex-headline headline contents info)))
#+END_SRC
Then you can either install it in the current `e-latex' back-end:
#+BEGIN_SRC emacs-lisp
(add-to-list 'org-e-latex-translate-table '(headline . my-e-latex-headline))
#+END_SRC
Or you can define your own back-end for this purpose:
#+BEGIN_SRC emacs-lisp
(org-export-define-derived-backend dissertation e-latex
:translate-alist ((template . my-e-latex-headline)))
(defun org-dissertation-export-to-pdf
(&optional subtreep visible-only body-only ext-plist pub-dir)
(interactive)
(org-e-latex-compile
(let ((outfile (org-export-output-file-name ".tex" subtreep pub-dir)))
(org-export-to-file
'dissertation outfile subtreep visible-only body-only ext-plist))))
#+END_SRC
You need a recent Org version to do this, though.
Regards,
--
Nicolas Goaziou
^ permalink raw reply [flat|nested] 25+ messages in thread* Re: org-export-preprocess-hook and the new exporter (was Re: Using Org for a dissertation)
2012-05-18 10:08 ` Nicolas Goaziou
@ 2012-05-20 6:12 ` Eric Fraga
2012-05-20 8:03 ` Nicolas Goaziou
2012-05-28 22:44 ` org-export-preprocess-hook and the new exporter Thomas S. Dye
1 sibling, 1 reply; 25+ messages in thread
From: Eric Fraga @ 2012-05-20 6:12 UTC (permalink / raw)
To: Nicolas Goaziou; +Cc: emacs-orgmode
Nicolas Goaziou <n.goaziou@gmail.com> writes:
> Hello,
>
> Eric S Fraga <e.fraga@ucl.ac.uk> writes:
>
>> This is probably more for Nicolas... and apologies for hijacking the
>> thread slightly!
>>
>> I was intrigued by the comment above regarding the ignoreheading
>> tag. Sounded just like what I needed. However, it doesn't do anything
>> with org /out-of-the-box/. A little searching led to Suvayu's posting
>> in stackoverflow [1] and that does the job nicely, but only for the
>> standard (read: old) export engine.
>>
>> The question is: is there an equivalent hook for the new exporter?
>
> For heavy structure modifications (like headlines removal), there is
> `org-export-before-parsing-hook' and the dynamically bound variable
> `org-export-current-backend'.
>
> Another way to solve the problem could be to implement your own headline
> parser:
>
> #+BEGIN_SRC emacs-lisp
> (defun my-e-latex-headline (headline contents info)
> (if (member "ignoreheading" (org-element-property :tags headline)) contents
> (org-e-latex-headline headline contents info)))
> #+END_SRC
>
> Then you can either install it in the current `e-latex' back-end:
>
> #+BEGIN_SRC emacs-lisp
> (add-to-list 'org-e-latex-translate-table '(headline . my-e-latex-headline))
> #+END_SRC
Nicolas,
I tried this but I get:
,----
| Warning (initialization): An error occurred while loading `/home/ucecesf/.emacs':
|
| Symbol's value as variable is void: org-e-latex-translate-table
|
| To ensure normal operation, you should investigate and remove the
| cause of the error in your initialization file. Start Emacs with
| the `--debug-init' option to view a complete error backtrace.
`----
I think it should be
#+BEGIN_SRC emacs-lisp
(add-to-list 'org-e-latex-translate-alist '(headline . my-e-latex-headline))
#+END_SRC
i.e. =alist= instead of =table=.
In any case, with this change, it works like a charm! Many thanks.
--
: Eric S Fraga (GnuPG: 0xC89193D8FFFCF67D) in Emacs 24.1.50.1
: using Org release_7.8.09-527-gc2aac5
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: org-export-preprocess-hook and the new exporter (was Re: Using Org for a dissertation)
2012-05-20 6:12 ` Eric Fraga
@ 2012-05-20 8:03 ` Nicolas Goaziou
0 siblings, 0 replies; 25+ messages in thread
From: Nicolas Goaziou @ 2012-05-20 8:03 UTC (permalink / raw)
To: emacs-orgmode
Hello,
Eric Fraga <e.fraga@ucl.ac.uk> writes:
> I think it should be
>
> #+BEGIN_SRC emacs-lisp
> (add-to-list 'org-e-latex-translate-alist '(headline . my-e-latex-headline))
> #+END_SRC
>
> i.e. =alist= instead of =table=.
Indeed, that was a typo in my message (in fact I hesitated a long time
between the two names before choosing one for the variable).
Regards,
--
Nicolas Goaziou
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: org-export-preprocess-hook and the new exporter
2012-05-18 10:08 ` Nicolas Goaziou
2012-05-20 6:12 ` Eric Fraga
@ 2012-05-28 22:44 ` Thomas S. Dye
2012-05-29 1:37 ` Eric S Fraga
1 sibling, 1 reply; 25+ messages in thread
From: Thomas S. Dye @ 2012-05-28 22:44 UTC (permalink / raw)
To: Nicolas Goaziou; +Cc: Richard Lawrence, emacs-orgmode
Nicolas Goaziou <n.goaziou@gmail.com> writes:
> Hello,
>
> Eric S Fraga <e.fraga@ucl.ac.uk> writes:
>
>> This is probably more for Nicolas... and apologies for hijacking the
>> thread slightly!
>>
>> I was intrigued by the comment above regarding the ignoreheading
>> tag. Sounded just like what I needed. However, it doesn't do anything
>> with org /out-of-the-box/. A little searching led to Suvayu's posting
>> in stackoverflow [1] and that does the job nicely, but only for the
>> standard (read: old) export engine.
>>
>> The question is: is there an equivalent hook for the new exporter?
>
> For heavy structure modifications (like headlines removal), there is
> `org-export-before-parsing-hook' and the dynamically bound variable
> `org-export-current-backend'.
>
> Another way to solve the problem could be to implement your own headline
> parser:
>
> #+BEGIN_SRC emacs-lisp
> (defun my-e-latex-headline (headline contents info)
> (if (member "ignoreheading" (org-element-property :tags headline)) contents
> (org-e-latex-headline headline contents info)))
> #+END_SRC
>
> Then you can either install it in the current `e-latex' back-end:
>
> #+BEGIN_SRC emacs-lisp
> (add-to-list 'org-e-latex-translate-table '(headline . my-e-latex-headline))
> #+END_SRC
Aloha Nicolas,
Has org-e-latex-translate-table gone away? I get:
Symbol's value as variable is void: org-e-latex-translate-table
I tried grepping the source code for it, but came up empty there, too.
All the best,
Tom
>
> Or you can define your own back-end for this purpose:
>
> #+BEGIN_SRC emacs-lisp
> (org-export-define-derived-backend dissertation e-latex
> :translate-alist ((template . my-e-latex-headline)))
>
> (defun org-dissertation-export-to-pdf
> (&optional subtreep visible-only body-only ext-plist pub-dir)
> (interactive)
> (org-e-latex-compile
> (let ((outfile (org-export-output-file-name ".tex" subtreep pub-dir)))
> (org-export-to-file
> 'dissertation outfile subtreep visible-only body-only ext-plist))))
> #+END_SRC
>
> You need a recent Org version to do this, though.
>
>
> Regards,
--
Thomas S. Dye
http://www.tsdye.com
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: org-export-preprocess-hook and the new exporter
2012-05-28 22:44 ` org-export-preprocess-hook and the new exporter Thomas S. Dye
@ 2012-05-29 1:37 ` Eric S Fraga
2012-05-29 3:20 ` Thomas S. Dye
0 siblings, 1 reply; 25+ messages in thread
From: Eric S Fraga @ 2012-05-29 1:37 UTC (permalink / raw)
To: Thomas S. Dye; +Cc: emacs-orgmode, Richard Lawrence, Nicolas Goaziou
"Thomas S. Dye" <tsd@tsdye.com> writes:
[...]
> Aloha Nicolas,
>
> Has org-e-latex-translate-table gone away? I get:
> Symbol's value as variable is void: org-e-latex-translate-table
>
> I tried grepping the source code for it, but came up empty there, too.
Tom,
Nicolas typed in the wrong variable name; change "table" to "alist" and
you should be okay:
(add-to-list 'org-e-latex-translate-alist '(headline . my-e-latex-headline))
--
Eric S Fraga (GnuPG: 0xC89193D8FFFCF67D)
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: org-export-preprocess-hook and the new exporter
2012-05-29 1:37 ` Eric S Fraga
@ 2012-05-29 3:20 ` Thomas S. Dye
0 siblings, 0 replies; 25+ messages in thread
From: Thomas S. Dye @ 2012-05-29 3:20 UTC (permalink / raw)
To: Nicolas Goaziou; +Cc: Richard Lawrence, emacs-orgmode
Eric S Fraga <e.fraga@ucl.ac.uk> writes:
> "Thomas S. Dye" <tsd@tsdye.com> writes:
>
> [...]
>
>> Aloha Nicolas,
>>
>> Has org-e-latex-translate-table gone away? I get:
>> Symbol's value as variable is void: org-e-latex-translate-table
>>
>> I tried grepping the source code for it, but came up empty there, too.
>
> Tom,
>
> Nicolas typed in the wrong variable name; change "table" to "alist" and
> you should be okay:
>
> (add-to-list 'org-e-latex-translate-alist '(headline . my-e-latex-headline))
Thanks Eric,
That was it.
All the best,
Tom
--
Thomas S. Dye
http://www.tsdye.com
^ permalink raw reply [flat|nested] 25+ messages in thread
* Re: Using Org for a dissertation
2012-05-12 18:23 Using Org for a dissertation Richard Lawrence
` (3 preceding siblings ...)
2012-05-15 12:26 ` suvayu ali
@ 2012-05-21 13:21 ` Matt Lundin
4 siblings, 0 replies; 25+ messages in thread
From: Matt Lundin @ 2012-05-21 13:21 UTC (permalink / raw)
To: Richard Lawrence; +Cc: emacs-orgmode
Richard Lawrence <richard.lawrence@berkeley.edu> writes:
> I am a graduate student in philosophy, and I am about to begin writing
> my dissertation. I am wondering about whether I should write it in Org,
> or stick to plain LaTeX.
I would recommend LaTeX. In my experience, writing long documents (or
Beamer slides) in org-mode creates additional work, insofar as I have to
think through two layers of translation: 1) how to get org-mode to
translate nicely into LaTeX; and 2) how to get LaTeX to output the final
document I desire. In larger documents, "leaky abstractions" can quickly
become a problem. I tried writing in org-mode but ended up with a
document encrusted with all sorts of hacks (#+LaTeX: lines and the
like). IMO, writing in LaTeX/AUCTeX affords greater control over the
final document. (Note: the new export engine will give the user greater
ability to reduce the number of "leaks".)
I would recommend using org-mode if the following apply:
1. You will rely heavily on org-babel.
2. You anticipate having to output to multiple formats (e.g., your
dissertation advisor requires you to submit .doc files).
3. Your document structure will be straightforward.
I would recommend using LaTeX if the following apply:
1. You have numerous footnotes. (Fontification and export of footnotes
in org-mode can be painfully slow when a document contains hundreds
of footnotes.)
2. You are using biblatex. (If you are relying heavily on biblatex for
citations, then you will need to export to LaTeX to output your final
document, thus precluding the possibility of outputting to other
formats. Furthermore, AUCTeX offers very helpful syntax highlighting
and folding of citations and footnotes, along with excellent reftex
integration.)
3. You will be using a many cross-references.
My workflow is as follows. I rely on my org-mode files for drafting
small segments of a project. I then export the segments to the kill ring
with the following function and yank them into the relevant LaTeX file.
--8<---------------cut here---------------start------------->8---
(defun my-org-export-latex-to-kill-ring ()
(interactive)
(kill-new (org-export-region-as-latex (point) (mark) t 'string)))
--8<---------------cut here---------------end--------------->8---
Best,
Matt
^ permalink raw reply [flat|nested] 25+ messages in thread