Starドキュメントマークアップ 仕様

印刷文字のエスケープ

エスケープ可能な印刷文字は次のとおりです。

• 角括弧(開)[文字を印刷するには\[を使用してください。
• 角括弧(閉)]文字を印刷するには\]を使用してください。
• バックスラッシュ\文字を印刷するには\\を使用してください。
• スペース 文字 を印刷するためには\をスペース文字の前に付けて\ としてください。

例：

This will print a markup command, instead of acting on it.
 \[cut\]

改行のエスケープ

例：

[align: middle]\
 [barcode: type code39;
           data 123456789012;
 		  height 15mm;
 		  module 0;
 		  hri]
 [align]\
 Thank you for trying the new Star Document Markup Language\
 we hope you will find it useful. Please let us know!
 [cut: feed; partial]

ワードラッピングがもたらす結果

次のテキストはテスト用入力データです。

This is a test of word wrapping when targeting point of sale printers of varying size, and print widths. Star Markup language makes this easy to manage automatically.

以下の各タブでは、通常のプレーンテキストを送った場合の出力結果と、対応する用紙幅が異なるStarプリンターに、Starドキュメントマークアップを通じて生成した印刷ジョブを送信した場合の出力結果を表示しています。

フォントと拡大サイズの混合

Starドキュメントマークアップがプリンターのネイティブコマンドにレンダリングされると、フォントサイズと拡大サイズが追跡されます。
これにより、ワードラッピングを維持しながら、異なるフォントと文字の拡大を1行で混在させることが可能になります。

ワードラッピングとスペース

ワードラッピングとStarドキュメントマークアップタグ

略語

タグ名とパラメーター名を選択する際の主な目標は読みやすさです。
読みやすさを維持できると思われる一部のタグ名とパラメーター名において、短縮バージョンをサポートしています。

例：

[magnification: width 3; height 2]

以下は機能的に上記と同じです。

[mag: w 3; h 2]

詳細については、各Starドキュメントマークアップタグのマニュアルを参照してください。

デフォルトのパラメーター

[magnification]や[align]などのレンダリング（テキスト描画）状態に影響するタグは、通常パラメーターを指定する必要があります。
パラメーターなしで使用するとデフォルト値にリセットされます。

例：

This is standard sized text
 [mag: w 2]Double Width Text[mag]
 This is standard sized text again.

詳細については、各Starドキュメントマークアップタグのマニュアルを参照してください。

長さのタイプ

長さは次の方法で指定できます

長さタイプの組み合わせ

一部のタグでは追加の長さ制約を指定できます。この場合単一のタグで異なる長さ単位タイプを混合すると便利です。
例えば [image] タグは最小サイズを指定することができます。

[image: url https://website.com/logo.jpg; width 60%; min-width 48mm]

これは画像が印刷可能な幅の60％で印刷されることを要求しますが48mm未満にはなりません。
目的は、印刷可能な領域の60％が小さすぎると感じる58mm/2inchモデルを含むすべてのプリンターで快適なサイズで画像を印刷するためです。