电脑本地搭建Hexo博客部署到Github

一首先安装 node.jsgit1安装node.js访问 Node.js 官网 下载电脑版安装2安装Git访问 Git 官网 下载电脑版安装3查看下Node.js、Git版本确保安装无误显示版本号说明安装成功4安装好 git 后续都是打开 Git Bash 运行命令验证安装node-vnpm-vgit-v二安装 Hexonpminstall-ghexo-cliHexo查看版本hexov显示下面的说明安装成功这些 warn 只是警告可执行下面命令不再拦截# 1. 查看当前被拦截的脚本列表确认是 hexo-utilnpminstall-scriptsls# 2. 全局允许 hexo-util 运行安装脚本 不再拦截npmconfigsetallow-scriptshexo-util--locationuser1安装完 hexo 后在桌面手动创建 Hexo 文件夹点击空白处鼠标右键打开 Git Bash也可执行cd~/Desktop/Hexo2初始化 hexohexo init初始化成功会在当前文件夹下生成hexo文件├── _config.landscape.yml主题配置文件。 ├── _config.yml站点配置文件对站点进行配置。 ├── node_modules用来存储已安装的各类依赖包。 ├── package-lock.json包版本依赖锁文件。 ├── package.json应用数据Hexo的版本以及相关依赖包的版本等。 ├── scaffolds博客模版文件夹包含page.mdpost.mddraft.md三种。 ├── source资源文件夹存放静态资源如博客md文件、图片等。 └── themes主题文件夹Hexo通过将网站内容与主题组合来生成静态网站。3安装依赖npminstall启动本地预览cd~/Desktop/Hexohexo s如下图说明启动成功访问 http://localhost:4000/ 就可以查看博客了本机IP:4000如果关闭了cmd 窗口需要重新运行桌面 Hexo 文件夹内点击空白处鼠标右键打开 Git Bash或是cd~/Desktop/Hexohexo s三hexo常用命令1启动本地预览hexo s2新建文章hexo n我的第一篇博客 Hexo Hello!3清除缓存hexo clean4生成静态文件hexo g5部署到 github 仓库hexo d6组合命令hexo cleanhexo ghexo s说明清缓存生成页面启动本地预览或者部署到远程仓库hexo cleanhexo ghexo d运行 hexo每次新建文章或者修改配置都执行三步四安装主题以 Fluid 为例Fluid主题 fluid官方文档配置指南Hexo Fluid 用户手册Hexo-Fluid主题美化参考这里hexo主题网站主题网站拉取 Fluid 主题成功后 theme 目录下没有 fluid 文件夹创建软链接执行下边命令ln-s$(pwd)/node_modules/hexo-theme-fluidthemes/fluid创建主题配置文件cpthemes/fluid/_config.yml _config.fluid.yml然后编辑 _config.fluid.yml 来个性化你的博客比如修改导航栏、首页信息、颜色主题等修改根目录的 _config.ymltheme: fluid或者在 Git Bash 中用命令直接替换 _config.yml 中的主题配置sed-is/theme: .*/theme: fluid/_config.yml四部署到远程仓库GitHub1注册 github 账号github官网2新建仓库仓库名最好和用户名一样这里只做演示和用户名一样github 博客地址就是 https://用户名.github.io/而不是 https://用户名.github.io/仓库名.github.io/用户名格式需要注意必须是 用户名 .github.io3添加远程仓库地址新建的仓库初始化一下再添加远程地址gitinitgitremoteaddorigin gitgithub.com:你的用户名/你的仓库名.git验证远程仓库是否关联成功git-v4安装 Hexo 部署插件用于将静态文件部署到 GitHubnpminstallhexo-deployer-git--save5修改 桌面 Hexo 目录下_config.yml 文件记事本编辑打开底部 deploy 位置复制进去替换deploy: type:gitrepo: gitgithub.com:你的用户名/你的仓库名.git branch: main6配置SSH钥匙用 hexo d 部署需要设置一下#输入自己的邮箱地址创建一对密钥ssh-keygen-ted25519-C你的邮箱example.com查看公钥cat~/.ssh/id_ed25519.pub如果遇到下面问题安装 Git 后不要用系统 CMD而是在桌面 Hexo文件夹点击空白处鼠标右键打开 Git Bash或是命令进入cd~/Desktop/Hexo7执行下边命令打开秘钥目录start /c/Users/Administrator/.ssh/8记事本编辑打开 id_rsa.pub 公钥文件复制下来到 github点你的头像有个setting进去后点 SSH and GPG keys 配置公钥配置好公钥了检查一下ssh-Tgitgithub.com输入yes9设置用户信息gitconfig--globaluser.namegithub名字#用户名gitconfig--globaluser.emailgithub注册的邮箱#填写自己的邮箱检查一下ssh-Tgitgithub.com10配置完成后部署到 github 仓库hexo cleanhexo ghexo d11部署成功后 github 仓库会多出来文件12打开仓库在 Pages 设置页面打开 main 分支然后点击 Save最好看一下 _config.yml 里面是哪个分支重要提示GitHub Pages 设置的发布分支必须与_config.yml中deploy配置的branch保持一致。如果您的_config.yml中配置的是branch: main那么 GitHub Pages 也必须选择main分支作为发布源如果配置的是branch: master则需选择master分支。稍等几分钟就会显示 github 博客地址了https://用户名.github.io/13创建自动化一键部署博客①进入 Hexo 目录②新建一个文本文档命名为 deploy.bat③右键编辑写入以下内容保存退出echo off chcp65001nulcd/d%~dp0echo正在清理缓存... call npx hexo cleanecho正在生成静态文件... call npx hexo generateecho正在部署到 GitHub... call npx hexo deployecho部署完成echo按任意键退出...pausenul使用方法以后要部署博客时双击 deploy.bat 就会自动执行清理、生成、部署三步操作部署完成后窗口会暂停显示结果方便你查看有没有报错。注意如果以后 Hexo 项目路径变了需要同步修改 deploy.bat 里的 cd /d 路径五文章发布进入hexo 目录cd~/Desktop/Hexo hexo n你的文章标题名这会在 source/_posts/ 下生成一个 Markdown 文件用任意编辑器VS Code、Typora 等打开生成的 .md 文件复制下面的进去替换--- title: file_name tag: 标签名 categories: 分类# 分类在sakura显示才能查看comment: 是否允许评论(true orfalse)description: 描述 language: zh-CN timezone:Asia/Shanghai---然后写正文即可编辑好文章后重新执行部署到 github 仓库hexo cleanhexo ghexo d常用命令就以下几个hexo n写文章hexo s本地预览hexo g生成页面hexo d部署上线hexo clean清缓存六备份源码#添加所有源码文件gitadd.#提交gitcommit-m更新文章#推送到github仓库备份gitpush七常见问题看这里看到这里博客就部署完成了感谢耐心阅读