このサイト（nju33.com）用の docset を作りました。2つの方法で使えます。<ol><li><a href=dash-feed://https%3A%2F%2Fnju33.com%2Fdash-feed%2Fnju33.com.xml>dash-feed</a>を単に開く</li><li>ローカルへソースをダウンロードしインストール</li></ol>2つ目の方法は<a href=https://github.com/nju33/nju33.com-docset>このリポジトリ</a>をクローンし、Preferences &gt; Docsets &gt; <code>+</code> &gt; Add Local Docset で、持ってきたリポジトリファイルの<code>nju33.docset/</code>ディレクトリを指定するだけです。<code>nju33</code>をキーワードとして使い、後に<code>&lt;note名&gt; [postタイトル]</code>のように続けることで記事を検索できます。（例: <code>nju33: typescript string</code>）良ければ使ってみてください！

nju33.com を Dash で読む

Docset は以下のようなディレクトリ構造になってます。<pre><code class=language-txt>&lt;name&gt;.docset/
├── Contents
│   ├── Resources
│   │   ├── Documents
│   │   └── docSet.dsidx
│   └── info.plist
├── icon.png
└── icon@2x.png
</code></pre>この中で重要なのが<ol><li>Documents</li><li>docSet.dsidx</li><li>info.plist</li></ol>です。<div class=n-md_h3-box><a href=#HTML_Docset_の作り方+Documents aria-label=Documentsのアンカー class=n-md_h3-anchor></a><h3 id=HTML_Docset_の作り方+Documents class=n-md_h3-heading>Documents</h3></div>この中にはHTMLファイルを格納します。Dash ではドキュメント（HTML）を開くと時に単に<code>Documents/</code>からのパスで開こうとします。HTMLファイルであれば何でもいいので静的サイトジェネレーターの選定は自由です。<div class=n-md_h3-box><a href=#HTML_Docset_の作り方+docSet.dsidx aria-label=docSet.dsidxのアンカー class=n-md_h3-anchor></a><h3 id=HTML_Docset_の作り方+docSet.dsidx class=n-md_h3-heading>docSet.dsidx</h3></div>索引する為のデータです。例えば「<code>typescript: interfaces</code>」と検索した時に「Interfaces」が出てくるのは、このファイルに「Interfaces の時はこのタイプでこの HTML ファイルね」と登録されている為です。これは Sqlite3 ファイルで作ります。Sqlite3 へは<code>sqlite3 docSet.dsidx</code>のように入り、<pre><code class=language-sql>CREATE TABLE searchIndex(id INTEGER PRIMARY KEY, name TEXT, type TEXT, path TEXT);
CREATE UNIQUE INDEX anchor ON searchIndex (name, type, path);
</code></pre>でテーブルを作った後、<pre><code class=language-sql>INSERT OR IGNORE INTO searchIndex(name, type, path) VALUES ('Interfaces', 'Guide', '/interfaces.html');
</code></pre>のような感じでデータを入れていきます。基本的はここはスクリプトを組んで実行する部分だと思います。<div class=n-md_h3-box><a href=#HTML_Docset_の作り方+info.plist aria-label=info.plistのアンカー class=n-md_h3-anchor></a><h3 id=HTML_Docset_の作り方+info.plist class=n-md_h3-heading>info.plist</h3></div>Dash でのメタ情報を設定します。例えば<code>typescript:</code>入力した時に、TypeScript Docset だけの検索モードになるのは、このファイルに「<code>typescript</code>をキーワードとして使ってね」のように記述されてる為です。基本的にこれは以下の<code>[nN]ame</code>を自分の環境に合わせて書き換えるだけでいいと思います。<pre><code class=language-html>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"&gt;
&lt;plist version="1.0"&gt;
&lt;dict&gt;
 &lt;key&gt;CFBundleIdentifier&lt;/key&gt;
 &lt;string&gt;name&lt;/string&gt;
 &lt;key&gt;CFBundleName&lt;/key&gt;
 &lt;string&gt;Name&lt;/string&gt;
 &lt;key&gt;DocSetPlatformFamily&lt;/key&gt;
 &lt;string&gt;name&lt;/string&gt;
 &lt;key&gt;isDashDocset&lt;/key&gt;
 &lt;true/&gt;
 &lt;key&gt;isJavaScriptEnabled&lt;/key&gt;
 &lt;true/&gt;
&lt;/dict&gt;
&lt;/plist&gt;
</code></pre><div class=n-md_h3-box><a href=#HTML_Docset_の作り方+アイコン aria-label=アイコンのアンカー class=n-md_h3-anchor></a><h3 id=HTML_Docset_の作り方+アイコン class=n-md_h3-heading>アイコン</h3></div>オプショナルですが<code>&lt;name&gt;.docset</code>直下に<code>icon.png</code>と<code>icon@2x.png</code>を置くとキーワードを入力した時にアイコンが付いて分かりやすくなります。<code>icon.png</code>は<code>16x16</code>、<code>icon@2x.png</code>は<code>32x32</code>のサイズでそれぞれ作成します。<div class=n-md_h3-box><a href=#HTML_Docset_の作り方+作った_Docset_を登録 aria-label="作った Docset を登録のアンカー" class=n-md_h3-anchor></a><h3 id=HTML_Docset_の作り方+作った_Docset_を登録 class=n-md_h3-heading>作った Docset を登録</h3></div>Preferences &gt; Docsets &gt; <code>+</code> &gt; Add Local Docset をクリックするとファインダーが開きます。ここで先程の<code>&lt;name&gt;.docset</code>を開けば登録されるはずです！<a href=https://github.com/nju33/boilerplate-dash>例</a>も参照してください。

HTML Docset の作り方

dash-feed を提供するとその URI リンクを開いただけで利用者が対象の Docset をインストールできるようになります。この dash-feed は XML で以下のように記述します。（このサイトのフィード）<pre><code class=language-xml>&lt;entry&gt;
 &lt;version&gt;1.0.0&lt;/version&gt;
 &lt;ios_version&gt;1&lt;/ios_version&gt;
 &lt;url&gt;https://github.com/nju33/nju33.com-docset/raw/master/nju33.tgz&lt;/url&gt;
&lt;/entry&gt;
</code></pre><code>version</code>と<code>ios_version</code>は最新のバージョンを置きます。Docset を更新する時は、このバージョンを上げる必要があります。（同じバージョンではアンインストール→インストールをしないと更新できませんでした。）<code>url</code>へは<code>&lt;name&gt;.docset</code>を<code>tgz</code>化したファイルへの URL を記載します。フィードを提供するには<code>dash-feed:</code>スキーマを使い、後に続けてフィードへのエンコードした URL を続けます。（このサイトの例: <code>dash-feedd://https%3A%2F%2Fnju33.com%2Fdash-feed%2Fnju33.com.xml</code>）注意点として最後の<code>&lt;name&gt;.xml</code>の<code>&lt;name&gt;</code>が Docsets 一覧の名前に使われるので<code>dash-feed.xml</code>のような名前ではなく、<code>&lt;name&gt;.docset</code>の<code>&lt;name&gt;</code>と同じものにするのがいいと思おいます。