开发工具总结(13)之Hexo制作文档并发布到GitHub
本文出自 AWeiLoveAndroid的博客
Hexo是一个很不错的文档工具,有着大量丰富的模板,很多开发者都在使用Hexo模板创建个人博客。如果你看到一个不错的模板,可以直接下载下来,然后修改一下配置,写自己的MD文件,一键生成html文件,可以直接部署到github。是不是很爽?省时省力。下面讲解一下Hexo之多文档详细的过程。
一、安装必备工具
(1)安装git(大家基本都会)
具体操作请查看我的博客:开发工具总结(3)之Git及GitHub快速入门图文全面详解https://www.jianshu.com/p/3f12bd3ccf2a
(2)安装Node.js
具体操作请查看我的博客:开发工具总结(11)之nodejs、npm和yarn安装和使用和填坑详解 https://www.jianshu.com/p/9eba0e2c0697
(3)执行npm install -g hexo-cli
下载hexo工具。
二、通用配置步骤(不管是什么hexo模板基本都有这几个步骤)
1.下载主题代码
hexo init blogname
创建一个名为blogname
的文件夹cd blogname
打开blogname
文件夹git clone https://github.com/xxx/yyy.git themes/aaa
从github下载源码,我这里选择的是https://github.com/xxx/yyy
这个库。这个命令意思是把github下载到指定文件夹里面的themes/aaa
这个文件目录。我们可以看到blogname/themes/
目录里面多了一个aaa文件夹。
2.修改hexo配置文件
修改hexo的配置文件:
blogname/_config.yml
:
例如:
# ...
title: 您自己的网站标题
subtitle: # 不需要填写
description: 您自己的网站描述
keywords: 您自己的网站关键词
author: 您的姓名
language: zh-Hans # 目前仅支持中文
timezone: # 不需要填写
permalink: passages/:title/ # 如果您需要开启评论和文章统计,请修改此配置
# 设置主题
theme: aaa # 启用 "aaa" 主题
# ...
当然这个配置有很多,根据不同的hexo主题的要求进行个性化设置即可。
3.修改主题配置文件:
主题配置文件:
blogname/themes/bmw/_config.yml
4.启动博客
执行命令
hexo s
启动博客,然后使用Chrome等主流浏览器打开 http://localhost:4000/ ,查看博客。
5.生成html源码
如果想部署到外部服务器,可以使用命令hexo g
生成html源码。
三、遇到的坑
1、项目里面的node_module
文件夹删除之后报错Local hexo not found in xxx
【解决方案】命令行进入项目路径,执行命令
npm install
。
四、美化Hexo文档(可选)
注:本文参考hexo文档地址:https://hexo.io/zh-cn/docs/ 有不懂的可以去查看。
- 通过 JS 判断页面是否有滚动条的简单方法
- Log4j官方文档翻译(六、日志的级别)
- AngularJS API之isXXX()
- 《linux c编程指南》学习手记4
- Kibana中doc与search策略的区别
- jQuery 图片查看插件 Magnify 开发简介(仿 Windows 照片查看器)
- Log4j官方文档翻译(五、日志输出的方法)
- AngularJS API之copy深拷贝
- 光标定位,隐藏光标
- AngularJS API之toJson 对象转为JSON
- Log4j官方文档翻译(七、日志格式化)
- Log4j官方文档翻译(八、文件输出)
- 《linux c编程指南》学习手记3
- Log4j官方文档翻译(九、输出到数据库)
- JavaScript 教程
- JavaScript 编辑工具
- JavaScript 与HTML
- JavaScript 与Java
- JavaScript 数据结构
- JavaScript 基本数据类型
- JavaScript 特殊数据类型
- JavaScript 运算符
- JavaScript typeof 运算符
- JavaScript 表达式
- JavaScript 类型转换
- JavaScript 基本语法
- JavaScript 注释
- Javascript 基本处理流程
- Javascript 选择结构
- Javascript if 语句
- Javascript if 语句的嵌套
- Javascript switch 语句
- Javascript 循环结构
- Javascript 循环结构实例
- Javascript 跳转语句
- Javascript 控制语句总结
- Javascript 函数介绍
- Javascript 函数的定义
- Javascript 函数调用
- Javascript 几种特殊的函数
- JavaScript 内置函数简介
- Javascript eval() 函数
- Javascript isFinite() 函数
- Javascript isNaN() 函数
- parseInt() 与 parseFloat()
- escape() 与 unescape()
- Javascript 字符串介绍
- Javascript length属性
- javascript 字符串函数
- Javascript 日期对象简介
- Javascript 日期对象用途
- Date 对象属性和方法
- Javascript 数组是什么
- Javascript 创建数组
- Javascript 数组赋值与取值
- Javascript 数组属性和方法
- JBrowse安装配置的一些教程
- 对不起,网上找的Redis分布式锁都有漏洞!
- 打卡群刷题总结0722——颜色分类
- 为什么Python没有main函数?
- 构建对象检测模型
- OpenCV4.4 + YOLOv4 真的可以运行了…..
- 基于分类任务的信号(EEG)处理
- 面试:如何决定使用 HashMap 还是 TreeMap?
- 有理有据:一篇来自前端同学对后端接口的吐槽!
- 【从0到1学算法】选择排序
- 【从0到1学算法】大O表示法
- 锦囊篇|一文摸懂AsyncTask
- 在Substrate链上跑Solidity ERC20智能合约
- 【Nginx】实现负载均衡、限流、缓存、黑白名单和灰度发布,这是最全的一篇了!
- 对称二叉树