Quoting Dmitry Shachnev (2021-11-21 18:23:22)
> On Thu, Nov 18, 2021 at 02:06:22PM +0100, Jonas Smedegaard wrote:
> > dh_sphinxdoc worked fine with emscripten 2.0.26~dfsg-4 at the time
> > it was released, but since then it fails:
> >
> > dh_sphinxdoc: error: DOCUMENTATION_OPTIONS does not define URL_ROOT
>
> This error is correct.
>
> Let's look at the generated search.html. It has this fragment:
>
> <script type="text/javascript">
> var DOCUMENTATION_OPTIONS = {
> URL_ROOT:'./',
> VERSION:'2.0.26 (dev)',
> COLLAPSE_INDEX:false,
> FILE_SUFFIX:'.html',
> HAS_SOURCE: true,
> LINK_SUFFIX: '.html'
> };
> </script>
> <script type="text/javascript"
> src="_static/documentation_options.js"></script>
>
> The first DOCUMENTATION_OPTIONS is good. However, documentation_options.js
> overwrites it. That JS file has:
>
> var DOCUMENTATION_OPTIONS = {
> URL_ROOT:
> document.getElementById("documentation_options").getAttribute('data-url_root'),
> VERSION: '2.0.26 (dev)',
> ...
> }
>
> But in search.html, there is no element with id="documentation_options", so
> this does not work.
>
> If you open search.html in a browser, you will see an error like this:
>
> Uncaught TypeError: Cannot read properties of null (reading 'getAttribute')
> at documentation_options.js:2
>
> Now, how to fix this. Emscripten uses emscripten_sphinx_rtd_theme, which is
> a modification of sphinx-rtd-theme. The parent project sphinx-rtd-theme had
> some fixes for Sphinx 4 between versions 0.5.1 and 1.0.0. In particular, see
> this pull request:
>
> https://github.com/readthedocs/sphinx_rtd_theme/pull/1123
>
> Rebasing emscripten_sphinx_rtd_theme against the latest version of
> sphinx-rtd-theme should fix this issue.Thanks a lot for a detailed and insightful response. I'll pass that upstream to Emscripten developers. - Jonas -- * Jonas Smedegaard - idealist & Internet-arkitekt * Tlf.: +45 40843136 Website: http://dr.jones.dk/ [x] quote me freely [ ] ask before reusing [ ] keep private
signature.asc
Description: signature
