Update English doc

ryhnatwoods · Feb 26, 2015 · 2e6d4ce · 2e6d4ce
1 parent 80d99f7
commit 2e6d4ce
Show file tree

Hide file tree

Showing 55 changed files with 1,121 additions and 2,096 deletions.
diff --git a/source/_data/menu.yml b/source/_data/menu.yml
@@ -1,5 +1,5 @@
 docs: /docs/
-api: /api/
+# api: /api/
 news: /news/
 plugins: /plugins/
 themes: /themes/
diff --git a/source/docs/asset-folders.md b/source/docs/asset-folders.md
@@ -0,0 +1,19 @@
+title: Asset Folders
+---
+Assets are non-post files in `source` folder, such as images, CSS or JavaScript files. Hexo provides a more convenient way to manage assets. To enable this, modify `post_asset_folder` setting.
+
+``` yaml
+post_asset_folder: true
+```
+
+Once `post_asset_folder` setting is enabled, Hexo will create a folder with the same name as the new post. You can put all assets related to the post into the folder. So that you can use them more easily.
+
+## Tag Plugins
+
+Several tag plugins are added in Hexo 3 for you to include assets in posts more easily.
+
+```
+{% asset_path slug %}
+{% asset_img slug %}
+{% asset_link slug [title] %}
+```
diff --git a/source/docs/cli-clean.md b/source/docs/cli-clean.md
diff --git a/source/docs/cli-config.md b/source/docs/cli-config.md
diff --git a/source/docs/cli-deploy.md b/source/docs/cli-deploy.md
diff --git a/source/docs/cli-generate.md b/source/docs/cli-generate.md
diff --git a/source/docs/commands.md b/source/docs/commands.md
@@ -16,8 +16,6 @@ $ hexo new [layout] <title>
 
 Creates a new article. If `layout` isn't defined, it'll equal the `default_layout` setting in [_config.yml](configuration.html). If the title is more than one word, wrap it with quotation marks.
 
-**Alias:** n
-
 ## generate
 
 ``` bash
@@ -26,8 +24,6 @@ $ hexo generate
 
 Generates static files.
 
-**Alias**: g
-
 Option | Description
 --- | ---
 `-d`, `--deploy` | Deploy after generate done
@@ -41,8 +37,6 @@ $ hexo publish [layout] <filename>
 
 Publishes a draft.
 
-**Alias**: p
-
 ## server
 
 ``` bash
@@ -51,14 +45,11 @@ $ hexo server
 
 Starts server.
 
-**Alias:** s
-
 Option | Description
 --- | ---
 `-p`, `--port` | Override default port
 `-s`, `--static` | Only serve static files
 `-l`, `--log` | Enable logger. Override logger format.
-`-d`, `--drafts` | Serve drafts as normal posts.
 
 ## deploy
 
@@ -68,13 +59,9 @@ $ hexo deploy
 
 Deploys your website.
 
-**Alias:** d
-
 Option | Description
 --- | ---
-`--setup` | Setup without deployment
 `-g`, `--generate` | Generate before deployment
-`-m`, `--message` | Customize commit message
 
 ## render
 
@@ -153,3 +140,19 @@ $ hexo --config custom.yml
 ```
 
 Customize config file path instead of `_config.yml`.
+
+### Display drafts
+
+``` bash
+$ hexo --draft
+```
+
+Display draft posts in `source/_drafts` folder.
+
+### Customize CWD
+
+``` bash
+$ hexo --cwd /path/to/cwd
+```
+
+Customize the path of current working directory.
diff --git a/source/docs/configuration.md b/source/docs/configuration.md
@@ -1,8 +1,6 @@
 title: Configuration
 ---
-You can modify most options in `_config.yml`.
-
-## Configuration
+You can modify most settings in `_config.yml`.
 
 ### Site
 
@@ -51,7 +49,7 @@ Setting | Description | Default
 `external_link` | Open external links in new tab | true
 `filename_case` | Transform filename into (1) lower case or (2) upper case | 0
 `render_drafts` | Display drafts | false
-`post_asset_folder` | Enables [Asset Folder](writing.html#Asset_Folder) | false
+`post_asset_folder` | Enables [Asset Folder](asset-folders.html) | false
 `relative_link` | Make links relative to root folder | false
 `future` | Display future posts | true
 `highlight` | Code block settings |