# 文章
## 新建文章
```
hexo.post.create(data, replace);
```
| 参数 | 描述 |
| --- | --- |
| `data` | 数据 |
| `replace` | 替换现有文件 |
您可以在资料中指定文章的属性,除了以下属性之外,其他属性也会被加到 front-matter 中。
| 属性 | 描述 |
| --- | --- |
| `title` | 标题 |
| `slug` | 网址 |
| `layout` | 布局。默认为 `default_layout` 参数。 |
| `path` | 路径。默认会根据 `new_post_path` 参数创建文章路径。 |
| `date` | 日期。默认为当前时间。 |
## 发布草稿
```
hexo.post.publish(data, replace);
```
| 参数 | 描述 |
| --- | --- |
| `data` | 资料 |
| `replace` | 替换现有文件 |
您可以在资料中指定文章的属性,除了以下的属性之外,其他属性也会被加到 front-matter 中。
| 属性 | 描述 |
| --- | --- |
| `slug` | 文件名称(必须) |
| `layout` | 布局。默认为 `default_layout` 参数。 |
## 渲染
```
hexo.post.render(source, data);
```
| 参数 | 描述 |
| --- | --- |
| `source` | 文件的完整路径(可忽略) |
| `data` | 数据 |
资料中必须包含 `content` 属性,如果没有的话,会尝试读取原始文件。此函数的执行顺序为:
* 执行 `before_post_render` 过滤器
* 使用 Markdown 或其他渲染器渲染(根据扩展名而定)
* 使用 [Nunjucks](http://mozilla.github.io/nunjucks/) 渲染
* 执行 `after_post_render` 过滤器
- 文档
- 开始使用
- 概述
- 建站
- 配置
- 指令
- 迁移
- 基本操作
- 写作
- Front-matter
- 标签插件(Tag Plugins)
- 资源文件夹
- 数据文件
- 服务器
- 生成文件
- 部署
- 自定义
- 永久链接(Permalinks)
- 主题
- 模版
- 变量
- 辅助函数(Helpers)
- 国际化(i18n)
- 插件
- 其他
- 问题解答
- 贡献
- API
- 核心
- 概述
- 事件
- 局部变量
- 路由
- Box
- 渲染
- 文章
- 脚手架(Scaffold)
- 主题
- 扩展
- 控制台(Console)
- 部署器(Deployer)
- 过滤器(Filter)
- 生成器(Generator)
- 辅助函数(Helper)
- 迁移器(Migrator)
- 处理器(Processor)
- 渲染引擎(Renderer)
- 标签插件(Tag)