码迷,mamicode.com
首页 > 其他好文 > 详细

HEXO【别人看不了】

时间:2018-07-29 16:31:06      阅读:268      评论:0      收藏:0      [点我收藏+]

标签:ora   header   oca   esc   new   zh-cn   --   日记   表达式   

什么是 Hexo?

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。

安装前提

安装 Hexo 相当简单。然而在安装前,您必须检查电脑中是否已安装下列应用程序:

安装 Hexo

所有必备的应用程序安装完成后,即可使用 npm 安装 Hexo。

$ npm install -g hexo-cli

hexo初始化

安装 Hexo 完成后,请在自定义文件夹下打开Git Bash并执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。npm简介

$ hexo init
$ npm install

创建一篇文章

$ hexo new [layout] <title>

新建一篇文章。如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话,请使用引号括起来。
这篇文章可以通过搜索找到文件夹,此处不赘述,找到位置可以用typora等专用markdown文件进行编辑,但要注意有可能修改到文档的开头部分造成无法generate

清除缓存

$ hexo clean

清除缓存文件 db.json和已生成的静态文件 public

在某些情况(尤其是更换主题后),如果发现您对站点的更改无论如何也不生效,您可能需要运行该命令。

生成静态文件

$ hexo generate
可以用以下命令代替
$ hexo g
选项 描述
-d, --deploy 文件生成后立即部署网站
-w, --watch 监视文件变动

启动本地服务

$ hexo server

启动服务器。默认情况下,访问网址为: http://localhost:4000/

选项 描述
-p, --port 重设端口
-s, --static 只使用静态文件
-l, --log 启动日记记录,使用覆盖记录格式

此处我们已经完成了网站的本地创建,并可以通过http://localhost:4000/进行查看

获得一个github账号并创建repo,命名为yourname.github.io

搭桥到github

配置github账户信息(YourName和YourEail都替换成你自己的):

网站部署

$ hexo deploy
该命令可以简写为:
$ hexo d
参数 描述
-g, --generate 部署之前预先生成静态文件

YAML 是专门用来写配置文件的语言,非常简洁和强大,我们的配置文件就是这种格式。需要了解的只有:

# 我是文配置件的注释

重要提示,例如:“theme: landspace”中冒号右边是半角空格,要切换到英文状态哟

网站site

参数 描述
title 网站标题
subtitle 网站副标题
description 网站描述
author 您的名字
language 网站使用的语言
timezone 网站时区。Hexo 默认使用您电脑的时区。时区列表。比如说:America/New_York, Japan, 和 UTC

其中,description主要用于SEO,告诉搜索引擎一个关于您站点的简单描述,通常建议在其中包含您网站的关键词。author参数用于主题显示文章的作者。

网址URL

参数 描述 默认值
url 网址
root 网站根目录
permalink 文章的 永久链接 格式 :year/:month/:day/:title/
permalink_defaults 永久链接中各部分的默认值

网站存放在子目录

如果您的网站存放在子目录中,例如 http://yoursite.com/blog,则请将您的 url 设为 http://yoursite.com/blog 并把 root 设为 /blog/

目录Directory

即:后面的参数都是文件夹的名称

参数 描述 默认值
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 表达式来匹配路径。

提示

如果您刚刚开始接触Hexo,通常没有必要修改这一部分的值。
没到自己制作theme的水平别修改!!!!!!!!!!!!!!

文章Writing

参数 描述 默认值
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 代码块的设置

相对地址

默认情况下,Hexo生成的超链接都是绝对地址。例如,如果您的网站域名为example.com,您有一篇文章名为hello,那么绝对链接可能像这样:http://example.com/hello.html,它是绝对于域名的。相对链接像这样:/hello.html,也就是说,无论用什么域名访问该站点,都没有关系,这在进行反向代理时可能用到。通常情况下,建议使用绝对地址。

分类 & 标签Category & Tag

参数 描述 默认值
default_category 默认分类 uncategorized
category_map 分类别名
tag_map 标签别名

日期 / 时间格式Date / Time format

Hexo 使用 Moment.js 来解析和显示时间。

参数 描述 默认值
date_format 日期格式 YYYY-MM-DD
time_format 时间格式 H:mm:ss

分页Pagination

参数 描述 默认值
per_page 每页显示的文章量 (0 = 关闭分页功能) 10
pagination_dir 分页目录 page

扩展Extensions

参数 描述
theme 当前主题名称。值为false时禁用主题
deploy 部署部分的设置

HEXO【别人看不了】

标签:ora   header   oca   esc   new   zh-cn   --   日记   表达式   

原文地址:https://www.cnblogs.com/hebust/p/9385466.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!