From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>
Received: from mp2.migadu.com ([2001:41d0:403:58f0::])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	by ms13.migadu.com with LMTPS
	id EIRkDM0dhWZoVwEAe85BDQ:P1
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Wed, 03 Jul 2024 09:45:49 +0000
Received: from aspmx1.migadu.com ([2001:41d0:403:58f0::])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	by mp2.migadu.com with LMTPS
	id EIRkDM0dhWZoVwEAe85BDQ
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Wed, 03 Jul 2024 11:45:49 +0200
X-Envelope-To: larch@yhetil.org
Authentication-Results: aspmx1.migadu.com;
	dkim=none;
	dmarc=fail reason="SPF not aligned (relaxed), No valid DKIM" header.from=hfmdk-frankfurt.de (policy=none);
	spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org"
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org;
	s=key1; t=1719999949;
	h=from:from:sender:sender:reply-to:subject:subject:date:date:
	 message-id:message-id:to:to:cc:mime-version:mime-version:
	 content-type:content-type:list-id:list-help:list-unsubscribe:
	 list-subscribe:list-post; bh=m4DKvfc5bMYKfl0FI83gTNl+ich/R5zkGZh/kZnzNPI=;
	b=rchD4FPxNP8VbuLJ8vPYRuueFyO5wT1u4jIDs/KYeQyPqZuUZM1rmpNEZ9s927KK3x7TXR
	/OQGHwXve1jJGUFhwzEINQuFgOp5wSnfnLxRMzZ/nDROueLtHfdFGbvP1xYHyEIo5a7TGP
	qUL+3UAcWOEGAO/rp3CxP9SUPvzjK3AjwMl6CuRhMTdIHulPIf6P1icpuw70XgxbvwaB78
	55tlShyc36VYEvvgcqpCl6JpQARf6NdvlgCram3yDURekkqzkNingGyhFU0OVb2hauuydc
	E8JsN7QPw+INrE77s06rzsOBG0JoPawppWLo4OBHdUuXPk/65RvICXpMWz9o8w==
ARC-Seal: i=1; s=key1; d=yhetil.org; t=1719999949; a=rsa-sha256; cv=none;
	b=FFkIxSf4+JhdnJ+JAvXpym6ChM2EDX2ftUT9/+wqRe4Dyl9bfBX2HUqV1hqqXuiKv9XGwa
	vt7DkeQ+btNOJxUgFBUvi9YeXlY+KlLx7CQhVL6W6Bt4iBbkV2aePIxZL+blajnatlyXIh
	PtlQ2sg6IUxMDAzkHpqdxk5g2L3FY7hYA1qOoelKUQ37ylaFDaR6LCwwcA3ncMX/NLqUNE
	go9TYBR15bc30loV7IuQOT0ajHEOx5pVgyD48hdkkEmermKvufCHkL0PfsuAjz6hXb697C
	UodBHb1ohqjcT+Lue7kLCFFsWbtXIeZsmWREwHxsxaNetGXYApp/ruYwrt0MCA==
ARC-Authentication-Results: i=1;
	aspmx1.migadu.com;
	dkim=none;
	dmarc=fail reason="SPF not aligned (relaxed), No valid DKIM" header.from=hfmdk-frankfurt.de (policy=none);
	spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org"
Received: from lists.gnu.org (lists.gnu.org [209.51.188.17])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(No client certificate requested)
	by aspmx1.migadu.com (Postfix) with ESMTPS id 0419082C1
	for <larch@yhetil.org>; Wed, 03 Jul 2024 11:45:49 +0200 (CEST)
Received: from localhost ([::1] helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <emacs-orgmode-bounces@gnu.org>)
	id 1sOwXr-0003G0-6x; Wed, 03 Jul 2024 05:44:59 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10])
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1)
 (envelope-from <orm.finnendahl@selma.hfmdk-frankfurt.de>)
 id 1sOwXk-00038T-AL
 for emacs-orgmode@gnu.org; Wed, 03 Jul 2024 05:44:53 -0400
Received: from www.selma.hfmdk-frankfurt.de ([46.4.92.145]
 helo=mail.selma.hfmdk-frankfurt.de)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1)
 (envelope-from <orm.finnendahl@selma.hfmdk-frankfurt.de>)
 id 1sOwXh-00036c-9K
 for emacs-orgmode@gnu.org; Wed, 03 Jul 2024 05:44:51 -0400
Received: by mail.selma.hfmdk-frankfurt.de (Postfix, from userid 113)
 id 49BC3F61D73; Wed,  3 Jul 2024 11:44:44 +0200 (CEST)
Received: from selma.hfmdk-frankfurt.de
 (ip-037-201-128-004.um10.pools.vodafone-ip.de [37.201.128.4])
 (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
 key-exchange X25519 server-signature ECDSA (P-256) server-digest SHA256)
 (Client did not present a certificate)
 by mail.selma.hfmdk-frankfurt.de (Postfix) with ESMTPSA id 2A4CAF602B4
 for <emacs-orgmode@gnu.org>; Wed,  3 Jul 2024 11:44:42 +0200 (CEST)
Received: by selma.hfmdk-frankfurt.de (Postfix, from userid 1000)
 id C68CC3960552; Wed, 03 Jul 2024 11:44:41 +0200 (CEST)
Date: Wed, 3 Jul 2024 11:44:41 +0200
From: Orm Finnendahl <orm.finnendahl@selma.hfmdk-frankfurt.de>
To: emacs-orgmode@gnu.org
Subject: multipage html output
Message-ID: <ZoUdiTfbYqzPwTiX@orm-t14s>
Mail-Followup-To: emacs-orgmode@gnu.org
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
X-Disclaimer: Why are you listening to me? 
X-Operating-System: GNU/Linux
Organization: Hochschule =?utf-8?B?ZsO8?= =?utf-8?Q?r?= Musik und
 Darstellende Kunst Frankfurt, Frankfurt, Germany
Received-SPF: pass client-ip=46.4.92.145;
 envelope-from=orm.finnendahl@selma.hfmdk-frankfurt.de;
 helo=mail.selma.hfmdk-frankfurt.de
X-Spam_score_int: -18
X-Spam_score: -1.9
X-Spam_bar: -
X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, SPF_HELO_NONE=0.001,
 SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-BeenThere: emacs-orgmode@gnu.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org
Sender: emacs-orgmode-bounces+larch=yhetil.org@gnu.org
X-Migadu-Flow: FLOW_IN
X-Migadu-Country: US
X-Migadu-Spam-Score: -1.28
X-Spam-Score: -1.28
X-Migadu-Queue-Id: 0419082C1
X-Migadu-Scanner: mx11.migadu.com
X-TUID: yvUqYGjTxIeT

Hi,

 after my clunky publishing chain from org to gitbook with multipage
page output broke down recently I finally decided to tackle adding an
export backend for multipage html output to org-export.

It is done now and mainly working. The backend uses all the
funcionality of the ox html exporter, only slightly modifying the code
in places where it is necessary for multipage output. In addition I
tried to make it as general, as possible to enable adding other
multipage backends (like for md output) easily.

Before sharing it I thought it might be a good idea to think about
integrating it properly/officially into org. I would be willing to
provide the code, docs, patches, etc.

There are a couple of decisions to make (should it be integrated as an
option into the html output backend or should it be a separate backend
altogether?  What options concerning footnotes, toc, etc. should be
provided?  etc...) and this mail is basically asking about how to
proceed.

My questions:

- Is there widespread interest to fully integrate it into org mode?

- If so, whom should I contact, or is it expected that I just go ahead
  and supply merge requests?

I'm a bit hesitant putting in the extra work of fully integrating it
without approval by the maintainers to go ahead.

In case someone wants to take a peek at the current state of the code
you can check out my github repository here:

https://github.com/ormf/ox-html-multipage

Be aware and warned that the code is in constant flux, not finalized
and there still are some open questions for me what would be the best
way to integrate the code into the old export engine, like whether
adding optional args to the transcoding functions or using properties
in the info channel, etc... Once it is finalized, the current single
page html export will work exactly as before (it already does, but
while checking it out I am modifying the html templates for the
multipage navigation, toc, etc.)

Hope to hear from you, especially if the maintainers are reading this.

--
Orm