From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id WF6kCbN9zmYSsgAAe85BDQ:P1 (envelope-from ) for ; Wed, 28 Aug 2024 01:30:27 +0000 Received: from aspmx1.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2.migadu.com with LMTPS id WF6kCbN9zmYSsgAAe85BDQ (envelope-from ) for ; Wed, 28 Aug 2024 03:30:27 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=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"; dmarc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1724808627; 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=+KkwPnohz8CK0wxy+UYKQunxaxbQo65C8BXE3b7a27U=; b=CPw6bFF7fJNWvs5fygAUMU0sjgMyMoaLtMBECzeDlYIy7plLuzsvQe7sK/jL+AWOK+w7FU Kr/x3Qo8iYDvU5LNDqgApOyQnD7DN+X4nnARImz0yVFlNzMGVKLsQllh7TO7zqpwDhuFJ9 UfwCdoTOD6gmM2McGI2VQMHGVnf2B7BVOT+yuvkfn5FFlcR1lWuLV9sz8SQXYTqSw7m+4F UJpadK16ev9RtDBsuE7UiX+1ddntNITiczqn7z1uQIAoSJlctMN+hCcShuCLXQPr8gZH1k SLKRrpRBHEqGdFZn7rzKBCYTIk5ASMWqO3spVLhakeNzMWTSrvO1Pu9sciai/w== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=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"; dmarc=none ARC-Seal: i=1; s=key1; d=yhetil.org; t=1724808627; a=rsa-sha256; cv=none; b=pfpuUnLNCh3RvsyHRq2fnttxCfED92CDMgW3UT7EgUiCnAD4aPrHU3fMSYNwBZc5qA8dzS p3zgB0zudV+WKDs8VyKlaPlJfL37C9MyEH87ASvQ8u9By7ELBlhqudPnvisnUSq2FQsMar 6UIxteufNkn9PY1z5yMM8VIEaVYthEnZTNXAGk4rwzzrW4cIZMk8j0c45jGfnDQSkHUXto dCO5+gBKMxqimGClKsio1M+GUKEnEIGoeJiD4mm/eSsNlVImMFGcv190lHtmQMKBfCAyuc 7mHcQ2rJfaAAnb/lw4J4Ir7zgTCBLYsi4uxgYhXFdkrQ/wktRzdNgRqJbBy8+A== 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 AF22C12E51 for ; Wed, 28 Aug 2024 03:30:26 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sj7VC-0005py-6t; Tue, 27 Aug 2024 21:29:38 -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 1sj7V5-0005pa-4J for emacs-orgmode@gnu.org; Tue, 27 Aug 2024 21:29:32 -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 1sj7V2-0008WA-Lf for emacs-orgmode@gnu.org; Tue, 27 Aug 2024 21:29:30 -0400 Received: from van (_gateway [192.168.1.1]) (Authenticated sender: seb) by k-7.ch (Postfix) with ESMTPSA id C3D24E810D for ; Wed, 28 Aug 2024 03:29:21 +0200 (CEST) From: =?utf-8?Q?S=C3=A9bastien_Gendre?= To: General discussions about Org-mode Subject: Enhancing the HTML exporter: Create a new backend or contribute to the upstream User-Agent: mu4e 1.12.1; emacs 29.4 Date: Wed, 28 Aug 2024 03:29:14 +0200 Message-ID: <87h6b51llh.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-Country: US X-Migadu-Flow: FLOW_IN X-Migadu-Queue-Id: AF22C12E51 X-Migadu-Scanner: mx13.migadu.com X-Migadu-Spam-Score: -8.58 X-Spam-Score: -8.58 X-TUID: cD4WpQWXSqv1 --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable 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: =2D 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 =2D A more "modern" look =2D More special blocks available like: - A question/answer bloc, where the answer is hidden - Important, warning and tip blocks - A generic hide-show bloc =2D Tab to select which content to see =2D Bibliography on a dedicated webpage when using org-publish =2D A button to download the Org-mode file source of a webpage =2D Possibility to set the home page, when there is no index.org =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 =2D------ Gendre S=C3=A9bastien --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQI/BAEBCAApFiEEaA9vw9ypVj1kP0tAtYb3x3I54p4FAmbOfWoLHHNlYkBrLTcu Y2gACgkQtYb3x3I54p53XRAA0W1KaEHBL459mnmfke6jpDV7YxNSCu2KitxOZAaj 4eNfem5TbZIEWFI9wSHfJnY+NAC2lJqCOc2u4BZkb2SzUtVlPAAza+qXw6+7bbFM GWYPP//5dJG94N7J88gKk3kPR/ae7Fup3GdiSyvEb3U3X4Wflgmsi+jZmdYK2nJU SOHpPJg0U+iv2Y8PvPC+/EyR9ftH4uDDcM/zer6q+221KjWIsj5rXI6rthOUGKex xg/vBIHU4I2p40pZcV6Q8zKGb/az0W0XR0b3rN0VZauXgZGnJKWeZyC+ydk1dlDf fM27ZqMynl0eRkvPrlJfGESNaHWcZGWN7lu1ShWTBQ8m2RJqvLaVanlLzO3H8iLo wB8JlSuAnKxeH0XyywxHV1vS1RbV65hQKt/s1RGzWXblj+lE+JuF9+VLMXKFdkju K0cqHXai+P28sV7kIv46cx3yw/Pf02AeUckmr+RfcpF+CK95iWcV7nlNZ621jAJl Pl+P+2k+ZhTiqg+sjAC+JBjHyG2z83QmNh2RVAkqKe67+F09HXX9aYuGKBx1zDBJ uK1+1ftdRwny3KY8wGJsSCyQr/a9FqhZ8yd29lNi9PJAwOZ0hLqHxbj8nnBSQ2eM fJ6UDGXM+qJvThxQGAOKJJiLVpCnzfWWA4LjtpHdq5/0BRqECrPH4OHZS6o0jEUR TMA= =a/S0 -----END PGP SIGNATURE----- --=-=-=--