Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

WARNING: html_static_path entry ... does not exist #1776

Closed
stevepiercy opened this issue Oct 20, 2015 · 13 comments
Closed

WARNING: html_static_path entry ... does not exist #1776

stevepiercy opened this issue Oct 20, 2015 · 13 comments
Labels
Support Support question

Comments

@stevepiercy
Copy link
Contributor

I noticed a 404.
http://docs.pylonsproject.org/projects/pyramid-tutorials/en/latest/

This issue cropped up recently for at least 5 other Pylons Project project's documentation.
http://docs.pylonsproject.org/projects/pyramid_tm/en/latest/
http://docs.pylonsproject.org/projects/pyramid-jinja2/en/latest/
http://docs.pylonsproject.org/projects/pyramid-debugtoolbar/en/latest/
http://docs.pylonsproject.org/projects/pyramid-zcml/en/latest/
http://docs.pylonsproject.org/projects/pyramid-cookbook/en/latest/

All was working fine a few weeks ago and there had been no changes to these repos that could have caused a build to fail. After much Googling, flailing, and random guessing, I just gave up. Every build ends up with a false positive like the following.
https://readthedocs.org/projects/pyramid_tutorials/builds/3413804/

copying static files... WARNING: html_static_path entry u'/home/docs/checkouts/readthedocs.org/user_builds/pyramid-tutorials/checkouts/latest/_static' does not exist
WARNING: html_static_path entry '/home/docs/checkouts/readthedocs.org/readthedocs/templates/sphinx/_static' does not exist

Any insight would be greatly appreciated.

@tseaver
Copy link

tseaver commented Oct 20, 2015

FWIW, the following does render:

http://pyramid-tm.readthedocs.org/en/latest/

@agjohnson
Copy link
Contributor

This might be related to some recent refactoring of domains and subprojects, have you made any changes to domains recently? It might be worth double checking those, or testing the new domain admin interface.

@agjohnson agjohnson added the Support Support question label Oct 20, 2015
@agjohnson
Copy link
Contributor

Also, to remove the warnings, try setting html_static_path = [] in your conf.py. We default this to include the _static path if it's not set.

@stevepiercy
Copy link
Contributor Author

Thanks for the tips, @agjohnson.

I am aware of no changes in the Domains section of the Admin interface. Is there another Admin UI?
https://readthedocs.org/dashboard/pyramid_tutorials/domains/

I tried adding http://docs.pylonsproject.org/projects/pyramid-tutorials/en/latest/ as the canonical domain name at the above, but got an error message:

Domain with this Domain already exists.

In our project's conf.py we have

    canonical_url='http://docs.pylonsproject.org/projects/pyramid-tutorials/en/latest/'

I wonder if that has anything to do with it?

Also, to remove the warnings, try setting html_static_path = [] in your conf.py. We default this to include the _static path if it's not set.

That was one of my earlier attempts which failed, too. 😞

@agjohnson
Copy link
Contributor

Calling @ericholscher in on this, he's had the most experience with domains and subprojects lately.

@stevepiercy
Copy link
Contributor Author

Another data point, the Pyramid docs build just fine. Pyramid is our "gold standard" for the ideal setup and configuration regarding Sphinx and RTD. That might give y'all something that works for comparison. Thanks for looking into this.

@ericholscher
Copy link
Member

This is an issue with our handling of underscores in project slugs. The work I did likely reverted a hacky bit we were doing transforming them. _'s are illegal in subdomains, so we don't allow them anymore, but we need to migrate old projects to fix their slugs. I will plan on doing this today, and it will fix this issue.

The main thing that needs to happen is redirects. We are already doing these redirects on subproject & subdomain URL's, we just need to add them to the actual project pages on RTD.org, and it should be seamless.

@stevepiercy
Copy link
Contributor Author

Thanks, @ericholscher, looks like those 6 projects are back. Closing this issue as resolved.

In this scenario, it was actually a Good Thing™ that the 404 occurred without a redirect. I might not have noticed with a redirect, depending on implementation.

nueverest added a commit to nueverest/blowdrycss that referenced this issue Dec 12, 2015
…NG: html_static_path entry '/home/docs/checkouts/readthedocs.org/readthedocs/templates/sphinx/_static' does not exist" on readthedocs.

Reference: readthedocs/readthedocs.org#1776 (comment)
tulimaki added a commit to tulimaki/shoop-guide that referenced this issue Apr 20, 2016
robin900 added a commit to robin900/citus_docs that referenced this issue Sep 19, 2016
mssgill pushed a commit to lsst-dm/scipi_docs_prototype that referenced this issue Jan 24, 2017
   "subtask targets" -> "retargetable subtasks"

For conf.py -- copied over one in pipelines_lsst_io, modified it
slightly as so:

- 2016 -> 2017
- commented out release version

Then was getting a warning, found from:
readthedocs/readthedocs.org#1776

Modifying this line:

 html_static_path = ['_static']

to:

  html_static_path = []

made it compile fine, no warnings.
@ale5000-git
Copy link

I get this copying static files... WARNING: html_static_path entry '/home/docs/checkouts/readthedocs.org/readthedocs/templates/sphinx/_static' does not exist.

How can be avoided?

@Ewan82
Copy link

Ewan82 commented Aug 11, 2017

I have the same issue as @ale5000-git , is there a work around here?

@niuzhenguo
Copy link

I got the same issue here http://mogan.readthedocs.io/projects/api-ref/en/latest/v1/index.html

@ale5000-git
Copy link

@stevepiercy: Could you please reopen the issue?

@stevepiercy
Copy link
Contributor Author

@ale5000-git It's up to the maintainers. Ping @agjohnson for triage, or open a new issue, referencing this one.

hagenw added a commit to sfstoolbox/theory that referenced this issue Nov 24, 2017
hluk pushed a commit to hluk/pdc-client that referenced this issue Feb 1, 2018
Fixes following warning when generating documentation.

    WARNING: html_static_path entry u'.../_static' does not exist

More info: readthedocs/readthedocs.org#1776
rocco8773 added a commit to BaPSF/bapsflib that referenced this issue Apr 22, 2018
…include 2018, made html_static_path = [] to prevent waring on RTD build (see readthedocs/readthedocs.org#1776)
logan2211 added a commit to limestonenetworks/knowledge-base that referenced this issue Jun 29, 2018
logan2211 added a commit to limestonenetworks/knowledge-base that referenced this issue Jun 29, 2018
logan2211 added a commit to limestonenetworks/knowledge-base that referenced this issue Jun 29, 2018
rocco8773 added a commit to BaPSF/bapsflib that referenced this issue Oct 23, 2018
…include 2018, made html_static_path = [] to prevent waring on RTD build (see readthedocs/readthedocs.org#1776)
bwohlberg added a commit to bwohlberg/sporco that referenced this issue Nov 7, 2018
beat-buesser pushed a commit to Trusted-AI/adversarial-robustness-toolbox that referenced this issue Mar 15, 2020
readthedocs/readthedocs.org#1776
Signed-off-by: Beat Buesser <beat.buesser@ie.ibm.com>
valeriabarra added a commit to CEED/libCEED that referenced this issue Mar 31, 2020
This is needed to avoid the 'html_static_path entry '_static' does not exist' warning

readthedocs/readthedocs.org#1776
valeriabarra added a commit to CEED/libCEED that referenced this issue Apr 6, 2020
* A small shift in notation

* Docs: Clarify ex2-surface mathematical description

* Refactor \boldsymbol -> \bm

* Refactor \mathbf -> \bm

* Sphinx: clear html_static_path

This is needed to avoid the 'html_static_path entry '_static' does not exist' warning

readthedocs/readthedocs.org#1776

* Fix some incosistencies

* Invert inner products (u,v) -> (v,u)

* Add SVG figure for coordinates on the sphere

* doc: use dirhtml on readthedocs

* Improve caption of sphere coords figure

* Add reference to figure in the bps on the cubed-sphere section

Co-authored-by: Jed Brown <jed@jedbrown.org>
realcr added a commit to freedomlayer/offset that referenced this issue Apr 25, 2020
It seems like `_static` dir is not found.
Attempt a fix according to:
readthedocs/readthedocs.org#1776 (comment)
realcr added a commit to freedomlayer/offset_docs that referenced this issue May 2, 2020
It seems like `_static` dir is not found.
Attempt a fix according to:
readthedocs/readthedocs.org#1776 (comment)
wangenau added a commit to wangenau/variational_mesh that referenced this issue Dec 2, 2020
* This may fixes the build warning
* Also this may happen in the future:
readthedocs/readthedocs.org#1776 (comment)
wangenau added a commit to wangenau/variational_mesh that referenced this issue Dec 2, 2020
* This may fixes the build warning
* Also this may happen in the future:
readthedocs/readthedocs.org#1776 (comment)
osharaki added a commit to osharaki/travel_regions that referenced this issue Dec 18, 2020
This was causing the following warning:
`WARNING: html_static_path entry '_static' does not exist`
Removed since it gets added by default
See readthedocs/readthedocs.org#1776 (comment)
MisanthropicBit added a commit to MisanthropicBit/colorise that referenced this issue Jan 21, 2021
It is not needed since we have no static assets and results in a warning
on GitHub Actions: "WARNING: html_static_path entry '_static' does not exist"

See readthedocs/readthedocs.org#1776 (comment)
miguelgrinberg pushed a commit to miguelgrinberg/Flask-Migrate that referenced this issue Mar 24, 2021
Sphinx issues a warning, when the `html_static_path` contains paths with
underscores.

`tox -e docs` resulted in the following warning:
"WARNING: html_static_path entry '_static' does not exist"

As `_static` is the default value for `html_static_path` there is no
need to configure it explicitly.

Also see readthedocs/readthedocs.org#1776

An alternative approach would have been to set the path to e.g.
`static`.
ppecheux added a commit to ppecheux/url-hostname that referenced this issue Mar 30, 2021
8563a236e65cede7b14220e65c70ad5718144a3 added a commit to 8563a236e65cede7b14220e65c70ad5718144a3/algos that referenced this issue Aug 14, 2021
Why: Something on read the docs end

How: Remove _static from conf.py

See: readthedocs/readthedocs.org#1776

Tags: continuous integration documentation
jcameron73 added a commit to jpmorganchase/py-avro-schema that referenced this issue Jun 17, 2022
Alex-JG3 added a commit to Alex-JG3/notes that referenced this issue Sep 25, 2022
This is done to stop the warning related to html_static_paths when
running `make html`. See
readthedocs/readthedocs.org#1776.
masonw11 added a commit to Aalawfi/TI-FI-docs that referenced this issue Dec 2, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Support Support question
Projects
None yet
Development

No branches or pull requests

7 participants