トラブルシューティング

プロダクトの開発・運用に関するトラブル

キャッシュをクリア

変更を適用したのに、あるいはプロダクトをアンインストールしたのにそれが反映されないという場合は、ブラウザや（apache, squidなどの）フロントエンドプロクシキャッシュを空にしてから再度読み込みしてください。
Firefoxの場合にはシフトを押しながら再度読み込み、IEの場合にはCtrlとF5を同時に押します。
DIYPloneStyleに限らず、スキンプロダクトの不具合の60%くらいはこれで解決するはずです。

ブラウザからのカスタマイズにご注意

スキンプロダクトのいくつかはcustomレイヤーによって上書きされているかもしれません。おかしいと思ったらcustomレイヤーを調べてみましょう。

名前変更の前には一度アンインストールを

スタイルシートやjavascriptの名前を変える前にアンインストールすることを忘れた場合は、ZMIからportal_cssツールやportal_javascriptsツールから問題を解決できます。アンインストールを忘れた場合、ファイルシステム上で行った変更を元に戻し、プロダクトをアンインストールしてからもう一度名前を変更しましょう。

プロダクトがZopeに読み込まれているかをチェック

ZMIから/Control_Panel/Products/manage_mainへ行き、プロダクトがリストアップされているか、そして壊れていないかをチェックしましょう。もしリストアップされていなかった場合は、ファイルシステム上でのインストールを再度確認し、Zopeを立ち上げるユーザが（少なくとも）読み込み権限を持っているかどうか確認します。もし壊れていた場合は、エラーログを確認し、またPythonコードが正しいかどうかもチェックします。

プロダクトがPloneにインストール可能かを確認

Ploneの「サイト設定」＞「プロダクトの追加・削除」にプロダクトがリストされていなかったり、クイックインストーラーの中に無い（ZMIのportal_quickinstallerを参照）ような場合は、Extensions/Install.pyモジュールをデバッグする必要があります。

テストのためのフレームワークを利用

DIYPloneStyleは基本的なユニットテストが付いています。
もしPloneのユニットテストフレームワークに興味があるならば、このチュートリアルのリソースの章のリンクをたどってみてください。

生成スクリプトの利用に関するトラブル

スクリプトが正しいPythonインタプリタを使用しているかをチェック

この点について指摘してくれたCasper R. Nielsenに感謝
unix系のシステムでは、Pythonコマンドを省略して生成スクリプトを直接呼ぶことが出来ます。 もしそのようなやり方をしてbad interpreter: No such file or directoryというエラーが出たならば、これはスクリプトの最初の行で参照しているファイルが存在しないことによります。
このエラーを回避するためには以下のような方法があります：

• Pythonコマンドを明示して実行

  $ python generator.py --productname CustomSkin

  あるいはPythonのフルパスを記述して実行

  $ /usr/local/bin/python generator.py --productname CustomSkin

• スクリプトの最初の行を、正しいPythonインタプリタを指すように編集してやる

スクリプトが実行可能かをチェック

Linux/Unixで直接スクリプトを呼ぶことによってPermission deniedというエラーが出た場合は、スクリプトが実行不可になっている可能性が非常に高いです。この場合はPythonコマンドを明示してやったり、chmodを使ってファイルのパーミッションを変えてやります：

      $ chmod 0755 generator.py

書き込み権限のチェック

こんな場合があるかもしれません：

Traceback (most recent call last):
  File "DIYPloneStyle/bin/generator.py", line 226, in ?
    generateDirectoryCopy( path, path.replace(DIYPloneStyle, productname) )
  File "DIYPloneStyle/bin/generator.py", line 182, in generateDirectoryCopy
    os.mkdir(dstDirectory)
OSError: [Errno 13] Permission denied: /Users/david/plone-instance/Products/CustomStyle/
    

これはおそらくDIYPloneStyleが存在する、あるいは新しいプロダクトが生成されるフォルダへの書き込み権限がないことが原因です。

さらにサポートを受けるには

Ploneコミュニティからのサポート

plone-usersメーリングリストやIRCの#ploneチャンネルを利用してみてください。

DIYPloneStyleの作成者からのサポート

DIYPloneStyleの作成者にE-maiを送るのもよいでしょう(E-mailアドレスはREADME.txtファイルに載っています)。