all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Marcin Borkowski <mbork@mbork.pl>
To: emacs-orgmode@gnu.org
Subject: Re: Exporting an org-file to multiple html pages
Date: Mon, 31 Aug 2015 13:43:58 +0200	[thread overview]
Message-ID: <8737yzk7i9.fsf@mbork.pl> (raw)
In-Reply-To: <87wpwblq45.fsf@iki.fi>


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

  reply	other threads:[~2015-08-31 11:44 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2015-08-31 10:16 Exporting an org-file to multiple html pages Jarmo Hurri
2015-08-31 11:43 ` Marcin Borkowski [this message]
2015-09-01  9:07   ` Jarmo Hurri
2015-09-01  9:39     ` Fabrice Popineau
2015-09-01  9:41     ` Marcin Borkowski

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=8737yzk7i9.fsf@mbork.pl \
    --to=mbork@mbork.pl \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.