Hexo Docs(二)- 基本用法

上一篇将『开始准备』部分大致说完了,接下来是『基本用法』部分。

这部分Docs分了8块内容,分别从写作、前置声明、标签插件、资源目录、数据文件、服务器、生成器、部署。也许翻译得不得当,但是我尽量把主要内容呈现出来并加上自己的理解。

1、写作

写作之前当然得先创建一个.md文件,使用命令hexo new [layout] <title>,其中layout默认为post,前面提过。

(1)Layout布局

Hexo提供了3种默认的布局,postpagedraft,路径分别为:source/_postssourcesource/_draft。如果你将在文章前置申明中,将layout设置为false,那么这篇文章将不会有任何的布局。

(2)Filename文件名

Hexo会默认将文章的标题当做文件名,但是你可以编辑_config.yml配置文件中的new_post_name来改变默认的文件名。

例如:使用hexo new hello命令创建一篇为hello文章,Hexo会默认在_posts目录下给你创建一个名为hello.md的文件。假如你将new_post_name改为了:year-:month-:day-:title.md,那么hexo就自动帮你创建名为2015-05-16-hello.md(当前日期为2015年5月16)

  • :title 文章标题
  • :year 创建年份
  • :month 月份,如4月为04
  • :day 日期
  • i_month 月份,单数字,比如4月就是4
  • i_day 同上

(3)Drafts草稿

Hexo提供草稿功能,在_drafts目录下的文章不会发表到网站上,你可以通过命令hexo publish [layout] <title>发布你的草稿,改命令会将文章移到_posts目录下。但是也可以设置_config.yml配置文件的render_drafts字段,使草稿默认发布到站点中。

(4)Scaffolds模版

当你使用new命令创建一篇文章的时候,Hexo会根据scaffolds目录中的模版帮你生成文章。假如执行hexo new photo "My Gallery",Hexo会尝试在scaffolds目录中去寻找photo.md的模版文件,然后基于它创建标题为My Gallery的文章。

它的用处就是能够在模版中写入你某一类文章都要添加的共同内容,这样你基于模版创建文章的时候,就不用再重复写入那部分内容。

2、前置申明

顾名思义,就是写在文章前面的一块内容,为了对文章进行某些设置。它有两种书写方式:

  1. YAML方式,以三短线结束

     title: Hello World
     date: 2013/7/13 20:46:25
     ---
    
  2. JSON方式,以三分号结束

     "title": "Hello World",
     "date": "2013/7/13 20:46:25"
     ;;;
    

下面看看有哪些参数可以设定:

  • layout 布局,一般不用写,默认就行
  • title 标题,这个必须要有
  • date 时间
  • updated 修改时间
  • comments 是否开启评论,默认为true
  • tags 文章标签
  • categories 文章分类
  • permalink 文章永久链接,一般不用写,默认就行

在写标签和分类的时候,可能会有多个的情况,多个标签可以无序排列的方式书写,而分类可能会有多级分类的情况。如何书写举例如下:

categories: 
- Sports
- Baseball
tags:
- Injury
- Fight
- Shocking

3、标签插件

这里说的标签插件不同于文章中的标签,它可以帮助你在文章中快速嵌入一些特殊的内容。

(1)Block Quote-块引用

插入带有作者信息的应用,体现在Html上就是在blockquote标签下加入了footer标签。但是会给文章带来不一样的显示效果,书写格式非常简单。

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

看下面的例子就大概知道怎么书写了,第一种最简单的方式就等于markdown里的>语句。

显示效果为(主题为light-ch):

(2)Code Block代码块

在文章中插入代码块可以使用下面方式书写

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

同样举个例子,用法一目了然。

显示效果如下:

(3)Pull Quote

这个插件可以帮助您在文章中插入重要引述。

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

(4)jsFiddle

在文章中嵌入jsFiddle片段。

{% jsfiddle shorttag [tabs] [skin] [width] [height] %}

(5)Gist

嵌入Gist片段

{% gist gist_id [filename] %}

(6)iFrame

插入网页框架

{% iframe url [width] [height] %}

(7)Image

插入图片,可以自定义大小

{% img [class names] /path/to/image [width] [height] [title text [alt text]] %}

(8)Link

插入带有target="_blank"属性值的链接。

{% link text url [external] [title] %}

(9)Include Code

从资源目录中插入代码片段。

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

(10)Youtube

在文章中插入Youtube视频。天朝的孩子就不用试了

{% youtube video_id %}

(11)Vimeo

在文章中插入Vimeo视频。

{% vimeo video_id %}

(12)Include Posts

包含其他文章的链接。

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

(13)Include Assets

包含文章资源。(具体怎么使用,还不太明白,后续再补充)

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

(14)Raw

一些内容不想被主题渲染,可以使用该插件呈现原始状态。

{% raw %}
content
{% endraw %}

4、资源目录

Assets指的是那些不在source目录下的资源,比如图片、CSS文件或者Javascript文件。Hexo提供一种更方便的方法来管理这些资源(Assets)。想使其生效,首先修改post_asset_folder字段的设置,将其值改为true

当生效后,在你创建文章的时候,Hexo会创建一个同名目录,你可以将该文章关联的资源全部放到该目录下。这样就可以更加方便的使用它们了。

使用方法就是上面介绍过的标签插件。

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

5、数据文件

有时,你可能会使用一些不在post中的模版数据,或者你想复用这些数据,那么你可以试用一下Hexo3中的『Data files』功能。这个特性加载source/_data目录中的YAML或者JSON文件,从而用到你的网站中。

例如,在source/_data目录中添加menu.yml文件。内容如下:

Home: /
Gallery: /gallery/
Archives: /archives/

在模版中,你可以这样使用它。

{% for link in site.data.menu %}
  <a href="{{ link }}">{{ loop.key }}</a>
{% endfor %}

6、服务器

(1)Hexo server

在Hexo3中,服务器模块从主模块中分开了,你可以通过安装hexo-server来使用它。

npm install hexo-server --save

安装完成后,通过运行命令hexo server来启动本地服务。可以通过http://localhost:4000或者http://0.0.0.0:4000来访问你的网站。服务启动后,Hexo会监视文件的改动情况并且自动更新,也就是说你修改网站内容后不必重启服务器就可以见到效果。

如果你想修改端口,可以通过hexo server -p 5000命令来指定端口。

hexo server -s启动静态模式,在静态模式中,只有public文件夹下的文件才会被放到服务器上,并且文件监听功能关闭。你可以在运行hexo g命令后运行该命令,通常用于生产系统中。

hexo server -i 192.168.1.1指定IP访问,可以替代默认的0.0.0.0.

(2)Pow

Pow是Mac上一个零配置的服务架构。通过curl get.pow.cx | sh命令下载并安装该软件;然后链接到项目文件夹中,步骤如下:

cd ~/.pow
ln -s /path/to/myapp index

通过上面命令,会在~/.pow目录下创建一个index的链接文件指向你的hexo根目录,然后你就可以通过访问http://index.dev就可以看到你的主页了。

7、生成器

这个很简单,hexo generate一条命令生成静态站点。可以使用缩写hexo g,还可以显示你修改的文件并且重新生成,使用命令hexo g --watch,还用两种用法可以跟部署结合起来,hexo g -d or hexo d -g,指的是生成后马上部署站点。

8、部署

部署的方式有多种,这里我主要介绍一下Git的方式,因为GitHub提供Pages功能,可以直接将站点部署到Github上。

主要就是设置_config.yml配置文件,

deploy:
    type: git
    repo: https://github.com/pengloo53/pengloo53.github.io.git
    branch: master

这样就设置好了,注意将repo改成自己的。其他方式类似。部署命令很简单,hexo d就OK了。

PS: 有些不太明白的地方后续再更新。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,923评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,154评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,775评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,960评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,976评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,972评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,893评论 3 416
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,709评论 0 271
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,159评论 1 308
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,400评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,552评论 1 346
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,265评论 5 341
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,876评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,528评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,701评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,552评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,451评论 2 352

推荐阅读更多精彩内容