From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1.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 +H0SEyiDzmYQgQAA62LTzQ:P1 (envelope-from ) for ; Wed, 28 Aug 2024 01:53:44 +0000 Received: from aspmx1.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1.migadu.com with LMTPS id +H0SEyiDzmYQgQAA62LTzQ (envelope-from ) for ; Wed, 28 Aug 2024 03:53:44 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=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=1724810024; 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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post; bh=dU/NjzbBmKwzrbu7cXu1qATOc1WLr7YuqBM9suM45Rw=; b=nOTaOz7GrHkMIpnjTgun7d9cbhpcYgES64y/LhBK9btHeKRWIJV6gsksnKY8+Zh5VuMdld IynveSP6fR6KMeKod7hUVPj1x9+hhcOrLBjkBqhr0xnKfxVnS++mj/tKuf2JjXrsfhK6ac ABRlvLCyP8aR3inncPHeS40weCUc8Gv68ufl2lCmxMJuT0xRppbxptQSS2dBePCSrUtUKg k7H5ibG4NjVNjykdp/kEZXUEpWFNx8ezcjzxev9WYcVRXXVelYuewCP6fagkCDAj1WsNg6 ai7PHvhBn/q4S6HH2YlMModp81aX3gQeBnPOvmUfuebIpmqJMhvA+VvNJdjJXQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1724810024; a=rsa-sha256; cv=none; b=Rogp399OvkbcP3ypfIldhSmWYYC8yJh4X8FjMQ/fjqUiGsZ8PcuG4dQbPGadrGD2UJvR8F Tivd+d8SwR8DvqoaRA0k5pw8Z5huUnUDdAaeT7KeQ6qIpcyO9fWhatKYxlLnX0/jYUSSRd oB8iYQVt0mJH2AhutvDpJBnSbbhy77r4Akt2iENTxq6gbG60NUkbagdJBxrrJwz7syliap HJq8GmTVlnP29nEgbv9GZvglsYSUkohgi1Lf6zUMiVAFt4QD77De+u4EEf4A9XCHXZKA8D YeoZDZaQBYSU2a4LGZBnn0/1cgNRzv9U5Ojbc1Ck9WCV1HCXty3ouW96vHtWJg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=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 0383C1ECF8 for ; Wed, 28 Aug 2024 03:53:44 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sj7rV-00008f-7x; Tue, 27 Aug 2024 21:52:41 -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 1sj7rS-00008O-NY for emacs-orgmode@gnu.org; Tue, 27 Aug 2024 21:52:38 -0400 Received: from 96-100-31-185.ftth.cust.kwaoo.net ([185.31.100.96] helo=k-7.ch) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sj7rQ-0002ef-FB for emacs-orgmode@gnu.org; Tue, 27 Aug 2024 21:52:38 -0400 Received: from van (_gateway [192.168.1.1]) (Authenticated sender: seb) by k-7.ch (Postfix) with ESMTPSA id E6B7EE810D for ; Wed, 28 Aug 2024 03:52:32 +0200 (CEST) From: =?utf-8?Q?S=C3=A9bastien_Gendre?= To: General discussions about Org-mode Subject: Re: Enhancing the HTML exporter: Create a new backend or contribute to the upstream In-Reply-To: <87h6b51llh.fsf@k-7.ch> (=?utf-8?Q?=22S=C3=A9bastien?= Gendre"'s message of "Wed, 28 Aug 2024 03:29:14 +0200") References: <87h6b51llh.fsf@k-7.ch> User-Agent: mu4e 1.12.1; emacs 29.4 Date: Wed, 28 Aug 2024 03:52:32 +0200 Message-ID: <87bk1d1kin.fsf@k-7.ch> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" Received-SPF: pass client-ip=185.31.100.96; envelope-from=seb@k-7.ch; helo=k-7.ch X-Spam_score_int: -8 X-Spam_score: -0.9 X-Spam_bar: / X-Spam_report: (-0.9 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RDNS_DYNAMIC=0.982, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, TVD_RCVD_IP=0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no 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: 0383C1ECF8 X-Migadu-Scanner: mx12.migadu.com X-Migadu-Spam-Score: -8.58 X-Spam-Score: -8.58 X-TUID: F5Bo+s0qIS4f --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Some precision about the time: I'm actually finishing the last work I have to do for the school, so I will be very busy until December. Until them, I can only dedicate my breaks to the enhancement of the HTML ex= porter. S=C3=A9bastien Gendre writes: > [[PGP Signed Part:Good signature from B586F7C77239E29E S=C3=A9bastien Gen= dre (trust ultimate) created at 2024-08-28T03:29:14+0200 using= RSA]] > > TL;DR: Plan to add features to HTML export, do I add them in the > built-in HTML exporter (as upstream contribution) ? Or as a > downloadable derived backend=C2=A0? Which on do you prefer=C2=A0? > > > Hello, > > I plan to use Org-publish to create a website from Org-mode files. And I > would have some features that are not provided by the built-in HTML > exporter. > > To add theses features, my first plan was to customize an org-publish > project. Using a custom preamble function, a custom completion function > and some new export options added to "org-export-options-alist". > > It's still a work in progress, but the more feature I add, the more I > think I need to add them in an export backend. > > So, my second plan is to create an export backend, derived from the > built-in HTML exporter. > > But maybe you would prefer that I=C2=A0add these new features as a > contribution to the built-in HTML exporter=C2=A0? > > Here is what I plan to add, on each generated webpage, compared to what > the built-in HTML exporter already provide: > > - A side panel containing: > - A site web name and/or logo > - A search field for an local search engine > - A main navigation menu, built from a dedicated org-mode file > - A more "modern" look > - More special blocks available like: > - A question/answer bloc, where the answer is hidden > - Important, warning and tip blocks > - A generic hide-show bloc > - Tab to select which content to see > - Bibliography on a dedicated webpage when using org-publish > - A button to download the Org-mode file source of a webpage > - Possibility to set the home page, when there is no index.org >=20=20=20 > As say above, I started it as a custom org-publish > project. You can found my work in progress here: > https://framagit.org/SebGen/org-documentation-template > > For now, the search engine use the software Pagefind: > https://pagefind.app > > And the menu is made from an org-mode file where first level heading > become menu item and links are simple org-mode links. > > > Best regards > > ------- > Gendre S=C3=A9bastien > > [[End of PGP Signed Part]] --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQI/BAEBCAApFiEEaA9vw9ypVj1kP0tAtYb3x3I54p4FAmbOguALHHNlYkBrLTcu Y2gACgkQtYb3x3I54p5TJQ/+JxpbBQDY6Gt+At2p1O6amRF9scpzVzx4/Lj2n3Ej JgQ3XbG420T//OM8ebtqclmMNdLqrp79v7uDugIgp0O06ejaQc7k6rRUU7G4zuqU yG3i5uiMQm65sbVJnqcWVKqyTo7VOUpHByilhalpTuFb0RQB4sRao9u1H1NSHCOd KdWu0QupxXo+EzW9TvHv3vLXGPt1jQV0HtEOoV/E+9OkABoAH8VqAkmRZKn9YGFd dc+wnGYUFB/DIrFEO7bMM3x69E45ac/xCABULV/NNj0327SokWZfAhdaoz5HYagx jVfbaru87J2GOJR+Co6VEk8kRYEATezS1nUBWjNjR2WSP9kGQ688BW/s6boMjSPY /g4t1NCywllvsLUI57PUd9uQVDw2LcmYbXko1qYib5XeCzDoSHph5rjyfcjeQwWI F/oVC2wsml569UZbCaxwKHQ/7KNcU8i7ZzZn2k6ibkXXsjbZl44GeSiDrS/IyErv M9BjdAHNKRyDD53Zlx4IQag8bPAac9SnlgNBzHQFGDvXN+vyz2x2WxDRC628IubL TTUp3hEhEARjIwG0EwOcfnkCd1YYdhGH4xUJTKEIdCzECVBrnOJt2ZdOaFr6pvib H+/FcvGozlNer2JvtR4HzB+XI6ToSB6K5PZoxzMKkVXKdwnsxvYVWSFbKRhVT8Vn T5c= =mOS9 -----END PGP SIGNATURE----- --=-=-=--