yodl - クラウド上のオンライン

プログラム：

NAME

yodl - メイン Yodl コンバータ

SYNOPSIS

ヨードル [オプション]...[ファイル]...

DESCRIPTION

Yodl は、事前ドキュメント言語とそれを処理するツールを実装するパッケージです。 の
Yodl のアイデアは、事前言語でドキュメントを作成し、ツール (例:
yodl2html(1)) それを最終的な文書言語に変換します。 電流コンバータは、
HTML、man、LaTeX、テキスト、および実験的な XML コンバーター。 主な書類の種類としては、
「記事」、「レポート」、「書籍」、「マンページ」、「レター」。 Yodl ドキュメント言語は次のとおりです。
使いやすく拡張可能であるように設計されています。

注: Yodl バージョン 3.00.0 以降、Yodl のデフォルトのファイルインクルード動作は次のようになります。
かわった。 現在の作業ディレクトリは、次のディレクトリに固定されなくなります。
Yodl が呼び出されますが、揮発性であり、yodl ファイルが存在するディレクトリに移動します。
位置した。 これには、Yodl のファイルインクルード動作が次の方法と一致するという利点があります。
Cの #include ディレクティブが動作します。 電流を遮断する可能性があるという欠点があります
書類。 ただし、変換は単純ですが、-L を指定すると完全に回避できます。
(--legacy-include) オプションが使用されます (下記を参照)。

OPTIONS

o -D、--define=NAME[=VALUE]: 定義します 名 象徴として。 このオプションは次のように動作します
DEFINESYMBOL(NAME)()。 =VALUE を追加すると、NAME は VALUE に初期化されます (同様に
DEFINESYMBOL(NAME)(VALUE))まで。

o -d, --definemacro=NAME=EXPANSION: NAME を EXPANSION に展開するマクロとして定義します。

o -h、--help: 使用法情報が標準エラー ストリームに書き込まれます。
Yodl のすべてのオプション。

o -i, --index[=file]: `file' はインデックス ファイルの名前です。 デフォルトでは
.idxが使用されます。 出力が標準出力に書き込まれる場合のデフォルトはありません。 インデックス
ファイルは Yodl のポストプロセッサである yodlpost によって処理されます。

o -I、--include=DIR: これは、YODL が含まれるシステム全体のインクルード ディレクトリを定義します。
入力ファイルを検索します。 たとえば、次のような特定のファイルをインクルードするステートメントです。
INCLUDEFILE(ラテックス)
これにより、Yodl は現在のディレクトリでファイル latex を検索します。
システム全体のインクルード ディレクトリで失敗します。 システム全体のインクルード ディレクトリ
通常、システムの管理者がマクロ ファイルを保存する場所です。
ヨードル。 この検索プロセスは、ドキュメント内に含まれるファイルに適用されます。
ただし、YODL プログラムを呼び出すときのコマンド ラインのファイル名にも適用されます。

インクルードされるファイルの名前 (上記の例では latex) は、裸の名前です。
YODL プログラムは、必要に応じてデフォルトの拡張子 (.yo) を提供します。

-I オプションは、システム全体のインクルード ディレクトリに対する Yodl の組み込み名を無効にします。
組み込み名は Yodl のコンパイル時に定義され、たとえば /usr/share/yodl になります。
さらに、定義には $HOME が含まれる場合があり、これはユーザーの名前に置き換えられます。
「home」または「HOME」環境変数が定義されている場合は、ホームディレクトリ。 また、
$STD_INCLUDE が含まれます。これはコンパイル定義の標準によって置き換えられます。
パスを含めます。 標準の includepath は、(この順序で) どちらかによって無効にされる可能性があります。
コマンド ライン スイッチ -I または YODL_INCLUDE_PATH 環境変数。 による
デフォルトでは、現在のディレクトリが標準のインクルード パスに追加されます。 ヒューバーのとき
-I または YODL_INCLUDE_PATH が使用される場合は、現在のディレクトリを指定する必要があります
明示的に。 個々のディレクトリを /- 文字で終了する必要はありません。
分散 .deb アーカイブでは、標準ディレクトリは /usr/share/yodl として定義されます。
(現在の作業ディレクトリが接頭辞として付きます)。

o -k、--keep-ws: YODL バージョン 2.00 以降、行頭と行末の空白は
「空白レベル」がゼロ以外の場合は、末尾に \ がなくても無視されます。
以前のバージョンでは、これらの空白が保持されていました。 末尾の空白の従来の処理
行は、-k フラグを使用して取得できます。 次の場合、空白は常に保持されることに注意してください。
逐語的コピーを使用し、空白レベルがゼロの場合。

o -l, --live-data=HOW: このオプションは、SYSTEM または
PIPETHROUGH コマンド。 HOW デフォルトではなし (0) です。 の HOW 引数には次のものを含めることができます
次の値：

o none または 0: (デフォルト): システム プログラムを呼び出すマクロは許可されません。

o 確認または 1: マクロは実行できますが、ユーザーの確認が完了した後でのみ実行できます。
得られた。 問題のマクロは、Yodl ドキュメントの処理中に表示されます。
ユーザーは通話を受け入れるか拒否する必要があります。

o レポートまたは 2: マクロは実行されますが、呼び出された内容は Yodl 中に表示されます。
実行します (WARNING メッセージ レベルがアクティブな場合)。

o ok または 3: マクロは実行されますが、実行中には表示されません。 ときは注意してください
--live-data を使用しても問題ありません。 文書が明確である場合にのみ使用してください。
「無害」。

o -m, --messages=SET: いわゆる「メッセージレベル」をSETの組み合わせに設定します。
アクデインｗ。 このセットの文字には次の意味があります。

oa: 警告。 アラートエラーが発生すると、Yodl は終了します。 ここでヨドルが何かを要求します
(get_cwd() など) システムのエラーが発生します。

oc: クリティカル。 重大なエラーが発生すると、Yodl は終了します。 メッセージ自体は、
抑制することはできますが、終了することはできません。 重大な状態とは、たとえば、
パラメータリストが表示される場所に開き括弧を付けるか、
INCLUDEFILE 仕様に存在しないファイル (このファイルは解析する必要があるため)。
NOEXPANDINCLUDE 指定を持つ存在しないファイルは、プレーン (非クリティカル) ファイルです。
エラー。

od: デバッグ。 おそらく情報が多すぎる、各キャラクターについての情報を取得するなど
それはヨードルが読んだものです。

oe: エラーです。 エラー (二重定義されたシンボルなど)。 エラーメッセージが出ても停止しない
入力は解析されますが (最大エラー数まで)、出力は解析されません。
生成された。

オイ：情報。 「デバッグ」ほど詳細ではありませんが、それでも非常に多くの情報が得られます。
メディアスイッチについて。

オン: 気づきます。 組み込み関数呼び出しの呼び出しなどに関する情報。

うわ: 警告。 知っておくべきことですが、おそらく Yodl には影響しません。
適切に機能していること 設定できないのは、 緊急事態 メッセージ。 これら
メッセージは抑制できませんが、内部的なメッセージを指しているため、発生すべきではありません。
エラー。 これらのメッセージに関する情報を受け取っていただければ幸いです。
これまでに発生します。

o -n, --max-nested-files=NR: このオプションを使用すると、次の数のファイルが存在すると Yodl が中止されます。
ネストされた入力ファイルは NR (デフォルトでは 20) を超えます。 この数値を超えると
通常、文書内のどこかにある循環定義を意味します。 これが事実です
ファイル a.yo には b.yo が含まれ、b.yo には a.yo が含まれる場合など。これは防止されません。
再帰的なマクロまたはサブストの置換。 そのためには、-r (--max-replacements) オプションを使用します。
の新しいガイドができました。

o -o, --output=FILE: このオプションにより、Yodl は出力を FILE に書き込みます。 デフォルトでは、
出力は標準出力ストリームに送られます。 たとえば、YODL を使用して
次の XNUMX つのコマンドを使用して、ファイル入力と出力への書き込みを行います。

yodl 入力 > 出力
yodl -o出力入力

違いは、後者の場合、インデックス ファイルは生成されますが、
前者の場合。 --index を指定すると、インデックス ファイルの書き込みが強制される可能性があることに注意してください。
オプションが指定されています。

o -p, --preload=CMD: このオプションは文字列 cmd を「プリロード」します。 cmdのように動作します
は、YODL によって処理される最初の入力ファイル内の最初のコマンドでした。

コマンドラインには複数の --preload=CMD オプションが存在する場合があります。 それぞれの
コマンドはファイルを読み取る前に順番に処理されます。

o -r、--max-replacements=NR: このオプションにより、次の数に達すると Yodl が中止されます。
マクロ呼び出しまたは置換置換が NR * 10,000 を超えます。 デフォルトでは、NR は 1 です。
--max-replacements=0 を設定すると、マクロまたは置換チェックが行われないことを意味します。
実行されました。

o -t、--trace: このオプションはトレースを有効にします。解析中に、Yodl はその出力を次のように書き込みます。
標準エラーストリーム。 -k オプションの場合と同様、このオプションは
デバッグ目的のみに定義されています。

o -V、--バージョン。 このオプションでは、YODL の実際のバージョンが表示されます。

o -v、--verbose: このオプションは Yodl の「冗長レベル」を上げ、より多くのエラーが発生する可能性があります。
一度よりも。 デフォルトでは、yodl はアラート、クリティカル、緊急、およびエラーを表示します。
メッセージ。 各 --verbose オプションは次のメッセージ レベルを追加します。 順番に、警告、
通知、情報、およびデバッグ メッセージがこのセットに追加されます。 以下のことも可能です
メッセージを抑制します。 これには VERBOSITY ビルトインを使用できます。

o -W、--保証。 このオプションでは、保証の免責事項と著作権表示が表示されます。

o -w、--warn: このオプションの存在により、Yodl は、たとえばシンボルが
再定義されました。

onworks.net サービスを使用してオンラインで yodl を使用する