DIV CSS 佈局教程網

FCKeditor 編輯器在 Java 中的安裝與設定
編輯:JavaScript綜合知識     

工作前的準備

版本採用 FCKeditor_2.4.2.zip(元件主檔包)與 FCKeditor.Java 2.3.zip(內含標簽庫與圖片上傳的 jar)。兩者皆可於 https://www.fckeditor.net 網站下載。

設定步驟

1. 新建工程 compass,在 WebRoot 資料夾下新建名為 FCKeditor 的資料夾(用來存放 FCKeditor 相關檔案;提醒您大小寫務必一致,因為一旦要改名,牽涉的檔案較多,且不確定是否全數改到)。

2. 將 FCKeditor_2.4.2 包中的 editor 資料夾,以及 fckconfig.js、fckeditor.js、fckstyles.xml、fcktemplates.xml 這四個檔案,放到專案的 FCKeditor 目錄。

3. 將 FCKeditor.Java-2.3.zip 包中 web/WEB-INF/lib 下的兩個 jar 檔,複製到專案的 WebRoot/WEB-INF/lib 目錄。

4. 將 FCKeditor.Java-2.3.zip 包中 src 下的 FCKeditor.tld 檔,複製到專案的 WebRoot/WEB-INF 目錄。

5. 在 WebRoot 目錄下新建 UserFiles 資料夾,並在其下新建 Image、Flash、File、Media 四個子資料夾,分別用來存放上傳的圖片、動畫、檔案與媒體檔。

6. 修改 fckconfig.js 元件設定檔(可在設定檔中搜尋等號前的資訊來定位某一項):

A、FCKConfig.SkinPath = FCKConfig.BasePath + 'skins/silver/' ;
這是元件的外觀樣板,用來決定你要使用哪一種樣式,可依個人喜好調整。

B、FCKConfig.DefaultLanguage = 'zh-cn' ;
用來決定使用哪一種語言,設為上述即表示使用簡體中文。

C、修改檔案瀏覽路徑:

FCKConfig.LinkBrowserURL = FCKConfig.BasePath + "filemanager/browser/default/browser.html?Connector=connectors/jsp/connector" ;
FCKConfig.ImageBrowserURL = FCKConfig.BasePath + "filemanager/browser/default/browser.html?Type=Image&Connector=connectors/jsp/connector" ;
FCKConfig.FlashBrowserURL = FCKConfig.BasePath + "filemanager/browser/default/browser.html?Type=Flash&Connector=connectors/jsp/connector" ;
把對應的資訊屏蔽掉,改用上述寫法。

D、修改上傳檔案路徑:

FCKConfig.LinkUploadURL = FCKConfig.BasePath + 'filemanager/upload/simpleuploader?Type=File' ;
FCKConfig.FlashUploadURL = FCKConfig.BasePath + 'filemanager/upload/simpleuploader?Type=Flash' ;
FCKConfig.ImageUploadURL = FCKConfig.BasePath + 'filemanager/upload/simpleuploader?Type=Image' ;
同樣把對應資訊屏蔽掉,改用上述寫法。

7. 修改 web.xml 檔,加入以下內容(FCKeditor.Java-2.3.zip 包中有個 web/WEB-INF/WEB.XML,把該節點內容複製到專案的對應位置)。值得說明的是:

<servlet-name>Connector</servlet-name>
<servlet-class>com.fredck.FCKeditor.connector.ConnectorServlet</servlet-class>
<init-param>
<param-name>baseDir</param-name>
<!-- 此為檔案瀏覽路徑,可視需要修改,但切記不可改成 "/[工程名]/UserFiles/",因為它目前已是在工程根目錄下運作;若要把預設瀏覽目錄改為 webroot 下的 upload 目錄,只需改成 /upload/ 即可 -->
<param-value>/UserFiles/</param-value>
</init-param>
<init-param>
<servlet-name>SimpleUploader</servlet-name>
<servlet-class>com.fredck.FCKeditor.uploader.SimpleUploaderServlet</servlet-class>
<init-param>
<param-name>baseDir</param-name>
<!-- 此為檔案上傳路徑,同樣切記不可改成 "/[工程名]/UserFiles/";若要把上傳檔案放到 webroot 的 upload 目錄下,只需改成 /upload/ 即可 -->
<param-value>/UserFiles/</param-value>
</init-param>
<init-param>
<param-name>debug</param-name>
<param-value>true</param-value>
</init-param>
<init-param>
<!-- 記得改這裡,把 FALSE 改成 TRUE,這是是否啟用上傳功能 -->
<param-name>enabled</param-name>
<param-value>true</param-value>
</init-param>
<servlet-mapping>
<servlet-name>Connector</servlet-name>
<url-pattern>
/FCKeditor/editor/filemanager/browser/default/connectors/jsp/connector
</url-pattern>
</servlet-mapping>
<!-- 別忘了上面與下面粗體部分的程式碼 -->

<servlet-mapping>
<servlet-name>SimpleUploader</servlet-name>
<url-pattern>/FCKeditor/editor/filemanager/upload/simpleuploader</url-pattern>
</servlet-mapping>

優化

以上是將元件嵌入工程的設定過程,接著我們來壓縮優化,把無用檔案剔除:

刪除 WebRoot/FCKeditor/editor/filemanager/browser/default/connectors 目錄下的所有檔案,這些是用來瀏覽檔案的,而 JSP 是透過 servlet 處理,故這些檔案多餘。

刪除 WebRoot/FCKeditor/editor/filemanager/upload 目錄下的所有檔案。

刪除 WebRoot/FCKeditor/editor/lang 目錄下不需要的語言,例如保留中文【zh-cn.js】、英文【EN.js】與 fcklanguagemanager.js 檔。

刪除 WebRoot/FCKeditor/editor/skins 目錄下不需要的外觀檔案,共有三種外觀,可依需要刪除。

在 JSP 頁面上的使用

★首先在 test.jsp 頁首加上標簽宣告語句(無須做目錄調整,可直接使用):

★接著在頁面的相應位置加入呼叫語句。對於 FCK 標簽,內部還可加上許多屬性,當然也可以不加;注意下列粗體處,我用了兩個較常用的屬性,一個是高度調整,另一個是元件風格。

This is FCKeditor demo!

★接收參數可以這樣寫。

其他

1、fckconfig.js 是總設定檔,可用記事本開啟,修改後存為 utf-8 編碼。找到 FCKConfig.TabSpaces = 0 ; 改為 FCKConfig.TabSpaces = 1 ; 即可在編輯區內使用 Tab 鍵。

2、若你的編輯器還會用在網站前台(例如留言板或日記回覆),就不得不考慮安全性了。前台千萬不要使用 Default 的工具列,要麼自訂功能,要麼就用系統已定義好的 Basic 基本工具列,找到:

FCKConfig.ToolbarSets["Basic"] = [
['Bold','Italic','-','OrderedList','UnorderedList','-',/*'Link',*/'Unlink','','Style','FontSize','TextColor','BGColor','-','Smiley','SpecialChar','Replace','Preview'] ] ;

這是改過的 Basic,把圖像功能與新增連結功能都拿掉,因為圖像、連結、Flash 與圖像按鈕的新增功能都會讓前台頁面直接存取與上傳檔案。fckeditor 還支援編輯區內的滑鼠右鍵功能:

FCKConfig.ContextMenu = [
'Generic',/*'Link',*/'Anchor',/*'Image',*/'Flash','Select','Textarea','Checkbox',
'Radio','TextField','HiddenField',/*'ImageButton',*/'Button','BulletedList',
'NumberedList','TableCell','Table','Form'] ;

這也是改過的,把右鍵的「連結、圖像、FLASH、圖像按鈕」功能都拿掉。

3、找到 FCKConfig.FontNames =
'Arial;Comic Sans MS;Courier New;Tahoma;Times New Roman;Verdana' ;
加上幾種常用字體:
FCKConfig.FontNames = '宋體;黑體;隸書;楷體_GB2312;Arial;Comic Sans MS;Courier New;Tahoma;Times New Roman;Verdana' ;

4、注意上傳的檔名不可含中文,否則將無法正常顯示或連結下載。

 
 

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved