<div dir="ltr"><div>Hi list,</div><div><br></div><div>Thought I might try this again, see if I can catch a different set of eyes or something.</div><div><br></div><div>I'm trying to figure out how to link between a Help guide page provided by one package and individual pages provided separately.</div><div><br></div><div>My closest attempt was to install a guide page in /usr/share/help/ and link in subsequent pages from .local/share/help/, but when I tried that, opening Yelp would _only_ show the .local page, and lose the /usr/ guide entirely.</div><div><br></div><div>I'm really not clear if this is breaking the spec, simply undefined behavior (and where), or a Yelp bug.</div><div><br></div><div>Anyone have thoughts?</div><div><br></div><div>Thanks,</div><div>Nate<br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Sep 5, 2018 at 11:44 PM Nathan Willis <<a href="mailto:nwillis@glyphography.com">nwillis@glyphography.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><div>Hello Mallard Nation,</div><div><br></div><div>I'm rather new to designing Mallard books and I'm trying to spec out a proposed project. So I've got a couple of questions I'm hoping the community can educate me on.</div><div><br></div><div>The core idea is to add help (in the form of individual per-package topic pages) to a set of desktop Linux packages so that you could visit the guide page and it will show you all the pages from whichever individual packages you happen to have currently installed.</div><div><br></div>... <br></div></blockquote><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div>As I understand it from the manual and a couple of tests, though, I can't have a guide page (e.g., /usr/share/help/installed-system-fonts/index.page) that automatically finds and links to HTML pages. Is that correct? If so, is there some workaround worth exploring?</div>...<br><div>The second wrinkle is that, ideally, we'd also be able to do the equivalent for things installed in the user's home directory (that being the use case for a font manager app as well as what you get when downloading from Google Fonts and the like). So, if that user-mode installer copies help files into ~/.local/share/help/fonts-bar/ (from a downloaded .zip file, not via a distro package), what would be the best way to pick that up in the same help guide?</div>...<div dir="ltr">But with some test files I played around with, I couldn't get that to work at all. Specifically, launching yelp on that guide (as above) shows only the ~/.local/ page, and drops the content in /usr/share/ entirely. That was on a fresh Ubuntu 18.04 machine. It's possible there's something funky going on that I just haven't noticed yet, but I'm more concerned that I'm missing something crucial in the fundamental topic/guide/page/HTML architecture. If so, I'd certainly appreciate some help figuring out what it is.</div><div><div dir="ltr" class="gmail-m_3846138942403115739gmail_signature"></div></div></div>
</blockquote></div><br clear="all"><br>-- <br><div dir="ltr" class="gmail_signature"><div dir="ltr">nathan.p.willis<br><a href="mailto:nwillis@glyphography.com" target="_blank">nwillis@glyphography.com</a><a href="http://identi.ca/n8" target="_blank"></a></div></div></div>