如何使用 MarkDown 自动建站

How To Create Site Via Markdown File 关于”如何使用 MarkDown 自动建站”

1. Requirements 依赖环境

NodeJS: https://nodejs.org/en/

Git: http://git-scm.com/

2. Install 安装

npm install -g hexo-cli

3. Create 创建

hexo init <folder>

cd <folder> & npm install

生成文件结构:

_config.yml 系统配置
package.json nodejs 配置
scaffolds 写作模板
source 文字路径
  _post 发表文字路径
  _draft 草稿文字路径
themes 主题

4. 撰写文字

撰写

撰写草稿 hexo new draft <title>
发布草稿 hexo publish <title>

撰写直接发布的文章 hexo new <title>

发布

编译生成内容 hexo generate
部署发布 hexo deploy

编译并发布 hexo -d generate 或者 hexo -g deploy

5. 如何编写格式化内容

5.1 使用静态数据源

例如数据源位置

source/_data/menu.yml

templates 中使用方法

<% for (var link in site.data.menu) { %>
  <a href="<%= site.data.menu[link] %>"> <%= link %> </a>
<% } %>

5.2 资源目录

{% asset_path slug %}
{% asset_img slug [title] %}
{% asset_link slug [title] %}

例如

{% asset_img "spaced asset.jpg" "spaced title" %}

5.3 其他语法糖

引用

{% blockquote [author[, source]] [link] [source_link_title] %}
    content
    {% endblockquote %}

{% blockquote OnO http://ono.lol Darkest To Sunlight %}
    This Is A BlockQuote From A Very Famous Person. It Guides You From The Darkest Place To Light. 这是一句引用哲人的话, 他将引你走向光明.
    {% endblockquote %}

This Is A BlockQuote From A Very Famous Person. It Guides You From The Darkest Place To Light. 这是一句引用哲人的话, 他将引你走向光明.

OnODarkest To Sunlight

代码

{% codeblock [title] [lang:language] [url] [link text] %}
    code snippet
    {% endcodeblock %}

{% codeblock _.compact http://underscorejs.org/#compact Underscore.js %}
    _.compact([0, 1, false, 2, '', 3]);
    => [1, 2, 3]
    {% endcodeblock %}

_.compactUnderscore.js

\_.compact([0, 1, false, 2, '', 3]);
=> [1, 2, 3]

本例子来源于 underscorejs.org , 如有侵权请联系删除

Pull-Quote 重要引文

{% pullquote [class] %}
    content
    {% endpullquote %}

Gist 主旨要点

{% gist gist_id [filename] %}

iframe, image, link, youtube, vimeo

{% iframe url [width] [height] %}
{% img [class names] /path/to/image [width] [height] [title text [alt text]] %}
{% link text url [external] [title] %}
{% youtube video_id %}
{% vimeo video_id %}

引用代码(source/downloads/code/)

{% include_code [title] [lang:language] path/to/file %}

{% include_code HelloHexo.JS lang:javascript hello-hexo.js %}

跳转其他文字

{% post_path slug %}
{% post_link slug [title] %}

引用 asset 资源

{% asset_path slug %}
{% asset_img slug [title] %}
{% asset_link slug [title] %}

SHODAN使用说明书 _本书源自 SHODAN 官网,如有侵权请联系处理_

不转义内容

{% raw %}
    content
    {% endraw %}

raw content with [], with <>, with @, with anything you want.

6. 装饰

6.1 使用 themes 主题

进入 themes 文件夹

git clone https://github.com/levblanc/hexo-theme-aero-dual

在 /_config.yml 中, 将 landscape 更改为 hexo-theme-aero-dual

在 /themes/hexo-theme-aero-dual/_config.yml 中将 About, GitHub, Email 字段更新

重新进行 hexo generate 即可

6.2