<div dir="ltr"><div>Now back to computers - so re-checked some bits.</div><div><br></div><div>The existing <a href="https://networkupstools.org/documentation.html">https://networkupstools.org/documentation.html</a> page offers currently the
<a href="https://github.com/networkupstools/ConfigExamples/releases/latest/">https://github.com/networkupstools/ConfigExamples/releases/latest/</a> URL as "<a href="https://github.com/networkupstools/ConfigExamples/releases/latest">NUT Configuration Examples</a> book maintained by Roger Price"<br></div><div><br></div><div>This in turn redirects to a particular newest release page, "beknownst to GitHub but unbeknownst to us" externally (paraphrasing Starballs, credit where due), and so the browser ends up at <a href="https://github.com/networkupstools/ConfigExamples/releases/tag/book-3.0-20230319-nut-2.8.0">https://github.com/networkupstools/ConfigExamples/releases/tag/book-3.0-20230319-nut-2.8.0</a> page currently, and the rendered book is available there as <a href="https://github.com/networkupstools/ConfigExamples/releases/download/book-3.0-20230319-nut-2.8.0/ConfigExamples.pdf">https://github.com/networkupstools/ConfigExamples/releases/download/book-3.0-20230319-nut-2.8.0/ConfigExamples.pdf</a><br></div><div><br></div><div>I've tried requesting <a href="https://github.com/networkupstools/ConfigExamples/releases/latest/ConfigExamples.pdf">https://github.com/networkupstools/ConfigExamples/releases/latest/ConfigExamples.pdf</a> but it does not auto-redirect to a newest release (as of the day of user's request from their browser).</div><div>
<div><br></div><div>There is a Makefile in the book repository <a href="https://github.com/networkupstools/ConfigExamples/tree/master">https://github.com/networkupstools/ConfigExamples/tree/master</a> but no further continuous integration recipes - so the book releases were built and uploaded to github manually after all.<br></div><div><br></div>

</div><div>At the moment a "seamless-browsing" way forward can be to discover the release PDF URL when building the nut-website, and embed that string into the documentation page (alternately - keep a copy of that PDF in the rendered website repo, like we keep user/dev manuals). One downside is that this reference would not direct the user to a newer PDF if/when the book marches on with new releases, at least not until the nut-website is rebuilt. This is likely not a big constraint in practice, given how the master version of the site is rebuilt with each new merged PR, and the book is updated much less frequently.</div><div><br></div><div>Technically, the website build job runs several times a day but usually detects there is nothing to do so aborts quickly. Detection of a new book release (or even commit in its repo, so we can `make` it into a PDF) can be a trigger to proceed with the build even if other sources did not change.</div><br><div>FWIW, I've also noticed that "<a href="http://rogerprice.org/NUT.html">NUT Setup with openSUSE</a> <em>(Roger Price)</em>" link from 
<a href="https://networkupstools.org/documentation.html">https://networkupstools.org/documentation.html</a> goes to <a href="http://rogerprice.org/NUT.html">http://rogerprice.org/NUT.html</a> which is AWOL, but there is now an <a href="http://rogerprice.org/NUT">http://rogerprice.org/NUT</a> (without an extension) with the OpenSUSE page mentioned as retired.</div><div><br></div><div>Jim<br></div><div><br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Jun 3, 2024 at 7:55 AM Jim Klimov <<a href="mailto:jimklimov%2Bnut@gmail.com">jimklimov+nut@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><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" target="_blank">nut-upsdev@alioth-lists.debian.net</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Roger Price <<a href="mailto:roger@rogerprice.org" rel="noreferrer" target="_blank">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" rel="noreferrer" target="_blank">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>
</blockquote></div>