第4章 設定ファイル

文字列を受け付ける

整数値を受け付ける

論理値（『TRUE』/『FALSE』）を受け付ける

変数へ置換する際はそれぞれ FALSE = 0, TRUE = 1 となる．

指定された文字列の選択肢 a,b,c のいずれかを受け付ける．

a,b,c の部分は任意．

複数の文字列を配列データとして受け付ける．

前者の書式 array(tag) は 後者の書式 array(tag,'\n') と同じ．

sep は複数の文字列の区切り文字を表す．ここで \n は改行を表し，C言語と同じ文字列のエスケープ書式を用いる．

XooNIps v3.4に変数へ置換する際は配列内のデータをそれぞれ tag に指定された XML タグで囲んで並べたものを利用する．例えば array(title) と指定し，そのセルに複数行の文字列 Line1, Line2, Line3 が指定されている場合，置換後は以下のようになる．

<title>Line1</title><title>Line2</title><title>Line3</title>

XooNIps v4.0に変数へ置換する際は配列内のデータをそれぞれ変数名の後尾で囲んで並べたものを利用する．例えば keywords.keyword=array(tag,'#') と指定し，そのセルに複数行の文字列 Keyword1, Keyword2, Keyword3 が指定されている場合，置換後は以下のようになる．

<C:keyword C:type="keyword" C:keyword_id="1">Keyword1</C:keyword>
<C:keyword C:type="keyword" C:keyword_id="2">Keyword2</C:keyword>
<C:keyword C:type="keyword" C:keyword_id="3">Keyword3</C:keyword>

tag および sep の部分は任意．

複数の文字列を配列データセットとして受け付ける．

前者の書式 dataset(group) は 後者の書式 dataset(group,'\n') と同じ．

sep は複数の文字列の区切り文字を表す．ここで \n は改行を表し，C言語と同じ文字列のエスケープ書式を用いる．

変数へ置換する際は配列内のデータに対してそれぞれ group で指定されたデータセット領域を配列数分繰り返して用意し，各フィールドに当てはめる．例えば，テンプレートが

<{dataset $group}>
  <group>
    <data><{$data}></data>
  </group>
<{/dataset}>

で ini ファイルが

data=dataset(group,'#'):...

となっており，Excel ファイル内の data のセルに d1#d2 のデータが格納されていた場合，以下の様に置換される．

<group>
  <data>d1</data>
</group>
<group>
  <data>d2</data>
</group>

他のセルの dataset においても同じ group 名を共有できる．ただし，それぞれのセルにおいて同じ配列個数分のデータが必要となる．

言語文字列 (eng,jpn,fra,deu,esl,ita,dut,sve,nor,dan,fin,por, chi,kor)のいずれかを受け付ける．

ローカルホスト上のファイルパスを受け付ける．

変数へ置換する際は file_type_name で指定されたファイルタイプを利用し，適切なタグと置き換える．

file_type_name の箇所は XooNIps のシステムが持つファイルタイプ識別子を指定する．

XooNIps v4.0 には複数ファイルを登録する可能な項目がある.これらの項目は複数のファイル名の区切り文字として改行を使う.

XooNIps v3.4 に XML テンプレートファイルでは，以下の変数名のルールでファイルに関する詳細情報を取り出すこともできる．

<{$変数名.original_file_name}>  : ファイル名
<{$変数名.mime_type}>           : MIME Type
<{$変数名.file_size}>           : ファイルサイズ
<{$変数名.suffix}>              : ファイル拡張子

ライセンス情報の文字列をを受け付ける．

Some rights reserved (Creative Commons License を指定する場合，CC-BY, CC-BY-SA, CC-BY-ND, CC-BY-NC, CC-BY-NC-SA, CC-BY-NC-ND のいずれかの予約済み文字列を指定する．

上記以外の文字列を指定した際は All rights reserved となり自由記述を行う．

XML テンプレートファイルでは以下の変数名のルールで Creative Commons License に関する詳細情報を取り出すこともできる．

<{$変数名.use_cc}>              : CC 利用の有無 (0:無, 1:有)
<{$変数名.cc_commercial_use}>   : 商用利用の可否 (0:非, 1:可)
<{$変数名.cc_modification}>     : 改変・翻訳条件 (0:禁止,
                                 1:同一条件下で許可, 2:許可)

関連付けるインデックスを受け付ける．

/Public もしくは /Private から始まる文字列を指定．

複数関連付ける際は，セル内に複数行に渡り記述する．

/Private で始まるパスを1つ以上含む必要がある．