github + hexo 搭建个人博客教程

版权声明:非商业性使用,禁止演绎,转载请保留原文链接及作者 https://blog.csdn.net/qq_39478237/article/details/83352775

Github Pages介绍

本来用于介绍托管在Github上上的项目,由于它的空间免费稳定,因此适合用来搭建博客。

每个帐号只能有一个仓库来存放个人主页,且仓库的名字必须是用户名/ username.github.io。你可以通过http://username.github.io来访问你的个人主页

个人主页的网站内容是在主分支下

HEXO介绍

HEXO是一个快速,简洁高效的博客框架,具有如下特点:

  • 生成静态网页
  • 支持降价
  • 一键部署博客到Github Pages
  • 丰富插件

准备工作

安装HEXO

在任意位置右键点击Git Bash

使用NPM安装HEXO,可以先切换NPM源,加速安装过程

npm config set registry  https://registry.npm.taobao.org npm install -g hexo

【注意】若安装不成功,可以使用npm install hexo --save再次安装

出现以下图示表示安装完成。

【注】若提示此包不再保养,耐心等待安装即可。

配置HEXO

创建HEXO文件夹

在某一文件夹下如F:\ hexo \ blog,右键Git Bash在这里,使用以下命令创建建立网站需要的文件

hexo init

 标记

安装依赖包

npm安装

标记

生成静态文件

hexo generate  #生成静态文件,会在当前目录下生成一个新的名为public的文件夹

启动HEXO

hexo server -p 5000 #使用hexo server 默认端口4000,会无法访问localhost:4000,因此改为5000端口

常用HEXO命令

hexo help #查看帮助
hexo -v #查看本地环境
hexo init #初始化一个目录
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo gernerate #生成网页,可以在public目录查看整个网站的文件
hexo server #本地预览 Ctrl+C关闭
hexo deploy #或hexo d 部署到远端如github、heroku
hexo clean #清除缓存 建议每次执行命令前先清理缓存,每次部署前先删除 .deploy文件夹

#常用缩写
hexo n  #hexo new
hexo g  #hexo generate
hexo s  #hexo server
hexo d  #hexo deploy

#常用组合
hexo d -g #生成部署
hexo s -g #生成预览

Github Pages

注册GitHub的账号

地址: https://github.com/

输入账号,邮箱,密码,然后点击注册按钮.-->之后验证邮箱

创建页面仓库  

创建一个仓库,需要和帐号对应,格式yourname.github.io,创建仓库

 

 

关联本地与github上

生成SSH密钥

任意地方右键Git Bash在这里,执行以下命令

ssh-keygen -t rsa -C“你的邮箱地址”

出现输入要保存密钥的文件(.....)直接回车选择默认位置

出现输入密码(无密码短语)直接两次回车不设密码以及确认

在Github上上添加SSH密钥

打开id_rsa.pub,复制内容。

进入你的GitHub的页面,右上角找到设置,点击进去,找到SSH。

点击新的SSH密钥

mark 

填写后点击添加SSH密钥

mark 

上传部署

目录结构

  • 部署#需要部署的文件
  • node_modules #Hexo插件
  • public#生成的静态网页文件
  • scaffolds#模板
  • 来源#博客正文和其他源文件
  • drafs#草稿
  • 帖子#文章
  • 主题#主题
  • config.yml#配置文件

部署

原理

过程

  • 需要在_config.yml中修改
deploy:    
  type: git   //注意:冒号后面有英文空格
  repository: http://github.com/username/username.github.io.git
 branch: master

安装依赖包

npm install hexo-deployer-git --save

配置好之后执行

hexo genearte
hexo deploy

【注】以上命令执行的环境必须在执行hexo init创建的文件夹下执行

执行完以上命令,会出现页面输入你的github上用户名和密码,验证后就可以上传成功

访问  username.github.io,成功打开页面即部署成功

新建文章

hexo new“postname”

该命令会自动在HEXO /源极/ _post文件夹下创建一个名为postname的降价文件,会自动在文件开头添加

---
title: 你的题目
tags: 你的标签
category: 你的分类
---

填写标签,类别,新建标签页面和分类页面后即可以显示相应的标签和分类

新建标签页面

hexo新页面标签

该命令会自动在HEXO /源文件夹下创建标签文件夹并在该文件夹下创建index.md文件。

修改index.md文件,添加以下两项

layout:tags
comments:false

新建分类页面

hexo新页面类别

该命令会自动在HEXO /源文件夹下创建类别文件夹并在该文件夹下创建index.md文件

修改index.md文件,添加以下两项:

布局:类别
评论:false

最后我们hexo g -d一把,打开自己的页面查看

以下是博主搭建的博客链接 https://liuziqiao.github.io

猜你喜欢

转载自blog.csdn.net/qq_39478237/article/details/83352775