問題タブ [asciidoctor]

Spring Rest Docs を Spring Boot アプリケーションに含めようとしており、アプリケーション ルート '/' へのリクエスト パスを示す単純な asciidoc HTML ファイルを生成することができました。問題は、スニペットのリクエスト URL にアプリケーション名が含まれていないことですか? たとえば、私のアプリケーションは「myservice」と呼ばれているので、ルート「/」リクエストパスを次のように文書化したいと思います

$ curl ' http://localhost:8080/myservice/ '

代わりに、生成することしかできません

$ curl ' http://localhost:8080/ '

Spring Rest Docs は初めてで、文書化された URL にアプリケーション名を含める方法がわかりません。asccidoctor の Maven プラグイン、テスト クラスの @before または @Test メソッド、または「include」タグの一部として .adoc ファイルに設定されていますか?

Asciidoctor は次の行を適切にレンダリングします。

このようにハードブレイクを入れると、

2 行目はまったくレンダリングされません。

どうすればこれを解決できますか?

アップデート

これまでのところ、先頭の 1 つのスペースが必要な作業を行っていることがわかりました。これが望ましい効果かどうかはわかりません。

Spring Rest ドキュメントの使用中に発生した問題を解決してください。Springマニュアルから必要なすべての設定を行いました。Spring MVC テストを書きました。これがコードです。奇妙な記号はロシア語です。

問題は、IDE (Intellij IDEA) からこのテストを開始すると、正常に動作し、すべてのスニペットが生成されることです。しかし、Maven の「パッケージ」タスク テストを実行すると、結果が表示されて失敗します。

問題がフィールドの説明にあることを確認しました。このパーツ パッケージのゴールを削除すると、正常に実行されます。

私のプロジェクトとすべての出力ファイルのエンコーディングは UTF-8 です。Mavenでは明示的に指定しました

ヘルプやアイデアをいただければ幸いです。

PlantUML は Asciidoc の優れた拡張機能ですが、グルーヴィーなコードからは使い方がわかりません。

私が見る限り、asciidoctorj-diaramモジュールは現在のリリースの一部であるasciidoctorj必要があるため、追加の依存関係は必要ないと思います。しかし、asciidoc を正常にレンダリングする私のコードは、PlantUML ダイアグラムをレンダリングしません。それは言います：

何が間違っている可能性がありますか？ネットで見つけたasciidoctorj-diagram例はすべてgradle-pluginを使用しています:-|

http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/を参照し、「コード ブロックとコールアウト」ページで検索し、「結果を表示」をクリックします。しかし、私は執筆に Ipython ノートブックを使用しており、Markdown を選択しています。(Ipython Notebook で "Raw NBconvert" を介して Asciidoctor を試してみましたが、結果は乱雑でした。)とにかく、Asciidoctor からのソース コード コールアウトだけが必要なようです。私の質問は、Markdown から同様の結果を得る方法です。

開発者ガイドの pdfをカスタマイズして、見栄えの良い最初のページを作成しようとしています。ここでasciidocの能力はかなり制限されているように見えるので、私はPhotoshopですべてをイメージとして行うことにまったく問題ありません。

残念ながら、どこを見ても、カバーシートをカスタマイズしたり、asciidoctor-fopub で機能する画像に置き換えたりする方法が 1 つも見つからないようです。

厄介なことに、この使用例はプロジェクトの readme https://github.com/asciidoctor/asciidoctor-fopub (カスタム XSL テンプレートの下) で具体的に言及されていますが、実際にそれを行う方法については言及されていません。その XSL にあります」。docbook に精通していない私には、どこから始めればよいかわかりません。

asciidoctor-pdf画像を含めるためのタグがありますが、ドキュメントにバーフがあり、ゴミが生成されます (ToC はすべての上に描画されます)。