开始使用ueditor

### 1 入门部署和体验
#### 1.1 下载编辑器
官网下载地址已经无了，这里提供github地址和gitee地址

- github地址：https://github.com/fex-team/ueditor#ueditor
- gitee地址：https://gitee.com/mirrors/ueditor

1. `git clone` 仓库
2. `npm install` 安装依赖（如果没有安装 `grunt` , 请先在全局安装 `grunt`）
3. 在终端执行 `grunt default`

#### 1.2 创建demo文件
解压下载的包，在解压后的目录创建 demo.html 文件，填入下面的html代码

```html
<!DOCTYPE HTML>
<html lang="en-US">

<head>
    <meta charset="UTF-8">
    <title>ueditor demo</title>
</head>

<body>
    
    <script id="container" name="content" type="text/plain">
        这里写你的初始化内容
    </script>
    
    <script type="text/javascript" src="ueditor.config.js"></script>
    
    <script type="text/javascript" src="ueditor.all.js"></script>
    
    <script type="text/javascript">
        var ue = UE.getEditor('container');
    </script>
</body>

</html>
```

#### 1.3 在浏览器打开demo.html
如果看到了下面这样的编辑器，恭喜你，初次部署成功！
![](/uploads/images/20240412/85912b525ad8c25153f7909af9cd9001.png)

#### 1.4 传入自定义的参数
编辑器有很多可自定义的参数项，在实例化的时候可以传入给编辑器：

```javascript
var ue = UE.getEditor('container', {
    autoHeight: false
});
```
配置项也可以通过 `ueditor.config.js` 文件修改，具体的配置方法请看[前端配置项说明](http://www.bixiaguangnian.com/manual/ueditor/1066.html "前端配置项说明")

#### 1.5 设置和读取编辑器的内容
通 `getContent` 和 `setContent` 方法可以设置和读取编辑器的内容

```javascript
var ue = UE.getContent();
//对编辑器的操作最好在编辑器ready之后再做
ue.ready(function() {
    //设置编辑器的内容
    ue.setContent('hello');
    //获取html内容，返回: <p>hello</p>
    var html = ue.getContent();
    //获取纯文本内容，返回: hello
    var txt = ue.getContentTxt();
});
```
#### 1.6 dev-1.5.0 版本二次开发自定义插件注意事项
dev-1.5.0版对于插件的加载逻辑进行了调整，但官网对应的二次开发功能文档未对相应调整做出开发细节说明，现补充如下：

除进行原有配置外，还需在实例化ueditor编辑器时在 toolbars 参数数组中，加入自定义插件的 uiname，并且注意uiname必须小写，方可正确加载自定义插件。

### 2 详细文档
ueditor 官网：http://ueditor.baidu.com (链接已失效)

ueditor API 文档：http://ueditor.baidu.com/doc (链接已失效)

ueditor github 地址：http://github.com/fex-team/ueditor

ueditor 第三方插件贡献 wiki : [第三方插件贡献规范](http://ueditor.baidu.com/website/thirdproject.html "第三方插件贡献规范") (链接已失效)

ueditor 贡献代码规范（javascript）： [javascript规范](https://github.com/fex-team/styleguide/blob/master/javascript.md "javascript规范")

### 3 第三方贡献
ueditor for nodejs 参考https://github.com/netpi/ueditor

### 4 联系我们
email：ueditor@baidu.com

issue：[github issue](http://github.com/fex-team/ueditor/issues "github issue")