Index: /FCKeditor.Java/trunk/src/site/apt/connector.apt =================================================================== --- /FCKeditor.Java/trunk/src/site/apt/connector.apt (revision 2509) +++ /FCKeditor.Java/trunk/src/site/apt/connector.apt (revision 2510) @@ -57,10 +57,10 @@ Assuming you installed the editor in the <<>> folder in your webapp.\ The Connector is now declared but disabled. The response is going to - be an error message. + be a localized error message. [[2]] Create a <<>> file in your classpath and add: +------------------------------------------------------------------------------+ - connector.userActionImpl=net.fckeditor.requestcycle.impl.TrueUserAction + connector.userActionImpl=net.fckeditor.requestcycle.impl.EnabledUserAction +------------------------------------------------------------------------------+ @@ -69,4 +69,5 @@ The Connector is now enabled. + >>>>>>>>>>>>>>>>>>>>>>>>>>>>>> Extending the Connector @@ -109,2 +110,3 @@ [] + >>>>>>>>>>>>>>>>>>>>>>>>>>>>>> Index: /FCKeditor.Java/trunk/src/site/apt/ext_overview.apt =================================================================== --- /FCKeditor.Java/trunk/src/site/apt/ext_overview.apt (revision 2509) +++ /FCKeditor.Java/trunk/src/site/apt/ext_overview.apt (revision 2510) @@ -24,6 +24,9 @@ Overview - The Java integration provides you several ways to extend and adapt itself - to your needs. + [Hint:] If you do not intend to extend the integration pack, skip this section. + An appropriate implementation will be used for every interface automatically. + + The Java integration provides you several interfaces to extend and adapt it to + your needs: * <>: Gives you full control over any action the user can do in the @@ -32,5 +35,5 @@ * <>: Enables you to construct a user-dependent file path. - * <>: You can localize any message returned by tags and + * <>: Enables you to localize any message returned by tags and the connector. Index: Keditor.Java/trunk/src/site/apt/i18n.apt =================================================================== --- /FCKeditor.Java/trunk/src/site/apt/i18n.apt (revision 2509) +++ (revision ) @@ -1,76 +1,0 @@ -~~ FCKeditor - The text editor for Internet - http://www.fckeditor.net -~~ Copyright (C) 2003-2008 Frederico Caldeira Knabben -~~ -~~ == BEGIN LICENSE == -~~ -~~ Licensed under the terms of any of the following licenses at your -~~ choice: -~~ -~~ - GNU General Public License Version 2 or later (the "GPL") -~~ http://www.gnu.org/licenses/gpl.html -~~ -~~ - GNU Lesser General Public License Version 2.1 or later (the "LGPL") -~~ http://www.gnu.org/licenses/lgpl.html -~~ -~~ - Mozilla Public License Version 1.1 or later (the "MPL") -~~ http://www.mozilla.org/MPL/MPL-1.1.html -~~ -~~ == END LICENSE == -~~ @version $Id$ - ------------------------- - Internationalization - ------------------------- - -Internationalization - - The interation pack offers you the capability to localize any string responded - to the user on a global basis and on a per locale basis dependending on the - deployed framework/system (Request, JSTL, Struts, Spring, and other). - - Read on to see how you can customize the system to your needs: - -* The interface - - The interface {{{java-core/apidocs/net/fckeditor/localization/LocaleResolver.html}<<>>}} - contains only one method: - - * <<>>: It will be passed the - current request instance on every request. It resolves the user locale according - to the underlying system or returns <<>> if it can't resolve the locale. - - [] - -** Choosing an implemenation - - [Hint:] If you do not (want to) choose an implementation, the default one - will be used. - - You have to choose an inplemenation, either an existing or a custom one. If no - existing implemention suits your need, create your own. Implement the interface - and resolve the locale the way you want. - - Existing, ready-to-go implementations: - - * {{{java-core/apidocs/net/fckeditor/localization/impl/AcceptLanguageHeaderResolver.html}<<>>}} (default): - It retrieves the first locale in the HTTP <<>> header if - availabe. - - * {{{java-core/apidocs/net/fckeditor/localization/impl/JstlResolver.html}<<>>}}: - The user locale will be retrieved from the session set by JSTL's <<>> - tag or similar. - - [] - -** Binding an implementation - - After your have chosen your desired implemenation, you have to bind it to the - system. Put the fully-qualified class name of the implementation in the - <<>>: - -+------------------------------------------------------------------------------+ - localization.localeResolverImpl= -+------------------------------------------------------------------------------+ - -* The strings - - dfdfdf Index: /FCKeditor.Java/trunk/src/site/apt/localization.apt =================================================================== --- /FCKeditor.Java/trunk/src/site/apt/localization.apt (revision 2510) +++ /FCKeditor.Java/trunk/src/site/apt/localization.apt (revision 2510) @@ -0,0 +1,82 @@ +~~ FCKeditor - The text editor for Internet - http://www.fckeditor.net +~~ Copyright (C) 2003-2008 Frederico Caldeira Knabben +~~ +~~ == BEGIN LICENSE == +~~ +~~ Licensed under the terms of any of the following licenses at your +~~ choice: +~~ +~~ - GNU General Public License Version 2 or later (the "GPL") +~~ http://www.gnu.org/licenses/gpl.html +~~ +~~ - GNU Lesser General Public License Version 2.1 or later (the "LGPL") +~~ http://www.gnu.org/licenses/lgpl.html +~~ +~~ - Mozilla Public License Version 1.1 or later (the "MPL") +~~ http://www.mozilla.org/MPL/MPL-1.1.html +~~ +~~ == END LICENSE == +~~ @version $Id$ + ------------------------- + Localization + ------------------------- + +Localization + + The interation pack offers you the capability to localize any string responded + to the user on a global basis and on a per-locale basis dependending on the + deployed framework/system (Request, JSTL, Struts, Spring, and other). + + Read on to see how you can refit the system to your needs: + +* The interface + + The interface {{{java-core/apidocs/net/fckeditor/localization/LocaleResolver.html}<<>>}} + contains only one method: + + * <<>>: On every request it will + passed the current <<>> instance. It resolves the user + locale according to the underlying system or returns <<>> if it can't + resolve the locale. + + [] + +** Choosing an implemenation + + You have to choose an inplemenation, either an existing or a custom one. If no + existing implemention suits your need, create your own. Implement the interface + and resolve the locale the way you want. + + Existing, ready-to-go implementations: + + * {{{java-core/apidocs/net/fckeditor/localization/impl/AcceptLanguageHeaderResolver.html}<<>>}} (default): + It retrieves the first locale in the HTTP <<>> header if + availabe. + + * {{{java-core/apidocs/net/fckeditor/localization/impl/JstlResolver.html}<<>>}}: + The user locale will be retrieved from the session set by JSTL's <<>> + tag or similar. + + [] + +** Declaring an implementation + + After your have chosen your desired implemenation, you have to declare it. + Put the fully-qualified class name of the implementation in your + <<>>: + ++------------------------------------------------------------------------------+ + localization.localeResolverImpl= ++------------------------------------------------------------------------------+ + +* The strings + + [Hint:] The resolver system is fail-safe concerning localized string retrieval. + This means that if a localized cannot be found, the default string + will be used. + + Each responded string can be localized on a global basis and on a per-locale basis. + Put your globally localized strings in your <<>> and your + per-locale localized strings in a <<.properties>>> file. + See the Localization chapter of the {{{properties.html}Configuration}} for a + string reference. Index: /FCKeditor.Java/trunk/src/site/apt/properties.apt =================================================================== --- /FCKeditor.Java/trunk/src/site/apt/properties.apt (revision 2509) +++ /FCKeditor.Java/trunk/src/site/apt/properties.apt (revision 2510) @@ -145,5 +145,5 @@ This section shows all messages which are responded to the user and can be - localized. See {{{i18n.html}I18n}} for more details. + localized. See {{{localization.html}Localization}} for more details. *-----------------------------------+-------------------------------------------+---------------+---------------------------------------------------+ Index: /FCKeditor.Java/trunk/src/site/site.xml =================================================================== --- /FCKeditor.Java/trunk/src/site/site.xml (revision 2509) +++ /FCKeditor.Java/trunk/src/site/site.xml (revision 2510) @@ -37,5 +37,5 @@ - +