問題タブ [asciidoc]

私はマルチモジュール Maven プロジェクトを持っています。そのうちの 1 つはドキュメンテーション プロジェクトで、他のモジュールを使用するためのリファレンス ガイドを作成しています。asciidoctor-maven-plugin と一緒に Maven のサイト プラグインを使用して、The Maven Way に固執しようとしています。

<packaging>質問は、 pomの要素にどの値を使用すればよいですか? これは実際には jar やその他の組み込み型ではありません。その答えをグーグルで検索しても、どこにも行きません... :(

Maven は指定せずに<packaging>(デフォルトの を使用してjar) サイトを正常にビルドしますが、警告が表示されることに注意してください

この警告が表示されないようにします。

Markdown私は、ライブ プレビューを実演しているエディタの多くのデモに出くわしました。

http://daringfireball.net/projects/markdown/dingus

http://dillinger.io/

http://www.markitdown.net/markdown

http://epiceditor.com/

http://hallojs.org/demo/markdown/

しかし、検索してもあまり見つかりませんでしたAsciiDoc Editor live preview。

そのような機能の設定に関する記事に出くわしました。

http://asciidoctor.org/docs/editing-asciidoc-with-live-preview/

しかし、私は実際にいくつかのオンラインデモを行ったばかりですが、そこにはありますか?

asciidoc を使用して PDF ブックを作成したいと思います。タイトル ページには、タイトル、サブタイトル、画像を含める必要があります。これまでのところ、これを達成する方法に関するドキュメントは見つかりませんでした。

直感的に私は次のようなことをします

image:images/titelimage.png[width=400]しかし、これはサブタイトルとして追加するだけです。私が持ちたいのは次のようなものです

ascciidocでこれを行う方法はありますか? そうでない場合、これを取得するにはどうすればよいですか?

単語の先頭または末尾にアポストロフィを付けるにはどうすればよいですか? これは古いスタイルに必要です

'Tis

それ以外の

これは

または複数形の単語の末尾にあるアポストロフィ

引数'

もちろん、ただ入力することもできます

しかし、これはマークダウンを使用する目的に反します。

編集: のように、最初と最後に一重引用符を使用したインライン引用スタイルが定義されているようには思えません。

ストレッチしすぎてはいけませんか？

AsciiDoc .adoc ファイルを HTMLに変換し、そのために Gradle を使用したいと考えています。

私はGradleが初めてです。私はhttps://github.com/asciidoctor/asciidoctor-gradle-plugin を見つけbuild.gradleました.

私は 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。

This block of AsciiDoc will create a title and current revision information:

The docinfo_generator will extract this information from a comment block in an AsciiDoc-formatted document, then embed it in the docinfo.xml file:

While useful, the revision history won't be included in the asciidoc-generated HTML (it might be in the a2x-gerneated HTML, but I haven't tested this).

I would like to find a way to embed the entire revision history in a asciidoc-formatted document, then have it displayed (ideally) at the end of said document as a table.

Is this possible?