doc2dash icon indicating copy to clipboard operation
doc2dash copied to clipboard

Is it possible to build a docset from a reStructuredText file directly?

Open deinspanjer opened this issue 4 years ago • 1 comments

I've used Dash for years, but have only dabbled in creating cheat sheets and such a couple of times.

Recently I've wanted to view docs for httpie inside Dash, so I tried to do some research on how to do so.

It feels like it should be fairly straightforward since the doc page seems to be based on the README.rst file in the github repo, but even though I read that reStructuredText is some core component of Sphynx, it doesn't seem like doc2dash is expecting or understanding a single .rst file.

If you could provide any tips on how I might go about setting this up, it would be greatly appreciated.

deinspanjer avatar Jan 25 '20 19:01 deinspanjer

A DocSet ist really just a bunch of HTML and index information. Sphinx has that information in a separate file which doc2dash reads. You can have a single file with no index of course, I believe there are simple examples at https://kapeli.com/docsets

hynek avatar Jan 26 '20 16:01 hynek