Hacker News Reader

Comment by qbasic_forever | Hacker News Reader

I wish it had a proper installable app. Relying on browser local storage is a nightmare since your browser will randomly and with no warning delete it all. The whole point of offline docs is that they're available... offline. On more than one occasion I've gone back to devdocs.io and everything I saved locally is wiped out, and of course I'm offline and just can't do anything.

Give me local HTML files I can stash in my filesystem. I actually just use wget to recursively archive entire documentation sites to local folders and serve them up with python's built in web browser. It's the only way to be sure I have accurate and up to date offline docs.

View on HN

Give me local HTML files I can stash in my filesystem.

Apparently devdocs does have an API to download docsets. I just installed the Emacs package that someone recommended in another thread and it let me download the docs.

which package please?

Sign me onto this same worry. It only takes one incident of offline mode borking to get upset.

Since the devdocs representation is so standardized, I have wondered if I could dump their database into SQLite and browse it with datasette. Should even be able to maintain text searching.

Could you elaborate ? What is datasette ?

Is the Zeal code open source enough that one could change the backend by replacing a small number of data access subroutines?

I think all you would need to change is setter code, since getter code wouldn’t be part of the interface. I think Zeal doesn’t write back any data, right ?

Not experienced with Zeal, but I have used devdocs, which is open source. Devdocs parses the relevant documentation pages and stores them in a more structured way inside a browser database file. I would prefer to keep that in a local SQLite file I fully control. However, storing the data is not enough, I need an easy way to search and browse the documentation. Datasette is a Python project which spawns a web interface to a SQLite database which gives an interactive way to explore the data. This interface should be sufficient for locally hosting and searching the documentation.

>your browser will randomly and with no warning delete it all

With Chrome based browsers this seems to happen usually on browser restarts after version upgrades, however With Firefox I have never had such issue

There seems to be an Electron Desktop client: https://github.com/gengjiawen/electron-devdocs

I use this (https://github.com/astoff/devdocs.el) emacs package to download devdocs locally and access them from emacs, which is pretty great.

Is there no browser plugin that can give a more reliable offline browsing experience than browser cache and more convenient than wget?

Reply on news.ycombinator.com