# 文章
## 新建文章
```
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)