これは、Ubuntu Online、Fedora Online、Windowsオンラインエミュレーター、MACOSオンラインエミュレーターなどの複数の無料オンラインワークステーションの2つを使用してOnWorks無料ホスティングプロバイダーで実行できるコマンドaXNUMXxです。
プログラム:
NAME
a2x-AsciiDocのツールチェーンマネージャー(Asciidocテキストファイルを他のファイルに変換します
フォーマット)
SYNOPSIS
a2x [OPTIONS] ソースファイル
DESCRIPTION
AsciiDocテキストファイルを翻訳するDocBookツールチェーンマネージャー ソースファイル PDFに、
EPUB、DVI、PS、LaTeX、XHTML(単一ページまたはチャンク)、マニュアルページ、HTMLヘルプまたはプレーンテキスト
を使用したフォーマット アスキードック(1) およびその他のアプリケーション(「要件」セクションを参照)。 ソースファイル できる
拡張子が.xmlのDocBookファイルでもあります。
OPTIONS
-a、 - 属性=属性
作成セッションプロセスで アスキードック(1)属性値(のショートカット --asciidoc-opts="-a 属性" オプション)。
このオプションは複数回指定できます。
--asciidoc-opts=ASCIIDOC_OPTS
NEW アスキードック(1) オプション。 このオプションは複数回指定できます。
--conf ファイル=CONF_FILE
構成ファイルをロードします。 CONFファイルのセクションを参照してください。
-NS、 --宛先ディレクトリ=DESTINATION_DIR
出力ディレクトリ。 デフォルトは ソースファイル ディレクトリ。 このオプションは、
HTMLベースの出力形式(チャンク, EPUB, htmlヘルプ, xhtml).
-NS、 --doctype=DOCTYPE
DocBookドキュメントタイプ: 記事, マンページ or 本。 デフォルトのドキュメントタイプは 記事
フォーマットが マンページ (この場合、デフォルトで マンページ).
-NS、 --バックエンド=バックエンド
バックエンド インストールされているバックエンドプラグインの名前です。 このオプションを指定した場合 a2x
ファイル名をロードしようとします a2x-バックエンド.py バックエンド プラグインディレクトリそれから
変換します ソースファイル へ バックエンド グローバル関数を使用してフォーマットされた出力ファイル
で定義された a2x-バックエンド.py 呼ばれます to_BACKEND.
-NS、 - フォーマット=FORMAT
出力フォーマット: チャンク, ドックブック, dvi, EPUB, htmlヘルプ, マンページ, PDFファイル (デフォルト)、 ps,
テックス, 클라우드 기반 AI/ML및 고성능 컴퓨팅을 통한 디지털 트윈의 기초 – Edward Hsu, Rescale CPO 많은 엔지니어링 중심 기업에게 클라우드는 R&D디지털 전환의 첫 단계일 뿐입니다. 클라우드 자원을 활용해 엔지니어링 팀의 제약을 해결하는 단계를 넘어, 시뮬레이션 운영을 통합하고 최적화하며, 궁극적으로는 모델 기반의 협업과 의사 결정을 지원하여 신제품을 결정할 때 데이터 기반 엔지니어링을 적용하고자 합니다. Rescale은 이러한 혁신을 돕기 위해 컴퓨팅 추천 엔진, 통합 데이터 패브릭, 메타데이터 관리 등을 개발하고 있습니다. 이번 자리를 빌려 비즈니스 경쟁력 제고를 위한 디지털 트윈 및 디지털 스레드 전략 개발 방법에 대한 인사이트를 나누고자 합니다. , xhtml。 AsciiDoc a2x形式 属性値はに設定されます FORMAT.
-NS、 - 助けて
コマンドライン構文とプログラムオプションをstdoutに出力します。
-アイコン
出力ドキュメントで警告またはナビゲーションアイコンの画像を使用します。 デフォルトの動作は
アイコンの代わりにテキストを使用します。
--icons-dir=パス
警告アイコンとナビゲーションアイコンを含むパス(出力ファイルに対する相対パス)。 デフォルト
画像/アイコンに。 The -アイコン このオプションが使用される場合、オプションは暗黙的です。
-k、 --keep-アーティファクト
一時ビルドファイルは削除しないでください。
--オオヤマネコ
オオヤマネコ(1) テキスト形式の出力を生成します。 デフォルトの動作は次のとおりです。 w3m(1).
-L、 --no-xmlint
asciidocの出力をチェックしないでください xmlint(1).
--- epubcheck
EPUB出力を確認してください epubチェック(1).
-NS、 -ドライラン
何もしないでください。何が行われたかを印刷するだけです。
-NS、 - 資源=リソーススペック
リソースを指定します。 このオプションは複数回指定できます。 を参照してください 資料
詳細についてはセクションを参照してください。
-NS、 -リソースマニフェスト=FILE
FILE リストリソースが含まれています(XNUMX行にXNUMXつ)。 マニフェスト FILE エントリはフォーマットされます
と同じように - 資源 オプション引数。 環境変数とチルダホーム
ディレクトリは許可されます。
-スタイルシート=スタイルシート
スタイル設定に使用されるXNUMXつ以上のCSSスタイルシートファイル名のスペース区切りリスト
DocBookXSLスタイルシートによって生成されたHTML出力。 デフォルトは docbook-xsl.cssを選択します。
スタイルシートはリスト順に処理されます。 スタイルシートは有効な場所に存在する必要があります
リソースファイルの場所。 HTML形式に適用: xhtml, EPUB, チャンク, htmlヘルプ
フォーマット。
-v、 -詳細
運用の詳細をstderrに印刷します。 XNUMX番目 -v オプションは詳細オプションをに適用します
ツールチェーンコマンド。
- バージョン
プログラムバージョンをstdoutに出力します。
--xsltproc-opts=XSLTPROC_OPTS
NEW xsltproc(1) オプション。 このオプションは複数回指定できます。
--xsl-ファイル=XSL_FILE
組み込みのXSLスタイルシートをカスタムXSLスタイルシートで上書きする XSL_FILE.
--ホップ
FOPを使用してPDFを生成します。 デフォルトの動作は次のとおりです。 dblatex(1)を選択します。 --ホップ オプション
このオプションを使用する場合は暗黙的です。
--fop-opts=FOP_OPTS
NEW フォップ(1) オプション。 このオプションを指定すると、FOPを使用してPDFが生成されます。
このオプションは複数回指定できます。
--dblatex-opts=DBLATEX_OPTS
NEW dblatex(1) オプション。 このオプションは複数回指定できます。
--バックエンドオプト=BACKEND_OPTS
によって指定されたバックエンドプラグインのオプション --バックエンド オプション。 このオプションは
複数回指定しました。
オプションはAsciiDocソースファイルでも設定できます。 もしも ソースファイル コメントが含まれています
で始まる行 // a2x: その後、行の残りの部分は次のように扱われます a2x
コマンドラインオプション。 例えば:
// a2xのデフォルトオプション。
// a2x:-dbook --epubcheck
// dblatex出力のリビジョン履歴を抑制します。
// a2x:-dblatex-opts "-Platex.output.revhistory = 0"
・そのような複数のコメント行にまたがるオプションは連結されます。
・先頭の間にゼロ個以上の空白文字を表示できます // と a2x:.
・コマンドラインオプションは、ソースファイルで設定されたオプションよりも優先されます。
出力 ファイル
出力ファイルは、で指定されたディレクトリに書き込まれます。 --宛先ディレクトリ オプション。 いいえの場合
--宛先ディレクトリ オプションが設定されている出力ファイルはに書き込まれます ソースファイル ディレクトリにあります。
出力ファイルの名前は ソースファイル しかし、適切なファイル名で
拡張子:.html for xhtml; .epub 用 EPUB; .hhp 用 htmlヘルプ; .pdf PDFファイル; .text の
클라우드 기반 AI/ML및 고성능 컴퓨팅을 통한 디지털 트윈의 기초 – Edward Hsu, Rescale CPO 많은 엔지니어링 중심 기업에게 클라우드는 R&D디지털 전환의 첫 단계일 뿐입니다. 클라우드 자원을 활용해 엔지니어링 팀의 제약을 해결하는 단계를 넘어, 시뮬레이션 운영을 통합하고 최적화하며, 궁극적으로는 모델 기반의 협업과 의사 결정을 지원하여 신제품을 결정할 때 데이터 기반 엔지니어링을 적용하고자 합니다. Rescale은 이러한 혁신을 돕기 위해 컴퓨팅 추천 엔진, 통합 데이터 패브릭, 메타데이터 관리 등을 개발하고 있습니다. 이번 자리를 빌려 비즈니스 경쟁력 제고를 위한 디지털 트윈 및 디지털 스레드 전략 개발 방법에 대한 인사이트를 나누고자 합니다. 、.xml for ドックブック。 慣例により、マンページには.man拡張子はありません(マンページセクション
番号のみ)。 チャンクされたHTMLディレクトリ名の拡張子は.chunkedです。 チャンクされたHTMLヘルプ
ディレクトリ名の拡張子は.htmlhelpです。
同じ名前の既存のファイルが上書きされます。
HTMLファイルの生成に加えて、 xhtml, EPUB, チャンク と htmlヘルプ フォーマットは確実にします
リソースファイルは、正しい宛先ディレクトリの場所にコピーされます。
資料
リソースは、HTMLベースの出力に必要なファイル(通常はCSSと画像)です。
(xhtml, EPUB, チャンク, htmlヘルプ フォーマット)。 a2x 生成されたHTMLファイルをスキャンし、
必要なCSSおよび画像ファイルのリスト。 追加のリソースファイルを指定できます
明示的に使用する - 資源 オプションを選択します。
a2x 次の場所で次の順序でリソースファイルを検索します。
1。 ザ ソースファイル ディレクトリにあります。
2.によって指定されたリソースディレクトリ - 資源 オプション(再帰的に検索)。
3.によって指定されたリソースディレクトリ -リソースマニフェスト オプション(再帰的に検索
マニフェストファイルに表示される順序で)。
4.ストックイメージとスタイルシートのディレクトリ アスキードック(1) 構成ファイル
ディレクトリ(再帰的に検索)。
5.宛先ディレクトリ。
リソースファイルが見つかると、正しい相対的な宛先ディレクトリにコピーされます。
欠落している宛先サブディレクトリは自動的に作成されます。
追加のリソースを指定するためのXNUMXつの異なるメカニズムがあります。
1.不足しているリソースファイルを再帰的に検索するリソースディレクトリ。
2.出力先ディレクトリにコピーされるリソースファイル。
リソースはで指定されます - 資源 次のいずれかになり得るオプション値
フォーマット:
[= ]
。 =
どこ:
ディレクトリを指定します(絶対または相対 ソースファイル)検索されます
不足しているリソースファイルに対して再帰的に。 あいまいさを排除するために名前
ディレクトリ区切り文字で終了する必要があります。
リソースファイルを指定します(絶対または相対 ソースファイル) どっちが
にコピー。 もしも指定されていない場合は
と同じ。
コピーされたソースファイルの宛先を指定します。 ザパスは
宛先ディレクトリからの相対パス(絶対パスは許可されていません)。 場所
宛先ディレクトリの出力は出力によって異なります FORMAT (参照 出力 ファイル
詳細についてはセクション):
チャンク、htmlhelp
チャンク化された出力ディレクトリ。
EPUB
アーカイブされたOEBPSディレクトリ。
xhtml
出力 DESTINATION_DIR.
。 =
EPUBファイルにリソースを追加すると、mimetypeは
ファイル>拡張子、mimetypeを推測できない場合、エラーが発生します。 ザ
。 = リソース構文を使用して、mimetypeを明示的に設定できます。 は
ファイル名拡張子、 対応するMIMEタイプです。
リソースオプションの例:
-リソース../images/
-リソースdoc / README.txt = README.txt
- 資源 〜/ images / tiger.png= images / tiger.png
--resource .ttf = application / x-font-ttf
例
a2x -f pdf doc / source-highlight-filter.txt
doc /source-highlight-filter.pdfファイルを生成します。
a2x -f xhtml -D ../doc --icons -r ../images/team.txt
HTMLファイル../doc/team.htmlを作成し、警告アイコンを使用して、再帰的に検索します。
不足しているリソースの../images/ディレクトリ。
a2x-fマンページdoc / asciidoc.1.txt
doc /asciidoc.1のマンページを生成します。
必要条件
a2x 次のプログラムを使用します。
· アシドック: http://asciidoc.org/
· xsltproc:(テキストを除くすべての形式): http://xmlsoft.org/XSLT/
· DocBook XSL スタイルシート (テキストを除くすべての形式):
http://docbook.sourceforge.net/projects/xsl/
· dblatex (pdf、dvi、ps、tex形式): http://dblatex.sourceforge.net/
· FOP延長 (pdf形式—代替PDFファイルジェネレーター): http://xmlgraphics.apache.org/fop/
· w3m (テキスト形式): http://w3m.sourceforge.net/index.en.html
· オオヤマネコ (テキスト形式—代替テキストファイルジェネレーター): http://lynx.isc.org/
· epubチェック (epub形式— EPUBファイルバリデーター): http://code.google.com/p/epubcheck/
最新のREADMEファイルも参照してください。
確認 ファイル
構成ファイルには、グローバルをオーバーライドする実行可能なPythonコードが含まれています
a2x.pyの構成パラメーター。 オプションの構成ファイルは、
次の順序:
1.を含むディレクトリからのa2x.conf a2x.py 実行可能ファイル。
2.AsciiDocグローバル設定ディレクトリのa2x.conf。 私たちがいる場合は、このステップをスキップしてください
ローカルにインストールされた(システム全体ではない)コピーを実行します。
3. AsciiDoc $ HOME /.asciidoc構成ディレクトリのa2x.conf。
4。 ザ CONF_FILE で指定 --conf ファイル オプションを選択します。
デフォルトの構成ファイルオプション値は次のとおりです。
#に渡されるオプションの環境変数ディクショナリ
#プログラムを実行します。 Noneに設定されている場合、既存
#環境が使用されます。
ENV =なし
#外部実行可能ファイル。
ASCIIDOC = 'asciidoc'
XSLTPROC = 'xsltproc'
DBLATEX = 'dblatex'#pdf生成。
FOP = 'fop'#pdf生成(--fopオプション)。
W3M = 'w3m'#テキスト生成。
LYNX = 'lynx'#テキスト生成(w3mがない場合)。
XMLLINT = 'xmllint'#無効にするには ''に設定します。
EPUBCHECK = 'epubcheck'#無効にするには ''に設定します。
#外部実行可能デフォルトオプション。
ASCIIDOC_OPTS = ''
DBLATEX_OPTS = ''
FOP_OPTS = ''
XSLTPROC_OPTS = ''
onworks.netサービスを使用してオンラインでa2xを使用する