devdocs icon indicating copy to clipboard operation
devdocs copied to clipboard

Offline Docs & Portable Browsers

Open TCB13 opened this issue 4 years ago • 4 comments

Hello,

I've been using the website for some time, it's a great resource but unfortunately I currently have to deal with an air-gapped machine.

The offline docs would be a solution however modern browsers like Chrome and Firefox seem to tie the local storage data to your computer in some way. I tried both Firefox and Chrome and if I download the docs I need (in a computer without internet) and then move the portable browser to the air grapped machine the docs aren't there. If I move the browser back to the first computer the docs are there and work.

The same issue sames to apply to the desktop app available in some other repository, if I download the docs they won't show up in other machines.

Any tips? Anyone has dealt with a situation like this? Thank you.

TCB13 avatar Apr 10 '20 19:04 TCB13

You could clone this repository onto your (non-airgapped) computer, run bundle install --standalone, then run bundle exec thor docs:download doc-name in the terminal (where doc-name is the doc you want to download; repeat for each doc). You can then move the cloned directory over to the airgapped machine, run bundle exec rackup, and visit localhost:9292.

j-f1 avatar Apr 10 '20 20:04 j-f1

@j-f1 That is a possible solution however it requires ruby and bundler installed on the airgapped machine, I was looking for something more self contained. Even an HTML dump of all pages would work.

TCB13 avatar Apr 10 '20 21:04 TCB13

You can download .tar.gz bundles from http://dl.devdocs.io/<name>.tar.gz or http://dl.devdocs.io/<name>~version.tar.gz, although they don’t include the actual DevDocs CSS so they don’t look very nice.

j-f1 avatar Apr 14 '20 15:04 j-f1

Well it seems to work. Some minor tweaks into a nginx server and I can get the links to work between pages :D

I'm presuming http://dl.devdocs.io/<name>.tar.gz always gives the lastest version, am I right?

TCB13 avatar Apr 14 '20 17:04 TCB13