在asp中fckeditor的使用手册范本

在asp中fckeditor的使用手册范本
在asp中fckeditor的使用手册范本

使用手册

.基本页(就是编辑器所在页)以及装入编辑器的JS脚本

.用来建立编辑器的脚本

.编辑器的语言和皮肤.

.建立编辑器.

.载入预置的编辑文档容.

.从现在开始 ,用户可以阅读和编辑文档了,不过,拖拽支持以及工具栏都是不可用的

.载入编辑器引擎脚本

.建立工具栏,并且可用

.从现在开始,编辑器的所有功能都已经完整

.载入工具栏图标

脚本压缩

在打包任何新版本时,编辑器的JS脚本将会进行预处理.预处理步骤如下:

.移除所有代码注释

.移除所有无用的空白字符.

.将脚本合并成几个文件

使用上面的方法,我们可以将脚本文件的大小压缩到原来的50%.

压缩后 ,原始的代码仍然存在于一个名为_Source的文件夹中

如何打包?

编辑器已经自带了打包程序,它位于FCKEDITOR的根文件夹中_PACKAGER文件夹中,名为Fckeditor.Packager.exe,将其复制到FCKEDITOR根文件夹中并运行,即可自动将JS脚本打包并压缩

需要注意的是该程序是一个.NET程序,必须安装.NET FRAMEWORK才能使用

想要获取支持?

如果你捐赠15000欧元,你就可以获得1年的免费技术支持(比较贵的说,相当于人民币15万,不过西欧的费用相当惊人)

如何安装?

1.下载最新版的FCKEDITOR

2.解压缩到你的站点根文件夹中名为FCKEDITOR的文件夹中(名称必须为FCKEDITOR,因为配置文件中已经使用此名称来标示出 FCKEDITOR的位置)

3.现在,编辑器就可以使用了,如果想要查看演示,可以按下面方法访问:

/FCKeditor/_samples/default.html

注意:你可以将FCKEDITOR放置到任何文件夹,默认情况下,将其放入到FCKEDITOR文件夹是

最为简单的方法.如果你放入的文件夹使用别的名称,请修改配置文件夹中编辑器BasePath参数,如下所示:

oFckeditor.BasePath="/Components/fckeditor/";

另外,FCKEDITOR文件夹中所有以下划线开头的文件夹及文件,都是可选的,可以安全的从你的发布中删除.它们并不是编辑器运行时必需的

如何将FCKEDITOR整合进我的页面?

由于目前的版本提供的FCKEDITOR仅提供了JAVASCRIPT式的整合,因此,这里仅讲述如何应用JAVASCRIPT来整合FCKEDITOR 到站点中,当然,其他各种语言的整合,你可以参考_samples文件夹中的例子来完成

1,假如编辑器已经安装在你的站点的/FCKEDITOR/文件夹下.那么,第一步我们需要做的就是在页面的HEAD段中放入SCRIPT标记以引入 JAVASCRIPT整合模块.例如:

其中路径是可更改的

2,现在,FCKEDITOR类已经可以使用了.有两个方法在页面中建立一个FCKEDITOR编辑器:

方法1:联方式(建议使用):在页面的FORM标记需要插入编辑器的地方置入以下代码:

script type="text/javascript">

var oFCKeditor = new FCKeditor( 'FCKeditor1' ) ;

oFCKeditor.Create() ;

方法2:TEXTAREA标记替换法(不建议使用):在页面的ONLOAD事件中,添加以下代码以替换一个已经存在的TEXTAREA标记

3.现在,编辑器可以使用了

FCKEDITOR类参考:

下面是用来在页面中建立编辑器的FCKEDITOR类的说明

构造器:

FCKeditor( instanceName[, width, height, toolbarSet, value] )

instanceName:编辑器的唯一名称(相当于ID)

WIDTH:宽度

HEIGHT:高度

toolbarSet:工具条集合的名称

value:编辑器初始化容

属性:

instanceName:编辑器实例名

width:宽度,默认值为100%

height:高度,默认值是200

ToolbarSet:工具集名称,参考FCKCONFIG.JS,默认值是Default

value:初始化编辑器的HTML代码,默认值为空

BasePath:编辑器的基路径,默认为/Fckeditor/文件夹,注意,尽量不要使用相对路径.最好能用相对于站点根路径的表示方法,要以/结尾

CheckBrowser:是否在显示编辑器前检查浏览器兼容性,默认为true

DisplayErrors:是否显示提示错误,默为true;

集合:

Config[Key]=value;

这个集合用于更改配置中某一项的值,如

oFckeditor.Config["DefaultLanguage"]="pt-br";

方法:

Create()

建立并输出编辑器

RepaceTextArea(TextAreaName)

用编辑器来替换对应的文本框

如何配置FCKEDITOR?

FCKEDITOR提供了一套用于定制其外观,特性及行为的设置集.主配置文件名为Fckconfig.js

你既可以编辑主配置文件,也可以自己定义单独的配置文件.配置文件使用JAVASCRIPT语法.

修改后,在建立编辑器时,可以使用以下语法:

var oFCKeditor = new FCKeditor( 'FCKeditor1' ) ;

oFCKeditor.Config['CustomConfigurationsPath'] = '/myconfig.js' ;

oFCKeditor.Create() ;

提醒:当你修改配置后,请清空浏览器缓存以查看效果

配置选项:

AutoDetectLanguage=true/false 自动检测语言

Basehref="" _fcksavedurl="""" 相对的基地址

ContentLangDirection="ltr/rtl" 默认文字方向

ContextMenu=字符串数组,右键菜单的容

CustomConfigurationsPath="" 自定义配置文件路径和名称

Debug=true/false 是否开启调试功能,这样,当调用FCKDebug.Output()时,会在调试窗中输出容

DefaultLanguage="" 缺省语言

EditorAreaCss="" 编辑区的样式表文件

EnableSourceXHTML=true/false 为TRUE时,当由可视化界面切换到代码页时,把HTML处理成XHTML

EnableXHTML=true/false 是否允许使用XHTML取代HTML

FillEmptyBlocks=true/false 使用这个功能,可以将空的块级元素用空格来替代FontColors="" 设置显示颜色拾取器时文字颜色列表

FontFormats="" 设置显示在文字格式列表中的命名

FontNames="" 字体列表中的字体名

FontSizes="" 字体大小中的字号列表

ForcePasteAsPlainText=true/false 强制粘贴为纯文本

ForceSimpleAmpersand=true/false 是否不把&符号转换为XML实体

FormatIndentator="" 当在源码格式下缩进代码使用的字符

FormatOutput=true/false 当输出容时是否自动格式化代码

FormatSource=true/false 在切换到代码视图时是否自动格式化代码

FullPage=true/false 是否允许编辑整个HTML文件,还是仅允许编辑BODY间的容GeckoUseSPAN=true/false 是否允许SPAN标记代替B,I,U标记

IeSpellDownloadUrl=""下载拼写检查器的网址

ImageBrowser=true/false 是否允许浏览服务器功能

ImageBrowserURL="" 浏览服务器时运行的URL

ImageBrowserWindowHeight="" 图像浏览器窗口高度

ImageBrowserWindowWidth="" 图像浏览器窗口宽度

LinkBrowser=true/false 是否允许在插入时浏览服务器

LinkBrowserURL="" 插入时浏览服务器的URL

LinkBrowserWindowHeight=""目标浏览器窗口高度

LinkBrowserWindowWidth=""目标浏览器窗口宽度

Plugins=object 注册插件

PluginsPath="" 插件文件夹

ShowBorders=true/false 合并边框

SkinPath="" 皮肤文件夹位置

SmileyColumns=12 图符窗列数

SmileyImages=字符数组图符窗中图片文件名数组

SmileyPath="" 图符文件夹路径

SmileyWindowHeight 图符窗口高度

SmileyWindowWidth 图符窗口宽度

SpellChecker="ieSpell/Spellerpages" 设置拼写检查器

StartupFocus=true/false 开启时FOCUS到编辑器

StylesXmlPath="" 设置定义CSS样式列表的XML文件的位置

TabSpaces=4 TAB键产生的空格字符数

ToolBarCanCollapse=true/false 是否允许展开/折叠工具栏

ToolbarSets=object 允许使用TOOLBAR集合

ToolbarStartExpanded=true/false 开启是TOOLBAR是否展开UseBROnCarriageReturn=true/false 当回车时是产生BR标记还是P或者DIV标记

如何自定义样式列表呢?

FCKEDITOR的样式工具栏中提供了预定义的样式,样式是通过XML文件定义的,默认的XML样式文件存在于FCkEditor根文件夹下的 FckStyls.xml文件中

这个XML文件的结构分析如下: