wiki.zope.jp
LetsBeginZWiki099 		   
RecentChanges WikiHelp WikiPractice JumpSearch

LetsBeginZWiki099

説明用ページ

編集中の旧ページ

Let's Begin ZWiki !!

初めに:LBZWikiIntro

　

Ａ．サーバ管理者編

　ここ、「Ａ．サーバ管理者編」では、あなたのPCに、実際にZWikiサーバを作る迄を説明します。2002年07月22日現在、一番簡単に日本語が扱えるZWikiサイトを立上げる手順を説明しますので、多少、標準とは異なりますが、初心者向けということでご了承願います。

  • 　Zope関係のマニュアルなどは、次のところにも掲載されています。ここでの説明で、分らないことがありましたらそちらもご参照願います。
    1. 日本語によるオリジナルHowTo Zope自体のインストール各OS別、バイナリやソース別にわかり易くまとめられている。)
    2. Zope FAQ ：必要なら、あなたも追加出来る。
    3. ZopeMailingList ：現時点迄の過去ログをNAMAZUで検索出来る。
    4. wiki.zope.jp ：右上のテキスト欄に入れた言葉を含むページを検索出来る。但し、入力した文字を含むリンクページがあるとそれだけが表示されるので、 http://wiki.zope.jp/SearchPage が正解です。このアドレスを忘れたら、意味不明の文字をwiki.zope.jpの右上のテキスト欄に入れたたら、http://wiki.zope.jp/SearchPageが出ます。Web管理者が、AnnoyingQuoteにSearchPageを登録してくれてると、初心者は凄く嬉しいのだが、皆さんどうでしよう？
    • 　もし、うまく行かないときは、ML に参加して質問して試て下さい。初心者を大切にする雰囲気のあるところですので、メンバーのどなたかが、親切に対応してくれます。但し、質問に当たっては、1.した内容、2.現状、3.環境など判断に必要と思える内容を整理し簡潔にお願いします。経験上、整理して行く内に自分で解決出来てしまうことも結構多く解決のコツを掴む練習にもなります。尚、MLに参加された、あなたは、既に "日本Zopeユーザ会" のメンバーでもあります。是非、http://wiki.zope.jp/に自己紹介を書き、最寄りの地域のZopeユーザ会にも参加して下さい。きっといいことがあります。地域のZopeユーザ会がないときは、作ることもいいですし、好みの地域のZopeユーザ会に参加してもいいと思います。

  1. ZWikiサーバを準備する

    　ここでは、ZWikiサーバを立上げる為の、Zope2.5.1サーバの導入に当たり押さえるべき点とその日本語ハックのパッチやプロダクトの導入について説明します。

    1. Zope2.5.1サーバの準備

      基本的に、日本語によるオリジナルHowToの手順でインストールし導入時の設定をして下さい。説明は、ひとつ前のバージョンですが、手順は変わりません。

      Zope本体のインストールで抑えておくべきことは、次の内容です。

      • 　最新の安定化パージョン(current stable release)は2.5.1 (2002-07-22現在)ですが、頻繁にバージョンアップされますので、インストール前に http://www.zope.org/Products/ を確認して下さい。尚、バージョンが異なると、以前のバージョンのパッチはそのままでは恐らく利用出来なくなりますし、プロダクツのなかには、同様に動作しなくなることもあります。その時は、新しいバージョンを入れ、実際にソースコードを見てハッキングするのもいい勉強になります。また、安全第一で古いバージョンで試した後、新バージョンに移行するのもひとつの考えです。
      • 　インストールディレクトリを明記する。プロダクトのインストールの時にはそのディレクトリの中の「lib/Python/Products/」にプロダクトを入れることになります。尚、Zopeは、インストールディレクトリを変えることで複数インストールすることも出来ます。プロダクトにより、特定のZopeのバージョンに依存しているプロダクトがうまく動かないときは有効な手段です。尚、別のディレクトリに入れたZopeに別のディレクトリで運営していたデータを引継ぎたい場合は、使用した全てのプロダクトを導入後に「var/Data.fs」をコピーすればＯＫです。
      • 　一般ユーザの登録を行ない、日頃はそれで管理作業を行ないます。
    2. 日本語ハックのバッチとプロダクトの導入

      Zopeは、Python上で作成している為、特殊な文字列処理がない限り、漢字はバイト文字列として扱うことで、そのままでも使えます。しかし、次の機能は、１バイト１文字を前提にしたソースコードを含む為、一部を修正する必要があります。

      1. 「構造化テキスト(StructuredText)」の日本語パッチZope-2.5.1-STmb-ja0.patch の適用
        • Zope-2.5.1-STmb-ja0.patch をダウンロードし、Zopeのインストールディレクトリ(Winでは「Website」Linux等では「Zope....」等)に入れる。
        • ディレクトリ位置をインストールディレクトリに変える。
        • patch -p1 < Zope-2.5.1-STmb-ja0.patch を実行。次の様に出ると成功: 
                patching file lib/python/StructuredText/DocumentClass.py
      patching file lib/python/StructuredText/STletters.py
      patching file lib/python/StructuredText/__init__.py

        ※　Windowsユーザは、Win32 port of GNU patch 2.5.4 を使うと同様のpatchコマンドによる処理が出来る。

      2. 「管理画面」の日本語対応プロダクトの導入

        基本的には次の手順で導入します。(このプロダクトを作成した田原さんのML投稿「Zope 2.5.0の管理画面と日本語」がオリジナルです。)

        • サーバ側のプロダクト導入作業
          1. ZMI 日本語化(EUC-JP)パッチをダウンロードし、Zopeの「lib/python/products」ディレクトリに入れる。
          2. Zopeを再起動する。

  • 　文字コードは、プロダクトにはEUC-JPでしか利用が難しいものがあります。無理をせずEUC-JPとしましょう。
  1. その他の日本語対応

    　ZWikiやSquishdot等の日本語版では対処済みではあるものの、そうでない場合は通常のZopeのページは「standard_html_header」かそのプロダクト独自の「????_header」の中に次のメタタグを加えることで解決します。また、同じプロダクト内であっても「????_header」を使わずにページを生成しているところにも次のメタタグを挿入する必要があります。その他の理由で対応が必要となるものを列記します。
    <meta http-equiv="Content-Type" content="text/html; charset=EUC-JP">

  • 　TinyTablePlusの漢字表示

    　TinyTablePlusJPにある通り、EUC-JPのみとの限定ながら、プロダクト内のImportExport.pyの次の2行をコメントアウトすればとりあえず日本語が通る(cheeseshopさんのハック)。〔この処理を加えた派生品を http://www.zope.org/Members/koyoshi/ に入れています。〕: 

           #            elif ord(c) <= 31 or ord(c) >= 127:
       #                s = s + '\\%03o' % ord(c)

  • 　日本語ファイル名の添付

    残念ながら、現在対応出来ていない。添付ファイルは原則英数文字のファイル名にしてから処理します。

  • 「 jMailHost 」プロダクトによる「MailHost」の日本語対応

    　DTMLタグを書くことで簡単なメール送信は可能な様です。現時点での最新公開パッケージのZWikiの0.9.9ではメール連携も可能になりました。ところが、Zope添付の「MailHost」は、日本語の様な多バイト文字を扱う仕組みを備えていない為、安田氏の「jMailHost」プロダクトを入れる必要があります。

    1. 安田氏のhttp://www.zope.org/Members/yukihiro/ページより、「 jMailHost-0.1.3 」プロダクトをダウンロードし、Zopeディレクトリ内の「lib/python/products」ディレクトリに入れる。
    2. kconv、kanjilib、JapaneseCodecsのいずれかひとつのpythonモジュールの導入
      • kconvの導入方法は、KConvをご覧願います。
    3. Zopeを再起動する。

    1. ZWiki日本語版 ( ZWiki-0.9.9-JapanesePack-0.0.1.tgz )の導入

      既に、日本語化されているものを導入すると極めて楽である。一般的には次の手順のみである。

      1. 　ZWiki日本語版 ( ZWiki-0.9.9-JapanesePack-0.0.1.tgz )をダウンロードし、Zopeディレクトリ内にある「lib/python/products」ディレクトリに「ZWiki」ディレクトリごと入れる。
      2. Zopeを再起動する。
      3. 文字化けを防ぐ、日本語対応
      4. 和文化

  • 残された英文の和訳
    • まだあるだろうか？【未】 ←もしあったら、見つけた方は書込んで下さい。
      • 2002/04/14 koyoshi - ZWikiの上部のサイト名の後の「contents」を「の文書一覧」にするには、「Parents.py」の136行目を次の様に変更します。: 
                return '<small><ul><a href="%s/map#%s">「%s」 の文書一覧(SiteMap)</a>\n' % \
               (self.page_url(), quote(self.id()), titletxt) + \
               hierarchy + '\n</ul></small>'

    1. ZWiki Webの作成
    2. カスタマイズ(サーバサイド)【未】
      1. セキュリティ
      2. 書込み書式の変更【未】
        • DTMLも使いたい
        • 平文テキストのみを使う
      3. ブラウザのユーザ設定に関係なく設定を変えるには【未】
        • 「Properties」の作成で実現出来る(ZWikiWG?上のspumoniさんのコメントを参照)
      4. 更新履歴の中身がみたい
        • 2002/04/03 koyoshi - RecentChanges?の更新日時の部分を以下の様にすると、各ページの最終更新日時のリンク同様に、変更箇所が表示出来る。これがあると断然嬉しい!! : 
                <dtml-if "AUTHENTICATED_USER.has_permission('View History',this())">
      <a href="&dtml-wiki_page_url;/diff">
      </dtml-if>

      <dtml-if zwiki_timezone>
      <dtml-var "bobobase_modification_time().toZone(zwiki_timezone).ISO()[2:-3]">
      <dtml-else>
      <dtml-var "bobobase_modification_time().ISO()[2:-3]">
      </dtml-if>

      <dtml-if "AUTHENTICATED_USER.has_permission('View History',this())">
      </a>
      </dtml-if>
      5. ZWikiのソースを覗いてみよう【未】

      Ｂ．ユーザ編

      1. ZWikiサイトを使おう
        1. ブラウザのUserOption設定【未】
        2. 魔法の書式書込み
          • 構造化テキストとは
          • リンクページ作り
          • もっと自由に
          • 画像とファイル添付
        3. 重複編集トラブル対応【未】
        4. ZWikiでの人的トラブル回避のお作法【未】
      2. ZWikiサイトの可能性【未】
        1. コミュニケーション革命
      3. ZWikiサイトの抱える問題点
        1. 日本語に構造化テキスト規則が適用出来ないことが...
        2. ブラウザのテキストエリア文字数上限で、文章が尻切れに
          • ブラウザ側の書込時の一時ファイル「NSxxxxxx.TMP」【未】
        3. 動的サイトの宿命：先祖帰り
          • サーバの異常終了
          • ブラウザキャッシュ＆Proxyキャッシュ

【コメント欄】

Last edited Wed, 13 Sep 2006 13:14:40 +0900 Edit this page