git+node+hexo玩转博客

本文详细介绍使用Hexo搭建个人博客的过程,包括安装、主题配置、部署至GitHub和Gitee,以及常见问题解决方法。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

npm install -g hexo

注意:-g是指全局安装hexo。或者

npm install -g hexo-cli

sudo方式运行,为什么会出现权限错误呢?sudo npm install --unsafe-perm --verbose -g hexo

调试命令如下,没有git部署

hexo i blog //init的缩写 blog是项目名
cd blog //切换到站点根目录
hexo g //generetor的缩写
hexo s //server的缩写

 

执行以下指令 npm install(安装依赖包)

hexo generate(构建,这时候会有红框内的文件夹了)

hexo server(启动服务,关闭服务是ctrl+c)

启动后 输入路径localhost:4000到游览器即可看到效果了,类似这样的网站

这个主题只是官方默认的主题,当然可以自己修改的,但是官方也提供一些网友自己制作的主题,可以直接套用

网址:https://hexo.io/themes/

添加主题

安装主题(yilia主题):

hexo clean
git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia   

启动主题

找到目录下的_config.yml 文件,打开找到 theme:属性并设置为yilia

更新主题

cd themes/yilia
git pull
hexo g
hexo s

此时刷新http://localhost:4000/页面就能看到新的主题了.

使用Hexo deploy部署到github

还是编辑根目录下_config.yml文件

deploy:
    type: git
    repo: git@github.com:cczeng/cczeng.github.io.git  #这里的网址填你自己的
    branch: master   

此处感谢有网友帮忙指出错误,原文自第二行起由于疏忽没有缩进

具体配置可参考我的博客备份

保存后需要提前安装一个扩展:

npm install hexo-deployer-git --save   

接下来就是将Hexo部署到我们的Github仓库上

不加载谷歌字体

在我们已经使用了next 

cd blog/themes/next/layout/_partials/head
vi external-fonts.swig
    修改其中的fonts.googleapis.com为 fonts.useso.com

写博客、发布文章

新建一篇博客,执行下面的命令:

hexo new post "article title"

这时候在我的 电脑的目录下 F:\hexo\source\ _posts 将会看到 article title.md 文件

用MarDown编辑器打开就可以编辑文章了。文章编辑好之后,运行生成、部署命令:

hexo g   // 生成
hexo d   // 部署

当然你也可以执行下面的命令,相当于上面两条命令的效果

hexo d -g #在部署前先生成

踩坑提醒

  • 1)注意需要提前安装一个扩展:
npm install hexo-deployer-git --save

如果没有执行者行命令,将会提醒

deloyer not found:git

  • 2)如果出现下面这样的错误, Permission denied (publickey). fatal: Could not read from remote repository. Please make sure you have the correct access rights and the repository exists.

则是因为没有设置好public key所致。 在本机生成public key,不懂的可以参考我的这一篇博客Git ssh 配置及使用

      .3)谷歌字体导致的速度慢
换用next主题,修改地址
      .4)部署到git后,样式消失
在配置文件中 root: /learning-blog/,注意配置好项目名,默认是 /
      .5)修改后未生效
hexo deploy后会提交代码,但是要生效的话得重新部署Gitee Pages
高级功能
1  全文显示
首页的文字一次性进行了全文显示,我们希望只显示一部分。
只需要在文字的中间加上
<!--more-->

2 下图效果的标签如何添加?

 

屏幕快照 2016-08-03 下午10.43.35.png

打开你的编辑器,在文章头部这块的tags下面用 -标签这种形式添加,就会生成图片中的标签了,相同的标签文章将会被归类到一起,很方便查看

---
title: 宏定义的黑魔法
date: 2016-07-22 15:08:32
categories:
tags:
     - 黑魔法
     - 奇淫技巧
---

3 每页显示多少篇文章,分页效果如何设置?

屏幕快照 2016-08-05 上午11.52.57.png

类似于上图,每一页显示几篇文章,我们打开主目录下的_config.yml,找到下端代码的位置,修改per_page后面的参数就行,例如我的就是每页五篇文章

## Set per_page to 0 to disable pagination
per_page: 5
pagination_dir: page

Gitee托管

  • 创建git项目
    在码云上创建一个learning-blog项目,复制地址
    https://gitee.com/sherryBy/learning-blog.git

  • 修改全局配置文件:_config

deploy:
    type: git
    repo: https://gitee.com/sherryBy/learning-blog.git
  • 安装

zhangliingdeMBP:blog zhangliuning$ sudo cnpm install hexo-deployer-git --save

  • 部署
    在博客根路径执行
    hexo deploy

中途需要输入git的用户名密码

  • 开启托管服务

    github上面的CNAME更新需要很长的一段时间

### 使用 GitHexo GitHub 搭建个人博客 #### 准备工作 为了成功搭建基于 Hexo 的个人博客,需先完成环境准备。这包括安装 Node.js 及 npm 或 cnpm, 这些工具对于后续操作至关重要。 #### 安装 Hexo 通过命令行工具来全局安装 Hexo 是第一步,在终端中运行如下命令可以实现此目的[^1]: ```bash npm install -g hexo-cli ``` #### 创建本地博客框架 安装完成后,选择一个目录作为博客根目录,并在此处初始化一个新的 Hexo 博客站点: ```bash hexo init blog cd blog ``` #### 设置远程仓库 前往 GitHub 平台创建新的私有或公共存储库用于承载博客内容。之后利用 SSH 密钥对或是 HTTPS 方式关联本地与远端仓库。首次推送前可能需要移除旧有的 `origin` 地址以便重新指定目标地址[^2]: ```bash git remote rm origin # 如果之前已经存在则删除原链接 git remote add origin https://github.com/yourusername/yourrepositoryname.git ``` #### 初始化并提交初始版本 确保所有文件都已加入追踪列表后,执行以下指令以记录更改并将它们推送到 GitHub 上的新分支: ```bash git init git add . git commit -m "Initial commit" git branch -M main git push -u origin main ``` #### 配置部署插件 为了让 Hexo 能够自动同步至 GitHub Pages,还需额外配置名为 `hexo-deployer-git` 的插件。可以通过包管理器快速安装它[^4]: ```bash cnpm install hexo-deployer-git --save ``` 编辑 `_config.yml` 文件中的 deploy 字段指向刚才建立好的 GitHub 仓库路径: ```yaml deploy: type: git repo: https://github.com/yourusername/yourrepositoryname.git branch: gh-pages ``` #### 发布首篇文章 现在可以在 `source/_posts` 下新建 Markdown 文档形式的文章草稿,编写完毕后借助下列命令将其转化为网页格式并上传到服务器上展示给访客们看[^3]: ```bash hexo new post "My First Post" hexo generate hexo deploy ``` 以上就是完整的使用 GitHexo GitHub 来构建静态网站的过程概述。一旦熟悉这些基本流程,就可以进一步探索更多高级功能来自定义自己的在线空间了!
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值