Exporting an org-file to multiple html pages

Exporting an org-file to multiple html pages

[Jarmo Hurri]

Greetings.

I am writing a relatively extensive document in org, and I am currently
trying to figure out how to split the exported html into multiple html
pages.

Is publishing along the lines of this tutorial still the best way to do
it?

http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.html

In other words, do I need to split one org file into multiple org files
and then build the links between them manually? That is, is there no way
to automatically have top level "chapters" split into pages with links
between chapters?

Thanks!

Jarmo

Re: Exporting an org-file to multiple html pages

[Marcin Borkowski]

On 2015-08-31, at 12:16, Jarmo Hurri <jarmo.hurri@iki.fi> wrote:

> Greetings.
>
> I am writing a relatively extensive document in org, and I am currently
> trying to figure out how to split the exported html into multiple html
> pages.
>
> Is publishing along the lines of this tutorial still the best way to do
> it?
>
> http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.html
>
> In other words, do I need to split one org file into multiple org files
> and then build the links between them manually? That is, is there no way
> to automatically have top level "chapters" split into pages with links
> between chapters?

Does this help?

https://github.com/mbork/org-one-to-many

Its purpose is to split an Org file into many pieces (either giving
a level, or marking the headlines to be split with a :split: tag),
modifying internal links so that they still point to the same places
(even though in different files).  Then you can export these files
individually to HTML.

I think splitting the Org file is a better idea than splitting the
produced HTML file: it seems both easier and maybe more versatile (you
are not restricted to HTML then).

Notice that if you have some configs (like #+OPTIONS etc.), it might be
a good idea to move them to a separate heading marked with :config: and
:noexport: tags.

The entry point is the =org-one-to-many= function.

It currently lacks proper documentation, but see its docstring for some
help.  Also, feel free to ask me.

Currently, the .el file lacks a proper header, too - I'll add it later
(maybe even today).

> Thanks!
>
> Jarmo

Hth,

-- 
Marcin Borkowski
http://octd.wmi.amu.edu.pl/en/Marcin_Borkowski
Faculty of Mathematics and Computer Science
Adam Mickiewicz University

Re: Exporting an org-file to multiple html pages

[Jarmo Hurri]

Marcin Borkowski <mbork@mbork.pl> writes:

>> I am writing a relatively extensive document in org, and I am
>> currently trying to figure out how to split the exported html into
>> multiple html pages.

> Does this help?
>
> https://github.com/mbork/org-one-to-many

Greetings Marcin.

Looks inviting. The built-in html exporter desperately needs something
like this.

I have to be prepared to share my org-file(s) of this project with other
people, so I am avoiding code outside the standard org distribution. Now
if only that famous *someone* would incorporate your solution into the
core.

The one thing that would need to be added, if I understand your solution
correctly, is an index and automatic links to index, prev, next etc.

Thanks,

Jarmo

Re: Exporting an org-file to multiple html pages

[Fabrice Popineau]

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

If you want a fancier solution : http://renard.github.io/o-blog-v2/
It works pretty well.

Fabrice

2015-09-01 11:07 GMT+02:00 Jarmo Hurri <jarmo.hurri@iki.fi>:

> Marcin Borkowski <mbork@mbork.pl> writes:
>
> >> I am writing a relatively extensive document in org, and I am
> >> currently trying to figure out how to split the exported html into
> >> multiple html pages.
>
> > Does this help?
> >
> > https://github.com/mbork/org-one-to-many
>
> Greetings Marcin.
>
> Looks inviting. The built-in html exporter desperately needs something
> like this.
>
> I have to be prepared to share my org-file(s) of this project with other
> people, so I am avoiding code outside the standard org distribution. Now
> if only that famous *someone* would incorporate your solution into the
> core.
>
> The one thing that would need to be added, if I understand your solution
> correctly, is an index and automatic links to index, prev, next etc.
>
> Thanks,
>
> Jarmo
>
>
>


-- 
Fabrice Popineau
-----------------------------
SUPELEC
Département Informatique
3, rue Joliot Curie
91192 Gif/Yvette Cedex
Tel direct : +33 (0) 169851950
Standard : +33 (0) 169851212
------------------------------

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

Re: Exporting an org-file to multiple html pages

[Marcin Borkowski]

On 2015-09-01, at 11:07, Jarmo Hurri <jarmo.hurri@iki.fi> wrote:

> Marcin Borkowski <mbork@mbork.pl> writes:
>
>>> I am writing a relatively extensive document in org, and I am
>>> currently trying to figure out how to split the exported html into
>>> multiple html pages.
>
>> Does this help?
>>
>> https://github.com/mbork/org-one-to-many
>
> Greetings Marcin.
>
> Looks inviting. The built-in html exporter desperately needs something
> like this.
>
> I have to be prepared to share my org-file(s) of this project with other
> people, so I am avoiding code outside the standard org distribution. Now
> if only that famous *someone* would incorporate your solution into the
> core.

That is non-trivial due to licensing issues.  When (and if) I sign the
FSF papers, this might be easier.  I'll look into it.

> The one thing that would need to be added, if I understand your solution
> correctly, is an index and automatic links to index, prev, next etc.

If you prepare your file so that all headlines get split, the main file
"becomes" the index file.  (The =bullets= parameter should help with
that, but unfortunately it doesn't really work very well.)

I may try to add such a feature anyway.  It requires a bit of thinking,
though, since which headlines exactly are split into their own files is
rather general, so the very meaning of "next" might not really be
obvious.

> Thanks,
>
> Jarmo

Best,

-- 
Marcin Borkowski
http://octd.wmi.amu.edu.pl/en/Marcin_Borkowski
Faculty of Mathematics and Computer Science
Adam Mickiewicz University