私はasciidoctorを使用して基本的なドキュメントサイトを構築しようとしています。私が苦労していることの1つは、標準のサイトヘッダー(ロゴとトップレベルのナビゲーションを持つバナー)を各ドキュメントページに挿入する方法です。asciidocドキュメントにサイトナビゲーションを含む汎用ページヘッダを追加するにはどうすればよいですか?
コマンドラインから私のasciidocをhtmlに直接レンダリングします。私は何とか余分なdiv
要素を挿入し、それを一番上に固定する方法を見つけようとしましたが、これにどのようなメカニズムを使用するのか分かりません。私の初期の試みはdocinfo.html
を使用していましたが、<body>
の代わりに<head>
要素のhtmlに注入されます。
ジキルのようなフル・パブリケーション・システムでは、おそらくこれを扱うことができる「フロント・マター」を構成できますが、これを達成するためのバニラ・アスキイドクターターを使用する仕組みやトリックがあることを期待していました。