EPrints 2.3技術文書 - generate_staticコマンド



名前

generate_static - テンプレートを使ってEPrintsアーカイブの静的ページを作成する


概要

generate_static archiveid [options]


説明

EPrintsの静的なWebサイトを作成する(複数の言語をサポートする場合は、複数のWebサイトを作成する)。

このコマンドはEPRINTS/archives/ARCHIVE/cfg/static/LANGID/にあるすべてのファイルを処理する。 言語毎に、/LANGID/と/generic/にあるすべてのファイルを処理して、EPRINTS/archives/ARCHIVE/html/LANGIDに置く。 混乱しそうだがたいしたことはないので心配はない。単に、static/en/にWebページの概略を、static/generic/に画像などを置き、このコマンドを実行して、何が起こるか見守るだけである。

ほとんどのファイルは対象となるディレクトリにそのままコピーされ、ディレクトリ構造は保存される。

ファイル名の接尾辞に .xpage あるいは .xhtmlを持つファイルはコピーの際に処理される。

.xpage
これは次のような構造を持つXMLファイルである。
 <?xml version="1.0" standalone="no" ?>
 <!DOCTYPE page SYSTEM "entities-en.dtd" >
 <page>
   <title>This is the page title</title>
   <body>
     <p>Some XHTML body</p><p>Which is <b>neat</b></p>
   </body>
 </page>

処理されたファイルは.htmlファイルになる(たとえば、foo.xpageはfoo.htmlになる)。アーカイブのテンプレートファイルを使い、適当な場所にtitleとbodyを挿入する。 コピーの際、EPrintsの外部エンティティも変換される。本文書の該当項を参照のこと。

.xhtml
これは次のXMLヘッダを持つ普通のXHTMLファイルである。
 <?xml version="1.0" standalone="no" ?>
 <!DOCTYPE html SYSTEM "entities-en.dtd" >

コピーの際、EPrintsの外部エンティティが変換される。外部エンティティについては本文書の該当項を参照のこと。 また、.htmlという名前に変更される。たとえば、foo.xhtmlはfoo.htmlとなる。


英語以外を話す人々への注記

英語以外の言語でEPrintsを運用する場合は、enではなく、対象となる言語のISO言語IDを名前に持つディレクトリ、たとえば、フランス語の場合はfr/に静的ファイルを置くこと。 generalディレクトリには、言語に関係のないファイルを置く。これは複数言語のサイトを運営する際に非常に便利である。 なお、エンティティファイルの名前も-enから、たとえばentities-fr.xmlのように変更しなければならない。


引数

archiveid
対象となるEPrintsアーカイブのID。


オプション

--help
簡単なヘルプメッセージを出力して、終了する。

--man
完全なマニュアルページを出力して、終了する。

--quiet
エラーが生じない限りすべての出力を抑制する。

--verbose
現在何を行っているかを詳細に説明する。よくわかるように説明が繰り返される場合がある。

--version
バージョン情報を出力して、終了する。


著者

このコマンドはEPrints2システムの一部である。EPrints2は、Christopher Gutteridgeにより開発された。


バージョン

EPrintsのバージョン: 2.3.6


連絡先

詳細な情報が必要な場合は、http://www.eprints.org/を参照のこと。メーリングリストに関する情報などがある。

Chris Gutteridgeに連絡を取る場合はsupport@eprints.orgにメールする。

何らかの理由があって郵便で連絡を取る必要がある場合、EPrintsの連絡先は次のとおりである。

 EPrints c/o Christopher Gutteridge
 Department of Electronics and Computer Science
 University of Southampton
 SO17 1BJ
 United Kingdom


著作権

このファイルはGNU EPrints 2の一部である。

Copyright(c)2000-2004 University of Southampton, UK. SO17 1BJ.

EPrints 2はフリーソフトウェアである。フリーソフトウェア財団(Free Software Foundation, FSF)が公表しているGNU一般公衆利用許諾契約書(バージョン2か、希望によってはそれ以降のバージョンのうちのどれか)の定める条件の下で、EPrints 2を再配布または変更することができる。

EPrints 2は有用であることを願って配布されているが、*まったくの無保証*である。 商業可能性の保証や特定の目的への適合性は、言外に示されたものも含めまったく存在しない。詳しくはGNU一般公衆利用許諾契約書を参照のこと。

EPrints2と一緒にGNU一般公衆利用許諾契約書の複製物を受け取ったはずである。もし受け取っていない場合は、フリーソフトウェア財団まで請求のこと。
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA


This file is part of GNU EPrints 2.

Copyright(c)2000-2004 University of Southampton, UK. SO17 1BJ.

EPrints 2 is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option)any later version.

EPrints 2 is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with EPrints 2; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

 EPrints 2.3技術文書 - generate_staticコマンド