You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
When using the jupyter-sphinx extension, we get 404s for some missing files. This is due to jupyter/jupyter-sphinx#163.
We actually don't really like the jupyter-sphinx extension anymore and are trying to get rid of it. But still the majority of Qiskit projects use it, so this is probably worth fixing.
How to reproduce
Build the docs with tox -e docs.
Then start up a web server to render the docs with python3 -m http.server -d example_docs/docs/_build/html. It will print to the console what website to go to, I think localhost:8000. It is useful to build the docs with a server because it fixes a bunch of errors you'd normally see in the Developer Console.
Then, open up the Developer Console and look at the 404 errors.
…pt (#292)
1. Remove references to `js/vendor`, which was removed in
#17
2. Remove reference to `css.theme.map`, which we never distribute since
we never minify `css.theme` to begin with
3. Remove invalid JavaScript references to `pytorch-shortcuts-wrapper`
and `header-holder`, which no longer exist in our HTML template and
caused the JavaScript to fail to run.
The main console error I still get is tracked by
#291. (FYI: to avoid
a bunch of console errors when developing, you need to serve the app
with e.g. `python3 -m http.server`, rather than opening `index.html`
directly.)
As a result of this change, the right page table of contents now shows
subheadings! You can click the + or - to expand it.
![Screenshot 2023-05-04 at 1 02 48
PM](https://user-images.githubusercontent.com/14852634/236303682-915ac4de-e500-4525-849a-062245e91762.png)
Problem
When using the
jupyter-sphinx
extension, we get 404s for some missing files. This is due to jupyter/jupyter-sphinx#163.We actually don't really like the
jupyter-sphinx
extension anymore and are trying to get rid of it. But still the majority of Qiskit projects use it, so this is probably worth fixing.How to reproduce
Build the docs with
tox -e docs
.Then start up a web server to render the docs with
python3 -m http.server -d example_docs/docs/_build/html
. It will print to the console what website to go to, I thinklocalhost:8000
. It is useful to build the docs with a server because it fixes a bunch of errors you'd normally see in the Developer Console.Then, open up the Developer Console and look at the 404 errors.
Proposed solution
See jupyter/jupyter-sphinx#163 (comment) and what it links to at sphinx-doc/sphinx#6241 (comment).
I believe you will want to add that code snippet to
qiskit_sphinx_theme/__init__.py
. In the file'ssetup
function, add a line like this:qiskit_sphinx_theme/qiskit_sphinx_theme/translations.py
Line 27 in bb3083e
But the event is 'html-page-context', not 'config-inited'.
The text was updated successfully, but these errors were encountered: