博客搭建

我创建了个人博客网站,基于 GitHub Pages 作为开源服务器,使用 Hexo 作为博客框架,Fluid 主题为界面设计。博客中使用 LeanCloud 作为阅读量统计工具,通过 GitHub 或者自己服务器进行部署。此博客网站完全免费,适合需要搭建个人博客的用户。

此部分内容基于CSDN博客作者的介绍。 以下为过程简述并添加注意部分。同时推荐阅读Hexo Fluid用户手册进行个性化设置,还可以参考官方的展示博客Hexo Theme Fluid获得创造灵感。


1. 在 GitHub 上创建一个新仓库

  • 在 GitHub 上创建一个新的代码仓库,名称必须为 <您的GitHub用户名>.github.io,例如 artintyt.github.io
  • 创建成功后,您将拥有一个可以访问的页面 https://artintyt.github.io,这是您的博客网站的基础。
  • 注意:branch设置为main。可以先在仓库写个初始页面来测试地址正常打开。

2. 安装 Hexo 和设置博客

  • 在您的电脑上安装 Node.jsGit(如文章中的准备工作部分所述)。
  • 注意:用终端安装时,先通过指令到达自己新建的 my-blog文件夹。
  • 使用以下命令安装 Hexo:
    1
    npm install -g hexo-cli
  • 创建一个 Hexo 项目:
    1
    2
    3
    hexo init my-blog
    cd my-blog
    npm install
  • 启动服务器
    1
    2
    hexo g
    hexo server
  • 测试页面是否正常启动:http://localhost:4000

3. 更换 Hexo 主题为 Fluid

  • 在 Hexo 博客目录中安装您喜欢的主题(例如 Fluid 主题):
    • 下载并解压 Fluid 主题至my-blog下面的 themes 文件夹
    • 修改 Hexo 配置文件 _config.yml,设置主题为 fluid
      1
      theme: fluid
    • 配置文件 _config.yml配置博客语言、标题等个性化信息。
    • 注意,有两个配置文件:
      • my-blog下面的是Hexo框架的配置文件
      • fluid下面的是fluid主题的配置文件
  • 启动本地服务器,并访问地址: http://localhost:4000
    1
    2
    hexo g -d
    hexo s

4. 配置 LeanCloud 统计网址阅读量和访问人数

  • 注册 LeanCloud ,从设置 - 应用凭证中获取 AppIDAppKey
  • 配置您的 Hexo 主题,打开 themes/fluid/_config.yml 文件,添加 LeanCloud 的 AppIDAppKey,开启阅读量统计和评论功能。

5. 创建博客文章

  • 使用 Hexo 命令创建新文章:
    1
    hexo new post "我的第一篇博客"
  • source/_posts 文件夹中编辑文章内容(Markdown/html 格式)。文件以.md结尾。
  • 图片等文件可以放在 source/images 目录下。

6. 部署博客到 GitHub Pages

  • 配置 GitHub 仓库为 Hexo 的发布目标,将访问令牌存储在环境变量中,避免直接写入配置文件。在 _config.yml 中添加以下配置:

    1
    2
    3
    4
    deploy:
    type: git
    repo: https://<您的GitHub用户名>:${GH_TOKEN}@github.com/<您的GitHub用户名>/<您的博客网址>.git
    branch: main
  • 我们将repo的敏感部分替换为环境变量。在终端中设置环境变量 GH_TOKEN

    1
    export GH_TOKEN=ghp_xxxx

    注意: 此环境变量只在当前终端会话中有效。如果需要永久生效,可以将其添加到 .bashrc.zshrc 或其他 Shell 配置文件中。

  • 然后运行以下命令使其生效,例如,在 .zshrc 文件中添加:

    1
    source ~/.zshrc
  • 安装部署插件并部署:

    1
    2
    npm install hexo-deployer-git --save
    hexo g -d
  • 访问 https://<您的GitHub用户名>.github.io 查看您的博客。


“觉得不错的话,给点打赏吧 ୧(๑•̀⌄•́๑)૭”

微信二维码

微信支付

支付宝二维码

支付宝支付

博客搭建
http://neurowave.tech/2025/01/13/1-博客搭建/
作者
Artin Tan
发布于
2025年1月13日
更新于
2025年2月21日