Bug#872944: www.debian.org: Debian Policy Manual not fully published
- To: Russ Allbery <rra@debian.org>
- Cc: 872944@bugs.debian.org
- Subject: Bug#872944: www.debian.org: Debian Policy Manual not fully published
- From: Samuel Bronson <naesten@gmail.com>
- Date: Fri, 08 Apr 2022 17:11:37 -0400
- Message-id: <[🔎] 87pmlr46wm.fsf@DESKTOP-5JD7O8D.localdomain>
- Reply-to: Samuel Bronson <naesten@gmail.com>, 872944@bugs.debian.org
- In-reply-to: <87efr5ro9m.fsf@hope.eyrie.org> (Russ Allbery's message of "Sun, 17 Sep 2017 14:47:17 -0700")
- References: <20170822192106.652n36e6wu3dkzsz@iris.silentflame.com> <20170822192106.652n36e6wu3dkzsz@iris.silentflame.com> <87bmn70w62.fsf@hope.eyrie.org> <39481c1a-33b4-c7ca-9b19-16e93866cf02@debian.org> <20170822192106.652n36e6wu3dkzsz@iris.silentflame.com> <87lgm8ad7p.fsf@iris.silentflame.com> <c12e3cad-c56f-69a3-a33b-728762eb684c@debian.org> <8760dba1b9.fsf@iris.silentflame.com> <20170822192106.652n36e6wu3dkzsz@iris.silentflame.com> <87efr5ro9m.fsf@hope.eyrie.org> <20170822192106.652n36e6wu3dkzsz@iris.silentflame.com>
Russ Allbery <rra@debian.org> writes:
> That said, introducing Javascript for the first time does feel like a
> large-ish step, and the reluctance also makes sense. I'm not sure the
> search functionality really adds much. (I haven't checked to confirm that
> is the only thing in the Sphinx output that uses Javascript, and that it's
> not used for something more useful like responsive design on mobile
> browsers, but maybe Sean has.)
I would be more inclined to agree if there was actually a single-page
HTML version.
Also, it looks like sphinx upstream is refactoring their javascript so
that all references to third-party javascript (underscore.js and
jquery.js) will be confined to _sphinx_javascript_frameworks_compat.js
-- see <https://github.com/sphinx-doc/sphinx/pull/10028>, merged as
<https://github.com/sphinx-doc/sphinx/commit/3b01fbe2adf3077cad5c2cf345c6d000d429d7ac>
on the 5.x branch.
Once those changes hit sid and debian-policy gets rebuilt and deployed
on debian.org, we should just have:
* 404s for underscore.js and jquery.js
* an uncaught ReferenceError in
_sphinx_javascript_frameworks_compat.js
but doctools.js and searchtools.js and the search box should be fully
functional.
(The cronscript seems to handle the files symlinked in from
libjs-sphinxdoc just fine -- it only seems to have trouble when the
files shipped in libjs-sphinxdoc are *also* symlinks.)
Reply to: