FckEditor（包括使用说明）.rar

------------------------------------------------- FCKeditor - JSP Integration Pack ver 2.3 ------------------------------------------------- --------------- Contents: --------------- 1 - Preface 2 - Installation 3 - Usage 4 - Building 5 - Future plans 6 - Donations 7 - Further information and support 8 - History -------------------- 1 - Preface -------------------- This is the JSP Integration Pack for using FCKeditor inside a java server page without the complexity of using a Java scriptlets or the javascript api. I hope you find it usefull. This package contains just the integration library. To setup a full working environment you need to download the latest version of FCKEditor (http://sourceforge.net/project/showfiles.php?group_id=75348&package_id=75845) -------------------- 2 - Installation -------------------- Installing FCKeditor in a JSP environment is quite easy: - Unzip the Java Integration Library in a directory named "FCKeditor" - Unzip the content of the FCKEditor release of your choise inside the "FCKeditor\web" folder - then you have to create in tomcat (or any servlet container) a new context named "FCKeditor" that points to the previously created "FCKeditor\web" folder - point your browser to http://domainName.ext/FCKeditor/_samples/default.jsp for the list of the samples -------------------- 3 - Usage -------------------- Take a look at the test files and in the javadoc api provided in the distribution. Anyway, for the lazy ones, here is a simple example First put this taglib definiton at the top of the JSP page <%@ taglib uri="http://fckeditor.net/tags-fckeditor" prefix="FCK" %> then the tag: <FCK:editor id="EditorAccessibility" //Unique name of the editor width="80%" //Width height="120" //Height toolbarSet="Accessibility" //Toolbar name >This is another test. <BR><B>The "Second" row.</B></FCK:editor> A more advance example, that show how to use the inner tags to overrides any of the settings specified in the config.js file <FCK:editor id="EditorDefault" basePath="/FCKeditor/" styleNames=";Style 1;Style 2; Style 3" fontNames=";Arial;Courier New;Times New Roman;Verdana" > This is some <B>sample text</B>. </FCK:editor> -------------------- 4 - Building -------------------- Inside the files there is the source files for the tags (/src) and the ant build file (build.xml) The ant build file provides the following tasks: - all: Clean build and dist directories, then compile - clean: Delete old build and dist directories - compile: Compile Java sources - dist: Create binary distribution - javadoc: Create Javadoc API documentation - release: Create Release Distribution Plus some Tomcat managing tasks (to make this tasks work you need to copy inside the "web" folder the FCKeditor package): - install: Create a web application pointing to the build directory - reload: Recompiles and reload the web application - remove: remove the web application To start building the class you first need to modify the "catalina.home" property inside the build.xml, then type "ant dist" to compile, create the javadoc API description and generate the jar library to be copied in the WEB-INF. Or more easily, type "ant install" after setting the right username and password for the tomcat manager application. -------------------- 5 - Future plans -------------------- * Integrate with Struts (so that FCKeditor can retrive and pass informations from Form Beans) * Integrate with mcpuk FileManager -------------------- 6 - Donations -------------------- I'm now starting to accept donations on the Sourceforge website: so if you like the jsp integration taglib, or are you using it on a commercial application, please help the development of next version of the taglib donating to my SF user. To donate please go to my SF page at http://sourceforge.net/users/simo/ and click on "Make a Donation". Doing this donation you will also help the Apache Foundation and SourceForge.net Also, donation bigger than 30� will have a one year priority support. -------------------- 7 - Further informations and support -------------------- For further informations refers to http://www.fckeditor.net/ For support specific with this JSP integration taglib send an email to simo@users.sourceforge.net. Due to the increased number of requests, from now on support is delivered with a "best effort" approach. To be sure to have a priority support please refer to paragraph #6 and please make a donation to my user. -------------------- 8 - History -------------------- 2.3 - 2005/08/11 - Added support for the FCKeditor 2.0 Final Release - Added a new servlet named SimpleUploader to process direct uploads (without passing through the File Browser) TAGLIB: - Added the following attributes: flashBrowserURL linkUploadURL imageUploadURL flashUploadURL CONNECTOR: - Removed some forgotten debug messages 2.2 - 2005/06/21 - Summer Edition TAGLIB: - Fixes the following bugs: [ 1200635 ] TLD fails when running under Resin app server [ 1200085 ] Opera Browser is detected incorrectly [ 1190264 ] NullPointerException in FCKeditor.isCompatible() [ 1190239 ] calling FCKeditor.create() multiple times corrupts content 2.1 - 2005/03/29 - Changed naming of the package - Provides just the jsp files, without the full editor as the previous versions TAGLIB: - Made the taglib similar to the .NET custom tag, so: * Added all attributes available for the .NET integration package (almost all custom config) * Removed the "config" tag CONNECTOR: - Added "debug" init-parameter for the connector SAMPLES: - Implemented all sample files provided by the javascript version - Samples now work out-of-the-box, since the connector configuration is set inside the tag 2.0b2 (1.0 beta 2 for 2.0b2) - 2004/11/03 - Fixes the following bugs: [ 1058945 ] user-agent parsing exception [ 1032971 ] Browserversion of Mozilla: StringIndexOutOfBoundsException 2.0b1 (1.0 beta 1 for 2.0b2) - 2004/09/13 - New stand alone package - Fixes the following bugs: [ 970740 ] ConnectorServlet not working [ 991489 ] getNameWithoutExtension [ 1025909 ] [Firefox 0.9.2] Resource browser works partially - Uploaded files and images are now shown with a absolute path (starting from the root of the site) and not as relatives from the editor directory 1.0 - 2004/05/09 Available just with the 1.6 release of FCKeditor. This is the 1.x compatible taglib