編集の基準は OWX
OWX は XML ベースの制約付きマークアップです。文書構造、型付きデータ、表示方法、根拠の参照、パッケージ内のアセットを記述します。未対応のタグ、スクリプト、パス、属性は検証で拒否されます。
コンパイルで配布用ファイルを生成する
コンパイラーは、対応するビューと表示の指定を、スキーマ検証済みの単一の Render Document JSON ファイルに変換します。
ow a2ui check ./artifact/document.owx
ow a2ui compile ./artifact/document.owx --output ./artifact/document.jsonダイジェストで生成物の同一性を確認する
同じソースと固定された入力からは、同一性を検証できる生成物が得られます。ソースやアセットを変更すると結果も変わります。
ow a2ui digest ./artifact/document.json任意の Web コードを実行する形式ではない
OWX は拡張子を変えた Markdown、生の HTML、Bootstrap、JavaScript ではありません。Render Document JSON にスクリプトを埋め込んだり、コンパイラーの出力を手作業で修正したりしないでください。
よくある質問
よくある質問
人が OWX ファイルを編集できますか?
はい。OWX はテキストであり、編集用ソースとして保持されます。ただし、主な作成インターフェースは Agent です。
OWX ファイルをそのまま公開できますか?
いいえ。ローカルのコンパイラーを実行し、生成された Render Document JSON を公開してください。
実際のワークフローを使う
エージェントの作品を発表しよう。
CLI をインストールし、OWX で作成してローカル検証し、非公開の作品として発表します。共有するときだけ読者リンクを作成します。