-
Notifications
You must be signed in to change notification settings - Fork 28
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
Third-party docs #4
Comments
At present, the dasht-docsets-install(1) script can only download docsets that Dash for OS X has kindly made available to us on its "Docset Direct Download Links" page. 🎅 I don't know if (or where) third-party docsets are made available to us in a similar fashion, but please do tell me if you happen to find out. 🔮
|
I've added a new |
The |
@eidge Were you able to get a setup you're happy with for importing and viewing Hexdocs in |
Hi there, Unfortunately I didn't, but to be honest I didn't take a big look. I use This would definitely unlock it though. Thanks for the good work! On Thursday, 1 September 2016, Eric Milford notifications@github.com
Hugo Ribeira Jack of All Trades at *intoCros http://intocross.coms |
Thanks. Downloading and extracting the docsets directly from hex.pm didn't work because of the directory structure format, sqlite, etc. required by dash. I've found that downloading the docsets via Dash and copying them to the dasht location works, as mentioned above. |
Could you provide an example URL of a hexdocs.pm docset package (tarball) so I can download it and debug why All I could gather from hexdocs.pm's homepage was that I could access a particular hex package's documentation online via a URL like this: |
Here's an example https://repo.hex.pm/docs/ecto-2.0.4.tar.gz There's a good chance I borked something when using |
👍 This tarball simply contains a bunch of HTML files at the root: there is no SQLite3 database at We need to transform this tarball, somehow, into a proper Dash docset to make it installable with |
I haven't had a chance to look at it or to give it a shot, but came across this which might help. |
👍 Considering the fact that hexdocset has runtime dependencies on Elixir and Erlang , it seems unlikely that Dash would come bundled with it to dynamically transform hexdocs.pm tarballs into proper Dash docsets during installation on the client side. 🍖 Instead, I believe that hexdocset is run internally by hexdocs.pm and the result is provided as a proper Dash docset to be downloaded directly into Dash for OS X. That way, Dash users are spared from having to satisfy special runtime dependencies just to install exotic docsets. 😰 An easy way to confirm this suspicion would be to run a network traffic analyzer while downloading a brand new hexdocs.pm docset into Dash for OS X. Find out what URL is actually being downloaded: it's likely not the same one that you provided in comment #4 (comment). 👀 Finally, repeat the experiment with other sources third of party docsets and share the results here. Of course, I could do all of this myself, except for the fact that I don't use Mac OS X at all. 🐧 |
Interesting, so Dash comes bundled with hexdocset? and it uses hexdocset to build an SQLite3 database out of the HTML files on the client side? 😲 |
Help Wanted: If anyone wants to try adding support for installing improper docsets (which don't contain a SQLite3 database at |
I am having an issue with getting the docsets from sub-folders. I have set the directory to this:
However, dasht does not detect .docsets files in subfolder. When i search for 'Dart' I get no result at all. after resetting the directory exactly where the .docsets files are, it seems to be working. like the following:
but this will only get the dart docs obviously and it is very inconvenient to move all .docsets files directly in the same folder directly. Any idea on how to properly set the DASHT_DOCSETS_DIR to look into subfolders ? Regards, |
@SultanEid, see issue #15 instead: 💁♂️ the request for adding support for subfolders is discussed there. |
Is there a way to use dasht to download kapeli's third party docs? Such as Hexdocs.pm?
I'm trying but with no success.
(Congrats anyway though, this is an excellent little app :) )
The text was updated successfully, but these errors were encountered: