FCKeditor配置文档
这是我以前翻译的fckeditor的文档,原来由于百度空间支持的文章字数太少,所以分成了几个部分,感觉挺有用的,所以转到这里来.
最近做网站总是需要编辑器,选择了fckeditor,所以花了点时间研究了下,发现官网(www.fckeditor.net)和网上都没有现成的文档下载,尤其是中文的,所以我就把官网上的配置文档读了一遍,顺便翻译了一下,可惜百度空间不支持附件功能,只能贴在这里了(还没有翻完,以后继续啦):
FCKcofing
作者:phynix (我以前的网名)
本文随意转载
编辑器行为(Editor Behavior)
1. AutoDetectPasteFromWord 自动检测粘贴内容来自word. 默认为true
2. BaseHref 设置输入框内资源的URL前缀 默认为空
3. CleanWordKeepsStructure 默认为false,所以按word的格式粘贴.
4. ContentLangDirection 决定文档的顺序
5. DefaultLinkTarget 连接打开方式,有_blank,_self,_parent,_self,默认为空
6. DocType 设置html的DocType 默认为空
7. ForcePasteAsPlainText 强制去掉粘贴其他格式,默认为false
8. FullPage 设置是否全页显示,默认为false
9. LinkDlgHideTarget 隐藏页面中的 从…打开 选项,而使用DefaultLinkTarget的设置.
10. MaxUndoLevels 设置最大撤销次数,默认为15.
11. StartupFocus 设置加载fckedior的当前页时是否自动把焦点移到fckedi上.默认为false.
12. StartupShowBlocks 是否显示区块,即一个段落用显示的方式提示,默认为false,建议设置为true.
13. TemplateReplaceAll 是否替换所有模板,如果为true,则全部替换,否则,在光标后插入,默认为true.
14. TemplateReplaceCheckbox 如果为true,则当替换模板时会出现模板对话框checkbox,否则checkbox不会出现且应用TemplateReplaceAll的设置,默认为true.
15. ToolbarComboPreviewCSS 设置工具条的组合CSS样式的css文件路径,默认为空.
HTML输出控制(HTML Output)
16. AdditionalNumericEntities 附加的数字实体.说明,这个也是困扰我好长时间的东西,数字实体应该也是html对特殊符号的一种编码方式,比方说单引号(‘)的数字实体是'而不是\’,还有一种常用的编码方式是:举个例子,空格的编码为 默认为空,添加的方式为正则表达式.
17. EnterMode 设置按下Enter键时候编辑器的变化,可以的值是p,div,br.
18. FillEmptyBlocks 默认为true,此时在表格单元的空白出默认插入空格符.
19. ForceSimpleAmpersand 强制编辑器在属性上输出简单的and符(&),而不是&清冽推荐不使用,因为不符合W3C规范.
20. FormatIndentator 格式缩进符号设置,默认为四个空格.
21. FormatOutput 如果设置为true,默认将在一些html标记和段落缩进之间加换行符.默认为true
22. FormatSource 如果设置为true,在切换到源代码视图时在一些html标记和段落缩进之间添加换行符.
23. HtmlEncodeOutput 如果设置为true,输出的某些字符将被编码,包括&,<,>.
24. IgnoreEmptyParagraphValue 如果设置为true,如果编辑器提交的是一个空的段落,则编辑器返回空值(“”).
25. IncludeGreekEntities 如果设置为true,则把希腊字母转化为对应的html实体,例如, α对应的html实体为α.W3C建议这么做,但是并不是必要的,尤其在希腊语的上下文中.
26. IncludeLatinEntities 如果设置为true,则把编辑器中的latin符号转化成相应的html实体,例如, á被转化为á.默认为true,W3C建议这么做,但也不是必须的.
27. ProcessHtmlEntities 把所有W3C规定的特殊字符转化为相应的html实体表示,可以使用IncludeGreekEntities和IncludeLatinEntities把某些字符排除在外.默认为true.
28. ProcessNumericEntities 把所有的非ASCII码的字符转化为相应的UNICODE数字实体.默认为false.
29. ShiftEnterMode 设置按下shift和enter键时编辑器的行为.可能的值为div,p,br.
30. TabSpaces 设置当按下TAB键时空间的大小,确切的说是 的个数,默认为0,所以默认情况下按下TAB没有任何空格而且会跳到另一个组件上去.
用户接口(Uuser Interface)
31. AutoDetectLanguage 检测浏览器或者系统的语言,如果设置为true,则编辑器的语言和浏览器和系统的一样,默认为true.如果fckeditor编辑器不支持系统的的语言,则DefaultLanguage就会被使用.
32. ContextMenu 通过这个设置,我们可以改变上下文菜单,也就是说当我们创建一个组件后如果想修改它的属性,在组件的像素点上点击右键,可以找到所谓的上下文菜单,通过ContextMunu可以对各种组件的上下文菜单进行定制,在ContextMenu数组里的组件是有上下文菜单的,如果哪个组件从数组中除掉了,那么就没有了高级上下文菜单,只有一些基础的上下文菜单,例如cut,copy,paste.默认为所有的基本组件.
33. DefaultFontFormatLabel 定义默认使用的格式(最下面一行菜单的一个格式选择框).
34. DefaultFontSizeLabel 功能同DefaultFontFormatLabel相似(对应于大小选择框).
35. DefaultFontLabel 功能同DefaultFontFormatLabel相似(对应于字体选择框).
36. DefaultLanguage 设置编辑器的默认字体,如果AutoDetectLanguage被设置为true,则此选项不起作用.支持的语言为:
· Afrikaans (af)
· Arabic (ar)
· Basque (eu)
· Bengali/Bangla (bn)
· Bulgarian (bg)
· Catalan (ca)
· Chinese Simplified (zh-cn)
· Chinese Traditional (zh)
· Croatian (hr)
· Czech (cs)
· Danish (da)
· Dutch (nl)
· Esperanto (eo)
· Faroese (fo)
· Finnish (fi)
· French (fr)
· Galician (gl)
· German (de)
· Greek (gr)
· Hindi (hi)
· Hungarian (hu)
· Italian (it)
· Japanese (jp)
· Korean (ko)
· Lithuanian (lt)
· Norwegian (no)
· Persian (fa)
· Polish (pl)
· Portuguese (Brazil) (pt-br)
· Portuguese (Portugal) (pt)
· Romanian (ro)
· Russian (ru)
· Serbian Cyrillic (sr) and Serbian Latin (sr-latn)
· Slovak (sk)
· Slovenian (sl)
· Spanish (es)
· Swedish (sv)
· Thai (th)
· Turkish (tr)
· Ukrainian (uk)
· Vietnamese (vi)
注意,设置的字体的书写格式为括号里的简写方式.默认为en.
37. DefaultStyleLabel 功能同DefaultFontFormatLabel相似(对应于样式选择框).
38. DisableFFTableHandles 关闭firefox的table tools功能,默认为true.
39. DisableObjectResizing 关闭对象(图片,表格等)的修改大小功能,默认为false.
40. EnableMoreFontColors 启用颜色选择中的更多其他颜色,默认为true.
41. FlashDlgHideAdvanced 隐藏插入flash对话框中的高级选项,默认为false.
42. FloatingPanelsZIndex 设置属性时出来的悬浮窗口的z-index值,默认为10000.
43. ImageDlgHideLink 隐藏图片设置属性对话框中的连接属性,默认为false.
44. ImageDlgHideAdvanced 隐藏图片设置对话框中的高级选项,默认为false.
45. KeyStrokes 定义编辑器的快捷键.
46. LinkDlgHideAdvanced 隐藏连接属性的高级选项.
47. ShowBorders 当在编辑器中编辑时,如果加入一个表格且设置border为0,如果ShowBorders为true,虽然为0,但是可以看到单元格以便于编辑(提交时还是为0).
48. ShowDropDialog 此设置依赖ForcePasteAsPlainText.如果ForcePasteAsPlain为true,则粘贴内容则为纯文本,如果ShowDropDialog为true,则在粘贴是也进行此项检查并提示对话框.
49. SkinPath 设置编辑器皮肤的路径,有default,office2003,silver,默认为default.
50. SourcePopup 选择点击源代码按钮时编辑器的行为,默认为false,即在原来的文本框里面显示,如果设置为true,则会新出现一个层用来编辑源代码.
51. SmileyColumns 设置表情对话框的表情图片列数,默认为8.
52. SmileyWindowHeight 设置表情对话框的高度,默认为240像素.
53. SmileyWindowWidth 设置表情对话框的宽度,默认为320像素.
54. ToolbarCanCollapse 设置是否工具栏可以收起/张开,默认为true.
55. ToolbarStartExpanded 设置加载时默认工具栏的表现方式,默认为true,工具栏张开,可以看到所有的组件,如果设置为false,则隐藏.
56. ToolbarLocation 设置工具条的位置,有以下几个选项:默认为和编辑区域一起,在他的顶部;第二种是None,没有工具条显示;第三种Out:[Targetld] 把工具条作为一个元素放在页面里;第四种Out:[TargetWindow]([Targetld])把工具条放到一个窗口(iframe)里.默认为In.
57. ToolbarSets 自定义工具栏.用[]来分开各个部分.分隔符有[]部分分隔,/为换行,-为管道符|,默认为全部,可以自定义位置和各项功能.
58. BodyId BodyClass 设置编辑器的默认bodyid 和bodyclass,然后可以在相应的css文件中设置样式.
59. CoreStyles 编辑器的核心样式表,不建议增加和删除,可以修改.
60. CostomStyles 自定义样式属性.
61. FontColors 自定义工具栏中的字体颜色和背景颜色.可以从列表中删除/添加.
62. FontFromats 自定义工具栏中的格式(format)列表中的内容.可以添加或者删除.
63. FontNames 自定义工具栏中的字体列表.
64. FontSize 自定义工具栏的fontsize(大小).值得一提的是可是使用字符串类型,smaller,larger,也可以使用css属性,14px,1.5em,80%等.
65. IndentClasses 使用CSS indent class,必须现在EditorAreaCSS中定义,然后在IndentClasses中应用.使用改功能后,IndentLength和IndentUnit会被覆盖.
66. IndentLength 编辑器的缩进量,默认为40px.注意和IndentUnit的关系
67. IndentUnit 使用的缩进单位,默认为px,也可以设置称为cm或者mm.
68. JustifyClass 允许使用css的对齐功能,必须现在EditorAreaCSS中定义,然后在Justify中应用.
69. RemoveFormatTags 定义在使用去除格式中去除的标签格式.只能应用于内嵌标签,所以h1,或者pre都不起作用.
70. StylesXmlPath 设置定义style的xml文件的路径.
可能我以后会用到,也可能自己写编辑器,先收藏下了。。。