Q: how to avoid to generate entries point to not exists file.

[tshu-w]

Hi, I'm trying to use doc2dash to generate scikit-learn doc for dash https://github.com/Kapeli/Dash-User-Contributions/pull/3805 https://github.com/Kapeli/Dash-User-Contributions/pull/3812. However, the ci complains about File not found:

Scikit/scikit-learn.tgz: FAIL ❌
File not found at "genindex.html" for entry with row id "3058" of "scikit-learn.docset"
File not found at "py-modindex.html" for entry with row id "3222" of "scikit-learn.docset"
File not found at "py-modindex.html" for entry with row id "3327" of "scikit-learn.docset"
[NOTICE] Some pages loaded online resources, which might mean the docset doesn't work offline.

I am asking for advice on how to solve this problem, here are the commands I tried:

# download scikit-learn docs directly
wget https://scikit-learn.org/stable/_downloads/scikit-learn-docs.zip
unzip -d scikit-learn-docs scikit-learn-docs.zip

# convert to dash
doc2dash --index-page documentation.html --enable-js -n scikit-learn scikit-learn-docs
tar --exclude='.DS_Store' -czvf scikit-learn.tgz scikit-learn.docset

[hynek]

Unfortunately downloading built docs from ReadTheDocs etc doesn't work for the reasons you're saying. For some reason it's missing files.

You have to download the repo and build the docs yourself. :(

[tshu-w]

Yes, so I also tried to build the docs myself in this PR but also facing this issue: https://github.com/tshu-w/Dash-User-Contributions/blob/0efe2f5ef9aa3b05f39e1fc2d474b4df2ea8c880/docsets/Scikit/build.sh#L37-L47

[hynek]

I'm sorry, but I don't see an issue?

[tshu-w]

Hi, my question is that in this PR, even if I build the docs myself, github-actions still complain about file not found. It would be much appreciated if you could help to check where the problem is.

[hynek]

I see!

This is probably related to #115, but I guess I'll have to fix it broader.

I believe I've fixed it in https://github.com/hynek/doc2dash/commit/c3593ac9b9e9e806094dfc89b2bb139dfd79277f – any chance you could try it out? I'm not sure when I'll be able to push out a new release. :-/

[tshu-w]

Hi @hynek, It works now https://github.com/Kapeli/Dash-User-Contributions/pull/3871! Thank you for your efforts.

[hynek]

Great, happy to see scikit-learn docsets!

[hynek]

JFTR, I've released doc2dash 3 yesterday, so please use the PyPI version again...I can't guarantee the main branch to remain stable and it could break your builds.