GUI編集

guieditプラグイン †

概要 †

FCKeditor を使用してページを編集するための PukiWiki プラグインです。

このプラグインを使用するには別途 FCKeditor が必要となります。

特徴 †

• GUI 編集機能
  • オープンソースの WYSIWYG HTML エディタである FCKeditor を使用して Microsoft Word と同じような操作での編集が可能です。
  • PukiWiki のプラグインの挿入にも対応しています。
  • FCKeditor は PukiWiki 向けに様々なカスタマイズや機能拡張をしています。
  • 機能一覧
• Ajax テンプレート機能
  • 画面の遷移なしに雛形（テンプレート）を読み込むことができます。
  • 雛形の一覧に表示しないページを設定することができます。
• Ajax プレビュー機能
  • 画面の遷移なしにプレビューを表示します。
• 確認ダイアログ表示機能*1
  • 編集中にページを移動しようとしたときやウインドウを閉じようとしたときに確認のダイアログを表示します。
  • 誤った操作によって編集内容が失われることを防ぎます。

ダウンロード †

最新版はここからダウンロードできます。
現在のバージョンは 1.64 です。
ライセンスは GPL です。

更新履歴 †

• 過去の更新履歴

1.64 (2009/05/28) †

• IE8への仮対応（IE8では互換モードで動作するようにした）
• XHTML から PukiWiki の構文への変換の不具合を修正
  • 注釈
  • 顔文字
• 細かな仕様変更

1.63 (2009/03/06) †

• FCKeditor 2.6.4 に対応
• Firefox で編集画面の最大化時にキャレットが消える不具合を修正

1.62 (2008/12/01) †

• FCKeditor 2.6.1 〜 2.6.3 に対応
• 新機能
  • 注釈挿入/編集
  • コメント挿入/編集
• テーブルの|の前後の空白を維持するようにした
• テーブルのヘッダが２重になる不具合を修正
• インラインプラグインのインライン文字列をエンコードしないようにした
• 一部の環境で 404 エラーが出る問題を修正

1.61 (2008/04/25) †

• セルの結合ができないことがある不具合を修正
• XHTML から PukiWiki の構文への変換の不具合を修正
  • 2 x 2 以上のセルの結合
  • $line_break が 1 のときの連続した改行

1.60 (2008/04/08) †

• FCKeditor 2.6 に対応
• WebKit 522 (Safari 3) 以上に対応
• Opera 9.50 以上に対応
• 新機能
  • テキスト挿入
  • プラグイン削除
  • 添付ファイル削除
• Ajax ライブラリを 0.516 にバージョンアップ
• ブラウザのチェック・編集する構文の取得をページの読み込み後に行うように変更
• 細かな仕様変更・バグ修正

導入方法 †

ここでは、guieditプラグインの導入方法を説明します。 以下の手順にしたがって導入作業を行ってください。

1. guiedit プラグインの配置
2. FCKeditor の配置
3. PukiWiki のナビゲータにリンクを追加
4. pukiwiki.ini.php の設定

以下はguieditプラグインの追加機能です。 必要に応じて作業を行ってください。

• 見出し単位の編集
• PukiWikiのツールバーにリンクを追加

guiedit プラグインの配置 †

1. guiedit.inc.php を PukiWiki の plugin ディレクトリに配置する。
2. guiedit ディレクトリを PukiWiki の skin ディレクトリに配置する。

   PukiWikiのルートディレクトリ
   　├ plugin
   　　　└ guiedit.inc.php
   　└ skin
   　　　└ guiedit
   　　　　　├ fck_plugins
   　　　　　├ fck_skin
   　　　　　├ guiedit.js
   　　　　　└ （以下省略）
   

FCKeditor の配置 †

FCKeditor は Version 2.4 以降のものが使用可能です。

次のバージョンのBetaやRCが最新版として公開されていることもありますが、これらを使用するとプラグインが動作しない可能性があります。安定版(Latest Stable)をダウンロードして使用することをお奨めします。

1. FCKeditor のサイト http://www.fckeditor.net/ から FCKeditor をダウンロードする。
2. ダウンロードしたファイルを展開する。
3. fckeditor ディレクトリを PukiWiki の skin ディレクトリに配置する。

   PukiWikiのルートディレクトリ
   　└ skin
   　　　└ fckeditor
   　　　　　├ editor
   　　　　　├ fckeditor.js
   　　　　　└ fckconfig.js
   

PukiWiki のナビゲータにリンクを追加 †

1. skin/pukiwiki.skin.php の

   <?php _navigator('edit') ?> |

   の次の行に以下の文を追加

   <?php echo '<a href="' . $script . '?cmd=guiedit&page=' . $r_page . '">' .
              $lang['guiedit'] . '</a>' ?> |

2. ja.lng.php の

   $_LANG['skin']['edit']      = '編集';

   の次の行に以下の文を追加

   $_LANG['skin']['guiedit']   = '編集（GUI）';

pukiwiki.ini.php の設定 †

• JavaScript を有効にするために、PKWK_ALLOW_JAVASCRIPT を 1 にする。

  // PKWK_ALLOW_JAVASCRIPT - Allow / Prohibit using JavaScript
  define('PKWK_ALLOW_JAVASCRIPT', 1);

• guiedit プラグインでは非推奨要素を使用しているため、$pkwk_dtd を次のいずれかに変更する。
  • PKWK_DTD_XHTML_1_0_TRANSITIONAL
  • PKWK_DTD_HTML_4_01_TRANSITIONAL

    /////////////////////////////////////////////////
    // Change default Document Type Definition
    
    // Some web browser's bug, and / or Java apprets may needs not-Strict DTD.
    // Some plugin (e.g. paint) set this PKWK_DTD_XHTML_1_0_TRANSITIONAL.
    
    //$pkwk_dtd = PKWK_DTD_XHTML_1_1; // Default
    //$pkwk_dtd = PKWK_DTD_XHTML_1_0_STRICT;
    //$pkwk_dtd = PKWK_DTD_XHTML_1_0_TRANSITIONAL;
    //$pkwk_dtd = PKWK_DTD_HTML_4_01_STRICT;
    //$pkwk_dtd = PKWK_DTD_HTML_4_01_TRANSITIONAL;

見出し単位の編集 †

見出し単位の編集を有効にする場合は以下の内容を変更する。

• lib/convert_html.php の Body クラスの getAnchor メソッド内の

  $anchor = ' &aname(' . $id . ',super,full){' . $_symbol_anchor . '};';

  の次の行に以下の文を追加

  $anchor .= " &guiedit(#$id,paraedit,nolabel);";

• pukiwiki.ini.php で $fixed_heading_anchor と $fixed_heading_anchor_edit を 1 にする。

  $fixed_heading_anchor = 1;
  $fixed_heading_anchor_edit = 1;

PukiWikiのツールバーにリンクを追加 †

Toolbarにguieditを追加したい場合は以下の手順で行います。

1. ja.lng.php の

   $_LANG['skin']['edit']      = '編集';

   の次の行に以下の文を追加します。

   $_LANG['skin']['guiedit']   = '編集（GUI）';

2. lib/html.php の

   $_LINK['edit']     = "$script?cmd=edit&page=$r_page";

   の次の行に以下の文を追加します。

   $_LINK['guiedit']  = "$script?cmd=guiedit&page=$r_page";

3. skin/pukiwiki.skin.php の

   $_IMAGE['skin']['edit']     = 'edit.png';

   の次の行に以下の文を追加します。

   $_IMAGE['skin']['guiedit']  = 'edit.png';

4. skin/pukiwiki.skin.php の

   <?php _toolbar('edit') ?>

   の次の行に以下の文を追加します。

   <?php _toolbar('guiedit') ?>

編集画面が表示されない場合 †

手順どおりに設定を行っても、GUI編集画面が表示されない場合は mbstring の設定に問題があります。

php.ini に以下の設定を追加してください。

mbstring.language = Japanese
mbstring.internal_encoding = EUC-JP
mbstring.http_input = auto
mbstring.http_output = pass
mbstring.encoding_translation = Off

PukiWiki で推奨されている mbstring の設定は下記のページを参照してください。

• mbstring(PukiWiki公式サイト)

使用方法 †

• 基本機能
• 表の挿入/編集
• プラグインの挿入/編集
• 添付ファイルの挿入/編集
• ショートカットキー
• カスタマイズ

対応するブラウザ †

guiedit プラグイン （最新版） は以下のブラウザに対応しています。

• Trident III （MSHTML 5.5） 以上のレンダリングエンジンを利用したブラウザ (Windows) 推奨
  • Internet Explorer 5.5 以上
• Gecko 1.4 (20030210) 以上のレンダリングエンジンを利用したブラウザ (Windows / Mac / Linux) 推奨
  • Firefox 1.0 以上
  • Netscape 7.1 以上
  • Camino 1.0 以上
• WebKit 522 以上のレンダリングエンジンを利用したブラウザ (Windows / Mac / Linux)
  • Safari 3.0 以上
• Opera 9.50 以上 (Windows / Mac / Linux)

各ブラウザでの使用上の注意は以下をご覧下さい。

全般 †

• JavaScript を有効にしてください。
• guiedit または FCKeditor のバージョンアップ後、正常に編集できないときはブラウザのキャッシュを削除してみて下さい。

Trident (Internet Explorer) †

• IE コンポーネントブラウザでは、ウインドウを閉じようとしたときに確認ダイアログが表示されません。（BUG:KB253201）

WebKit (Safari) †

• オブジェクトが選択できません。（Ticket #58）
  • プラグイン・添付ファイルの編集に影響します。
  • プラグイン・添付ファイルを削除するときは必ずコンテキストメニューの「プラグイン削除」「添付ファイル削除」から行ってください。

Opera †

• FCKeditor のコンテキストメニューを利用する為にブラウザの設定が必要です。
  1. ブラウザのメニューバーの「ツール」から「設定」を選択するとダイアログが開く。
  2. 「詳細設定」→「コンテンツ」→「JavaScript オプション」を選択するとダイアログが開く。
  3. 「右クリックを制御するスクリプトを許可する」にチェックを入れる。

掲示板 †

質問、要望、バグなどがあれば掲示板に書き込んで下さい。

リンク †

• FCKeditor