問題タブ [asciidoc]
For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.
asciidoc - AsciiDoctor を使用してカスタム クラスの HTML 分割を作成するにはどうすればよいですか?
私は AsciiDoctor から始めており、HTML を出力したいと考えています。部門でカスタム クラスを作成する方法を理解しようとしてきましたが、Google やマニュアルなどを検索しましたが、解決策が見つかりませんでした。私がやりたいことは、単に次のようなものを書くことです：
Type the word [userinput]#asciidoc# into the search bar.
HTMLを生成するもの
<span class="userinput">asciidoc</span>
しかし、スパンの代わりにdivタグが必要です。それを行う方法はありますか、それとも次のようなものを使用する必要があります
+++<div class="userinput">asciidoc</span>+++か?
asciidoc - AsciiDoc を使用して、ヘッダーの前に余分なキャリッジ リターンの空白を強制する方法は?
見出しの前、つまり定義項目の後に適切なスペースが表示されないという問題があります。（ここに写真を載せることはできないと思います。）
ここに asciidoc の一部があります。「== してはいけないこと」は見出しですが、前のテキストの横に押しつぶされています。誰かが私のバグや修正を見ていますか? どうもありがとう！
asciidoc - 変数を外部 asciidoc ドキュメントに分割するにはどうすればよいですか?
asciidoctor を使って本を書いています。書類はこんな感じ。
book.asciidoc
chapter01.asciidoc
それはうまくレンダリングされ、結果はよく見えます。
今、私はatom-asciidoc-previewと共にAtomを使用しようとしています。問題は、atom-asciidoc-previewが変数を適切に置換できないように見えることです。
私はこれを試します。
変数.asciidoc
chapter01.asciidoc
運がない。どうすればこの問題を解決できますか?
asciidoc - 複数の翻訳に適した Asciidoc のイディオムは何ですか?
最初から英語と北京語の複数の翻訳が必要な記事があります。2 つのドキュメントを使用して一方を他方にリンクするか、一方を他方に配置して最初にそれぞれにリンクを追加することができます。
これを処理するよりエレガントな方法はありますか? たとえば、最初に言語を選択し、インラインで選択できますか?
asciidoc - asciidoc でテンプレート ファイルにパラメーターを渡す
スプリング レスト ドキュメントを使用して asciidoc スニペットを生成しています。
生成されたスニペットをドキュメント ページに含めることができます。ただし、個別の adoc ファイルで各セクションの構造を 1 回定義し、インデックス ファイルにそれらのそれぞれに 1 行を追加したいと考えています。
現在、私のindex.adocファイルは次のようになっています。
むしろこうであってほしい
index.adoc
mytemplate.adoc
このようなことができる方法を知っている人はいますか？
asciidoc - asciidoctor でラベルを使用して要素を相互参照する
現在、asciidoctor を使用してドキュメントを作成しており、ドキュメント内の画像とセクションをリンクする必要があります。asciidoctor の相互参照がどのように機能するかを理解していますが、asciidoctor が :sectnums: 属性で生成する要素番号も表示するセクションや画像などの要素をリンクする方法があるかどうか疑問に思っていました。この例では、手動で入力しなくても、達成したいことがよくわかります。
asciidoc - 独自の asciidoc マクロを定義する方法
asciidoc/asciidoctor でマクロを定義するにはどうすればよいですか?
ドキュメントの多くの部分で繰り返しパターンを使用するので、同じものを何度も入力しないようにパラメーター化された置換を行いたいと考えています。
特に、次の asciidoc スニペットがあります。
そして、X と Y の代わりに異なるテキスト置換を使用して、ドキュメントのいくつかの部分に配置する必要があります。どうすればそれを実現できますか?
maven - Maven を使用してユーザー ガイド ドキュメントを作成する
私は、pdf および html 5 形式のドキュメントを変更するために、簡単に保守可能で見栄えの良いものを作成して構築する必要があります。ソース形式は編集しやすいものにする必要があります。この Maven プラグインは、私の会社の組織テーマ (フォント、色、画像など)、TOC 生成、異なるファイルへの章の分離、画像ファイルの統合、コード スニペットをドキュメントに簡単に挿入する方法をサポートする必要があります。私はMavenビルドを持っていますが、それを行うための現在の最善の決定は何ですか?
私は2つのオプションを調査していました：
- Doxia - 入力形式として md(markdown) を使用。WSWG md フリー エディターがあり、多くの前述の機能をサポートしています。そのアーティファクトには外部レポが必要です。
- Asciidoctor - asdcii doc を入力形式として使用します。フラグメントなどを使用したテンプレート化をサポートします。
このプラグインを使用する利点と欠点は何ですか? 他に良い解決策はありますか？
asciidoc - asciidoc がファイル リンクを実際のリンクに変換するのを防ぐ方法はありますか?
古い MS Word ドキュメントを新しい asciidoc 形式に手動で変換しています。
そうすることで、まだ回避できない問題に遭遇しました。
ファイル リンクの構文がどのように見えるべきかを読者に示したい例があります。
だから私は例としてこれを使用しました：
Asciidocはこの疑似リンクを実際のリンクにレンダリングし、asciidoc ドキュメントを html および pdf に変換する際に警告を表示します。
通常、リンクのレンダリングを防ぐために [source] 要素を使用するだけです。ただし、ファイル リンクはテーブルの一部です。
ファイル リンクのレンダリング/変換を防ぐ方法はありますか?