emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Exporting an org-file to multiple html pages
@ 2015-08-31 10:16 Jarmo Hurri
  2015-08-31 11:43 ` Marcin Borkowski
  0 siblings, 1 reply; 5+ messages in thread
From: Jarmo Hurri @ 2015-08-31 10:16 UTC (permalink / raw)
  To: emacs-orgmode


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

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Exporting an org-file to multiple html pages
  2015-08-31 10:16 Exporting an org-file to multiple html pages Jarmo Hurri
@ 2015-08-31 11:43 ` Marcin Borkowski
  2015-09-01  9:07   ` Jarmo Hurri
  0 siblings, 1 reply; 5+ messages in thread
From: Marcin Borkowski @ 2015-08-31 11:43 UTC (permalink / raw)
  To: emacs-orgmode


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

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Exporting an org-file to multiple html pages
  2015-08-31 11:43 ` Marcin Borkowski
@ 2015-09-01  9:07   ` Jarmo Hurri
  2015-09-01  9:39     ` Fabrice Popineau
  2015-09-01  9:41     ` Marcin Borkowski
  0 siblings, 2 replies; 5+ messages in thread
From: Jarmo Hurri @ 2015-09-01  9:07 UTC (permalink / raw)
  To: emacs-orgmode

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

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Exporting an org-file to multiple html pages
  2015-09-01  9:07   ` Jarmo Hurri
@ 2015-09-01  9:39     ` Fabrice Popineau
  2015-09-01  9:41     ` Marcin Borkowski
  1 sibling, 0 replies; 5+ messages in thread
From: Fabrice Popineau @ 2015-09-01  9:39 UTC (permalink / raw)
  To: Jarmo Hurri; +Cc: emacs-orgmode@gnu.org

[-- 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 --]

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Exporting an org-file to multiple html pages
  2015-09-01  9:07   ` Jarmo Hurri
  2015-09-01  9:39     ` Fabrice Popineau
@ 2015-09-01  9:41     ` Marcin Borkowski
  1 sibling, 0 replies; 5+ messages in thread
From: Marcin Borkowski @ 2015-09-01  9:41 UTC (permalink / raw)
  To: emacs-orgmode


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

^ permalink raw reply	[flat|nested] 5+ messages in thread

end of thread, other threads:[~2015-09-01  9:41 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2015-08-31 10:16 Exporting an org-file to multiple html pages Jarmo Hurri
2015-08-31 11:43 ` Marcin Borkowski
2015-09-01  9:07   ` Jarmo Hurri
2015-09-01  9:39     ` Fabrice Popineau
2015-09-01  9:41     ` Marcin Borkowski

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).