From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id eKutC36rLmVavQAAauVa8A:P1 (envelope-from ) for ; Tue, 17 Oct 2023 17:42:54 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id eKutC36rLmVavQAAauVa8A (envelope-from ) for ; Tue, 17 Oct 2023 17:42:54 +0200 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 AFDB54426E for ; Tue, 17 Oct 2023 17:42:53 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=eshelyaron.com header.s=mail header.b=HpA3DA77; 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=pass (policy=reject) header.from=eshelyaron.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1697557374; 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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=dihpZf7gHuiIQadH/YETcemB1xbcBeGdj005IK4rENg=; b=hzxDYCK2maG+w76w5N+AEmwVaALTuWAqg7SI5VLvFmJY7nYm20ScQfDj9V9c87/OlVYlvL WFsPSg5fOz0m7cQb0Xt2CBldoqDoMAiNZEpzDlSEx/dm2fOL5UPakUyjjWWg1/eLO0Sz92 qqNFREDZNqxwnmUpaPifPpOZKBMsxZBSB4BHfKf88ZJBxQfU1mp3d4bA2EPsYbovD+wefM C8mASrZyxjM8XB4ppLvpmxE7VvfgkawvDeywukN10O9nxdhjR6HnUYKzX5dOh5tvuthgo3 vox4ae/SyTQK3USHYia6BTxvW/G+lm/vpEkwTeiITwk5vb/f8zs+gkXhIR8Mzg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1697557374; a=rsa-sha256; cv=none; b=Mu62GUfhjmYwYvQwUh0lBiOCVxdt+A93McH7arVgDDt8rj2wErWcO6HIDYolvxHX0wPQ4d sAijzj5HGkCD9lTxZw8ZX40lq/dzEP1Z1Y7fpFmrQYcZAMRGaTwjnoHCb+oc2g/HVDpq0g F8nfG4Y5hdm/+nzkQDP1T9+LBdbwchUudIhoxPv1ndFj2/cGLTYEcNz149YmkrxDOgvYvE zCs6b5ihjweIGaf9+QW4pctZHA+VHLfNn3wvPh7QAGR2lu0HN5qJnOopoRUtOzkP7/amJN 5AA8iYmv6v9K2VQBcZyc8tJcy77ONR6YPZM3xHkMMMRIg/AhRCKr1kuXfJw+rA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=eshelyaron.com header.s=mail header.b=HpA3DA77; 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=pass (policy=reject) header.from=eshelyaron.com Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qsmCQ-0000Yf-EX; Tue, 17 Oct 2023 11:41: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 1qsjhZ-0007HF-Qm for emacs-orgmode@gnu.org; Tue, 17 Oct 2023 09:01:46 -0400 Received: from mail.eshelyaron.com ([107.175.124.16] helo=eshelyaron.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qsjhQ-0004BF-MO for emacs-orgmode@gnu.org; Tue, 17 Oct 2023 09:01:37 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=eshelyaron.com; s=mail; t=1697547686; bh=zNpDJn27B7e/zkKFhE0OB2g4UtzGsPwStiYmSw0xMiU=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=HpA3DA778JJ4NZAR3c1oCpc7tjcbu5ZCmnaNdWpcyJ9X4bQhX0C+4SqJ1UJP+jhvh lnrUyAHHiiNfzmGN5DLQxXYvwtEgKZbgb5LCRG991kSCUWzsEgegdiETtHF2feI5RU aStKC1DX9VWU30WlUXDP6bjaMoQ5LyXAHBVwhUJybYJvfYDl3TVZX4Pc8ggYvAvy6q 88molahqxX+eiFp9Dui7EHX7mVVsTKv5IUkFuYY6aFO9O2uCsMfAuDGHYK32U3LmF6 eicFk4y5jx5dXLrkcvtFN+pkymds2MTAgLQ3Ad9Z5ZZ1O967UP1InSwq/3n6pWgLiJ IWH1HzyQ9LNnQ== From: Eshel Yaron To: Ihor Radchenko Cc: emacs-orgmode@gnu.org Subject: Re: [SUMMARY] #3 [[bbb:OrgMeetup]] on Wed, Oct 11, 19:00 UTC+3 In-Reply-To: <87edhtfpal.fsf@localhost> (Ihor Radchenko's message of "Tue, 17 Oct 2023 11:42:42 +0000") References: <87mswxi7mk.fsf@localhost> <87edhtfpal.fsf@localhost> Date: Tue, 17 Oct 2023 15:01:23 +0200 Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=107.175.124.16; envelope-from=me@eshelyaron.com; helo=eshelyaron.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Tue, 17 Oct 2023 11:41:35 -0400 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-Spam-Score: -7.88 X-Migadu-Queue-Id: AFDB54426E X-Migadu-Scanner: mx0.migadu.com X-Migadu-Spam-Score: -7.88 X-TUID: Zz1jsabdhhzo Hello Ihor, Ihor Radchenko writes: > - There was a demo demonstrating how to export texinfo manual to HTML > with source code examples fontified as in Org mode > > - The motivation is limited Org support for manual authoring > - ELPA, when generating manuals from Org sources, does not use the > latest Org version, with some features lacking. > - While Org supports org to texi export, only a limited subset of > texinfo markup is supported, as Org is not specialized for > manuals and does not have a notion of specialized markup like > , , , etc > - Also, Org does not yet support glossaries and indexes as well as > Texinfo does. Though see > https://github.com/tecosaur/org-glossary, which is an > experimental implementation by one of the Org contributors. > > - One downside of texinfo is that code snippets are not colored > - To solve this problem, https://github.com/hniksic/emacs-htmlize > and Org publishing are utilized > - The manual source is written in texi and then exported to html > during publishing > - The generated HTML is further processed (via > ~org-publish-after-publishing-hook~), taking the code in HTML, > passing it through ~htmlize~ (just like what Org does in > ~org-html-fontify-code~), and replacing the HTML code elements > with property fontified versions. > > - Unfortunately, the code was only showed on screen and no link was > dropped to the chat. So, I am just leaving what I remember from > how the code works (above). I presented that, sorry for not sharing a link. You can find the code I use for adding highlighting to Texinfo examples here: http://git.eshelyaron.com/gitweb/?p=esy-publish.git;a=blob;f=esy-publish.el;h=cb103b78b7dd2f8d0f5260883b61bf651d0650f5;hb=HEAD#l394 Namely, the function `esy-publish-fontify-examples` takes the name of an HTML-formatted Texinfo manual, and uses `htmlize` to markup the contents of "example" blocks in that HTML file. The result is very similar to the markup of source blocks in Org documents. For instance you can see some highlighted "examples" here: https://eshelyaron.com/man/sweep/Numbered-Variables.html Thank you for organizing this nice meetup! Best, Eshel