在GitHub,一个项目对应唯一的Git版本库,创建一个新的版本库就是创建一个新的项目。访问仪表板(Dashboard)页面,如图3-1,可以看 到关注的版本库中已经有一个,但自己的版本库为零。在显示为零的版本库列表面板中有一个按钮“New Repository”,点击该按钮开始创建新版本库。
进入代码库创建页面:
在Repository name
下填写yourname.github.io
,Description (optional)
下填写一些简单的描述(不写也没有关系),如图所示:
正确创建之后,你将会看到如下界面:
下图可以看到访问协议增加了一个支持读写的SSH协议,访问地址为:git@github.com:gotgithub/helloworld.git。注意任何GitHub用户均可使用该URL访问此公开版本库,但只有版本库建立者gotgithub具有读写权限,其他人只有只读权限。在初始化版本库之前,最好先用公钥进行认证。(参考:http://zuyunfei.com/2013/04/10/setup-github-ssh-key/)
配置公钥验证后,显示如下:
$ ssh -T git@github.com Hi gotgithub! You‘ve successfully authenticated, but GitHub does not provide shell access.
-------------------------------------------------------------------------------------------------------------------------------
在本地克隆新建立的版本库。
$ git clone git@github.com:gotgithub/gotgithub.github.io.git
$ cd gotgithub.github.io/
在版本库根目录中创建文件index.html作为首页。
$ printf "<h1>GotGitHub‘s HomePage</h1>It works.\n" > index.html
建立提交。
$ git add index.html
$ git commit -m "Homepage test version."
推送到GitHub,完成远程版本库创建。
$ git push origin master
-----------------------------------------------------------------------------------------------------------------
访问网址: http://gotgithub.github.io/ 。
最多等待10分钟,GitHub就可以完成新网站的部署。网站完成部署后版本库的所有者会收到邮件通知。
还有要注意访问用户二级域名的主页要使用HTTP协议非HTTPS协议。
在自己认为合适的地方创建一个文件夹,然后在文件夹空白处按住Shift
+鼠标右键,然后点击在此处打开命令行窗口。(同样要记住啦,下文中会使用在当前目录打开命令行
来代指上述的操作)
在命令行中输入:
npm install hexo-cli -g
然后你将会看到:
可能你会看到一个WARN
,但是不用担心,这不会影响你的正常使用。 然后输入
npm install hexo --save
然后你会看到命令行窗口刷了一大堆白字,下面我们来看一看Hexo是不是已经安装好了。 在命令行中输入:
hexo -v
如果你看到了如图文字,则说明已经安装成功了。
接着上面的操作,输入:
hexo init
如图:
然后输入:
npm install
之后npm将会自动安装你需要的组件,只需要等待npm操作即可。
继续操作,同样是在命令行中,输入:
hexo g
如图:
然后输入:
hexo s
然后会提示:
INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.
在浏览器中打开http://localhost:4000/
,你将会看到:
到目前为止,Hexo在本地的配置已经全都结束了。
在配置过程中请使用yamllint来保证自己的yaml语法正确
此段落引用自Hexo官方文档
您可以在 _config.yml
中修改大部份的配置。
参数 | 描述 |
---|---|
title |
网站标题 |
subtitle |
网站副标题 |
description |
网站描述 |
author |
您的名字 |
language |
网站使用的语言 |
timezone |
网站时区。Hexo 默认使用您电脑的时区。时区列表。比如说:America/New_York , Japan , 和 UTC 。 |
参数 | 描述 | 默认值 |
---|---|---|
url |
网址 | |
root |
网站根目录 | |
permalink |
文章的 永久链接 格式 | :year/:month/:day/:title/ |
permalink_default |
永久链接中各部分的默认值 |
如果您的网站存放在子目录中,例如 http://yoursite.com/blog
,则请将您的 url
设为 http://yoursite.com/blog
并把 root
设为 /blog/
。
参数 | 描述 | 默认值 |
---|---|---|
source_dir |
资源文件夹,这个文件夹用来存放内容。 | source |
public_dir |
公共文件夹,这个文件夹用于存放生成的站点文件。 | public |
tag_dir |
标签文件夹 | tags |
archive_dir |
归档文件夹 | archives |
category_dir |
分类文件夹 | categories |
code_dir |
Include code 文件夹 | `downloads/code |
i18n_dir |
国际化(i18n)文件夹 | :lang |
skip_render |
跳过指定文件的渲染,您可使用 glob 表达式来匹配路径。 |
参数 | 描述 | 默认值 |
---|---|---|
new_post_name |
新文章的文件名称 | :title.md |
default_layout |
预设布局 | post |
auto_spacing |
在中文和英文之间加入空格 | false |
titlecase |
把标题转换为 title case | false |
external_link |
在新标签中打开链接 | true |
filename_case |
把文件名称转换为 (1) 小写或 (2) 大写 | 0 |
render_drafts |
显示草稿 | false |
post_asset_folder |
启动 Asset 文件夹 | false |
relative_link |
把链接改为与根目录的相对位址 | false |
future |
显示未来的文章 | true |
highlight |
代码块的设置 |
参数 | 描述 | 默认值 |
---|---|---|
default_category |
默认分类 | uncategorized |
category_map |
分类别名 | |
tag_map |
标签别名 |
Hexo 使用 Moment.js 来解析和显示时间。
参数 | 描述 | 默认值 |
---|---|---|
date_format |
日期格式 | MMM D YYYY |
time_format |
时间格式 | H:mm:ss |
参数 | 描述 | 默认值 |
---|---|---|
per_page |
每页显示的文章量 (0 = 关闭分页功能) | 10 |
pagination_dir |
分页目录 | page |
参数 | 描述 |
---|---|
theme |
当前主题名称。值为false 时禁用主题 |
deploy |
部署部分的设置 |
首先,你需要为自己配置身份信息,打开命令行,然后输入:
git config --global user.name "yourname"
git config --global user.email "youremail"
同样在_config.yml
文件中,找到Deployment
,然后按照如下修改:
deploy:
type: git
repo: git@github.com:yourname/yourname.github.io.git
branch: master
如果使用git方式进行部署,执行npm install hexo-deployer-git --save
来安装所需的插件
然后在当前目录打开命令行,输入:
hexo d
随后按照提示,分别输入自己的Github账号用户名和密码,开始上传。 然后通过http://yourname.github.io/来访问自己刚刚上传的网站。
打开Hexo目录下的source
文件夹,所有的文章都会以md形式保存在_post
文件夹中,只要在_post
文件夹中新建md类型的文档,就能在执行hexo g
的时候被渲染。 新建的文章头需要添加一些yml信息,如下所示:
---
title: hello-world //在此处添加你的标题。
date: 2014-11-7 08:55:29 //在此处输入你编辑这篇文章的时间。
categories: Exercise //在此处输入这篇文章的分类。
toc: true //在此处设定是否开启目录,需要主题支持。
---
如果成功完成了上述的全部步骤,恭喜你,你已经搭建了一个最为简单且基础的博客。但是这个博客还非常简单, 没有个人的定制,操作也比较复杂,下面的进阶技巧将会让你获得对Hexo更为深入的了解。
可以在此处寻找自己喜欢的主题 下载所有的主题文件,保存到Hexo目录下的themes
文件夹下。然后在_config.yml
文件中修改:
# Extensions
## Plugins: http://hexo.io/plugins/
## Themes: http://hexo.io/themes/
theme: landscape //themes文件夹中对应文件夹的名称
然后先执行hexo clean
,然后重新hexo g
,并且hexo d
,很快就能看到新主题的效果了~
首先,需要注册一个域名。在中国的话,.cn
全都需要进行备案,如果不想备案的话,请注册别的顶级域名,可以使用godaddy或新网或万网中的任意一家,自己权衡价格即可。 然后,我们需要配置一下域名解析。推荐使用DNSPod的服务,比较稳定,解析速度比较快。在域名注册商出修改NS服务器地址为:
f1g1ns1.dnspod.net
f1g1ns2.dnspod.net
以新网为例,首先点击域名管理进入管理页面:
然后点击域名后面的管理
:
进入域名管理的操作界面,点击域名管理
,来到域名管理界面:
点击修改域名DNS
,然后选择填写具体信息
,在下面的空框中填入DNSPod的NS服务器:
然后我们进入DNSPod的界面,开始真正进入域名解析的配置= =。在DNSPod中,首先添加域名,然后分别添加如下条目:
最后,我们对Github进行一下配置。
在自己本地的hexo目录下的source
文件夹中,新建一个CNAME
文件(注意,没有后缀名。),内容为yourdomin.xxx
。然后再执行一下hexo d -g
,重新上传自己的博客。 在github中打开你自己的库,进入库的setting界面,如果看到了如下提示,说明配置成功了。
在这一系列的操作中,包括修改NS服务器,设置A解析等等,都需要一定的时间。短则10分钟,长则24小时,最长不会超过72小时。如果超过72小时,请检查自己的配置过程,或者修改自己本地的DNS服务器。
参考:
https://xuanwo.org/2015/03/26/hexo-intor/
http://www.cnblogs.com/liuxianan/p/build-blog-website-by-hexo-github.html
http://luckystar88.github.io/2015/08/31/%E4%BD%BF%E7%94%A8hexo-github%E6%90%AD%E5%BB%BA%E4%B8%AA%E4%BA%BA%E5%8D%9A%E5%AE%A2/
http://theme-next.iissnan.com/
原文:http://www.cnblogs.com/sos-blue/p/6431265.html