hynek / doc2dash

Create docsets for Dash.app-compatible API browsers.

Home Page:https://doc2dash.hynek.me/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Can't convert Sphnix docset

AllanLRH opened this issue · comments

Hi, I can't figure out how to convert the latest version of the NetworkX docset (generated using sphnix): http://networkx.readthedocs.io/en/latest/

I downloaded the webpage using this: wget --recursive http://networkx.readthedocs.io/en/latest/

I tried converting using these commands, but all gives the same error…

~/temp/nx2dashdoc
(py35) ❯ doc2dash --name "Networkx2dev" networkx.readthedocs.io
"/Users/allan/temp/nx2dashdoc/networkx.readthedocs.io" does not contain a known documentation format.

~/temp/nx2dashdoc
(py35) ❯ doc2dash --name "Networkx2dev" networkx.readthedocs.io/en
"/Users/allan/temp/nx2dashdoc/networkx.readthedocs.io/en" does not contain a known documentation format.

~/temp/nx2dashdoc
(py35) ❯ doc2dash --name "Networkx2dev" networkx.readthedocs.io/en/latest
"/Users/allan/temp/nx2dashdoc/networkx.readthedocs.io/en/latest" does not contain a known documentation format.

What am I doing wrong?

Also, here's the top four levels of the directory tree:

(py35) ❯ tree -FL 4  # Only descend 4 levels down into the file tree
.
└── networkx.readthedocs.io/
    ├── en/
    │   ├── latest/
    │   │   ├── _images/
    │   │   ├── _modules/
    │   │   ├── _static/
    │   │   ├── bibliography.html
    │   │   ├── developer/
    │   │   ├── download.html
    │   │   ├── examples/
    │   │   ├── gallery.html
    │   │   ├── genindex.html
    │   │   ├── index.html
    │   │   ├── install.html
    │   │   ├── overview.html
    │   │   ├── py-modindex.html
    │   │   ├── reference/
    │   │   ├── search.html
    │   │   ├── test.html
    │   │   └── tutorial/
    │   ├── networkx-1.10/
    │   │   ├── _images/
    │   │   ├── _modules/
    │   │   ├── _static/
    │   │   ├── bibliography.html
    │   │   ├── developer/
    │   │   ├── download.html
    │   │   ├── gallery.html
    │   │   ├── genindex.html
    │   │   ├── index.html
    │   │   ├── install.html
    │   │   ├── overview.html
    │   │   ├── py-modindex.html
    │   │   ├── reference/
    │   │   ├── search.html
    │   │   ├── test.html
    │   │   └── tutorial/
    │   ├── networkx-1.11/
    │   │   ├── _images/
    │   │   ├── _modules/
    │   │   ├── _static/
    │   │   ├── bibliography.html
    │   │   ├── developer/
    │   │   ├── download.html
    │   │   ├── examples/
    │   │   ├── gallery.html
    │   │   ├── genindex.html
    │   │   ├── index.html
    │   │   ├── install.html
    │   │   ├── overview.html
    │   │   ├── py-modindex.html
    │   │   ├── reference/
    │   │   ├── search.html
    │   │   ├── test.html
    │   │   └── tutorial/
    │   └── stable/
    │       ├── _images/
    │       ├── _modules/
    │       ├── _static/
    │       ├── bibliography.html
    │       ├── developer/
    │       ├── download.html
    │       ├── examples/
    │       ├── gallery.html
    │       ├── genindex.html
    │       ├── index.html
    │       ├── install.html
    │       ├── overview.html
    │       ├── py-modindex.html
    │       ├── reference/
    │       ├── search.html
    │       ├── test.html
    │       └── tutorial/
    └── robots.txt

33 directories, 41 files

Sadly page dumps don't work for doc2dash. You need an actual build dir. IOW fetch the repo and build the docs yourself using Sphinx.