Dash – Beautiful instant offline docs for almost everything
kapeli.com
kapeli.com
Possibly Zeal's search just isn't as good yet, but I had a heck of a time finding things about Python which are trivial to locate on the website through Google.
Speaking of: http://zealdocs.org/download.html
Dash-docs for Linux, PPA for Ubuntu/Mint available! It uses the exact same documentation sets and supports downloading in app.
[1] http://blog.pythonaro.com/2014/06/dash-docset-for-python-221...
But, it seems like Dash includes the JDK, so how exactly are they able to do it but not DevDocs? My knowledge on the legal front is limited but if Dash is able to redistributed these docs I don't see why DevDocs couldn't do it.
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means.
DevDocs is just a hobby of mine and I don't want to waste my time on a documentation that I may have to remove. If Oracle is willing to grant DevDocs a license (I haven't asked them) I'd gladly add the JDK docs to it.The icon has changed since then as well.
I guess I'm OK with the situation now and I shall use Dash without guilt (if it turns out to be useful, buying the Alfred Powerpack now I think).
They should just throw out the baby and the bathwater and start fresh.
I can't believe this hasn't come up before - we had a big discussion about working offline on cruise ships and it wasn't mentioned. [1]
For those of you on OSX, the integration with Alfred[0] is also stellar.
They work in linux and windows.
BIAS ALERT: I'm coauthor of the plugin.
Indeed, comments in HN aggregate a wiiide range of signal/noise. Great case of study.
Certanly a great investment.
I make a lot of my own docsets as well (i.e., ones for GLFW 3, Gambit Scheme, JeroMQ, and so on), since kapeli was hesitant in the past to add docsets that would be only of interest to really narrow groups of people, though it looks like the user docset thing on GitHub sort of fixes that. Either way, it not being closed off to outside docsets was nice, since I imagine it would've been easy to not allow it.
Anyway, glad to see it on HN since I'm a huge fan of Dash after using it for years. Sort of a shame it's Mac-only, since I keep looking around for ways to jump to Linux, but it looks like there're some open source alternatives. So, yeah, Dash was probably the best $30 I spent back in 2012.
Great product, it just doesn't fit into my routine.
Perhaps the author should integrate web search for the best of both worlds when available.
I would pay and use it immediately if I could access all versions (for example, Django 1.0 thru 1.7 etc)
If it's possible, can you make available all Django versions, from 1.0 onwards? Too much work? Perhaps just 1.x.latest?
Take your time with other versions, it's not like it's urgent.
Once again thanks for great work.
Also as a little side note, I thought the way it handled the UI for tabs was interesting, though it does leave little room to grab the window and drag when you've got a few open.
Oh, that's nice! I've had Dash for a couple of years now and love it, but it would be very nice to have it open on my iPad while I develop on my mac! Awesome!
[0] http://zealdocs.org/ [1] http://dash-port.launchrock.com/
[0] - http://kivy.org
BTW, Zeal's original author here - thanks for mentioning Zeal and good luck with your project!
As some personal advice, I wouldn't try Kivy for such content-oriented desktop app. I've tried briefly using it once for doing a very simple application, but it seemed much harder to implement usual desktop-like widgets. Overall it looks like it's good for graphics-rich and custom-rendered applications.
You'll also need some HTML rendering engine for docsets. While there are Kivy projects like https://github.com/kivy-garden/garden.cefpython or https://github.com/kivy/kivy-berkelium aiming to provide exactly that, they don't seem very mature.
However, I don't claim to be Kivy expert at all, and maybe you'll have good experience with it.
I love to travel and specifically I love to travel to places that dont have wifi. Often times I take fly fishing trips to Montana, or shorter trips to the Smokey Mountains and during these times I need to be able to work an entire day without internet and Dash is the only reason I can do this effectively.
Dash + Alfred + Sublime are probably my most used tools in any given day (aside from Spotify which is rarely ever turned off)
Here is the dash-feed: dash-feed://http%3A%2F%2Fspeedata.github.io%2Fpublisher%2Fspeedata_Publisher_(en).xml
[1] https://github.com/speedata/publisher/blob/develop/bin/creat...
The advantages of searching document's offline really can't be emphasized enough, 'hotkey - search term - answer', all provided in a floating window that doesn't interrupt the programmers workspace.
(subtle feature request: subcategories for the underscore docset, or headers/sections in the method listing)
For a clojure programmer having clojuredocs docset is also a must (https://github.com/dlokesh/clojuredocs-docset) although I think this is unofficial.
Would be willing to pay even more if it integrated well with ReadTheDocs — there are tons of (not only) Python docs living there which I need regularly.
And yes, I know #662 exists [1] on the RTD side and the future is not so clear.
My only wish is that someday I could get Intel's x86 manuals and ARM Cortex M0 and M4 instruction set documentation in Dash.
A small wishlist:
- ClojureDocs: http://clojuredocs.org/
- Hoogle integration: http://www.haskell.org/hoogle/
- BroPages: http://bropages.org/
My one request. I wish that I could take my own HTML docs (WiiU Dev stuff, as example) and my own PDF's and get them into DASH for searching.
I have a fair amount of documentation in HTML that I would love to have all in one place along with the Docsets I use daily.
It's got examples for
1. AppleDoc (Objective-C Source Files)
2. Python, Sphinx or PyDoctor-Generated Documentation
3. Javadoc-Generated Documentation
4. RDoc or Yard-Generated Documentation
5. Scaladoc-Generated Documentation
6. Doxygen (Source Files: C, C++, C#, PHP, Objective-C, Java, Python)
7. Any HTML Documentation
I would like to see a utility that would collect (readability-ified) urls and package them nicely for Dash/Zeal. This would make it easy to build an ultra-custom collection of useful info - a searchable offline bookmarking tool. Best of all would be something that knew how to periodically refresh this archive.
Also, these tools should include a timeline tracking what was useful so that as I return to projects/problems I can scroll back and pick up where I left off.
My only wish is that it would let me use a 'night mode' so I can use white text on dark background at night.
Kudos HN, for bringing this app into the limelight!
Good stuff!
But for some reason that even I don't really know, I stopped using it. I just checked the App Store on this computer, and it says Install, not Buy, which means I already paid for it long ago, and could have been using it this whole time. If only the developers could figure out why I stopped, they could probably make a lot more money.
That said, I do still see an App Store notification pop up every once in a while saying Dash needs to be updated, and it is pretty annoying how often that happens compared to any other app.
Easily worth the 19.99 price. Thanks.
Dash needs better fuzzy searching.
I know they're expensive (though a low-end macbook air is pretty reasonably priced) but I've found it well worth the money given it's what I spend almost every waking hour in front of.
And with decent enough hardware Linux runs very nicely under a virtual machine when you need it.
Following this logic, should I have bought a latest Windows PC to run the program or two I run under Wine?
Why would I want to do everything inside of a Linux virtual machine, as opposed to natively?
If it's only for one app, no.
I just personally find the mac platform in general to offer a better user experience, esp. with regards to not having to waste hours getting stuff to work.
This is just my personal experience; if Linux works for you then great.
In my very limited encounters with OS X's desktop environment, I didn't find it practical, and the proposition is: take it or leave it, right? Changes to the default desktop environment are as outlawed as they are in Windows, or aren't they?
I use slate + pckeyboardhack + keyremap4mac to control my windows via keyboard. Instead of using multiple monitors I switched to a single larger one which is easier to control.
I guess my point is that you can kind of change things, but you might need to compromise in some areas. I don't know of a way to get multiple desktops, for example, but I can switch between apps by binding keys to names of them and get around that way.
It's also going to be hard to try these sorts of things out in the store, and given how expensive the devices are it's difficult to justify given you may end up with an expensive tool you don't want to use.
YMMV, of course.
I am wondering why you went with a native app as opposed to something webbased though?
I looked at the page and it wasn't immediately obvious to me what it was.
Dash is... an app? a site? a collation of data?
If I'd hit the front page to something like:
> DASH
> An application for browsing API documentation sets
I'd know what was going on immediately.
you thought perhaps my comment was a complaint, an angry statement, this couldn't be further from the truth. In actuality I was just reflecting on how good signposting (through pertinent language and UI) helps people interpret meaning on websites.
If you design your website so that your potential users/customers cant look at the front page and have an instant grasp of what your product is, then your website is failing to do its job.
Again I say, people shouldn't have to infer what something is by association. Saying "what is this? oh look, there's an appstore link, it must be an app" is not the right way to tell people what you've made. Unambiguous and engaging language is.
Didn't expect a mac only app to make it to the front of HN.
Must be really good I don't use a Mac though.
Edit: Mac fan-boys stop down voting me just because you disagree with my choice of OS.
Also, you were terse so that there isn't much content in your comment. As always, ask yourself if your comment is worth the time for people to read. Cheers.
Ok, I guess the target audience would in 99% _guess_ what Dash is, but that still doesn't mean that it shouldn't be written somewhere clearly.
When I'm at the cottage (no internet) I can still use the keyboard shortcut from my editor to instantly pop up the docs for something.