From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.text.pandoc/31767 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: "'William Lupton' via pandoc-discuss" Newsgroups: gmane.text.pandoc Subject: Re: Multiple HTML file (chunked) output with template Date: Thu, 17 Nov 2022 14:42:01 +0000 Message-ID: References: <264eeee0-68c8-4389-a5c5-12563c6926f6n@googlegroups.com> <1ef6858a-0a37-4f5f-a88b-eff2479a8130n@googlegroups.com> <539db8b9-47f4-43b8-83d1-4b4c99dc3b3fn@googlegroups.com> <7f4b28ec-1e91-4228-ab03-fe58a2e5cf18n@googlegroups.com> <5e290d88-1c47-407d-819b-34a094d8b48fn@googlegroups.com> <20b2a20b-69ad-4b93-863a-c70db01d45een@googlegroups.com> <0a29b118-ae0f-448f-8e3e-39cc96ef5d8an@googlegroups.com> Reply-To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="00000000000036cdb705edab987f" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="17795"; mail-complaints-to="usenet@ciao.gmane.io" To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Original-X-From: pandoc-discuss+bncBCS4HJ6WSAHBBRUQ3GNQMGQEZZABWQY-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Thu Nov 17 15:42:19 2022 Return-path: Envelope-to: gtp-pandoc-discuss@m.gmane-mx.org Original-Received: from mail-ej1-f58.google.com ([209.85.218.58]) by ciao.gmane.io with esmtps (TLS1.3:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.92) (envelope-from ) id 1ovg5p-0004QW-Kj for gtp-pandoc-discuss@m.gmane-mx.org; Thu, 17 Nov 2022 15:42:17 +0100 Original-Received: by mail-ej1-f58.google.com with SMTP id xc12-20020a170907074c00b007416699ea14sf1211282ejb.19 for ; Thu, 17 Nov 2022 06:42:17 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1668696137; cv=pass; d=google.com; s=arc-20160816; b=VyLyfnGaqnGbVX/BJhVQ7iTkwKGDLrfELzyVS19hBpODAqDoNfOw1C5cFw1cy/pvN2 z7PZxmaZ8Tk34p85V6uopdGaPzq1Q6g8GIu5B/DDPrQYpzDkqG6JCfIZq0741oxPc+t+ QjtrtoYT2YZuatp4LOmdjW8pqzfPaUktEi65Duji5QKrKc9ma1mjoePn8xdeFxNwPKVE Nt8o/BHNuJr6XlPCTUd/qF5pR0TsKhK2dTbiGrxmXsRWGJqjzMc42RR2ehJOzaFxU3/F 2qwB/mhJS/xAuPRn0ifmS7cyRUi52QNtmv/h4um/qvMnDqu/FGLU34dlGKmufOdXp2YO kt/w== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:reply-to:to:subject:message-id:date :from:in-reply-to:references:mime-version:dkim-signature; bh=m8MMjOFtkF/6LtGRKbz+6R/kE9yzhvfCg7j0Pw5o930=; b=dWWs40TxukCMamaNuRaS6quMThZh5OZ+vH/ICblh+ltaGEJYYNscUhYK1y4+l+UOA/ Z7oBF6353zfjg0rnZkCtpJ1h7FlU+Vr1r0eloACqGUkRC3JhwsuejfCjbwpp+KFpTZYn ffguFWzVIFMYfBT/BTnN8ftqMLjMkkV+4X7VMcLPdqOcjgUSVRXJ/XWTr4TLDVV2uzrP oOBvToNG0uMe9xh2gXaJ3mvc9lFKsNWYioWLupFWg80Nyp19a3qeG14oOo1MpHbhckpr 71CeK+Tbo6MTtn9UGRvd1kDTYF8bu6i+bY7cgOLUjPKbOGClnP4ZblEp7MTmMDnZV04T xZLg== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@broadband-forum.org header.s=google header.b="X9SiB/Tc"; spf=pass (google.com: domain of wlupton-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org designates 2a00:1450:4864:20::633 as permitted sender) smtp.mailfrom=wlupton-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=broadband-forum.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20210112; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:reply-to :x-original-authentication-results:x-original-sender:to:subject :message-id:date:from:in-reply-to:references:mime-version:from:to:cc :subject:date:message-id:reply-to; bh=m8MMjOFtkF/6LtGRKbz+6R/kE9yzhvfCg7j0Pw5o930=; b=r6LJU5twAL6UGOJ83wLomilCna2GX1dp2fa4VD9kiV0y9kIApqQ9L1Yjc655eBEfPh 5ZnOYyzNyrYui9wt2a3+C5EmCzr0QM2bLz3SA9/n0+PnKNy+cHgCdWJPAZAucPWbMzq6 O+41xGfU08UTy4ZcBXb/Qot+18O10i0xED6XH4Aukg+ERy11+v+KvhGDLcUKcV4IJ5k/ /2LhS1/L2/j7tWVcnX+M/RObevtjwzWj/URmU3uG//Mcu/8G6FIS7IpKZ321+k4J1Utq ik0xvxAslpN9z8AiLMAdFV5K4P/+nqiXooJD8a28TjhIS+UQHVKD6yfUQkdwdBIaou5x liqQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :x-spam-checked-in-group:list-id:mailing-list:precedence:reply-to :x-original-authentication-results:x-original-sender:to:subject :message-id:date:from:in-reply-to:references:mime-version :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=m8MMjOFtkF/6LtGRKbz+6R/kE9yzhvfCg7j0Pw5o930=; b=pkhzTGDQy5eN5jcFIPxjyYQK7RVbUWJlLfx16dcf9DfhE0f6R7zSFLYbxLcUSRP6qA o7xosZ1nHpl9wYKWcfVKRC8t2kXxkZaAeb7v2t2pWaugvxHKhQVce1xANTFqJiB1Be3c d2yexUlqlPpQ9E7SWF2+5zkonvvd8mSrxRbZk9dsiE1D2P1MSKsWjd1oY+vXqqRe/AL9 G8iJfhpHWp27lGbDtKFQaUu4AJ/6/gdac04TpFE8MaxJldN26qer3RgrJj7UWO1DguVq Ot+vZUitKxZ/LXS/vktmjs4/0JUjRoZbF/6F2Gg7eXor7d05x5hrj1qMm7+RkVO X-Gm-Message-State: ANoB5pnnNsm3rVIICUOeJ8eVtoXxeLQpxOSci2WAiXOj6gNTtQJ8TB5i U/sz9ZTL5sHWPBF+iQXiS/k= X-Google-Smtp-Source: AA0mqf73FjfgQatchAN7uofpO8+zSv8g7hNgl3MmpZ5HNkZXF4DFy4uUaFjd7DFsV5zuLkfh2AX0HQ== X-Received: by 2002:aa7:db18:0:b0:467:e2dd:b593 with SMTP id t24-20020aa7db18000000b00467e2ddb593mr2417290eds.378.1668696137052; Thu, 17 Nov 2022 06:42:17 -0800 (PST) X-BeenThere: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Original-Received: by 2002:a05:6402:35d3:b0:45c:bfd9:fb45 with SMTP id z19-20020a05640235d300b0045cbfd9fb45ls617335edc.3.-pod-prod-gmail; Thu, 17 Nov 2022 06:42:13 -0800 (PST) X-Received: by 2002:a05:6402:b6d:b0:468:eee7:324c with SMTP id cb13-20020a0564020b6d00b00468eee7324cmr1650502edb.119.1668696133052; Thu, 17 Nov 2022 06:42:13 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1668696133; cv=none; d=google.com; s=arc-20160816; b=DhskDAUUAAsU58iZtS6utpsZdMiC1GwCcNVTct/Dgz//opF7FiiZBl1aHK7A1kZI99 Q8o1hEGRA+vMU9Oqkeox+eDCWO90UDpmB8IGZiAaVHXjfiyM5/d6DBNeHW1hciJr1c76 mrWaJjtctVONVWxAtgq4KE2EamPIN2iuO28mwZyi2treMcFvE+FZZvPxtnoYStOFelOS ffJzUK55WsKgFrS1iDHZtz06GnIA0yvGQrfOEmoZ7Yj5RAos8LDHAZtvkHx3PrH37l6R 6ijedjUHWQVLy1wqAL3pDfn9BnYJRIEZDU7qFUlE7Yl3vLiw6j9zZqHooHLE8IJ8y33C VEqg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :dkim-signature; bh=N3uISY5Bf4Mgk2NE/TaHNWf8OGfZTv5z8fZWW21IO+k=; b=T+8mDQ1zmGtPyQOCR/lOpcRiRd5p9cYdESySJ1TuQq7klT7vN8t5xxGUqLRdi2lMRf 490Rr/NE84WAy+IpRuCCbHeFAcFY8zgQUukkCfjxXjWFZF4dBd9WNwhJXzUuLlSPSbxI pP59HKof/6J0cXERbd5FIOOrNF2PCyy7nKAGAKMmzBim4q7kHB9cXH+7WMpztQ66mTn5 nkyA/1ufQjtu7mvadKbajiIXTeVsFhsACL/wS68+sRdebCzR3SHgdOL3zPeAciQ9OayI tPw8M/ES3M73kY77Iw0vHEw1CASiKKJm1y0rr5Zk/OonTJzqxxzE47mBQlU9VTv/S3zQ uDEA== ARC-Authentication-Results: i=1; gmr-mx.google.com; dkim=pass header.i=@broadband-forum.org header.s=google header.b="X9SiB/Tc"; spf=pass (google.com: domain of wlupton-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org designates 2a00:1450:4864:20::633 as permitted sender) smtp.mailfrom=wlupton-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=broadband-forum.org Original-Received: from mail-ej1-x633.google.com (mail-ej1-x633.google.com. [2a00:1450:4864:20::633]) by gmr-mx.google.com with ESMTPS id a5-20020aa7d905000000b00461ad0b1dc0si55932edr.3.2022.11.17.06.42.12 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Thu, 17 Nov 2022 06:42:12 -0800 (PST) Received-SPF: pass (google.com: domain of wlupton-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org designates 2a00:1450:4864:20::633 as permitted sender) client-ip=2a00:1450:4864:20::633; Original-Received: by mail-ej1-x633.google.com with SMTP id t25so5530590ejb.8 for ; Thu, 17 Nov 2022 06:42:12 -0800 (PST) X-Received: by 2002:a17:906:b1c6:b0:7ad:e82b:b66b with SMTP id bv6-20020a170906b1c600b007ade82bb66bmr2382859ejb.453.1668696132465; Thu, 17 Nov 2022 06:42:12 -0800 (PST) In-Reply-To: <0a29b118-ae0f-448f-8e3e-39cc96ef5d8an-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org> X-Original-Sender: wlupton-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org X-Original-Authentication-Results: gmr-mx.google.com; dkim=pass header.i=@broadband-forum.org header.s=google header.b="X9SiB/Tc"; spf=pass (google.com: domain of wlupton-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org designates 2a00:1450:4864:20::633 as permitted sender) smtp.mailfrom=wlupton-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=broadband-forum.org X-Original-From: William Lupton Precedence: list Mailing-list: list pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org; contact pandoc-discuss+owners-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org List-ID: X-Google-Group-Id: 1007024079513 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , Xref: news.gmane.io gmane.text.pandoc:31767 Archived-At: --00000000000036cdb705edab987f Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable https://pandoc.org/MANUAL.html#options-affecting-specific-writers and look for --css (I suggest also searching the manual for "css") -c *URL*, --css=3D*URL* Link to a CSS style sheet. This option can be used repeatedly to include multiple files. They will be included in the order specified. A stylesheet is required for generating EPUB. If none is provided using this option (or the css or stylesheet metadata fields), pandoc will look for a file epub.css in the user data directory (see --data-dir ). If it is not found there, sensible defaults will be used. On Thu, 17 Nov 2022 at 14:36, Lu=C3=ADs de Sousa wrote: > Hi again Will, > > I managed to get a well formatted output with a few tweaks to the CSS in > the repo. However, I need to add the references to CSS files by hand. I > understand this might be beyond the original scope of this thread, but wh= at > is the canonical method to automatically include these files in the pando= c > compilation? If that is possible. > > Thank you. > > On Wednesday, 16 November 2022 at 10:25:37 UTC+1 > wlu...-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org wrote: > >> Probably, yes! >> >> The details depend on the template variable values (and on the CSS too o= f >> course; for example, the "sidebar" ToC is all done using CSS). >> >> If you go to the example that I gave earlier ( >> https://usp.technology/specification) and then to corresponding place in >> the GitHub repo ( >> https://github.com/BroadbandForum/usp/tree/master/docs/specification) >> you can see all the final products, including the CSS. >> >> On Wed, 16 Nov 2022 at 08:32, Lu=C3=ADs de Sousa = wrote: >> >>> Hello again. I am now certain the template is being applied as you >>> showed. However the output page is in all similar to the default, same >>> font, colours and the absence of a TOC (a screen capture of the two sid= e by >>> side is attached). I was expecting to see something more akin to what y= ou >>> pointed to upthread and thought it was not functioning: >>> https://usp.technology/specification . So I would just ask you to >>> confirm the output in the screen capture is the expected. >>> >>> Thank you. >>> >>> On Tuesday, 15 November 2022 at 19:29:14 UTC+1 >>> wlu...-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org wrote: >>> >>>> Well not really, apart from using a very simple input file. See below >>>> for an example (I've downloaded the template from the gist to >>>> github-template-gist.html and put it in the current directory). >>>> >>>> I'm wondering whether your problem might be that you're not supplying >>>> the needed metadata, so it _looks_ as though it's using the default >>>> template but in fact it isn't. I hope that you noted this comment in t= he >>>> README: >>>> >>>> - This is intended as a demo just to show the approach. It is not >>>> likely to be directly usable. In particular, all generated YAML fil= es will >>>> currently be empty. >>>> >>>> Have you tried editing the template, e.g., to insert some arbitrary >>>> HTML, so you can be absolutely sure whether it's being used or not? >>>> >>>> % cat temp.md >>>> Document. >>>> >>>> % pandoc temp.md >>>>

Document.

>>>> >>>> % pandoc -s temp.md -o temp-default.html >>>> [WARNING] This document format requires a nonempty element. >>>> Defaulting to 'temp' as the title. >>>> To specify a title, use 'title' in metadata or --metadata title=3D".= ..". >>>> >>>> % pandoc -s --template github-template-gist.html temp.md -o >>>> temp-github.html >>>> [WARNING] This document format requires a nonempty <title> element. >>>> Defaulting to 'temp' as the title. >>>> To specify a title, use 'title' in metadata or --metadata title=3D".= ..". >>>> >>>> % diff -w temp-default.html temp-github.html >>>> 1a2 >>>> > <!-- ORGANIZATION GitHub Pages pandoc template; modified from >>>> default.html template --> >>>> 164a166 >>>> > <!-- XXX header includes are included just before the ToC (below) >>>> --> >>>> 165a168 >>>> > >>>> 166a170,182 >>>> > <section class=3D"page-header"> >>>> > <h1 class=3D"project-name"> >>>> > <a href=3D"" style=3D"text-decoration: none; color: white;"> >>>> > <img src=3D"bbflogo-reverse-dark.png"/><br> >>>> > >>>> > </a> >>>> > </h1> >>>> > <h2 class=3D"project-tagline"></h2> >>>> > <p></p> >>>> > <p></p> >>>> > </section> >>>> > >>>> > <section class=3D"main-content"> >>>> 167a184,194 >>>> > <div style=3D"clear: both;"/> >>>> > <footer class=3D"site-footer"> >>>> > <span class=3D"site-footer-owner"> >>>> > </span> >>>> > <span class=3D"site-footer-credits"> >>>> > This page was generated by <a href=3D"https://pandoc.org >>>> ">pandoc</a> >>>> > and <a href=3D"https://pages.github.com">GitHub Pages</a>. >>>> > <span class=3D"release"/> >>>> > </span> >>>> > </footer> >>>> > </section> >>>> >>>> On Tue, 15 Nov 2022 at 15:54, Lu=C3=ADs de Sousa <luis.a....-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org= > >>>> wrote: >>>> >>>>> Hi again Will, sorry for bothering you further. I so far failed to ge= t >>>>> the template to work. I tried to add it to the data folder >>>>> ($HOME/.local/share/pandoc/templates/) but still nothing. Looks like = the >>>>> default template is being applied no matter what. For instance, none = of the >>>>> meta predicates in the head section ever make it to the final HTML. >>>>> >>>>> Would you have any suggestion to debug this issue? >>>>> >>>>> Thank you. >>>>> >>>>> On Friday, 11 November 2022 at 15:30:17 UTC+1 >>>>> wlu...-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org wrote: >>>>> >>>>>> Inline... >>>>>> >>>>>> On Fri, 11 Nov 2022 at 14:01, Lu=C3=ADs de Sousa <luis.a....@gmail.c= om> >>>>>> wrote: >>>>>> >>>>>>> Alright, it is working now, many thanks. The output HTML looks >>>>>>> pretty solid and well linked. Two questions: >>>>>> >>>>>> >>>>>> Great! >>>>>> >>>>>> 1. What is the purpose of the /dev/null bit in the second compile >>>>>>> command? >>>>>>> >>>>>> >>>>>> That's what this remark in the README is referring to (rather >>>>>> obliquely): >>>>>> >>>>>> > Including the HTML via --include-in-header was a workaround I >>>>>> think, and might no longer be necessary. >>>>>> >>>>>> I think there was a problem with parsing HTML at one point, and this >>>>>> was a way of injecting HTML without passing it through pandoc. >>>>>> >>>>>> >>>>>>> 2. Could you share an HTML template? It would greatly facilitate th= e >>>>>>> design work. >>>>>>> >>>>>> >>>>>> I've added github-template.html >>>>>> <https://gist.github.com/wlupton/2fc23fc1c4e4b4899121bfafc0fea4bf#fi= le-github-template-html> (somewhat >>>>>> anonymised) to the gist. >>>>>> >>>>>> Next I will give it a try with a more elaborate document including >>>>>>> cross-references, citations, etc. Will report back on that. >>>>>>> >>>>>> >>>>>> You'll probably have noted that the writer attempts to fix >>>>>> cross-references so they reference the correct output file. >>>>>> >>>>>> Regards. >>>>>>> >>>>>>> On Friday, 11 November 2022 at 13:58:28 UTC+1 >>>>>>> wlu...-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org wrote: >>>>>>> >>>>>>>> Oh, I'm so sorry! I hadn't tested exactly what I gave you (I'd put >>>>>>>> the contents of utils.lua into the writer for testing, but then pu= t it into >>>>>>>> a new file to share with you, so the writer didn't need to change)= , but I >>>>>>>> forgot to put 'return utils' at the bottom. >>>>>>>> >>>>>>>> I've now added this line: >>>>>>>> https://gist.github.com/wlupton/2fc23fc1c4e4b4899121bfafc0fea4bf#f= ile-utils-lua-L51 >>>>>>>> and this time I've tested it locally. Please try again. >>>>>>>> >>>>>>>> On Fri, 11 Nov 2022 at 12:33, Lu=C3=ADs de Sousa <luis.a....@gmail= .com> >>>>>>>> wrote: >>>>>>>> >>>>>>>>> Hello again. I confirm those are the contents in line 38. I assum= e >>>>>>>>> utils.lua is being found, line 21 is now being parsed without er= ror. >>>>>>>>> Anything else I can try? >>>>>>>>> >>>>>>>>> Thank you. >>>>>>>>> >>>>>>>>> On Thursday, 10 November 2022 at 18:06:06 UTC+1 >>>>>>>>> wlu...-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org wrote: >>>>>>>>> >>>>>>>>>> can you confirm what's in line 38 of the writer? if you haven't >>>>>>>>>> edited the file then it's this >>>>>>>>>> <https://gist.github.com/wlupton/2fc23fc1c4e4b4899121bfafc0fea4b= f#file-html-multi-writer-lua-L38> >>>>>>>>>> : >>>>>>>>>> >>>>>>>>>> local output_file_dir, output_file_base =3D >>>>>>>>>> utils.path.split(output_file) >>>>>>>>>> >>>>>>>>>> can you confirm that you've also copied utils.lua and that it's >>>>>>>>>> being found? it should be calling the function at this line: >>>>>>>>>> https://gist.github.com/wlupton/2fc23fc1c4e4b4899121bfafc0fea4bf= #file-utils-lua-L31 >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> On Thu, 10 Nov 2022 at 16:36, Lu=C3=ADs de Sousa <luis.a....@gma= il.com> >>>>>>>>>> wrote: >>>>>>>>>> >>>>>>>>>>> Thank you once more for keeping this going. I made some progres= s >>>>>>>>>>> but now there is an error with html-multi-writer.lua itself (lo= g below). I >>>>>>>>>>> never worked with Lua before, apologies if I am making somethin= g dumb. >>>>>>>>>>> >>>>>>>>>>> $ wget >>>>>>>>>>> https://raw.githubusercontent.com/wlupton/pandoc-lua-logging/ma= in/logging.lua >>>>>>>>>>> --2022-11-10 17:28:08-- >>>>>>>>>>> https://raw.githubusercontent.com/wlupton/pandoc-lua-logging/ma= in/logging.lua >>>>>>>>>>> Resolving raw.githubusercontent.com (raw.githubusercontent.com)= ... >>>>>>>>>>> 185.199.111.133, 185.199.108.133, 185.199.110.133, ... >>>>>>>>>>> Connecting to raw.githubusercontent.com ( >>>>>>>>>>> raw.githubusercontent.com)|185.199.111.133|:443... connected. >>>>>>>>>>> HTTP request sent, awaiting response... 200 OK >>>>>>>>>>> Length: 8173 (8,0K) [text/plain] >>>>>>>>>>> Saving to: =E2=80=98logging.lua=E2=80=99 >>>>>>>>>>> >>>>>>>>>>> logging.lua 100%[=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D>] >>>>>>>>>>> 7,98K --.-KB/s in 0s >>>>>>>>>>> >>>>>>>>>>> 2022-11-10 17:28:08 (42,0 MB/s) - =E2=80=98logging.lua=E2=80=99= saved [8173/8173] >>>>>>>>>>> >>>>>>>>>>> $ mkdir -p $HOME/.local/share/pandoc/filters >>>>>>>>>>> $ mv logging.lua $HOME/.local/share/pandoc/filters >>>>>>>>>>> $ export LUA_PATH=3D"$HOME/.local/share/pandoc/filters/?.lua;;" >>>>>>>>>>> $ pandoc multi-test.md -t html-multi-writer.lua -o >>>>>>>>>>> output/multi-test.html >>>>>>>>>>> Error running Lua: >>>>>>>>>>> html-multi-writer.lua:38: attempt to index a boolean value >>>>>>>>>>> (local 'utils') >>>>>>>>>>> stack traceback: >>>>>>>>>>> >>>>>>>>>>> >>>>>>>>>>> On Thursday, 10 November 2022 at 13:47:52 UTC+1 >>>>>>>>>>> wlu...-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org wrote: >>>>>>>>>>> >>>>>>>>>>>> I've updated the gist by adding utils.lua and updating the >>>>>>>>>>>> README. This should be sufficient for the writer to run withou= t error >>>>>>>>>>>> (please let me know if not). >>>>>>>>>>>> >>>>>>>>>>>> Note that you'll also need to get logging.lua as described, an= d >>>>>>>>>>>> also note that any generated YAML files will be empty (I didn'= t want to >>>>>>>>>>>> share my brain-dead YAML writer but there appear to be lua YAM= L writers out >>>>>>>>>>>> there that might work... anyway you might decide that you don'= t need the >>>>>>>>>>>> generated YAML... this depends on how you set up the make rule= s). >>>>>>>>>>>> >>>>>>>>>>>> I don't really want to create a repo for this (well... a gist >>>>>>>>>>>> _is_ a repo!) because I don't want (at this point) to provide = any support >>>>>>>>>>>> for it (questions are OK though). I'm providing the gist just = as a demo of >>>>>>>>>>>> the approach. Maybe later... >>>>>>>>>>>> >>>>>>>>>>>> On Wed, 9 Nov 2022 at 18:28, William Lupton < >>>>>>>>>>>> wlu...-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org> wrote: >>>>>>>>>>>> >>>>>>>>>>>>> Oh sorry, yes, utils is one of mine! I'll look into this >>>>>>>>>>>>> tomorrow... >>>>>>>>>>>>> >>>>>>>>>>>>> On Wed, 9 Nov 2022, 16:03 Lu=C3=ADs de Sousa, <luis.a....@gma= il.com> >>>>>>>>>>>>> wrote: >>>>>>>>>>>>> >>>>>>>>>>>>>> Thank you very much for sharing, that looks very promising. >>>>>>>>>>>>>> >>>>>>>>>>>>>> Pandoc can't run the script though, says it can't find the >>>>>>>>>>>>>> utils package. I installed luarocks and with it lua-utils bu= t the error >>>>>>>>>>>>>> prevails: >>>>>>>>>>>>>> >>>>>>>>>>>>>> $ pandoc multi-test.md -t html-multi-writer.lua -o >>>>>>>>>>>>>> output/multi-test.html >>>>>>>>>>>>>> Error running Lua: >>>>>>>>>>>>>> html-multi-writer.lua:21: module 'utils' not found: >>>>>>>>>>>>>> no field package.preload['utils'] >>>>>>>>>>>>>> no file '/usr/local/share/lua/5.4/utils.lua' >>>>>>>>>>>>>> no file '/usr/local/share/lua/5.4/utils/init.lua' >>>>>>>>>>>>>> no file '/usr/local/lib/lua/5.4/utils.lua' >>>>>>>>>>>>>> no file '/usr/local/lib/lua/5.4/utils/init.lua' >>>>>>>>>>>>>> no file './utils.lua' >>>>>>>>>>>>>> no file './utils/init.lua' >>>>>>>>>>>>>> no file '/usr/local/lib/lua/5.4/utils.so' >>>>>>>>>>>>>> no file '/usr/local/lib/lua/5.4/loadall.so' >>>>>>>>>>>>>> no file './utils.so' >>>>>>>>>>>>>> stack traceback: >>>>>>>>>>>>>> html-multi-writer.lua:21: in main chunk >>>>>>>>>>>>>> >>>>>>>>>>>>>> P.S.: would you consider creating a repository for this work= ? >>>>>>>>>>>>>> I would like to automate the second stage with bash, shouldn= 't be too hard. >>>>>>>>>>>>>> >>>>>>>>>>>>>> On Monday, 7 November 2022 at 15:46:58 UTC+1 >>>>>>>>>>>>>> wlu...-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org wrote: >>>>>>>>>>>>>> >>>>>>>>>>>>>>> I've created this gist: >>>>>>>>>>>>>>> https://gist.github.com/wlupton/2fc23fc1c4e4b4899121bfafc0f= ea4bf >>>>>>>>>>>>>>> >>>>>>>>>>>>>>> I added a README.md and hope that there's enough info to ge= t >>>>>>>>>>>>>>> going. Please let me know if not. >>>>>>>>>>>>>>> >>>>>>>>>>>>>>> (Please note that this writer does some other things too, >>>>>>>>>>>>>>> which might need to be stripped out. Also, it's an old-styl= e writer... I >>>>>>>>>>>>>>> haven't got around to updating it yet,) >>>>>>>>>>>>>>> >>>>>>>>>>>>>>> On Mon, 7 Nov 2022 at 09:22, Lu=C3=ADs de Sousa < >>>>>>>>>>>>>>> luis.a....-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote: >>>>>>>>>>>>>>> >>>>>>>>>>>>>>>> Hi there. That is precisely the kind of output I would lik= e >>>>>>>>>>>>>>>> to have. Similar to what tools like mdBook produce. I woul= d be glad if you >>>>>>>>>>>>>>>> could share more details on that custom writer. >>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>> Thank you and regards. >>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>> On Friday, 4 November 2022 at 17:51:24 UTC+1 >>>>>>>>>>>>>>>> wlu...-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org wrote: >>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>> See https://usp.technology/specification for an example >>>>>>>>>>>>>>>>> of how the Broadband Forum has recently been publishing s= ome specs. This >>>>>>>>>>>>>>>>> output is generated via an html-multi-writer.lua custom w= riter that >>>>>>>>>>>>>>>>> contains the logic for splitting the output into multiple= files (based on >>>>>>>>>>>>>>>>> header level and/or specific classes). The writer also ta= kes care of >>>>>>>>>>>>>>>>> generating the navigation bar that you see at the top and= bottom of the >>>>>>>>>>>>>>>>> pages. The multiple files are then passed through pandoc = again (to add the >>>>>>>>>>>>>>>>> overall sidebar ToC and the top/bottom navigation bars, a= nd to generate >>>>>>>>>>>>>>>>> multiple standalone docs). >>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>> Please let me know if you'd like more details (the overal= l >>>>>>>>>>>>>>>>> setup is not very easily shareable, because it's heavily = dependent on >>>>>>>>>>>>>>>>> rather complicated make rules, but I could probably share= the custom writer >>>>>>>>>>>>>>>>> and give some example command lines.) >>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>> On Fri, 4 Nov 2022 at 12:45, Lu=C3=ADs de Sousa < >>>>>>>>>>>>>>>>> luis.a....-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote: >>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>> Dear all, >>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>> I am currently working on a long document that must >>>>>>>>>>>>>>>>>> served as a web page. The single file output is becoming= too slow and >>>>>>>>>>>>>>>>>> cumbersome for readers. I am aware this functionality is= not available, but >>>>>>>>>>>>>>>>>> a Feature Request is open [0]. >>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>> In that issue there are some hints to this issue being >>>>>>>>>>>>>>>>>> addressable with a template [1]. I have tried many HTML = templates, but >>>>>>>>>>>>>>>>>> never seen one that would split a long document in a set= of small files. >>>>>>>>>>>>>>>>>> Would there be an example somewhere I could follow? Othe= rwise, could >>>>>>>>>>>>>>>>>> someone provide a general idea of how such template woul= d function? >>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>> Thank you. >>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>> [0] https://github.com/jgm/pandoc/issues/6122 >>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>> [1] >>>>>>>>>>>>>>>>>> https://github.com/jgm/pandoc/issues/6122#issuecomment-5= 83593340 >>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>>> -- >>>>>>>>>>>>>>>>>> You received this message because you are subscribed to >>>>>>>>>>>>>>>>>> the Google Groups "pandoc-discuss" group. >>>>>>>>>>>>>>>>>> To unsubscribe from this group and stop receiving emails >>>>>>>>>>>>>>>>>> from it, send an email to >>>>>>>>>>>>>>>>>> pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org >>>>>>>>>>>>>>>>>> To view this discussion on the web visit >>>>>>>>>>>>>>>>>> https://groups.google.com/d/msgid/pandoc-discuss/264eeee= 0-68c8-4389-a5c5-12563c6926f6n%40googlegroups.com >>>>>>>>>>>>>>>>>> <https://groups.google.com/d/msgid/pandoc-discuss/264eee= e0-68c8-4389-a5c5-12563c6926f6n%40googlegroups.com?utm_medium=3Demail&utm_s= ource=3Dfooter> >>>>>>>>>>>>>>>>>> . >>>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>> -- >>>>>>>>>>>>>>>> You received this message because you are subscribed to th= e >>>>>>>>>>>>>>>> Google Groups "pandoc-discuss" group. >>>>>>>>>>>>>>>> To unsubscribe from this group and stop receiving emails >>>>>>>>>>>>>>>> from it, send an email to pandoc-discus...-/JYPxA39Uh4Ykp1iOSErHA@public.gmane.org= m >>>>>>>>>>>>>>>> . >>>>>>>>>>>>>>>> >>>>>>>>>>>>>>> To view this discussion on the web visit >>>>>>>>>>>>>>>> https://groups.google.com/d/msgid/pandoc-discuss/cb3753d7-= e845-4a72-a1aa-e93086a32f11n%40googlegroups.com >>>>>>>>>>>>>>>> <https://groups.google.com/d/msgid/pandoc-discuss/cb3753d7= -e845-4a72-a1aa-e93086a32f11n%40googlegroups.com?utm_medium=3Demail&utm_sou= rce=3Dfooter> >>>>>>>>>>>>>>>> . >>>>>>>>>>>>>>>> >>>>>>>>>>>>>>> -- >>>>>>>>>>>>>> You received this message because you are subscribed to the >>>>>>>>>>>>>> Google Groups "pandoc-discuss" group. >>>>>>>>>>>>>> To unsubscribe from this group and stop receiving emails fro= m >>>>>>>>>>>>>> it, send an email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org >>>>>>>>>>>>>> To view this discussion on the web visit >>>>>>>>>>>>>> https://groups.google.com/d/msgid/pandoc-discuss/1ef6858a-0a= 37-4f5f-a88b-eff2479a8130n%40googlegroups.com >>>>>>>>>>>>>> <https://groups.google.com/d/msgid/pandoc-discuss/1ef6858a-0= a37-4f5f-a88b-eff2479a8130n%40googlegroups.com?utm_medium=3Demail&utm_sourc= e=3Dfooter> >>>>>>>>>>>>>> . >>>>>>>>>>>>>> >>>>>>>>>>>>> -- >>>>>>>>>>> You received this message because you are subscribed to the >>>>>>>>>>> Google Groups "pandoc-discuss" group. >>>>>>>>>>> To unsubscribe from this group and stop receiving emails from >>>>>>>>>>> it, send an email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org >>>>>>>>>>> >>>>>>>>>> To view this discussion on the web visit >>>>>>>>>>> https://groups.google.com/d/msgid/pandoc-discuss/539db8b9-47f4-= 43b8-83d1-4b4c99dc3b3fn%40googlegroups.com >>>>>>>>>>> <https://groups.google.com/d/msgid/pandoc-discuss/539db8b9-47f4= -43b8-83d1-4b4c99dc3b3fn%40googlegroups.com?utm_medium=3Demail&utm_source= =3Dfooter> >>>>>>>>>>> . >>>>>>>>>>> >>>>>>>>>> -- >>>>>>>>> You received this message because you are subscribed to the Googl= e >>>>>>>>> Groups "pandoc-discuss" group. >>>>>>>>> To unsubscribe from this group and stop receiving emails from it, >>>>>>>>> send an email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org >>>>>>>>> >>>>>>>> To view this discussion on the web visit >>>>>>>>> https://groups.google.com/d/msgid/pandoc-discuss/7f4b28ec-1e91-42= 28-ab03-fe58a2e5cf18n%40googlegroups.com >>>>>>>>> <https://groups.google.com/d/msgid/pandoc-discuss/7f4b28ec-1e91-4= 228-ab03-fe58a2e5cf18n%40googlegroups.com?utm_medium=3Demail&utm_source=3Df= ooter> >>>>>>>>> . >>>>>>>>> >>>>>>>> -- >>>>>>> You received this message because you are subscribed to the Google >>>>>>> Groups "pandoc-discuss" group. >>>>>>> To unsubscribe from this group and stop receiving emails from it, >>>>>>> send an email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org >>>>>>> >>>>>> To view this discussion on the web visit >>>>>>> https://groups.google.com/d/msgid/pandoc-discuss/5e290d88-1c47-407d= -819b-34a094d8b48fn%40googlegroups.com >>>>>>> <https://groups.google.com/d/msgid/pandoc-discuss/5e290d88-1c47-407= d-819b-34a094d8b48fn%40googlegroups.com?utm_medium=3Demail&utm_source=3Dfoo= ter> >>>>>>> . >>>>>>> >>>>>> -- >>>>> You received this message because you are subscribed to the Google >>>>> Groups "pandoc-discuss" group. >>>>> To unsubscribe from this group and stop receiving emails from it, sen= d >>>>> an email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org >>>>> >>>> To view this discussion on the web visit >>>>> https://groups.google.com/d/msgid/pandoc-discuss/20b2a20b-69ad-4b93-8= 63a-c70db01d45een%40googlegroups.com >>>>> <https://groups.google.com/d/msgid/pandoc-discuss/20b2a20b-69ad-4b93-= 863a-c70db01d45een%40googlegroups.com?utm_medium=3Demail&utm_source=3Dfoote= r> >>>>> . >>>>> >>>> -- >>> You received this message because you are subscribed to the Google >>> Groups "pandoc-discuss" group. >>> To unsubscribe from this group and stop receiving emails from it, send >>> an email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org >>> >> To view this discussion on the web visit >>> https://groups.google.com/d/msgid/pandoc-discuss/fbe785d6-57dc-45a5-a4d= a-cc275638cd6dn%40googlegroups.com >>> <https://groups.google.com/d/msgid/pandoc-discuss/fbe785d6-57dc-45a5-a4= da-cc275638cd6dn%40googlegroups.com?utm_medium=3Demail&utm_source=3Dfooter> >>> . >>> >> -- > You received this message because you are subscribed to the Google Groups > "pandoc-discuss" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org > To view this discussion on the web visit > https://groups.google.com/d/msgid/pandoc-discuss/0a29b118-ae0f-448f-8e3e-= 39cc96ef5d8an%40googlegroups.com > <https://groups.google.com/d/msgid/pandoc-discuss/0a29b118-ae0f-448f-8e3e= -39cc96ef5d8an%40googlegroups.com?utm_medium=3Demail&utm_source=3Dfooter> > . > --=20 You received this message because you are subscribed to the Google Groups "= pandoc-discuss" group. To unsubscribe from this group and stop receiving emails from it, send an e= mail to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org To view this discussion on the web visit https://groups.google.com/d/msgid/= pandoc-discuss/CAEe_xxgnCSkiBiFFrU%3DOBEVwHf1XUXzf9PshA-HCB-w2E6dfkw%40mail= .gmail.com. --00000000000036cdb705edab987f Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable <div dir=3D"ltr"><a href=3D"https://pandoc.org/MANUAL.html#options-affectin= g-specific-writers">https://pandoc.org/MANUAL.html#options-affecting-specif= ic-writers</a> and look for --css<div><br></div><div>(I suggest also search= ing the manual for "css")<div><div><br></div><div><dt style=3D"fo= nt-weight:bold;margin-bottom:0.1em;color:rgb(85,85,85);font-family:Georgia,= serif;font-size:17.3333px"><span id=3D"gmail-option--css" class=3D"gmail-op= tion-anchor"><span class=3D"gmail-nowrap"><code class=3D"gmail-option-def" = style=3D"white-space:nowrap;font-size:11pt;background-color:transparent">-c= </code></span>=C2=A0<em>URL</em>,=C2=A0<span class=3D"gmail-nowrap"><code c= lass=3D"gmail-option-def" style=3D"white-space:nowrap;font-size:11pt;backgr= ound-color:transparent">--css=3D</code></span><em>URL</em></span></dt><dd s= tyle=3D"margin-left:2em;color:rgb(85,85,85);font-family:Georgia,serif;font-= size:17.3333px"><p>Link to a CSS style sheet. This option can be used repea= tedly to include multiple files. They will be included in the order specifi= ed.</p><p>A stylesheet is required for generating EPUB. If none is provided= using this option (or the=C2=A0<span class=3D"gmail-nowrap"><code style=3D= "white-space:nowrap;font-size:11pt;background-color:transparent">css</code>= </span>=C2=A0or=C2=A0<span class=3D"gmail-nowrap"><code style=3D"white-spac= e:nowrap;font-size:11pt;background-color:transparent">stylesheet</code></sp= an>=C2=A0metadata fields), pandoc will look for a file=C2=A0<span class=3D"= gmail-nowrap"><code style=3D"white-space:nowrap;font-size:11pt;background-c= olor:transparent">epub.css</code></span>=C2=A0in the user data directory (s= ee=C2=A0<a href=3D"https://pandoc.org/MANUAL.html#option--data-dir" class= =3D"gmail-option" style=3D"color:rgb(51,122,183);text-decoration-line:none"= ><span class=3D"gmail-nowrap"><code style=3D"white-space:nowrap;font-size:1= 1pt;background-color:transparent;color:inherit">--data-dir</code></span></a= >). If it is not found there, sensible defaults will be used.</p></dd></div= ></div></div></div><br><div class=3D"gmail_quote"><div dir=3D"ltr" class=3D= "gmail_attr">On Thu, 17 Nov 2022 at 14:36, Lu=C3=ADs de Sousa <<a href= =3D"mailto:luis.a.de.sousa-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org">luis.a.de.sousa-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org</a>> wro= te:<br></div><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px = 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hi again Wil= l,<div><br></div><div>I managed to get a well formatted output with a few t= weaks to the CSS in the repo. However, I need to add the references to CSS = files by hand. I understand this might be beyond the original scope of this= thread, but what is the canonical method to automatically include these fi= les in the pandoc compilation? If that is possible.</div><div><br></div><di= v>Thank you.<br><br></div><div class=3D"gmail_quote"><div dir=3D"auto" clas= s=3D"gmail_attr">On Wednesday, 16 November 2022 at 10:25:37 UTC+1 <a href= =3D"mailto:wlu...-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org" target=3D"_blank">wlu...@broadband-f= orum.org</a> wrote:<br></div><blockquote class=3D"gmail_quote" style=3D"mar= gin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1= ex"><div dir=3D"ltr">Probably, yes!<div><br></div><div>The details depend o= n the template variable values (and on the CSS too of course; for example, = the "sidebar" ToC is all done using CSS).</div><div><br></div><di= v>If you go to the example that I gave earlier (<a href=3D"https://usp.tech= nology/specification" rel=3D"nofollow" target=3D"_blank">https://usp.techno= logy/specification</a>) and then to corresponding place in the GitHub repo = (<a href=3D"https://github.com/BroadbandForum/usp/tree/master/docs/specific= ation" rel=3D"nofollow" target=3D"_blank">https://github.com/BroadbandForum= /usp/tree/master/docs/specification</a>) you can see all the final products= , including the CSS.</div></div><br><div class=3D"gmail_quote"></div><div c= lass=3D"gmail_quote"><div dir=3D"ltr" class=3D"gmail_attr">On Wed, 16 Nov 2= 022 at 08:32, Lu=C3=ADs de Sousa <<a rel=3D"nofollow">luis.a....@gmail.c= om</a>> wrote:<br></div></div><div class=3D"gmail_quote"><blockquote cla= ss=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid = rgb(204,204,204);padding-left:1ex">Hello again. I am now certain the templa= te is being applied as you showed. However the output page is in all simila= r to the default, same font, colours and the absence of a TOC (a screen cap= ture of the two side by side is attached). I was expecting to see something= more akin to what you pointed to upthread and thought it was not functioni= ng:=C2=A0<a href=3D"https://usp.technology/specification" rel=3D"nofollow" = target=3D"_blank">https://usp.technology/specification</a>=C2=A0. So I woul= d just ask you to confirm the output in the screen capture is the expected.= <br><br><div>Thank you.</div><div><br></div><div class=3D"gmail_quote"><div= dir=3D"auto" class=3D"gmail_attr">On Tuesday, 15 November 2022 at 19:29:14= UTC+1 <a rel=3D"nofollow">wlu...-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org</a> wrote:<br></div><= blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-l= eft:1px solid rgb(204,204,204);padding-left:1ex"><div dir=3D"ltr">Well not = really, apart from using a very simple input file. See below for an example= (I've downloaded the template from the gist to=C2=A0<span style=3D"fon= t-family:monospace">github-template-gist.html</span>=C2=A0and put it in the= current directory).<div><br></div><div>I'm wondering whether your prob= lem might be that you're not supplying the needed metadata, so it _look= s_ as though it's using the default template but in fact it isn't. = I hope that you noted this comment in the README:</div><div><ul><li>This is= intended as a demo just to show the approach. It is not likely to be direc= tly usable. In particular, all generated YAML files will currently be empty= .</li></ul></div><div>Have you tried editing the template, e.g., to insert = some arbitrary HTML, so you can be absolutely sure whether it's being u= sed or not?</div><div><br><div><div><div><font face=3D"monospace">% cat tem= p.md<br>Document.<br><br></font></div><div><font face=3D"monospace">% pando= c temp.md <br><p>Document.</p><br><br></font></div><div><font f= ace=3D"monospace">% pandoc -s temp.md -o temp-default.html<br>[WARNING] Thi= s document format requires a nonempty <title> element.<br>=C2=A0 Defa= ulting to 'temp' as the title.<br>=C2=A0 To specify a title, use &#= 39;title' in metadata or --metadata title=3D"...".<br><br></f= ont></div><div><font face=3D"monospace">%=C2=A0pandoc -s --template github-= template-gist.html temp.md -o temp-github.html<br>[WARNING] This document f= ormat requires a nonempty <title> element.<br>=C2=A0 Defaulting to &#= 39;temp' as the title.<br>=C2=A0 To specify a title, use 'title'= ; in metadata or --metadata title=3D"...".<br><br></font></div><d= iv><font face=3D"monospace">% diff -w temp-default.html temp-github.html <b= r>1a2<br>> <!-- ORGANIZATION GitHub Pages pandoc template; modified f= rom default.html template --><br>164a166<br>> =C2=A0 <!-- XXX head= er includes are included just before the ToC (below) --><br>165a168<br>&= gt; <br>166a170,182<br>> =C2=A0 <section class=3D"page-header&qu= ot;><br>> =C2=A0 =C2=A0 <h1 class=3D"project-name"><b= r>> =C2=A0 =C2=A0 =C2=A0 <a href=3D"" style=3D"text-de= coration: none; color: white;"><br>> =C2=A0 =C2=A0 =C2=A0 =C2=A0= <img src=3D"bbflogo-reverse-dark.png"/><br><br>> = =C2=A0 =C2=A0 =C2=A0 =C2=A0 <br>> =C2=A0 =C2=A0 =C2=A0 </a><br>>= ; =C2=A0 =C2=A0 </h1><br>> =C2=A0 =C2=A0 <h2 class=3D"proj= ect-tagline"></h2><br>> =C2=A0 =C2=A0 <p></p><= br>> =C2=A0 =C2=A0 <p></p><br>> =C2=A0 </section><b= r>> <br>> =C2=A0 <section class=3D"main-content"><br>= 167a184,194<br>> =C2=A0 =C2=A0 <div style=3D"clear: both;"/= ><br>> =C2=A0 =C2=A0 <footer class=3D"site-footer"><b= r>> =C2=A0 =C2=A0 =C2=A0 <span class=3D"site-footer-owner"&= gt;<br>> =C2=A0 =C2=A0 =C2=A0 </span><br>> =C2=A0 =C2=A0 =C2=A0= <span class=3D"site-footer-credits"><br>> =C2=A0 =C2=A0= =C2=A0 =C2=A0 This page was generated by <a href=3D"<a href=3D"htt= ps://pandoc.org" rel=3D"nofollow" target=3D"_blank">https://pandoc.org</a>&= quot;>pandoc</a><br>> =C2=A0 =C2=A0 =C2=A0 =C2=A0 and <a hre= f=3D"<a href=3D"https://pages.github.com" rel=3D"nofollow" target=3D"_= blank">https://pages.github.com</a>">GitHub Pages</a>.<br>>= ; =C2=A0 =C2=A0 =C2=A0 =C2=A0 <span class=3D"release"/><br>= > =C2=A0 =C2=A0 =C2=A0 </span><br>> =C2=A0 =C2=A0 </footer&g= t;<br>> =C2=A0 </section></font><br></div></div></div></div></div>= <br><div class=3D"gmail_quote"></div><div class=3D"gmail_quote"><div dir=3D= "ltr" class=3D"gmail_attr">On Tue, 15 Nov 2022 at 15:54, Lu=C3=ADs de Sousa= <<a rel=3D"nofollow">luis.a....-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org</a>> wrote:<br></div></div= ><div class=3D"gmail_quote"><blockquote class=3D"gmail_quote" style=3D"marg= in:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1e= x">Hi again Will, sorry for bothering you further. I so far failed to get t= he template to work. I tried to add it to the data folder ($HOME/.local/sha= re/pandoc/templates/) but still nothing. Looks like the default template is= being applied no matter what. For instance, none of the meta predicates in= the head section ever make it to the final HTML.=C2=A0<div><br></div><div>= Would you have any suggestion to debug this issue?</div><div><br></div><div= >Thank you.<br><div><br></div></div><div class=3D"gmail_quote"><div dir=3D"= auto" class=3D"gmail_attr">On Friday, 11 November 2022 at 15:30:17 UTC+1 <a= rel=3D"nofollow">wlu...-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org</a> wrote:<br></div><blockquot= e class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px s= olid rgb(204,204,204);padding-left:1ex"><div dir=3D"ltr"><div dir=3D"ltr"><= div>Inline...</div><div><br></div></div><div class=3D"gmail_quote"></div></= div><div dir=3D"ltr"><div class=3D"gmail_quote"><div dir=3D"ltr" class=3D"g= mail_attr">On Fri, 11 Nov 2022 at 14:01, Lu=C3=ADs de Sousa <<a rel=3D"n= ofollow">luis.a....-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org</a>> wrote:<br></div><blockquote class=3D"= gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(20= 4,204,204);padding-left:1ex">Alright, it is working now, many thanks. The o= utput HTML looks pretty solid and well linked. Two questions:=C2=A0</blockq= uote><div><br></div></div></div><div dir=3D"ltr"><div class=3D"gmail_quote"= ><div>Great!</div></div></div><div dir=3D"ltr"><div class=3D"gmail_quote"><= div><br></div><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px= 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div>1. Wha= t is the purpose of the /dev/null bit in the second compile command?</div><= /blockquote><div><br></div></div></div><div dir=3D"ltr"><div class=3D"gmail= _quote"><div>That's what this remark in the README is referring to (rat= her obliquely):</div><div><br></div><div>>=C2=A0Including the HTML via -= -include-in-header was a workaround I think, and might no longer be necessa= ry.</div><div><br></div><div>I think there was a problem with parsing HTML = at one point, and this was a way of injecting HTML without passing it throu= gh pandoc.</div></div></div><div dir=3D"ltr"><div class=3D"gmail_quote"><di= v>=C2=A0</div><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px= 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div>2. Cou= ld you share an HTML template? It would greatly facilitate the design work.= </div></blockquote><div><br></div></div></div><div dir=3D"ltr"><div class= =3D"gmail_quote"><div>I've added=C2=A0<a href=3D"https://gist.github.co= m/wlupton/2fc23fc1c4e4b4899121bfafc0fea4bf#file-github-template-html" rel= =3D"nofollow" target=3D"_blank">github-template.html</a>=C2=A0(somewhat ano= nymised) to the gist.</div></div></div><div dir=3D"ltr"><div class=3D"gmail= _quote"><div><br></div><blockquote class=3D"gmail_quote" style=3D"margin:0p= x 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><d= iv>Next I will give it a try with a more elaborate document including cross= -references, citations, etc. Will report back on that.<br></div></blockquot= e><div><br></div></div></div><div dir=3D"ltr"><div class=3D"gmail_quote"><d= iv>You'll probably have noted that the writer attempts to fix cross-ref= erences so they reference the correct output file.=C2=A0</div><div><br></di= v><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;borde= r-left:1px solid rgb(204,204,204);padding-left:1ex"></blockquote></div></di= v><div dir=3D"ltr"><div class=3D"gmail_quote"><blockquote class=3D"gmail_qu= ote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,20= 4);padding-left:1ex"><div>Regards.<br><div><br></div></div><div class=3D"gm= ail_quote"><div dir=3D"auto" class=3D"gmail_attr">On Friday, 11 November 20= 22 at 13:58:28 UTC+1 <a rel=3D"nofollow">wlu...-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org</a> wro= te:<br></div><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px = 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir=3D"= ltr">Oh, I'm so sorry! I hadn't tested exactly what I gave you (I&#= 39;d put the contents of utils.lua into the writer for testing, but then pu= t it into a new file to share with you, so the writer didn't need to ch= ange), but I forgot to put 'return utils' at the bottom.<div><br></= div><div>I've now added this line:=C2=A0<a href=3D"https://gist.github.= com/wlupton/2fc23fc1c4e4b4899121bfafc0fea4bf#file-utils-lua-L51" rel=3D"nof= ollow" target=3D"_blank">https://gist.github.com/wlupton/2fc23fc1c4e4b48991= 21bfafc0fea4bf#file-utils-lua-L51</a> and this time I've tested it loca= lly. Please try again.</div></div><br><div class=3D"gmail_quote"></div><div= class=3D"gmail_quote"><div dir=3D"ltr" class=3D"gmail_attr">On Fri, 11 Nov= 2022 at 12:33, Lu=C3=ADs de Sousa <<a rel=3D"nofollow">luis.a....@gmail= .com</a>> wrote:<br></div></div><div class=3D"gmail_quote"><blockquote c= lass=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px soli= d rgb(204,204,204);padding-left:1ex">Hello again. I confirm those are the c= ontents in line 38. I assume utils.lua is being found, line 21 is now being= =C2=A0 parsed without error. Anything else I can try?=C2=A0<div><br></div><= div>Thank you.<br><br></div><div class=3D"gmail_quote"><div dir=3D"auto" cl= ass=3D"gmail_attr">On Thursday, 10 November 2022 at 18:06:06 UTC+1 <a rel= =3D"nofollow">wlu...-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org</a> wrote:<br></div><blockquote cl= ass=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid= rgb(204,204,204);padding-left:1ex"><div dir=3D"ltr">can you confirm what&#= 39;s in line 38 of the writer? if you haven't edited the file then it&#= 39;s <a href=3D"https://gist.github.com/wlupton/2fc23fc1c4e4b4899121bfafc0f= ea4bf#file-html-multi-writer-lua-L38" rel=3D"nofollow" target=3D"_blank">th= is</a>:<div><br></div><div><font face=3D"monospace">local output_file_dir, = output_file_base =3D utils.path.split(output_file)<br></font></div><div><br= ></div><div>can you confirm that you've also copied utils.lua and that = it's being found? it should be calling the function at this line:=C2=A0= <a href=3D"https://gist.github.com/wlupton/2fc23fc1c4e4b4899121bfafc0fea4bf= #file-utils-lua-L31" rel=3D"nofollow" target=3D"_blank">https://gist.github= .com/wlupton/2fc23fc1c4e4b4899121bfafc0fea4bf#file-utils-lua-L31</a></div><= div><br></div></div><br><div class=3D"gmail_quote"></div><div class=3D"gmai= l_quote"><div dir=3D"ltr" class=3D"gmail_attr">On Thu, 10 Nov 2022 at 16:36= , Lu=C3=ADs de Sousa <<a rel=3D"nofollow">luis.a....-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org</a>> w= rote:<br></div></div><div class=3D"gmail_quote"><blockquote class=3D"gmail_= quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,= 204);padding-left:1ex">Thank you once more for keeping this going. I made s= ome progress but now there is an error with html-multi-writer.lua itself (l= og below). I never worked with Lua before, apologies if I am making somethi= ng dumb.<div><br></div><div>$ wget <a href=3D"https://raw.githubusercontent= .com/wlupton/pandoc-lua-logging/main/logging.lua" rel=3D"nofollow" target= =3D"_blank">https://raw.githubusercontent.com/wlupton/pandoc-lua-logging/ma= in/logging.lua</a><br>--2022-11-10 17:28:08-- =C2=A0<a href=3D"https://raw.= githubusercontent.com/wlupton/pandoc-lua-logging/main/logging.lua" rel=3D"n= ofollow" target=3D"_blank">https://raw.githubusercontent.com/wlupton/pandoc= -lua-logging/main/logging.lua</a><br>Resolving <a href=3D"http://raw.github= usercontent.com" rel=3D"nofollow" target=3D"_blank">raw.githubusercontent.c= om</a> (<a href=3D"http://raw.githubusercontent.com" rel=3D"nofollow" targe= t=3D"_blank">raw.githubusercontent.com</a>)... 185.199.111.133, 185.199.108= .133, 185.199.110.133, ...<br>Connecting to <a href=3D"http://raw.githubuse= rcontent.com" rel=3D"nofollow" target=3D"_blank">raw.githubusercontent.com<= /a> (<a href=3D"http://raw.githubusercontent.com" rel=3D"nofollow" target= =3D"_blank">raw.githubusercontent.com</a>)|185.199.111.133|:443... connecte= d.<br>HTTP request sent, awaiting response... 200 OK<br>Length: 8173 (8,0K)= [text/plain]<br>Saving to: =E2=80=98logging.lua=E2=80=99<br><br>logging.lu= a =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 100%[=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D>] =C2= =A0 7,98K =C2=A0--.-KB/s =C2=A0 =C2=A0in 0s<br><br>2022-11-10 17:28:08 (42,= 0 MB/s) - =E2=80=98logging.lua=E2=80=99 saved [8173/8173]<br><br>$ mkdir -p= $HOME/.local/share/pandoc/filters<br>$ mv logging.lua $HOME/.local/share/p= andoc/filters<br>$ export LUA_PATH=3D"$HOME/.local/share/pandoc/filter= s/?.lua;;"<br>$ pandoc multi-test.md -t html-multi-writer.lua -o outpu= t/multi-test.html<br>Error running Lua:<br>html-multi-writer.lua:38: attemp= t to index a boolean value (local 'utils')<br>stack traceback:<br><= /div><div><br><br></div><div class=3D"gmail_quote"><div dir=3D"auto" class= =3D"gmail_attr">On Thursday, 10 November 2022 at 13:47:52 UTC+1 <a rel=3D"n= ofollow">wlu...-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org</a> wrote:<br></div><blockquote class= =3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rg= b(204,204,204);padding-left:1ex"><div dir=3D"ltr">I've updated the gist= by adding utils.lua and updating the README. This should be sufficient for= the writer to run without error (please let me know if not).<div><br></div= ><div>Note that you'll also need to get logging.lua as described, and a= lso note that any generated YAML files will be empty=C2=A0(I didn't wan= t to share my brain-dead YAML writer but there appear to be lua YAML writer= s out there that might work... anyway you might decide that you don't n= eed the generated YAML... this depends on how you set up the make rules).</= div><div><br></div><div>I don't really want to create a repo for this (= well... a gist _is_ a repo!) because I don't want (at this point) to pr= ovide any support for it (questions are OK though). I'm providing the g= ist just as a demo of the approach. Maybe later...</div></div><div dir=3D"l= tr"></div><br><div class=3D"gmail_quote"><div dir=3D"ltr" class=3D"gmail_at= tr">On Wed, 9 Nov 2022 at 18:28, William Lupton <<a rel=3D"nofollow">wlu= ...@broadband-forum.org</a>> wrote:<br></div><blockquote class=3D"gmail_= quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,= 204);padding-left:1ex"><div dir=3D"auto">Oh sorry, yes, utils is one of min= e! I'll look into this tomorrow...</div><br><div class=3D"gmail_quote">= <div dir=3D"ltr" class=3D"gmail_attr">On Wed, 9 Nov 2022, 16:03 Lu=C3=ADs d= e Sousa, <<a rel=3D"nofollow">luis.a....-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org</a>> wrote:<br></d= iv><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;bord= er-left:1px solid rgb(204,204,204);padding-left:1ex">Thank you very much fo= r sharing, that looks very promising.<div><br></div><div>Pandoc can't r= un the script though, says it can't find the utils package. I installed= luarocks and with it lua-utils but the error prevails:</div><div><br></div= ><div>$ pandoc multi-test.md -t html-multi-writer.lua -o output/multi-test.= html<br>Error running Lua:<br>html-multi-writer.lua:21: module 'utils&#= 39; not found:<br>=C2=A0 =C2=A0 no field package.preload['utils']<b= r>=C2=A0 =C2=A0 no file '/usr/local/share/lua/5.4/utils.lua'<br>=C2= =A0 =C2=A0 no file '/usr/local/share/lua/5.4/utils/init.lua'<br>=C2= =A0 =C2=A0 no file '/usr/local/lib/lua/5.4/utils.lua'<br>=C2=A0 =C2= =A0 no file '/usr/local/lib/lua/5.4/utils/init.lua'<br>=C2=A0 =C2= =A0 no file './utils.lua'<br>=C2=A0 =C2=A0 no file './utils/ini= t.lua'<br>=C2=A0 =C2=A0 no file '/usr/local/lib/lua/5.4/utils.so= 9;<br>=C2=A0 =C2=A0 no file '/usr/local/lib/lua/5.4/loadall.so'<br>= =C2=A0 =C2=A0 no file './utils.so'<br>stack traceback:<br>=C2=A0 = =C2=A0 html-multi-writer.lua:21: in main chunk<br><br></div><div>P.S.: woul= d you consider creating a repository for this work? I would like to automat= e the second stage with bash, shouldn't be too hard.</div><div><br></di= v><div class=3D"gmail_quote"><div dir=3D"auto" class=3D"gmail_attr">On Mond= ay, 7 November 2022 at 15:46:58 UTC+1 <a rel=3D"noreferrer nofollow">wlu...= @broadband-forum.org</a> wrote:<br></div><blockquote class=3D"gmail_quote" = style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);pa= dding-left:1ex"><div dir=3D"ltr">I've created this gist:=C2=A0<a href= =3D"https://gist.github.com/wlupton/2fc23fc1c4e4b4899121bfafc0fea4bf" rel= =3D"nofollow noreferrer" target=3D"_blank">https://gist.github.com/wlupton/= 2fc23fc1c4e4b4899121bfafc0fea4bf</a><div><br></div><div>I added a README.md= and hope that there's enough info to get going. Please=C2=A0let me kno= w if not.</div><div><br></div><div>(Please note that this writer does some = other things too, which might need to be stripped out. Also, it's an ol= d-style writer... I haven't got around to updating it yet,)</div></div>= <br><div class=3D"gmail_quote"></div><div class=3D"gmail_quote"><div dir=3D= "ltr" class=3D"gmail_attr">On Mon, 7 Nov 2022 at 09:22, Lu=C3=ADs de Sousa = <<a rel=3D"nofollow noreferrer">luis.a....-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org</a>> wrote:<br><= /div></div><div class=3D"gmail_quote"><blockquote class=3D"gmail_quote" sty= le=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);paddi= ng-left:1ex">Hi there. That is precisely the kind of output I would like to= have. Similar to what tools like mdBook produce. I would be glad if you co= uld share more details on that custom writer.<div><br></div><div>Thank you = and regards.<br><br><div class=3D"gmail_quote"><div dir=3D"auto" class=3D"g= mail_attr">On Friday, 4 November 2022 at 17:51:24 UTC+1 <a rel=3D"nofollow = noreferrer">wlu...-QSt+ys/nuMyEUIsrzH9SikB+6BGkLq7r@public.gmane.org</a> wrote:<br></div><blockquote clas= s=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid r= gb(204,204,204);padding-left:1ex"><div dir=3D"ltr"><div>See=C2=A0<a href=3D= "https://usp.technology/specification" rel=3D"nofollow noreferrer" target= =3D"_blank">https://usp.technology/specification</a> for an example of how = the Broadband Forum has recently been publishing some specs. This output is= generated via an html-multi-writer.lua custom writer that contains the log= ic for splitting the output into multiple files (based on header level and/= or specific classes). The writer also takes care of generating the navigati= on bar that you see at the top and bottom of the pages. The multiple files = are then passed through pandoc again (to add the overall sidebar ToC and th= e top/bottom navigation=C2=A0bars, and to generate multiple standalone docs= ).</div><div><br></div><div>Please let me know if you'd like more detai= ls=C2=A0(the overall setup is not very easily shareable, because it's h= eavily dependent on rather=C2=A0complicated make rules, but I could probabl= y share the=C2=A0custom writer and give some example command=C2=A0lines.)</= div></div><br><div class=3D"gmail_quote"></div><div class=3D"gmail_quote"><= div dir=3D"ltr" class=3D"gmail_attr">On Fri, 4 Nov 2022 at 12:45, Lu=C3=ADs= de Sousa <<a rel=3D"nofollow noreferrer">luis.a....-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org</a>> w= rote:<br></div></div><div class=3D"gmail_quote"><blockquote class=3D"gmail_= quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,= 204);padding-left:1ex">Dear all,<div><br></div><div>I am currently working = on a long document that must served as a web page. The single file output i= s becoming too slow and cumbersome for readers. I am aware this functionali= ty is not available, but a Feature Request is open [0].=C2=A0</div><div><br= ></div><div>In that issue there are some hints to this issue being addressa= ble with a template [1]. I have tried many HTML templates, but never seen o= ne that would split a long document in a set of small files. Would there be= an example somewhere I could follow? Otherwise, could someone provide a ge= neral idea of how such template would function?</div><div><br></div><div>Th= ank you.</div><div><br></div><div>[0]=C2=A0<a href=3D"https://github.com/jg= m/pandoc/issues/6122" rel=3D"nofollow noreferrer" target=3D"_blank">https:/= /github.com/jgm/pandoc/issues/6122</a></div><div><br></div><div>[1]=C2=A0<a= href=3D"https://github.com/jgm/pandoc/issues/6122#issuecomment-583593340" = rel=3D"nofollow noreferrer" target=3D"_blank">https://github.com/jgm/pandoc= /issues/6122#issuecomment-583593340</a></div> <p></p></blockquote></div><div class=3D"gmail_quote"><blockquote class=3D"g= mail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204= ,204,204);padding-left:1ex"> -- <br> You received this message because you are subscribed to the Google Groups &= quot;pandoc-discuss" group.<br> To unsubscribe from this group and stop receiving emails from it, send an e= mail to <a rel=3D"nofollow noreferrer">pandoc-discus...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org</a= >.<br> To view this discussion on the web visit <a href=3D"https://groups.google.c= om/d/msgid/pandoc-discuss/264eeee0-68c8-4389-a5c5-12563c6926f6n%40googlegro= ups.com?utm_medium=3Demail&utm_source=3Dfooter" rel=3D"nofollow norefer= rer" target=3D"_blank">https://groups.google.com/d/msgid/pandoc-discuss/264= eeee0-68c8-4389-a5c5-12563c6926f6n%40googlegroups.com</a>.<br> </blockquote></div> </blockquote></div></div> <p></p> -- <br> You received this message because you are subscribed to the Google Groups &= quot;pandoc-discuss" group.<br> To unsubscribe from this group and stop receiving emails from it, send an e= mail to <a rel=3D"nofollow noreferrer">pandoc-discus...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org</a= >.<br></blockquote></div><div class=3D"gmail_quote"><blockquote class=3D"gm= ail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,= 204,204);padding-left:1ex"> To view this discussion on the web visit <a href=3D"https://groups.google.c= om/d/msgid/pandoc-discuss/cb3753d7-e845-4a72-a1aa-e93086a32f11n%40googlegro= ups.com?utm_medium=3Demail&utm_source=3Dfooter" rel=3D"nofollow norefer= rer" target=3D"_blank">https://groups.google.com/d/msgid/pandoc-discuss/cb3= 753d7-e845-4a72-a1aa-e93086a32f11n%40googlegroups.com</a>.<br> </blockquote></div> </blockquote></div> <p></p> -- <br> You received this message because you are subscribed to the Google Groups &= quot;pandoc-discuss" group.<br> To unsubscribe from this group and stop receiving emails from it, send an e= mail to <a rel=3D"noreferrer nofollow">pandoc-discus...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org</a= >.<br> To view this discussion on the web visit <a href=3D"https://groups.google.c= om/d/msgid/pandoc-discuss/1ef6858a-0a37-4f5f-a88b-eff2479a8130n%40googlegro= ups.com?utm_medium=3Demail&utm_source=3Dfooter" rel=3D"noreferrer nofol= low" target=3D"_blank">https://groups.google.com/d/msgid/pandoc-discuss/1ef= 6858a-0a37-4f5f-a88b-eff2479a8130n%40googlegroups.com</a>.<br> </blockquote></div> </blockquote></div> </blockquote></div> <p></p> -- <br> You received this message because you are subscribed to the Google Groups &= quot;pandoc-discuss" group.<br> To unsubscribe from this group and stop receiving emails from it, send an e= mail to <a rel=3D"nofollow">pandoc-discus...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org</a>.<br></blo= ckquote></div><div class=3D"gmail_quote"><blockquote class=3D"gmail_quote" = style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);pa= dding-left:1ex"> To view this discussion on the web visit <a href=3D"https://groups.google.c= om/d/msgid/pandoc-discuss/539db8b9-47f4-43b8-83d1-4b4c99dc3b3fn%40googlegro= ups.com?utm_medium=3Demail&utm_source=3Dfooter" rel=3D"nofollow" target= =3D"_blank">https://groups.google.com/d/msgid/pandoc-discuss/539db8b9-47f4-= 43b8-83d1-4b4c99dc3b3fn%40googlegroups.com</a>.<br> </blockquote></div> </blockquote></div> <p></p> -- <br> You received this message because you are subscribed to the Google Groups &= quot;pandoc-discuss" group.<br> To unsubscribe from this group and stop receiving emails from it, send an e= mail to <a rel=3D"nofollow">pandoc-discus...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org</a>.<br></blo= ckquote></div><div class=3D"gmail_quote"><blockquote class=3D"gmail_quote" = style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);pa= dding-left:1ex"> To view this discussion on the web visit <a href=3D"https://groups.google.c= om/d/msgid/pandoc-discuss/7f4b28ec-1e91-4228-ab03-fe58a2e5cf18n%40googlegro= ups.com?utm_medium=3Demail&utm_source=3Dfooter" rel=3D"nofollow" target= =3D"_blank">https://groups.google.com/d/msgid/pandoc-discuss/7f4b28ec-1e91-= 4228-ab03-fe58a2e5cf18n%40googlegroups.com</a>.<br> </blockquote></div> </blockquote></div> <p></p> -- <br> You received this message because you are subscribed to the Google Groups &= quot;pandoc-discuss" group.<br> To unsubscribe from this group and stop receiving emails from it, send an e= mail to <a rel=3D"nofollow">pandoc-discus...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org</a>.<br></blo= ckquote></div></div><div dir=3D"ltr"><div class=3D"gmail_quote"><blockquote= class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px so= lid rgb(204,204,204);padding-left:1ex"> To view this discussion on the web visit <a href=3D"https://groups.google.c= om/d/msgid/pandoc-discuss/5e290d88-1c47-407d-819b-34a094d8b48fn%40googlegro= ups.com?utm_medium=3Demail&utm_source=3Dfooter" rel=3D"nofollow" target= =3D"_blank">https://groups.google.com/d/msgid/pandoc-discuss/5e290d88-1c47-= 407d-819b-34a094d8b48fn%40googlegroups.com</a>.<br> </blockquote></div></div> </blockquote></div> <p></p> -- <br> You received this message because you are subscribed to the Google Groups &= quot;pandoc-discuss" group.<br> To unsubscribe from this group and stop receiving emails from it, send an e= mail to <a rel=3D"nofollow">pandoc-discus...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org</a>.<br></blo= ckquote></div><div class=3D"gmail_quote"><blockquote class=3D"gmail_quote" = style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);pa= dding-left:1ex"> To view this discussion on the web visit <a href=3D"https://groups.google.c= om/d/msgid/pandoc-discuss/20b2a20b-69ad-4b93-863a-c70db01d45een%40googlegro= ups.com?utm_medium=3Demail&utm_source=3Dfooter" rel=3D"nofollow" target= =3D"_blank">https://groups.google.com/d/msgid/pandoc-discuss/20b2a20b-69ad-= 4b93-863a-c70db01d45een%40googlegroups.com</a>.<br> </blockquote></div> </blockquote></div> <p></p> -- <br> You received this message because you are subscribed to the Google Groups &= quot;pandoc-discuss" group.<br> To unsubscribe from this group and stop receiving emails from it, send an e= mail to <a rel=3D"nofollow">pandoc-discus...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org</a>.<br></blo= ckquote></div><div class=3D"gmail_quote"><blockquote class=3D"gmail_quote" = style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);pa= dding-left:1ex"> To view this discussion on the web visit <a href=3D"https://groups.google.c= om/d/msgid/pandoc-discuss/fbe785d6-57dc-45a5-a4da-cc275638cd6dn%40googlegro= ups.com?utm_medium=3Demail&utm_source=3Dfooter" rel=3D"nofollow" target= =3D"_blank">https://groups.google.com/d/msgid/pandoc-discuss/fbe785d6-57dc-= 45a5-a4da-cc275638cd6dn%40googlegroups.com</a>.<br> </blockquote></div> </blockquote></div> <p></p> -- <br> You received this message because you are subscribed to the Google Groups &= quot;pandoc-discuss" group.<br> To unsubscribe from this group and stop receiving emails from it, send an e= mail to <a href=3D"mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org" targ= et=3D"_blank">pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org</a>.<br> To view this discussion on the web visit <a href=3D"https://groups.google.c= om/d/msgid/pandoc-discuss/0a29b118-ae0f-448f-8e3e-39cc96ef5d8an%40googlegro= ups.com?utm_medium=3Demail&utm_source=3Dfooter" target=3D"_blank">https= ://groups.google.com/d/msgid/pandoc-discuss/0a29b118-ae0f-448f-8e3e-39cc96e= f5d8an%40googlegroups.com</a>.<br> </blockquote></div> <p></p> -- <br /> You received this message because you are subscribed to the Google Groups &= quot;pandoc-discuss" group.<br /> To unsubscribe from this group and stop receiving emails from it, send an e= mail to <a href=3D"mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org">pand= oc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org</a>.<br /> To view this discussion on the web visit <a href=3D"https://groups.google.c= om/d/msgid/pandoc-discuss/CAEe_xxgnCSkiBiFFrU%3DOBEVwHf1XUXzf9PshA-HCB-w2E6= dfkw%40mail.gmail.com?utm_medium=3Demail&utm_source=3Dfooter">https://group= s.google.com/d/msgid/pandoc-discuss/CAEe_xxgnCSkiBiFFrU%3DOBEVwHf1XUXzf9Psh= A-HCB-w2E6dfkw%40mail.gmail.com</a>.<br /> --00000000000036cdb705edab987f--