問題タブ [asciidoctor]

私は AsciiDoc と ASciiDoctor を初めて使用することを認めなければなりません...

私が達成しようとしているのは、特定の AsciiDoc テンプレート ( https://github.com/masch70/arc42-template-asciidoc ) を groovy でレンダリングすることです。私の解決策は、jRuby で動作する AsciiDoc を書き直したように見える AsciiDoctor Java Interface を利用することです。これまでのところ、コードは正常に実行されます。

しかし、私にはかなり問題ないように見えるインクルードセクションを無視しているようです:

ファイルを含める代わりに、ファイルへのリンクがレンダリングされます。

AsciiDoctor のマニュアルには、インクルードがサポートされていると書かれています: http://asciidoctor.org/docs/user-manual/#include-directive。

CLI から AsciiDoctor を実行すると、スタイルシートが埋め込まれた HTML ドキュメントが作成されます。

ただし、Ruby ファイルで Asciidoctor を実行しても、次のことはできません。

ドキュメントは、違いがあるべきであることを示していません。私は何が欠けていますか？

詳細：

• アサイドクター 0.1.4
• ルビー 2.0.0p247

Windows で asciidoctor-maven-plugin を使用すると、ゴール プロセス asciidocs を排出するときにエンコーディングの非互換性エラーが発生します。

プラグインの 0.1.4 リリースと master の最新の SNAPSHOT を試しました。

asciidoctor gem で cruby を使用している場合、このエラーは発生しないため、問題は jruby 実行環境にあると考えられます。

Mac では、JAVA_TOOL_OPTIONS="-DFile=encoding.UTF-8" を設定することで同じエラーを解決しましたが、Windows では効果がありません。

jruby に UTF-8 の使用を強制するにはどうすればよいですか?

asciidoctorjを使ってID付きの外部リンクを作成したいと考えています。マニュアルのどこにもそれを行う方法が見つかりませんでした。

Asciidoctor 出典:

現在の結果:

期待される結果：

asciidoctor では、template_dir オプションを使用してカスタム テンプレートを提供できます。ドキュメンテーションは私がそれを始めるのに十分ではないようで、グーグルも助けにはなりません。

カスタム テンプレートが使用されている良い例を知っている人はいますか?

基本的に、このようなブロックをレンダリングしたいと思います

自分のスタイルで。デフォルトのスタイルの 1 つをコピーし、名前を変更して template_dir を指定しましたが、現在表示されるのは次のエラー メッセージだけです。invalid style for example block: custom

ここで説明されているガードファイルで asciidoc を使用しています。

asciidoctor オプションが与えられた場合:asciidoctor -a icons -a iconsdir /foo -a copycss bar.adocこれらのオプションをガード ファイルに追加したいと思います。しかし、方法がわかりません。

現在、ガード ファイルは次のようになっています。

Asciidoctor、Ruby、または gradle の経験はありません。私は、この 3 つすべてを使用する他の誰かによって開発されたプロジェクトを担当しています。コードにはAsciidoctor::HTML5::DocumentTemplateエラーをスローする関数があります

最近、Asciidoctor 1.5.0 にアップグレードしました。このプロジェクトをコンパイルしようとすると、次のエラー メッセージがスローされます。

108行目は次のとおりです。<%= ::Asciidoctor::HTML5::DocumentTemplate.outline(self, (attr :toclevels, 2).to_i) %>

私が見る限り、タイトルの前に ## タグが付いたファイルの目次が作成されます。

ここからどうすればいいですか？