# 寫作
你可以執行下列命令來創建一篇新文章。
```
$ hexo new [layout] <title>
```
您可以在命令中指定文章的布局(layout),默認為 `post`,可以通過修改 `_config.yml` 中的 `default_layout` 參數來指定默認布局。
### 布局(Layout)
Hexo 有三種默認布局:`post`、`page` 和 `draft`,它們分別對應不同的路徑,而您自定義的其他布局和 `post` 相同,都將儲存到 `source/_posts` 文件夾。
| 布局 | 路徑 |
| --- | --- |
| `post` | `source/_posts` |
| `page` | `source` |
| `draft` | `source/_drafts` |
> **不要處理我的文章**
>
> 如果你不想你的文章被處理,你可以將 Front-Matter 中的`layout:` 設為 `false` 。
### 文件名稱
Hexo 默認以標題做為文件名稱,但您可編輯 `new_post_name` 參數來改變默認的文件名稱,舉例來說,設為 `:year-:month-:day-:title.md` 可讓您更方便的通過日期來管理文章。
| 變量 | 描述 |
| --- | --- |
| `:title` | 標題(小寫,空格將會被替換為短杠) |
| `:year` | 建立的年份,比如, `2015` |
| `:month` | 建立的月份(有前導零),比如, `04` |
| `:i_month` | 建立的月份(無前導零),比如, `4` |
| `:day` | 建立的日期(有前導零),比如, `07` |
| `:i_day` | 建立的日期(無前導零),比如, `7` |
### 草稿
剛剛提到了 Hexo 的一種特殊布局:`draft`,這種布局在建立時會被保存到 `source/_drafts` 文件夾,您可通過 `publish` 命令將草稿移動到 `source/_posts` 文件夾,該命令的使用方式與 `new` 十分類似,您也可在命令中指定 `layout` 來指定布局。
```
$ hexo publish [layout] <title>
```
草稿默認不會顯示在頁面中,您可在執行時加上 `--draft` 參數,或是把 `render_drafts` 參數設為 `true` 來預覽草稿。
## 模版(Scaffold)
在新建文章時,Hexo 會根據 `scaffolds` 文件夾內相對應的文件來建立文件,例如:
```
$ hexo new photo "My Gallery"
```
在執行這行指令時,Hexo 會嘗試在 `scaffolds` 文件夾中尋找 `photo.md`,并根據其內容建立文章,以下是您可以在模版中使用的變量:
| 變量 | 描述 |
| --- | --- |
| `layout` | 布局 |
| `title` | 標題 |
| `date` | 文件建立日期 |
- 文檔
- 開始使用
- 概述
- 建站
- 配置
- 指令
- 遷移
- 基本操作
- 寫作
- Front-matter
- 標簽插件(Tag Plugins)
- 資源文件夾
- 數據文件
- 服務器
- 生成文件
- 部署
- 自定義
- 永久鏈接(Permalinks)
- 主題
- 模版
- 變量
- 輔助函數(Helpers)
- 國際化(i18n)
- 插件
- 其他
- 問題解答
- 貢獻
- API
- 核心
- 概述
- 事件
- 局部變量
- 路由
- Box
- 渲染
- 文章
- 腳手架(Scaffold)
- 主題
- 擴展
- 控制臺(Console)
- 部署器(Deployer)
- 過濾器(Filter)
- 生成器(Generator)
- 輔助函數(Helper)
- 遷移器(Migrator)
- 處理器(Processor)
- 渲染引擎(Renderer)
- 標簽插件(Tag)