<div dir="auto">The pieces should all be there, I think.<div dir="auto"><br></div><div dir="auto">NUT source iterations cooperate with the sister nut-website repo on github, as well as nut-ddl and some more, to produce an horde of static HTML pages, and PDF versions of some docs, tarballs, etc. which are pushed to a repo for "github pages" and with their magic (I guess GH spins up a container with a web server and many data files for each new commit on this pages repo) they become a browsable statically rendered site, as Greg outlined.</div><div dir="auto"><br></div><div dir="auto">A model case for "browsable" PDF files embedded here are NUT's User and Developer manuals, or the Changelog.</div><div dir="auto"><br></div><div dir="auto">Likewise, a couple of years back we made Roger's book sources into a GitHub repo (should be complete with a Makefile to render it, don't quite remember if I had any further CI to react to commits or tagged releases, or I built the PDFs locally and uploaded as release artifacts), and it was updated a couple of times since.</div><div dir="auto"><br></div><div dir="auto">So maybe the quest is about changing the link style from the nut-website renditions to the book's PDF, so it would by default open in the same tab?</div><div dir="auto"><br></div><div dir="auto">Currently commuting so can't say more at the moment.</div><div dir="auto"><br></div><div dir="auto">Jim</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Jun 3, 2024, 02:21 Greg Troxel via Nut-upsdev <<a href="mailto:nut-upsdev@alioth-lists.debian.net">nut-upsdev@alioth-lists.debian.net</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Roger Price <<a href="mailto:roger@rogerprice.org" target="_blank" rel="noreferrer">roger@rogerprice.org</a>> writes:<br>
<br>
> On Sun, 2 Jun 2024, Jim Klimov wrote:<br>
><br>
>> Trying to remember the context: is your book only rendered as a PDF<br>
>> (a "release" of which on GitHub the NUT site currently points to),<br>
>> or are there also HTML renditions to point to this way (to see in a<br>
>> typical browser)?<br>
><br>
> Sorry, I did not express myself clearly.  The book is in PDF, but PDF<br>
> can be displayed as if it were HTML by browsers such as Firefox and<br>
> Opera.  These browsers and maybe others are capable of treating PDF<br>
> just like it was HTML and providing an immediate display.<br>
<br>
Not really, but they will run a js program to render pdf.  Which means<br>
the user sees it, similar to html, so I see your point.<br>
<br>
> I would like to have an immediate display of the book from the NUT<br>
> website rather than from my own.  I think it's better to point<br>
> visitors to our official site rather than a personal site.  Also, NUT<br>
> will around a lot longer than me and my site, and maybe the book would<br>
> still be usefull.<br>
<br>
I think it still needs a CI rule to build the pdf and put it on github<br>
pages, or some other way to get it on whatever <a href="http://networkupstools.org" rel="noreferrer noreferrer" target="_blank">networkupstools.org</a> is,<br>
and for that I think we'll need to wait for Jim.<br>
<br>
_______________________________________________<br>
Nut-upsdev mailing list<br>
<a href="mailto:Nut-upsdev@alioth-lists.debian.net" target="_blank" rel="noreferrer">Nut-upsdev@alioth-lists.debian.net</a><br>
<a href="https://alioth-lists.debian.net/cgi-bin/mailman/listinfo/nut-upsdev" rel="noreferrer noreferrer" target="_blank">https://alioth-lists.debian.net/cgi-bin/mailman/listinfo/nut-upsdev</a><br>
</blockquote></div>