From nobody Thu Jan 26 13:25:23 2023 X-Original-To: doc@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4P2hKJ0xFMz3bpml for ; Thu, 26 Jan 2023 13:25:24 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4P2hKH5m3dz3H3J for ; Thu, 26 Jan 2023 13:25:23 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674739523; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=/0lO6eiHu2lYR+JX6jUzkzokvSQDz1adEy8SqGH0TOw=; b=Wr6RMtYJ7p9M3JeiF2cH87Xf4BytQD82T8H0nR0wfAmcuEp2+fztVgYRNXjeskIGQiZ4PR iMtSp94w8jZHTdLGBy3IOhW94vYnL9zdZMqRMW6zSkSGeSH1QnK3skCFF8LQHMepPZdlkd pQg0E3iDaB0R2sgf481JXXpUde+QOARj0opvqmSyoH+c9YSZ3xw+pRfc39ADYluv3CrOpk Txozg0XKgo6FN+Yb1dkd+X7Zpa9z4taEs6sF0z6cC2EjF8miQ5hwEHXK7CJ0M7mrcldnIr MZur+Ef+7BOP33M60kRnKQ3S+79rwwdaO8t6+1z9IjP9Bik3Rcysz1LvoKAKBQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1674739523; a=rsa-sha256; cv=none; b=AMz67tcjL6eZ2MIb2JZ059dFzk2l94IbLBw8BXIosjj+sAer9kVriVz4pOnyignS/HQB61 bsn+u/VTxc8//Dwke1zHjDwfe+DxSkj+KaMJlf4wxvQt/f6gNffcpMSp/VaAR0KnjDPU2k HlnXtdA0fxmN5GncSXaSxgdQ62yuikJnmD9d56tyhIZR3cAb8eA4bcSrj2dVbMHzSIJbRi L46jAyMzQ8+NRT0nRCVI1eZeymjuSzQVPGj8o5ecHUvn+mok7TBekL234/mdr/FUXEm4zI OR1saOLM6HAiCE9/k/tkAYuuunC/HKn6U9t9mw1hM7oUinMQwXlxXbOAs0y2Rw== Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4P2hKH4r7QzVl3 for ; Thu, 26 Jan 2023 13:25:23 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 30QDPNin006328 for ; Thu, 26 Jan 2023 13:25:23 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 30QDPNwj006327 for doc@FreeBSD.org; Thu, 26 Jan 2023 13:25:23 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 265276] Books: FAQ: Single HTML: 404 Date: Thu, 26 Jan 2023 13:25:23 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: changed X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Books & Articles X-Bugzilla-Version: Latest X-Bugzilla-Keywords: needs-patch X-Bugzilla-Severity: Affects Some People X-Bugzilla-Who: ciaranainsworth@posteo.net X-Bugzilla-Status: Open X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: doc@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: cc Message-ID: In-Reply-To: References: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@freebsd.org MIME-Version: 1.0 X-ThisMailContainsUnwantedMimeParts: N https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D265276 Ciar=C3=A1n Ainsworth changed: What |Removed |Added ---------------------------------------------------------------------------- CC| |ciaranainsworth@posteo.net --- Comment #3 from Ciar=C3=A1n Ainsworth --- 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.=