Hexo+GitHub搭建静态博客网站

网站APP 2 个月前 回复

, ,

一、前置知识

本文档参考博客文章:http://t.csdnimg.cn/XiZky

我搭建的个人博客:https://starlike-daydream.github.io/Cesteo.github.io/

幕布文档的基本操作:(推荐用浏览器打开本文档链接,而不是用微信,手机端显示也会有问题)

每个小圆点都是一个主题,如果这个主题有子主题(会有半透明外圆环),那鼠标放在这个主题的左边就能看到小三角形,点击小三角形就可以展开。收缩这部分的主题

如果点击小圆点就会进入这个主题,只展示这个主题的部分,可以在右上角点击它的父级主题返回到之前的主题

文档里的网址链接单击即可打开,可能有些是国外网站,访问比较慢,如果下载node.js或者Git遇到问题,可以到我的Gitee下载安装Installer: 国外的软件可能会下载较慢,为了方便下载,放了一些软件的安装包 (gitee.com)(就是要注册一个Gitte)
这里以Git为例,先点进去对应安装包,再点击右方的原始数据即可

命令行的操作:后面的命令都是在命令行(cmd)或者类似命令行(Git Bash)的界面运行

打开命令行:win+R打开运行,输入cmd打开

cls : 清空屏幕

cd 目录: 更改当前所在目录

cd 当前目录的子文件夹:进入到子文件夹()

rd.. : 返回上一级目录

exit : 退出命令行

rd\ : 返回根目录

D: : 盘名加冒号切盘(无需回到根目录)

dir : 显示该目录下的文件

上下方向键回溯历史命令

Markdown文件(后缀是md的文件)的编写:推荐使用Typora(破解版链接https://gitee.com/starlike_daydream/installer/raw/master/typora-setup-x64.exe)),不需要记忆语法格式了

浏览器展示的页面文件--html文件:我们md文档将会生成html文件用于在浏览器展示。

这部分由于只给浏览页面的用户看,我们也称之为前端,这个个人博客的搭建只涉及一点前端的知识

二、下载生成个人博客所需要的软件/环境

1.Git:(第三部分会用到)

简介:分布式版本控制系统,用于上传代码/文件(这里会用到)和记录代码/文件的历史版本,合并文件改动,团队项目必备工具(详见Git教程 - 廖雪峰的官方网站)。

官网安装:Git - Downloads (git-scm.com),找到download下载(应该在左上角),若要选择版本,选择上面的64位版本(与电脑系统对应的版本)

1(64位windows版安装图示)

2

官网下载慢的话可以用我的下载链接:https://gitee.com/starlike_daydream/installer/raw/master/Git-2.43.0-64-bit.exe

如果下载的文件没有后缀名,在文件名后面加上.exe扩展名就可以安装了

检测是否安装成功:git --version,出现对应版本号即代表安装成功

后面的命令可以在Git Bash执行(在任意文件目录右击空白处选择Open Git Bash Here,没有的话就选择更多选项(win11)),也可以win+R打开运行输入cmd,在命令行运行。

如果遇到执行不成功的情况,可以尝试用管理员身份运行Git Bash/cmd

2.node.js:Node.js 中文网 (nodejs.cn)安装,进去后点击下载安装,选择长期支持版即可

官网下载慢的话可以用我的下载链接:https://gitee.com/starlike_daydream/installer/raw/master/node-v18.18.0-x64.msi

官网安装图示(windows64位版)

1.

2.

简介:Node.js 是基于 V8 JavaScript 引擎 构建的 JavaScript 运行时,可以用它搭建本地服务器,这里我们需要用到它的npm命令

检测是否安装成功:命令行运行node -v和npm -v(注意中间要有空格),出现对应版本号即代表安装成功

添加国内镜像加快下载速度:运行命令npm config set registry https://registry.npm.taobao.org(如果还是下载缓慢或者失败可以切换其他镜像源)

查看自己当前的镜像:运行命令:npm get registry

切换加速镜像源(推荐):运行命令:npm config set registry https://registry.npmmirror.com

切回官方镜像:运行命令:npm config set registry http://www.npmjs.org

其他国内镜像源:国内npm源镜像(npm加速下载) 指定npm镜像_npm 国内镜像-CSDN博客

如果说切换镜像还是不行,可以尝试取消代理,或者降低npm的版本,在尝试上面的步骤

npm config set proxy null // proxy:外部请求的代理

npm config set https-proxy null // https-proxy:用于代理https请求的

npm install npm@6.4.1 -g 用于降低npm版本

安装好node.js之后就可以用npm命令下载安装hexo了

3.Hexo的安装与配置:

简介:一个基于node.js的帮我们写好的博客框架,用了它,我们只需要修改部分内容,就能获得只属于自己的个人博客,并编写文章上传了

(1)创建一个文件夹MyBlog,以后在这个文件夹操作,存放项目文件以及博客文章

(2)运行命令:npm install -g hexo-cli:安装hexo

(3)运行命令:hexo v:查看是否安装成功,出现对应版本号即代表安装成功

(4)运行命令:hexo init:在当前目录(博客文件夹目录,而且必须为空目录)初始化一个使用hexo框架的项目(默认)

(5)运行命令:hexo generate:生成项目

(6)运行命令:hexo s/hexo server:启动本地服务器,按Ctrl键点击链接即可用默认浏览器访问,用按Ctrl+C停止运行

但只有本机能访问,想要在互联网上也能访问就需要下面的步骤

三、使用GitHub提供的免费服务器

GitHub简介:一个项目开放源代码的国外的代码托管平台,我们将用这里的GitHub仓库的Pages功能使用GitHub为我们提供的个人服务器

1.注册github账号(https://github.com/),并创建一个仓库(默认选项创建就行)-->仓库名格式要求:你的GitHub用户名.github.io

我的用户名是Cesteo,创建的仓库名就叫Cesteo.github.io

如果注册过程遇到问题,可以参考这篇博客的教程:http://t.csdnimg.cn/IKe0L

2.初始化Git的用户名和邮箱(加--global是为所有git项目设置,不加则是在当前目录的git项目设置)

注意:这里的yourname输入你的GitHub用户名,youremail输入你GitHub的邮箱。这样GitHub才能知道你是不是对应它的账户。

(1)初始化用户名--运行命令:git config --global user.name "yourname"(注意user.name/email和英文双引号"之间要有一个空格)

(2)初始化邮箱--运行命令:git config --global user.email "youremail"

(3)确认设置用户名和邮箱成功:执行以下命令

用户名:git config --global user.name

邮箱:git config --global user.email

3.ssh连接:只有连接成才能上传代码

(1)下载github部署插件:运行命令:npm install hexo-deployer-git --save

本地生成获取ssh密钥

(2)生成密钥:运行命令:ssh-keygen -t rsa -C "youremail"(这里改为自己的邮箱),可能要一路回车

(3)获取密钥:在Git Bash运行命令cat ~/.ssh/id_rsa.pub,然后复制这行命令运行的结果

github创建ssh密钥

(4)打开github,在右上角的头像下面点击settings,再点击SSH and GPG keys,新建一个SSH,名字随便取一个都可以,把你的id_rsa.pub里面的信息复制进去,点击create/创建即可完成创建

(5)验证ssh连接是否成功:ssh -T git@github.com,出现用户名,即代表访问成功

ssh连接我遇到的问题

ssh连接除了好几次错误:先是22端口拒绝连接,然后我去搜,最后发现电脑只有ssh客户端,没有ssh服务器,然后下了似乎又说真实性,yes/no什么的,这里又搜了一下,是要输yes,我的443端口没问题,不是防火墙的原因,好像少了一个kown_hosts文件

类似下图的错误,反正yes着yes着的、差不多就好了

4.生产的博客项目根目录下的_config.yml中的url,url是Pages生成的网站网址,可以第六步再配置,deploy下的repository 要配置成自己的仓库地址(记得文件要保存,如果编辑器窗口顶部的文件名前面有个星号*,那就说明话没有保存)

我的配置:

deploy的repository填deploy

特别注意这里还有个坑:修改代码时候注意空格,例如 repo: 后面都是有空格的,删除空格之后,后面运行的时候就会报错,这是编码的规定,还有就是deploy一定从行首开始写,不要加空格,注意格式

5.使用hexo的常用命令来生成网页:

(1)清除之前生成的项目--hexo clean(可以清除之前项目的一些问题)

(2)在本地生成项目--hexo g(缩写)/hexo generate

(3)把项目部署到GitHub上--hexo d(缩写)/hexo deploy

这里会让你登录GitHub

如果在GitHub创建了token,就需要在生成token时勾选repo下面这些权限

如果访问Github慢,部署失败的问题,可以在hosts文件(位于C:\Windows\System32\drivers\etc)添加我的hosts(hosts · starlike_daydream/Installer - 码云 - 开源中国 (gitee.com))的51-82行到你的hosts里(建议直接看最后一个改,可能效果好些x)

Github加速器:下载链接(最好只用于访问,建立ssh连接可能会有问题,本人亲身尝试)

*更改hosts文件可以加快访问/上传速度:https://developer.aliyun.com/article/1077240

(4)上传一个帖子/笔记:hexo new post "文件名"(这个文件就是md文档,内容将在这里编写)(位于生成的博客目录->source->_post)

(5)生成网页的连接的位置:

你创建的仓库repository-->上方菜单栏Settings-->左方菜单栏Pages-->Source选择:Deploy from a branch-->Branch选择:master,folder选择root-->点击save过一会刷新应该就会生成

(6)一般的使用步骤:编写md文档,hexo g+hexo d生成部署项目,等到GitHub的项目右上角的小圆点标识变绿(再顶部的菜单Action点击一个上传操作即可查看详细过程)即可刷新博客网页,查看生成并部署好的在线网页

(7)配置个人信息:在文件根目录下的_config.yml,就是整个hexo框架的配置文件了。可以在里面修改大部分的配置。详细可参考官方的配置描述

四、后续:个人博客还有很多炫酷的,有意思的功能,大家可以自行探索

切换主题

我使用的是这篇博客的主题:https://github.com/blinkfox/hexo-theme-matery

增加功能

可参考主题的readme文档

原文:https://mubu.com/doc/5OeZGO2XKgh

支付宝打赏微信打赏

如果此文对你有帮助,欢迎打赏作者。

发表评论

欢迎回来 (打开)

(必填)