Date: Thu, 26 Jan 2023 13:25:23 +0000 From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 265276] Books: FAQ: Single HTML: 404 Message-ID: <bug-265276-9-iz4r0vKqoK@https.bugs.freebsd.org/bugzilla/> In-Reply-To: <bug-265276-9@https.bugs.freebsd.org/bugzilla/> References: <bug-265276-9@https.bugs.freebsd.org/bugzilla/>
next in thread | previous in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D265276 Ciar=C3=A1n Ainsworth <ciaranainsworth@posteo.net> changed: What |Removed |Added ---------------------------------------------------------------------------- CC| |ciaranainsworth@posteo.net --- Comment #3 from Ciar=C3=A1n Ainsworth <ciaranainsworth@posteo.net> --- The reason this happens is that the theme generates a single HTML link that= is hardcoded to the `book.adoc` file in a given directory. This file includes = all chapters to present everything in a single page. However, for pages like the FAQ and the dev-model, this is unnecessary. These are already single page documents. You have a few ways to handle this: 1. Create a `book.adoc` file that contains all the content from the index p= age (don't do this). 2. Update the theme and add a frontmatter parameter which allows the editor= to hide the single page link when it's not necesssary. 3. Find some way to inform Hugo when there's no book file and have it simply route the user back to the main page when they click the link. Of these, 2 is by far the easiest to implement as we can just add a paramet= er like `show_single_page: false` to the frontmatter of single page docs and t= he theme won't show the link, thereby avoiding the confusion. If this sounds like an agreeable solution, let me know and I'll put a patch= in. --=20 You are receiving this mail because: You are the assignee for the bug.=
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-265276-9-iz4r0vKqoK>