2016-10-18 20 views
0

私はasciidoctorを使用して基本的なドキュメントサイトを構築しようとしています。私が苦労していることの1つは、標準のサイトヘッダー(ロゴとトップレベルのナビゲーションを持つバナー)を各ドキュメントページに挿入する方法です。asciidocドキュメントにサイトナビゲーションを含む汎用ページヘッダを追加するにはどうすればよいですか?

コマンドラインから私のasciidocをhtmlに直接レンダリングします。私は何とか余分なdiv要素を挿入し、それを一番上に固定する方法を見つけようとしましたが、これにどのようなメカニズムを使用するのか分かりません。私の初期の試みはdocinfo.htmlを使用していましたが、<body>の代わりに<head>要素のhtmlに注入されます。

ジキルのようなフル・パブリケーション・システムでは、おそらくこれを扱うことができる「フロント・マター」を構成できますが、これを達成するためのバニラ・アスキイドクターターを使用する仕組みやトリックがあることを期待していました。

答えて

1

メーリングリストmentioned単純なプロジェクトのテッドBergeron氏:ちょうどAsciidoctorを使用して作成さ

Demo website

corresponding repoを確認してファイルを確認し、サイトを作成する方法(コマンドを1つだけ使用する方法)を確認してください。要約すると

:単純に、(デモサイトでは、これはテーブルマークアップを使用して行われる)レベル0(文書)タイトルを含むなしをあなたのサイトのナビゲーションを含むヘッダのasciidocファイルを作成します。サイトの各ページの上部にこのヘッダーファイルを含めます。プロジェクトでasciidoctor *.txtを実行してレンダリングします。

関連する問題