概要

正男を定義する為のxmlを作ってみました。今後、正男エディタのデータを統一する際などに利用される考慮した形式です。

この文書の地位

福田直人氏の物ではないので、公式としての地位は無いですが、正男同盟に於ける数少ない形式案として少しの地位はありそうです。

まさおコンストラクション用xml仕様書について

このxmlは正男のデータをhtmlと分離して、再利用性を高める為の形式として考案されました。

正男のソフトウェア側での保存形式や、サーバーサイド、サイトの正男のデータの保管形式として使うことを想定しています。

本家、福田直人のページのコンテンツであるまさおコンストラクションとは一次創作物と二次創作物の扱いになり、福田直人のページの正男コンストラクションの仕様に対して常に準ずる形となります。

MasaoConstructionXmlSchemaの構造

簡単なMasaoConstractionは以下の様なタグによって作成することが出来ます。

<?xml version="1.0" encoding="UTF-8"?>
<masao xmlns="http://masao.in/2009/masaoConstruction" >
<options>
<title>まさお コンストラクション</title>
</options>
<params />
</masao>

これによってまさおコンストラクションサンプルステージ１が表示される内容が作ることが出来ます。

masao要素

xml内に必ず一つ必要な要素。親要素。中にoptions要素とparams要素を必ず含まなくてはならない。

また、scripts要素、styles要素を任意に含む事が出来る。

options要素

まさおデータの付加情報についての定義を行う為の要素。この要素にtitleや、次のステージ、前のステージ、作者情報などを入れることとなる。title要素を必須要素として、任意にoption要素を入れることが出来る。

title要素

まさおデータのタイトルを書かなくてはならない。

option要素

各種値を入れる要素。以下の様に書くことが出来る。

<option type="subtitle" value="ステージ01"/>

typeにその情報keyを、valueにその値を入れている。又、以下の様にも書くことが出来る。

<option type="description">
<![CDATA[このステージは初歩の初歩のステージです。チコリンの攻撃に注意。]]>
</option>

先程と同様にtypeに情報key、そして要素内にvalueの代わりの値をCDATAとして入れている。文章が長くなる場合や、属性として使えない値を使う場合に用いることが出来る。

また、typeとして以下の様な値が定義されている。

option要素のtype属性用定義済みkey一覧
key用途
subtitleページの副題
descriptionページの概要
next次のページへのリンク
prev前のページへのリンク
createrSite制作者のサイト
persuadeページの説明
author制作者名
copyright著作権

直、同じoptionに同じkeyを指定しても良い為、幾つも同様のkeyの要素を作る事も可能である。

scripts要素

任意要素で、無くても問題無いです。主にまさおコンストラクションをEcmaScriptやJavaScript、VBScriptによる制御する際に用います。

子要素として一つ以上のscript要素を持ちます。

script要素

scriptを定義する要素です。

type属性を持つことが出来る。省略した場合、その値はapplication/ecmascirptとなる。他にもtext/javascript,text/ecmascript、application/javascriptも指定することが出来る。IE専用ではあるが、text/vbscriptも利用は可能である。

また、src属性を付けた場合に外部JavaScriptファイルを指定することが出来る。

styles要素

任意要素で、無くても問題無いです。主にまさおコンストラクションのデザインを決める要素ではありますが、出力時にデザインも統一してしまうため、必要は無いです。主に特殊なデザインのステージを作るときに用います。

style要素

styleを定義する要素。内部に直接スタイルを定義することが出来るが、href属性を持つことで外部スタイルを読み込むことが出来る。

type要素を省略す事が出来るが、省略した場合はtext/cssと扱われる。

params要素

必須要素で、code属性とid属性とversion属性を指定することが出来る。

0個以上のparam要素を持つ。

code属性

code属性はまさおのjarファイル内のclass名を入れる。省略時はMasaoConstruction.classが指定される。FXシリーズの機能を十二分に利用する為にはMasaoJSS.classを指定する必要性がある。

id属性

id属性は省略可能で、省略した場合は何も指定されない物とする。

version属性

まさおコンストラクションのバージョンを指定する。省略した場合、その実行環境で準備されている最新の物であるとする。バージョンの表記方法はclassicシリーズとなるVersion3.1やFXシリーズとなるFXUpdate7の様な表記方法を用いる。

param要素

まさおのparam要素そのものである。本家まさおのparam要素とname属性、value属性がそのまま対応する。