Documented docsets formats in README

This commit is contained in:
Jerzy Kozera 2013-02-10 20:00:17 +01:00
parent 1ef3c77fb6
commit b4fe3045fb

View File

@ -45,6 +45,15 @@ A 64-bit Windows binary with all dependencies is available to download from Drop
* More docsets * More docsets
* Refactoring to reuse common code between `ZealDocsetsRegistry` and `ZealListModel` * Refactoring to reuse common code between `ZealDocsetsRegistry` and `ZealListModel`
## Creating your own docsets
For creating new docsets, you have three choices of index format supported by Zeal.
1. `ZEAL` format, as generated by scripts in `gendocsets` directory. It's essentially a single sqlite table with `type`, `name`, `path` and `parent` columns.
2. `DASH` format, which is also similar single table, without the `parent` column.
3. So-called `ZDASH`, which is a more complex Xcode docset format, implemented in Zeal to allow reusing Dash's docsets.
Author of Dash [has suggested](https://github.com/jkozera/zeal/issues/1#issuecomment-13357189) a "docset exchange programme", allowing Zeal to use one Dash docset in return for each new generated-for-Zeal docset, so it's recommended to use the `DASH` format.
## Contributions ## Contributions