問題タブ [asciidoc]

PDF および HTML ヘルプ生成をサポートしているため、現在、ソフトウェア プロジェクトの文書化にAsciiDocを使用しています。現在、 a2x ツールチェーンが適切に機能するように、Cygwin で実行しています。これは私にとってはうまくいきますが、他の Windows コンピューターでセットアップするのは面倒です。私は別の方法を探していて、最近 Sphinx を再訪しました。HTML ヘルプ ファイルが生成されるようになったので、試してみましたが、実行した小規模なテストではうまく機能するようです。

私の質問は、Windows プログラムが適切なヘルプ API を呼び出すことができ、ファイルが起動され、目的の場所に開かれるように、コンテキスト依存ヘルプのマップ ID をテキストで指定する方法はありますか?

AsciiDoc では を使用してpass::[<?dbhh topicname="_about" topicid="801"?>]います。これらの構造を使用することにより、context.hおよびが他の HTML ヘルプ ファイル (状況依存のヘルプ情報alias.h)と共に生成されます。

私が書いている gcc チートシートについて、gcc がさまざまなファイル末尾をどのように解釈するかを説明する表を作成したいと考えています。これまでに作成したテーブルは次のように定義されています。

私が抱えている問題は、テーブルがページ全体の幅にまたがっていることですが、私が望むのは、各列のみが最も広いエントリと同じ幅であり、テーブルが必要な幅だけ広がることです。

asciidoc ドキュメントを作成し、それを pdf ドキュメントに変換したいと考えています。ただし、デフォルトのものとは異なる書式スタイルを使用したいと考えています。そのために、asciidoc を使用して txt ファイルを docbook に変換し、dblatex を使用して結果の docbook xml を pdf ファイルに変換しようとします。アイデアは、dblatex に特定の tex スタイルを設定して、目的の pdf 結果を取得することです。ここでは小さなスタイル変更を行うことが推奨されているため、既存の docbook.sty スタイルをコピーしました。./docbook ファイルで行われた唯一の変更は、\setlength{\textwidth}{18cm} を \setlength{\textwidth}{12cm} に変更したことです。ただし、コマンドを実行すると

またはコマンド

どちらも、スタイルの変更で同じ結果 (なし) を生成します。つまり、./docbook.sty ファイルにどのような変更を加えても、これらの変更は出力に適用されません。私は常に同じ結果、デフォルトのフォーマットのpdfを取得します。どこに問題があるのか​​ わかりますか？

前もって感謝します。

AsciiDoc に次のマークアップがあります。

[[filter-example]] .フィルターは行列演算によって作成されます image::figs/filter_example.png[scaledwidth="90%"]

この画像で unfloat::[] マクロを使用したいのですが、その方法の例を見つけることができませんでした。誰か提案はありますか？

HTML をAsciiDocマークアップに変換する Python ツールを探しています。

ありがとう！

これが私の問題です。通常、私はasciidocドキュメントをHTML（より正確にはasciidoc-> docbook-> html）に変換しますが、ここではマークダウンドキュメントが与えられています。

そのマークダウンドキュメントから、asciidocからのものと同じように見えるHTMLドキュメントを作成できるようにしたいですか、それともこのマークダウンをasciidocに変換できるようにしたいですか？

AsciiDoc軽量マークアップ言語で書かれたマンページを Perl のPOD (Plain Old Documentation)に自動的に変換するには?

おそらく、DocBook から POD に変換するもの (AsciiDoc ソースからマンページ形式への変換、つまり troff は DocBook (XML 経由) 経由で行われます)。

テキストのレンダリングには asciidoc を使用します。

マクロを理解するのが難しい。私の目標は、単純なマクロ処理 (LaTeX のようなもの) を持つことです。2 つのマクロを書きたいと思います。

1. FOOに置き換える必要があります"bar"
2. MYTEXT(xyz)に置き換える必要があります: "This is my text xyz!"
   (おそらく、パラメーター 'xyz' を渡す別の方法を使用)

サンプル ファイル abc.txt:

これにより、

FOOandの定義はMYTEXTファイルに入れる必要があると思いますabc.conf。おそらくセクション[マクロ]に。

追加の質問:

とでFOO置き換える必要がある場合、パターン マッチングに問題はあり ますか?'bar'FOOX'barbar'

GitHub が、AsciiDoc の readme ファイルまたは wiki ページ内のコード ブロックで改行を保持することを拒否しているという問題に出くわしました。問題をグーグル検索すると、GitHub トラッカーにバグが発生し、適切な説明なしに問題が解決済みとしてマークされました。

GitHub で改行を保持するにはどうすればよいですか?

DocBook 形式の本は「モジュラー」方式で作成できることを考慮して、AsciiDoc で同様のことができ、章と第 1 レベルのセクションを別々のファイルに分割できることを望みました。残念ながら、ドキュメントはこれについて何も述べていません。これまでのところ唯一可能な解決策は、すべての「部分」ファイルをマージしてブックを生成する独自の AsciiDoc プリプロセッサを作成することです。誰かが今までにこの問題を解決しましたか?