- 追加された行はこのように表示されます。
- 削除された行は
このように表示されます。
{{category 入門}}
!目次
{{outline}}
!!!カスタマイズ
ここでの変更はシステムに関するものなので、'''WikiFarm も含めてすべてに影響します'''。
!!setup.dat ファイルの編集
FreeStyleWiki をインストールしたディレクトリ（フォルダ）にある setup.dat を編集することで様々なカスタマイズをすることができます。Windows であれば FFFTP などのFTPクライアントソフトを使って、setup.dat ファイルをダウンロードし、[秀丸エディタ|http://hide.maruo.co.jp/]や[サクラエディタ|http://sakura-editor.sourceforge.net/]等のエディタソフトで編集します。なぜならファイルは Shift-JIS ではなく EUC で記述されているのでメモ帳では文字化けしてしまい編集できないのです。
!トップページをFrontPage以外にする
# トップページのページ名
frontpage = FrontPage
の部分を、例えば、
# トップページのページ名
frontpage = Top
とすれば、wiki.cgi の後に何も指定しないと「Top」という名前のページが表示されます。また、上部メニューの「トップ」をクリックしたときも「Top」が表示されるようになります。また、新しい Farm を作ったときも「Top」の編集画面になります。
公なページで「FrontPage」はあまり具合が良くない場合に、任意のページを指定します。
!編集履歴（バックアップ）を複数回残す
# バックアップ世代数（0だと無制限）
backup = 1
これを、2,3,……と増やせばその分の世代をバックアップします。当然すべてのページについて同じ事を行うので、ハードディスク領域を圧迫します。一度でも変更すると履歴がクリアされるようです。
!更新するごとにメールでお知らせが届くようにする
# sendmailのパス
send_mail =
「/usr/sbin/sendmail」（さくらインターネットの場合）
等です。レンタルサーバによって違います。
また、この次の項目で SMTP サーバを指定する項目があり、sendmail が使えなかった場合に指定することができるようになっていますが、最近「Outbound Port 25 Blocking」対策で当該プロバイダ回線以外からの接続ははじくので、なかなか使えないと思います。
!本体の wiki.cgi を違うファイル名にする
wiki.cgi を別なファイル名に変更した後
# CGIスクリプトのファイル名
script_name = wiki.cgi
を変更します。
サーバの設定で拡張子「.pl」しか認めないとか、「index.cgi」というファイル名なら省略しても自動的にアクセスできるからそうしたいなどといった場合に使います。XREA の場合などですね。
!!Firefox 等での日本語添付ファイルの文字化け
BBS-サポート掲示板/559（公式サイト）
http://fswiki.org/wiki.pl?page=BBS%2D%A5%B5%A5%DD%A1%BC%A5%C8%B7%C7%BC%A8%C8%C4%2F559
plugin\attach\AttachHandler.pmの変更
!!間違えて「core」や「admin」プラグインを無効化してしまった時
*Q.coreプラグインのチェックを外してしまいました（公式サイト）
**http://fswiki.osdn.jp/cgi-bin/wiki.cgi/docs?page=FAQ#p51
!!wikiインストールディレクトリの「/」でwikiを表示させたい
通常は、URL の最後が「/」で終わった場合、ディレクトリ内の「index.html」があった場合このファイルを表示します。この「/」で終わらせたときに wiki のトップページを表示するようにしたい場合です。FreeStyleWiki では、wiki.cgi が呼び出されて初めてシステムとして動くので、FreeStyleWiki での設定ではどうにもなりません。Webサーバの設定を変更します。
例えば、Webサーバソフトウェアが Apache の場合、FreeStyleWiki インストールディレクトリ内の「.htaccess」ファイルを編集し、「DirectoryIndex wiki.cgi」という一行を加えます。これで「/」で終了したアドレスの場合「wiki.cgi」を自動で呼び出すようになります。
!!dataなどのディレクトリに直接アクセスできないようにする
上記同様「.htaccess」ファイルを編集して、
<FilesMatch "\.(pm|dat|wiki|log)$">
deny from all
</FilesMatch>
を記述します。これによって、指定の拡張子（FreeStyleWiki で使うもの）以外を指定した場合にアクセス拒否されるようになります。
*公式サイトの「ドキュメント」−「readme」−「セキュリティ」
**http://fswiki.osdn.jp/cgi-bin/wiki.cgi/docs?page=readme#p4
また、変更する予定のないディレクトリのパーミッションを変更して、書き込みを不可にしてしまうのも安全のためにはいいかもしれません。しかし「data」や「config」などの書き込みを不可にするとエラーになります。
!!ページ下公式サイトへのリンクをfswiki.poi.jpからfswiki.orgに修正したい
2007年11月に公式サイトはfswiki.poi.jpからfswiki.orgにサーバ移転しました。しかし、FreeStyleWiki3.6.2においては、
Powered by FreeStyleWiki3.6.2 with Perl5.008008
となっている部分のリンクが「http://fswiki.poi.jp/」のままになっています。これを「http://fswiki.org/」に直したい場合は、
（インストールディレクトリ）/tmpl/footer.tmpl
のファイル内の記述を修正します。
*BBS-サポート掲示板/777 公式サイトのリンク変更について（公式サイト）
**http://fswiki.org/wiki.pl?page=BBS%2D%A5%B5%A5%DD%A1%BC%A5%C8%B7%C7%BC%A8%C8%C4%2F777
※バージョン3.6.3 では直っていますが、著作権表示はまだ「2002-2007」のままですね……。
【2018/3/28】バージョン3.6.5から？公式サイトは
http://fswiki.osdn.jp/cgi-bin/wiki.cgi?page=FrontPage
に移ったようです。
!!Wikiメニューをアイコン画像に変えてしまう
*BugTrack-plugin/233 Wikiメニューにアイコン画像を表示するプラグイン（公式サイト）
**http://fswiki.org/wiki.pl?page=BugTrack-plugin%2F233
!!!維持管理
!!バックアップ
基本的に、FreeStyleWiki はすべての設定をテキストファイルの形で保存しています。したがって、面倒くさければすべてのディレクトリをFTPで丸ごとコピーすればバックアップできます。それをそのまま戻せばリストアになります。
最低限、'''dataディレクトリ、attachディレクトリ、configディレクトリおよび setup.dat をコピー'''すれば、ページのデータ、添付ファイル、設定ファイルを取っておくことができます。
これは、親wiki から子wiki へのデータ移動も同じです。それぞれのディレクトリ内に「子wiki の名前のディレクトリ」ができていますので、そこに親wiki からコピーしたものをアップロードすれば、親から子へデータを移すことができます。
*データのバックアップ方法（公式サイト）
**http://fswiki.osdn.jp/cgi-bin/wiki.cgi/docs?page=readme#p6
!!バージョンアップ
公式サイトより
""設置ディレクトリ直下にあるsetup.dat、dataディレクトリ、backupディレクトリ、pdfディレクトリ、logディレクトリ、 configディレクトリ以外のファイルおよびディレクトリをいったん削除し、配布ファイルで置き換えてください。また、dataディレクトリ内の help.wikiはヘルプで表示されるページですのでこれも最新版のファイルで上書きしてください。
""setup.datはできるだけバージョン間で相違のないよう配慮していますが、止むを得ずバージョンアップ時に内容を変更する必要がある場合があります。できれば最新のファイルで上書きしたあと、設定内容を修正するようにしてください。
*バージョンアップ時の設置方法（公式サイト）
**http://fswiki.osdn.jp/cgi-bin/wiki.cgi/docs?page=readme#p5
とありますが、この通りだと不都合が生じます。attachディレクトリは添付ファイルが保存されていますが、これを削除してしまうと大変です。また、pluginディレクトリや theme ディレクトリには自分で追加したものが入っている場合がほとんどでしょうから、削除してしまうわけにはいきません。
基本的に、wiki.cgi と libディレクトリ、setup.dat ファイルの３つが FreeStyleWiki のシステムと考えて良いでしょう。setup.dat のフォーマットが変更される場合も考え、自分でカスタマイズした部分を新しく解凍した方の setup.dat ファイルをエディタで開き、記述を書き写す作業をして、wiki.cgi ファイルとlibディレクトリと共に旧バージョンをサーバから一端削除して、新しいものをアップロードします。
その後、plugin、theme、tmplディレクトリを新しいものを上書きでアップロードするのが良いでしょう。それ以外は手を付けない方が良いと思います。
!!!他のwikiとの連携
!!親子での連携
!!InterWiki
!!!所詮はwikiと割り切って
[[FreeStyleWiki 入門9]]へ