### CuteEditor配置详解
#### 一、CuteEditor概述与安装步骤
CuteEditor是一款功能强大的富文本编辑器，支持图片、文件上传以及Word文档直接编辑等功能，适用于各种系统环境，具有良好的兼容性。本文旨在详细介绍CuteEditor的配置过程。
#### 二、配置步骤
##### 1. 复制必要的文件
需要将以下文件复制到网站根目录下的`bin`文件夹内（这些文件均可以在CuteEditor 6.0版本的`bin`文件夹下找到）：
- `CuteEditor.dll`：CuteEditor的核心组件。
- `CuteEditor.ImageEditor.dll`：用于处理图像编辑的功能库。
- `CuteEditor.ImageAssembly.dll`：图像处理相关的组件。
- `CuteEditor.lic`：授权文件。
- `NetSpell.SpellChecker.dll`：拼写检查功能库。
- `spell.dic`：拼写检查词典文件，通常为非必要文件。
如果您的项目使用的是.NET Framework，确保将上述DLL文件添加到项目引用中。
##### 2. 设置样式表和路径
将`CuteSoft_Client`文件夹放置于项目的根目录下，并在其中创建一个名为`CuteSoft_Client/CuteEditor`的文件夹，该文件夹应包含`example.css`样式表文件、各种图标以及`example.css`指向的编辑器样式文件。例如，可以设置`example.css`的路径如下：
- `FilesPath`应指向文件所在目录，如`FilesPath="~/admin/CuteSoft_Client/CuteEditor/"`
- 示例中的`example.css`文件路径设置为：`EditorWysiwygModeCss="/admin/CuteSoft_Client/CuteEditor/themes/example.css"`
##### 3. 创建上传文件夹
在项目根目录下创建一个名为`Uploads`的文件夹，用于存放用户上传的图片等文件。
##### 4. 添加DLL引用
在.NET Framework项目中，需要通过“添加引用”功能将`CuteEditor.dll`等文件添加到项目的引用列表中。这一步骤确保了编辑器能够在运行时正确加载所需的组件。
##### 5. 配置编辑器属性
在当前页面所在的目录中进行以下配置：
- **AutoConfigure**：选择`simple`模式，这会启用编辑器的简易配置模式。
- **EditorWysiwygModeCss**：指定编辑器的样式表路径，例如`EditorWysiwygModeCss="../example.css"`。
- **FilesPath**：指定上传文件的存储路径，如`FilesPath="~/CuteSoft_Client/CuteEditor/"`。
##### 6. 注册控件
在页面头部添加注册声明，以便在ASP.NET页面中使用CuteEditor控件：
```html
<%@ Register TagPrefix="CE" Namespace="CuteEditor" Assembly="CuteEditor" %>
```
然后，在页面中使用以下代码实例化编辑器：
```html
<CE:Editor id="Editor1" runat="server" Width="700px" FilesPath="~/CuteSoft_Client/CuteEditor/" EditorWysiwygModeCss="../example.css" ThemeType="Office2003_BlueTheme"></CE:Editor>
```
注意，`FilesPath`属性应指向您之前设置的文件存储路径，而`EditorWysiwygModeCss`则指向编辑器的样式表文件。
##### 7. 修改`Web.config`文件
为了确保CuteEditor能够正常工作，还需要对`Web.config`文件进行一定的修改。主要涉及以下内容：
- **appSettings**：指定词典文件夹的位置，如`<add key="DictionaryFolder" value="bin"/>`。
- **system.web**：此部分主要用于.NET 2.0环境，需要配置浏览器兼容性设置。
示例代码如下：
```xml
<appSettings>
<add key="DictionaryFolder" value="bin"/>
</appSettings>
<system.web>
<browserCaps>
<tagWriter type="System.Web.UI.HtmlTextWriter"/>
</browserCaps>
</system.web>
```
#### 三、CuteEditor配置选项详解
除了上述基本配置外，CuteEditor还提供了丰富的配置选项，帮助开发者根据具体需求调整编辑器的行为。下面是一些常用的配置项及其含义：
- **EditorWysiwygModeCss**：编辑器的样式表路径。
- **ThemeType**：编辑器的主题类型，如`Office2003_BlueTheme`。
- **AutoConfigure**：配置模式，如`simple`或`full`。
- **MaxHTMLLength**：允许的最大HTML长度，默认值为100000个字符。
- **BreakElement**：换行元素，默认为`<br/>`。
- **HTMLURLType**：HTML链接类型，默认为`Absolute`。
- **ResizeMode**：编辑器大小调整模式，默认为`None`。
- **ReadOnly**：是否只读，默认为`false`。
- **CustomCulture**：自定义文化信息，默认为中国地区`china`。
- **EditCompleteDocument**：是否编辑完整文档，默认为`false`。
- **AllowPasteHtml**：是否允许粘贴HTML，默认为`true`。
- **EnableContextMenu**：是否启用上下文菜单，默认为`true`。
#### 四、高级配置
对于更高级的配置需求，可以通过以下方式进一步调整CuteEditor的行为：
- **配置文件**：位于`CuteSoft_Client/CuteEditor/Configuration/AutoConfigure`的配置文件可用于更改编辑器的一些默认行为。
- **上下文菜单模式**：位于`CuteSoft_Client/CuteEditor/Configuration/ContextMenuMode`的配置文件可自定义编辑器的上下文菜单行为。
- **安全性配置**：位于`CuteSoft_Client/CuteEditor/Configuration/Security`的配置文件用于调整编辑器的安全性设置。
通过以上详细的配置步骤及选项说明，相信您可以顺利地将CuteEditor集成到您的项目中，并根据实际需求对其进行个性化配置。
