HonKitのよくある質問
このページではHonKitのフォーマットやツールチェーンに関するよくある質問とその回答をまとめています。
ブックのホスト/出版はどのようにすればよいですか?
GitHub PagesやNetlifyへのパブリッシュなど。
プラグインを再読み込みしない?
HonKitはデフォルトでテキストコンテンツファイルごとにファイルキャッシュを使用します。
このファイルキャッシュは、ファイルの変更をチェックし、自動的に再読み込みを行います。 プラグインの変更を検知できない場合があります。
もし、強制的に更新したい場合は、--reload
フラグを使用してください。
$ honkit build --reload
HonKitはRTL/双方向のテキストをサポートしていますか?
HonKitのフォーマットは、右から左への双方向の書き込みをサポートしています。これを有効にするには、言語(例:ar
)を指定するか、book.json
でRTLを使用するようにHonKitを強制する必要があります。
{
"language": "ar",
"direction": "rtl"
}
HonKitのバージョン3.0では、内容に応じて自動的に検出されるようになっています。 出力される本は確かにRTLを尊重しますが、エディタはまだRTLの書き込みをサポートしていないことに注意してください。
リンクの拡張子は .html
と .md
のどちらを使用すればよいですか?
ファイルへのリンクには常にパスと .md
拡張子を使用する必要があります。HonKit は目次でポインティングファイルが参照されるときに、これらのパスを自動的に適切なリンクに置き換えます。
リポジトリのサブディレクトリにHonKitを作成することはできますか?
HonKitはサブディレクトリに作成することができます。
HonKitはRTL言語に対応していますか?
はい、HonKitはページ内の方向(rtl
またはltr
)を自動的に検出し、それに応じてレイアウトを調整します。また、book.jsonでグローバルに向きを指定することもできます。
HonKitはMath equationに対応していますか?
HonKitはプラグインによって数式やTeXをサポートしています。現在、数式を表示するための公式プラグインは2つあります。mathjaxとkatexです。
出力のカスタマイズやテーマは可能ですか?
はい、テーマを使って、ウェブサイトと電子書籍の両方の出力をカスタマイズすることができます。
インタラクティブなコンテンツ(動画など)を追加することはできますか?
HonKitは非常に拡張性に富んでいます。既存のプラグインを使うこともできますし、自分で作ることもできます!