Outline structure and LaTeX

Outline structure and LaTeX

[SW]

I'm preparing an academic document with several chapters. The text will
eventually exist as a LaTeX document. However, I am doing my early planning and
writing directly in an org file, making use of the structure elements (*, **,
***, etc) to provide structure and entering text for the relevant sections in
the appropriate place.

Org is a huge project and I have not explored every aspect and every contributed
extension. Is there a "best practice" approach for what I am doing? Should I
write directly in LaTeX rather? Is there an easy conversion process from an
outlined document to LaTeX? I know there org can export to LaTeX. Would that be
the best option? It has not worked well for me previously -- page breaks
appeared in the wrong place and other pages has text that flowed over the end of
the page.

Re: Outline structure and LaTeX

[Thomas S. Dye]

Aloha SW,

SW <sabrewolfy@gmail.com> writes:

> I'm preparing an academic document with several chapters. The text will
> eventually exist as a LaTeX document. However, I am doing my early planning and
> writing directly in an org file, making use of the structure elements (*, **,
> ***, etc) to provide structure and entering text for the relevant sections in
> the appropriate place.
>
> Org is a huge project and I have not explored every aspect and every contributed
> extension. Is there a "best practice" approach for what I am doing? Should I
> write directly in LaTeX rather? Is there an easy conversion process from an
> outlined document to LaTeX? I know there org can export to LaTeX. Would that be
> the best option? It has not worked well for me previously -- page breaks
> appeared in the wrong place and other pages has text that flowed over the end of
> the page.
>
>
>

Org mode can export to various formats.  Export to LaTeX works well, but
it helps to know LaTeX when something unwanted happens.  One of the
other export options might better suit your needs.

There are some examples of academic documents prepared with Org mode
that might help you follow the LaTeX export path,
e.g. http://www.jstatsoft.org/v46/i03,
http://orgmode.org/worg/org-contrib/babel/uses.html#sec-6.
 
hth,
Tom
-- 
Thomas S. Dye
http://www.tsdye.com

Re: Outline structure and LaTeX

[Eric S Fraga]

SW <sabrewolfy@gmail.com> writes:

> I'm preparing an academic document with several chapters. The text will
> eventually exist as a LaTeX document. However, I am doing my early planning and
> writing directly in an org file, making use of the structure elements (*, **,
> ***, etc) to provide structure and entering text for the relevant sections in
> the appropriate place.
>
> Org is a huge project and I have not explored every aspect and every contributed
> extension. Is there a "best practice" approach for what I am doing? Should I
> write directly in LaTeX rather? Is there an easy conversion process from an
> outlined document to LaTeX? I know there org can export to LaTeX. Would that be
> the best option? It has not worked well for me previously -- page breaks
> appeared in the wrong place and other pages has text that flowed over the end of
> the page.

I used to write all my papers etc. in LaTeX.  I now use org almost
exclusively, using LaTeX directly only for letters.  With the advances
in the LaTeX export engines (both the "stable" one and the new one
Nicolas is working on), I am able to work completely in org and only
worry about exporting to LaTeX at the end, when ready to submit.

For instance, this paper:

http://www.sciencedirect.com/science/article/pii/S0306261911006507

was written completely in org and the resulting LaTeX file exported by
org was sent *as is* to the publisher (Elsevier, in this case).

The best thing, for me, about using org to write papers is that I can
have all my data, notes, musings, etc. in the same document and only
export the content that I want to export.  Add babel to the mix and my
analysis is also within the same document.  And include inline tasks and
I can even have task management in the document.  Brilliant!

In terms of /best practice/, my advice in using org would be the same as
I would give if you were to write in LaTeX directly: don't tilt at
windmills!  Instead of trying to micro-manage the document, concentrate
on the content.  Unless you have very specific typesetting requirements,
e.g. from the publisher, let org+LaTeX do its thing.  Usually, what
comes out looks much better than what you could do manually.

If things need fixing, do it at the end when the *content* is
finalised.  Org allows you to concentrate on the content without too
much clutter, actually very little clutter.

Addressing your question more specifically, I don't understand your
comment about page breaks.  LaTeX is usually very good about page
breaks, especially with respect to line widows etc.

Finally, there are quite a few people on this list that use org to
create LaTeX documents and they're all quite friendly so ask away if you
have any specific questions.

HTH,
eric

-- 
: Eric S Fraga (GnuPG: 0xC89193D8FFFCF67D) in Emacs 24.1.50.1 + Ma Gnus v0.6

Re: Outline structure and LaTeX

[Giacomo M]

[-- Attachment #1: Type: text/plain, Size: 163 bytes --]

I'm still new to emacs-orgmode, but I couldn't avoid getting fascinated and
inspired by the reproducible research examples mentioned here.
Thanks!

Giacomo M



>

[-- Attachment #2: Type: text/html, Size: 405 bytes --]

Re: Outline structure and LaTeX

[SW]

@Eric S Fraga:  <e.fraga <at> ucl.ac.uk> writes:

Thanks for the reply and suggestions -- I found them useful.

> Addressing your question more specifically, I don't understand your
> comment about page breaks.  LaTeX is usually very good about page
> breaks, especially with respect to line widows etc.

I'll post details when/if I encounter it again. It's happened in every LaTeX
export I've ever tried, but I'll search for a solution again before posting. I'm
working on a minimal example now to help me understand how it works too :)

Thanks.

SW.