From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id EAMWJ6DOuGaJCgAAe85BDQ:P1 (envelope-from ) for ; Sun, 11 Aug 2024 14:45:52 +0000 Received: from aspmx1.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2.migadu.com with LMTPS id EAMWJ6DOuGaJCgAAe85BDQ (envelope-from ) for ; Sun, 11 Aug 2024 16:45:52 +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=1723387552; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=xk0xc6ZoOBXWLmW7Li4tyX9h/D7WOvCd5FKUapxw6co=; b=YBLkfZl30jzpUxmpYxBnNTrrgTrgd9EWlow3tYYv0GYQqOHINASI75jxhQdqVY1Z+cnP0P Cox9IFx+GmsoFsYsAdP3uMQ2dQt167jT8LwLrFUjBoa2qmN8RzeIBljAX63b/tvUN0tM8c VwGqyfuKoHpEr9F3xvphVggK4WMxtCVNu5wC5a8K0wWTYejo1NT6frAzmowudZbk5sbYms Egz+iaj+RTyYSPbKq847hfYvlpekNej3lJDokkcAsVRHe5uUNcZfg7SylppFIJnV7CqX1c 03UunKySlbJ3vRz34QyTmjqWafIpEB6D+vrmOb4tbFNMlc4KKFl7fTLumevLEA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1723387552; a=rsa-sha256; cv=none; b=WWo8uRDEEVDHP4BSDY/kbVqj+x/Trg3E9AsCL2WjE9tv4AOdEJZt0eWDS1rdC07UEFt5V+ FldyJKVuFvBqJl0lbcflD4jdgKxzZVA89rPJzI/owPKUd6Y1oOSX8C77gV/UHXCXANtYvl +4oTBvcnWG45ikPz2tWKHgolSGe23caGI6aKzjhxj6qEkXIYQYyW+RxWH5b5iEjbOOzpyG IHpR428diIL6DiG5rseudXJqme5j38corF2tPkQMRcUhSThQxUGpcDezDJkT1AIAEnvklZ jWAUnClB5w4dRZw2tm+ub+JtS7h3L6lc1mP6VQ15uRmJPIEUClfnWNl64ww3UQ== 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 5DBAC69EF2 for ; Sun, 11 Aug 2024 16:45:52 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sd9og-0008Vy-E9; Sun, 11 Aug 2024 10:45:06 -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 ) id 1sd9oW-0008VA-Kk for emacs-orgmode@gnu.org; Sun, 11 Aug 2024 10:44:58 -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 ) id 1sd9oT-0002ai-IZ for emacs-orgmode@gnu.org; Sun, 11 Aug 2024 10:44:56 -0400 Received: by mail.selma.hfmdk-frankfurt.de (Postfix, from userid 113) id C7DE6F62340; Sun, 11 Aug 2024 16:44:50 +0200 (CEST) Received: from [127.0.0.1] (dynamic-176-003-000-108.176.3.pool.telefonica.de [176.3.0.108]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 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 6F51EF611A0; Sun, 11 Aug 2024 16:44:48 +0200 (CEST) Date: Sun, 11 Aug 2024 16:44:47 +0200 From: Orm Finnendahl To: Ihor Radchenko CC: Org mailing list Subject: Re: multipage html output User-Agent: K-9 Mail for Android In-Reply-To: <87a5hjxjbh.fsf@localhost> References: <87frrzdrbz.fsf@localhost> <87plr14wka.fsf@localhost> <87bk2i8w07.fsf@localhost> <87r0b2kext.fsf@localhost> <87zfpk36er.fsf@localhost> <87a5hjxjbh.fsf@localhost> Message-ID: MIME-Version: 1.0 Content-Type: multipart/alternative; boundary=----9XFMHMAMANMLUM029UZF0WI3ZTKL72 Content-Transfer-Encoding: 7bit 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, HTML_MESSAGE=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 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." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-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-Queue-Id: 5DBAC69EF2 X-Migadu-Scanner: mx12.migadu.com X-Migadu-Spam-Score: -6.35 X-Spam-Score: -6.35 X-TUID: gNtxvMcsSvg6 ------9XFMHMAMANMLUM029UZF0WI3ZTKL72 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hi, OK, got it, I'll check and implement everything tomorrow when I'm back on = my desk=2E=2E=2E Am 11=2E August 2024 15:47:30 MESZ schrieb Ihor Radchenko : >Orm Finnendahl writes: > >>> Also, as a side note, this docstring does not follow docstring >>> conventions=2E Try M-x checkdoc >> >> I corrected it adding your suggestion explicitely=2E Checkdoc doesn't >> complain about this one any more, but complains all over the place >> with other docstrings not written by me as well, so I'm not >> sure=2E Please check again=2E > >> (defvar org-export-multipage-split-functions nil >> "List of functions applied to the parse tree=2E >> The functions are applied only, when multipage output is >> requested=2E They are called after the parse tree has been split >> for multipage output=2E > >This is kind of accurate (because of the implementation details), but >very confusing=2E Mostly because this docstring also serves as the >docstring for :filter-multipage-split export option=2E I'd prefer to be a >bit more explicit in the design=2E > >Maybe, instead of using the same :filter-multipage-split option both to >perform the document splitting and to post-process it, we can introduce >two export options: > >1=2E :multipage-split-function - the function (always one function!) to > perform the split > >2=2E :filter-multipage - functions applied on document AST after it is > processed by :multipage-split-function=2E > >>> I do not see `org-export-transcode-multipage' in >>> https://github=2Ecom/ormf/org-mode/tree/org-html-multipage >>>=20 >>> Did you forget to push some commits? >> >> No, that was a typo in my mail=2E It should have said: >> >>> I factored out org-html-transcode-multipage to >>> org-export-transcode-org-data and got rid of >>> org-html-transcode-multipage=2E > >I think you misunderstood what I was asking about=2E >My point is that `org-html-transcode-org-page' largely duplicates what >is already done in `org-export-transcode-org-data' - processing >'inner-templtate and 'template=2E My suggestion is to move generic parts >of `org-html-transcode-org-page' to ox=2Eel and call it >`org-export-transcode-org-page'=2E > >--=20 >Ihor Radchenko // yantar92, >Org mode contributor, >Learn more about Org mode at =2E >Support Org development at , >or support my work at ----------------- Prof=2E Orm Finnendahl Komposition Hochschule f=C3=BCr Musik und Darstellende Kunst Eschersheimer Landstr=2E 29-39 60322 Frankfurt am Main ------9XFMHMAMANMLUM029UZF0WI3ZTKL72 Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hi,

OK, got it, I'll check and implement ev= erything tomorrow when I'm back on my desk=2E=2E=2E

Am 11=2E August 2024 15:47:30 MESZ schrieb Ihor Radchenko <ya= ntar92@posteo=2Enet>:
Orm Finnendahl <orm=2Efinnendahl@sel=
ma=2Ehfmdk-frankfurt=2Ede> writes:

Also, a=
s a side note, this docstring does not follow docstring
conventions=2E T=
ry M-x checkdoc

 I corrected it adding your suggestion =
explicitely=2E Checkdoc doesn't
 complain about this one any more, but c=
omplains all over the place
 with other docstrings not written by me as =
well, so I'm not
 sure=2E Please check again=2E

(defvar org-export-multipage-s=
plit-functions nil
  "List of functions applied to the parse tree=2E
=
The functions are applied only, when multipage output is
requested=2E  T=
hey are called after the parse tree has been split
for multipage output=
=2E

This is kind of accurate (because of the implementa= tion details), but
very confusing=2E Mostly because this docstring also = serves as the
docstring for :filter-multipage-split export option=2E I'd= prefer to be a
bit more explicit in the design=2E

Maybe, instead= of using the same :filter-multipage-split option both to
perform the do= cument splitting and to post-process it, we can introduce
two export opt= ions:

1=2E :multipage-split-function - the function (always one func= tion!) to
perform the split

2=2E :filter-multipage - functions= applied on document AST after it is
processed by :multipage-split-fu= nction=2E

I do not see `org-export-transcode-= multipage' in
https://github=2Ecom/ormf/org-mode/tree/org-html-multipage=

Did you forget to push some commits?

No, that = was a typo in my mail=2E It should have said:

I factored out org-html-transcode-multipage toorg-export-transcode-org-data and got rid of
org-html-transcode-multip= age=2E

I think you misunderstood what I wa= s asking about=2E
My point is that `org-html-transcode-org-page' largely= duplicates what
is already done in `org-export-transcode-org-data' - pr= ocessing
'inner-templtate and 'template=2E My suggestion is to move gen= eric parts
of `org-html-transcode-org-page' to ox=2Eel and call it
`o= rg-export-transcode-org-page'=2E

-- =
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more abou= t Org mode at <https://orgmode=2Eorg/= >=2E
Support Org development at <https://liberapay=2Ecom/org-mode>,
or support my= work at <https://liberapay= =2Ecom/yantar92>
Prof=2E Orm Finnendahl
Komposition
Hochschule= f=C3=BCr Musik und Darstellende Kunst
Eschersheimer Landstr=2E 29-3960322 Frankfurt am Main
------9XFMHMAMANMLUM029UZF0WI3ZTKL72--