7章ページの作成 - 24. ページインポート機能

4. テキストファイルのインポート

WebRelease は各種のテキストファイルをインポートすることができます。

サフィックスが .js .txt .csv .php .jsp .asp .xml .json .sql .py .pl .less .md .xhtml のいずかのファイルはテキストファイルとしてインポートされます。
WebRelease 上に作成されるページのタイトルとファイル名にはインポートされたファイルのファイル名が使用されます。例えば script.js をインポートすると作成されるページのタイトルとファイル名はどちらも script.js になります。
インポートするファイルのファイル名には日本語は使用できません。
ファイルのエンコーディングは UTF-8 として扱われます。UTF-8 以外のファイルはインポートできません。
ページの作成には「テキストファイル取り込みテンプレート (システム組み込み)」というシステム組み込みのテンプレートが使用されます。または、特定の条件を満たすテンプレートを作成しておくことで、ユーザ定義のテンプレート（カスタムテンプレート）を使ってファイルをインポートすることも可能です。カスタムテンプレートで取り込めば、取り込んだファイルの内容を加工してから公開サーバに配信することが可能になります。

インポートの手順

テキストファイルをインポートする場合には、インポートしたいファイルを WebRelease にアップロードします。事前に準備する必要があるものは取り込むファイルだけです。取り込みには、基本的にシステム組み込みのテンプレートが使われるのでテンプレートの事前準備は必要ありません。

まず、ページを作成したい（インポートしたファイルでページを作成したい）フォルダに移動します。必要があればフォルダを作成すると良いでしょう。今回は example3 というフォルダを作成し、そこにコンテンツを取り込んでみることにします。フォルダに移動したら画面右上にある「インポート」ボタンをクリックします。

① 表示されるダイアログで「ファイルをアップロード....」を選びます。
② アップロードしたいファイルを選択します。今回は script.js をインポートしてみましょう。ここではファイルをひとつだけインポートしていますが、複数のファイルを指定して同時にインポートすることもできます。

日本語のファイル名を持つファイルはインポートできません。

③ 必要に応じて、オプションを設定してください。

既存のファイルの上書きを許可する

WebRelease はファイルをインポートする時、インポートの結果作成されるページと同じページタイトルを持つページが既に WebRelease 上にある場合には、そのページを上書きしようとします。このオプションを ON にすると既に存在するページの上書きを許可できます。このオプションが OFF の状態では、既存のページが上書きされることはありません。上書きが発生するファイルのインポートはエラーとなり、インポートは行われません。（同時にアップロードした他のファイルのインポートも中止されます）

上書きの対象となるページは、インポートしようとしているファイルのファイル名と同じページタイトルを持っているページです。script.js をインポートする場合、ページのタイトルが script.js となっているページが上書きの対象となります。

ページを上書きする場合、上書きされるページの状態が、編集中、編集完了、または作業コピーとなっている場合には、取り込まれたファイルによりページの該当リビジョンが直接上書き更新されます。ページの状態がそれ以外の場合には、上書きされるページに新しいリビジョンが作成され、そこにインポートしたファイルの内容が取り込まれます。

上書き対象となるページが、これから取り込まれようとしているファイルに適用されるテンプレートと異なるテンプレートを使用している場合には上書きはできません。WebRelease では、ひとつのページに属するすべてのリビジョンは同じテンプレートをベースにしている必要があるためです。

既存のファイルの新規リビジョンとしてインポート

このオプションは、上記の「既存のファイルの上書きを許可する」を ON にした場合にのみ表示され、指定できるようになります。このオプションを ON にすると、既存のページの上書きが発生する場合には、そのページの状態にかかわらず、常に新規リビジョンが作成されてからファイルが取り込まれます。

取り込んだ html ファイル中の title 要素の値をページタイトルに使用する

このオプションはテキストファイルのインポートでは意味がありませんので指定は不要です。ON / OFF どちらでも動作に影響はありません。

取り込んだ html css js ... xhtml ファイルの行末コードを 0x0d + 0x0a (CR + LF) に置き換える

このオプションを指定するとアップロードしたファイルの行末コードを 0x0d + 0x0a (CR + LF) に置き換えてから取り込むことができます。

④ ダイアログパネル右上の「インポート」ボタンをクリックすると、コンテンツが取り込まれます。

インポートしたテキストファイルの編集

インポートした css ファイルはページとして編集可能です。先ほどインポートした script.js の編集画面を開いてみましょう。ページ一覧画面の「編集」ボタンをクリックすると編集画面に入ることができます。

インポートした script.js ファイルの編集画面は下記のようになっているでしょう。

① このページの作成には「テキストファイル取り込みテンプレート(システム組み込み)」という名前のテンプレートが使われています。インポート時にユーザ定義のカスタムテンプレートを指定している場合には、ページは指定したテンプレートで作成されます。

② インポートして作成したページのページタイトルは「script.js」となっています。テキストファイルをインポートした場合、作成されるページのページタイトルはインポートしたファイルのファイル名になります。ページタイトルは必要があれば変更することができます。

③ ページのファイル名は script.js になっています。このページが公開サーバ上に公開される時にはこの script.js というファイル名で公開されます。ファイル名は必要があれば変更することができます。

④ このページのエンコーディングは「UTF-8」になっています。このページが公開サーバ上に公開される時にはファイルのエンコーディングは UTF-8 で公開されます。