JERRY Hexo & GitHub 静态网站搭建说明

2023-04-13 08:52:24 浏览数 (1)

JERRY-Hexo-GitHub

《JERRY Hexo & GitHub 静态网站搭建说明》

非原创内容，转载请注明出处！

一、前言

1.1 什么是 Hexo？

一个基于 Node.js 设计的快速、简洁且高效的博客框架

  • 超快速度
  • 支持 Markdown
  • 一键部署
  • 插件和可扩展性
  • 免费开源

1.2 什么是 GitHub？

一个面向开源及私有软件项目的托管平台，因为只支持 Git 作为唯一的版本库格式，故名 GitHub

  • 全球最活跃开源社区
  • 开源社交平台
  • 企业项目管理平台

1.3 什么是静态网站？

通俗的讲静态网站指：只有 前端 没有 后端 的网站，静态网站的所有页面内容在没有被修改的前提下都是固定不变的

适用于博客、固定页面展示等网站。

1.4 Hexo 与 GitHub 搭配建站的优缺点

（1）优点

  • 简单稳定
  • 开源免费
  • 社区活跃利于交流

（2）缺点：

  • 国内访问速度慢
  • 不支持动态网站搭建

二、安装 Git

2.1 什么是 Git？

Git 是一个开源的分布式版本控制系统，用于敏捷高效地处理任何或小或大的项目

使用 GitHub 必须有 Git。

2.2 Git 的下载安装与配置

（1）下载安装

Git官网

选择对应系统版本下载，安装默认下一步即可。

（2）配置

打开终端键入以下命令：

代码语言：javascript复制
$ git --version

# 查看 git 版本号
# 若成功识别即为 git 安装成功
代码语言：javascript复制
$ git config --global user.name "xxx"
$ git config --global user.email xxx@xxx.com

# 配置个人的用户名称和电子邮件地址
代码语言：javascript复制
$ git config --list

# ...
# user.name=xxx
# user.email=xxx@xxx.com

# 检查已有的配置信息
# 若配置信息中出现正确用户名及邮箱即为配置成功

三、安装 Node.js

3.1 什么是 Node.js？

一个基于 Chrome V8 引擎的 JavaScript 运行环境，使用了一个事件驱动 、非阻塞式 I/O 模型，让 JavaScript 运行在服务端的开发平台，它让 JavaScript 成为与 PHP、Python、Perl、Ruby 等服务端语言平起平坐的 脚本语言。

3.2 Node.js 的下载安装与配置

Node.js官网

选择对应系统的长期支持版下载，安装默认下一步即可。

安装完成，打开终端键入以下命令：

代码语言：javascript复制
$ node -v

# 查看 Node.js 版本
代码语言：javascript复制
$ npm -v

# 查看 npm 包管理器版本

若以上两个命令都成功识别，那么 Node.js 便安装成功。

代码语言：javascript复制
$ npm install -g cnpm --registry=https://registry.npm.taobao.org

# 利用 npm 下载国内淘宝镜像 cnpm
代码语言：javascript复制
$ cnpm -v

# 查看 cnpm 版本
# 若以上命令成功识别，那么 cnpm 便安装成功

什么是 npm 和 cnpm ?

  • npm (node package manager)：Node.js 的包管理器，用于 node 插件管理（包括安装、卸载、管理依赖等）。
  • cnpm：因为 npm 安装插件是从国外服务器下载，受网络的影响比较大，可能会出现异常，所以乐于分享的淘宝团队解决了这事。来自官网：“这是一个完整 npmjs.org 镜像，你可以用此代替官方版本(只读)，同步频率目前为 10分钟 一次以保证尽量与官方服务同步”。

四、安装 Hexo

4.1 Hexo 的下载安装与配置

下载安装：

可以参考Hexo官网

打开终端键入以下命令：

代码语言：javascript复制
$ cnpm install hexo-cli -g

# 等待一会，安装完毕
代码语言：javascript复制
$ hexo -v

# 查看 hexo 版本
# 若以上命令成功识别，那么 hexo 便安装成功

五、搭建静态网站

5.1 新建一个网站

代码语言：javascript复制
$ hexo init [folder]

# 如果没有设置 folder，Hexo 默认在当前的文件夹建立网站

5.2 生成静态文件

代码语言：javascript复制
$ hexo generate

# 该命令可以简写为 $ hexo g

5.3 启动服务器

代码语言：javascript复制
$ hexo server

# 该命令可以简写为 $ hexo s
# 默认情况下，访问端口为：http://localhost:4000/
# 在浏览器中访问 http://localhost:4000/ 即可打开本地搭建好的网站

5.4 新建一篇文章

代码语言：javascript复制
$ hexo new 

# 如果标题包含空格的话，请使用引号括起来 $ hexo new "first blog"
# 生成的 Markdown 文章放在 source 内的 _posts 下</code></pre><h1>六、利用 GitHub 部署网站</h1><h2>6.1 注册用户</h2><p><a href="https://github.com/">GitHub官网</a></p><p>点击右上角注册即可。</p><h2>6.2 创建同名仓库</h2><ul><li>点击右上的 <code> </code>，选择 <code>New repository</code> 新建一个仓库</li><li>仓库名称设为 <code>用户名.github.io</code></li><li>仓库类型为 <code>Public</code> 公共类型</li><li>复制仓库 <code>HTTPS</code> URL</li></ul><h2>6.3 更改 Hexo 配置文件</h2><p>修改根目录 <code>_config.yml</code> 内的 <code>deploy</code>。</p><pre><code class="lang-yml"># Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: 'git'
  repo: https://github.com/用户名/用户名.github.io.git    # HTTPS URL
  branch: master</code></pre><h2>6.4 安装 hexo - git 部署工具</h2><p>在 Hexo 博客根目录下，打开终端键入：</p><pre><code class="lang-bash">$ cnpm install hexo-deployer-git --save

# 安装 hexo-deployer-git 工具</code></pre><h2>6.5 远程部署到 GitHub Pages 服务器</h2><pre><code class="lang-bash">$ hexo deploy

# 该命令可以简写为 $ hexo d</code></pre><p>部署成功后即使用 <code>https://用户名.github.io/</code> 在浏览器中访问网站。</p><h1>七、结束语</h1><h2>7.1 美化 Hexo 网站</h2><p>Hexo 支持主题自定义，并且有一个活跃的 <a href="https://hexo.io/themes/">主题社区</a>。</p><p>切换主题方法：下载主题到 <code>themes</code> 文件夹内并修改根目录 <code>_config.yml</code> 内的 <code>theme</code> 设定，即可切换主题。</p><p>修改配置主题请查阅相应主题的文档。</p><p>目前比较热门的几个主题：</p><ul><li><a href="https://github.com/iissnan/hexo-theme-next">NexT GitHub</a></li><li><a href="https://github.com/jerryc127/hexo-theme-butterfly">Butterfly GitHub</a></li><li><a href="https://github.com/litten/hexo-theme-yilia">Yilia GitHub</a></li><li><a href="https://github.com/blinkfox/hexo-theme-matery">Matery GitHub</a></li></ul><h2>7.2 使用 Hexo 插件</h2><p>Hexo 是一个支持插件的可扩展框架，具体插件类型及安装方法请前往 <a href="https://hexo.io/plugins/">Hexo 官网查看</a> 或在搜索引擎求助。</p><h2>7.3 帮助文档</h2><p>Hexo 提供了全面的 Hexo <a href="https://hexo.io/docs/index.html">使用文档</a>（中英文版）及 <a href="https://hexo.io/api/">API 文档</a>，在使用及开发优化 Hexo 的过程中，建议以官方文档为基准。</p>
github 网站 开源 hexo 配置

0 人点赞