AsciiDocからChmの作成

Microsoft Compiled HTML Help(chm)は古い技術ですが、いまだに使用されています。
検索機能もあり、かなり便利と思っています。
AsciiDocからDocBook、DocBookからChmを作成する手順をまとめました。

ツールの使い方の説明が不十分です。時間があるときに追記します。

AsciiDocの作成

適当に作成してください。

作成したファイルは、this.adoc

AsciiDocからDocBookへの変換

asciidoctor -b docbook this.adoc

DocBookからChmの変換

docbook-xslの準備

docbook-xsl-1.79.1 のXSLTをダウンロードして任意のフォルダに配置

XSLTの作成

docbook_htmlhelp_chm.xsl

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version='1.0' xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:import href="file:///任意のフォルダ/docbook-xsl-1.79.1/htmlhelp/htmlhelp.xsl"/>
<xsl:output method="html" encoding="Shift_jis" indent="no"/>
<xsl:param name="l10n.gentext.default.language">ja</xsl:param>
<xsl:param name="l10n.gentext.language">ja</xsl:param>
<xsl:param name="chunk.first.sections">1</xsl:param>
<xsl:param name="chunk.section.depth">2</xsl:param>
<xsl:param name="base.dir">htmlout</xsl:param>
<xsl:param name="manifest.in.base.dir">1</xsl:param>
<xsl:param name="html.stylesheet">help.css</xsl:param>
<xsl:param name="htmlhelp.encoding">17</xsl:param>
</xsl:stylesheet>

パラメータの意味は、以下 DocBook のページを参照してください。
パラメータ

「任意のフォルダ」を絶対パスで指定します。
help.cssは適当なものを用意してください。

DocBookからHTML Helpのソースへの変換

docbook_htmlhelp_chm.xslを使用して、お好きなXSLTプロセッサで、this.xmlを変換します。
上記XSLTを使用すると、フォルダhtmloutに出力されます。

HTML Helpのソースから htmlhelp.chmへの変換

フォルダhtmloutのhtmlhelp.hhpをHTML Help Workshop で開いて、コンパイルします。

htmlhelp.chmが作成されます。