利用 GitHub 和 Hexo 搭建个人博客【保姆教程】

利用 GitHub 和 Hexo 搭建个人博客

一、前言

在网络飞速发展的本日，个人博客已成为人们在网络天下中展示独特个性、分享知识见解以及纪录生存点滴的抱负平台。GitHub 作为举世着名的开源代码托管平台，为我们提供了稳固且免费的存储服务，而 Hexo 作为一款基于 Node.js 的快速、轻巧、高效的静态博客框架，两者团结，为我们打造个人博客带来了极大的便利，能让我们轻松搭建出既雅观又功能丰富的博客。
二、预备工作

（一）安装 Node.js 和 Git

• Node.js 安装
  Node.js 是 Hexo 运行所依赖的关键环境。访问 Node.js 官方网站（https://nodejs.org/），在首页上根据您的利用体系范例（Windows、Mac OS 或 Linux）选择相应的安装包举行下载。下载完成后，按照安装领导的提示渐渐完成安装。安装竣过后，打开下令行工具（在 Windows 上是“下令提示符”或“PowerShell”，在 Mac OS 和 Linux 上是“终端”），输入node -v和npm -v。假如准确安装，下令行将分别表现已安装的 Node.js 版本号和 npm（Node.js 的包管理工具）版本号。
  
• Git 安装
  Git 是用于管理博客代码版本以及将博客内容推送到 GitHub 的告急工具。前往 Git 官方网站（https://git-scm.com/），同样根据利用体系范例下载符合的安装包举行安装。安装完成后，在下令行中输入git --version，若表现 Git 的版本信息，则表明安装乐成。
  

（二）注册 GitHub 账号

打开欣赏器，访问 GitHub 官网（https://github.com/）。在首页上找到“Sign up”按钮，点击后按照提示填写干系信息，包罗用户名、邮箱所在和暗码等，完成注册过程。这个账号将作为存储博客文件的堆栈，承载着博客的全部代码和内容。
三、安装 Hexo

（一）创建博客目次

在本地盘算机的硬盘上，选择一个您方便管理的位置（比方 D 盘根目次大概用户目次下的某个文件夹），创建一个新的文件夹，将其定名为myblog（您也可以根据本身的喜好定名，但要留意克制利用特殊字符和空格）。这个文件夹将作为博客项目的根目次，后续全部与博客干系的文件和利用都将在这个目次下举行。
（二）安装 Hexo

打开下令行工具，通过cd下令进入到刚刚创建的博客目次（比方，假如您在 Windows 上，且博客目次在 D 盘根目次下，您可以输入d:然后cd myblog；假如在其他利用体系下，利用相应的路径导航下令）。进入目次后，运行以下下令安装 Hexo：npm install -g hexo-cli。此下令中的-g参数表现全局安装，hexo-cli是 Hexo 的下令行工具，全局安装后可以在任何目次下利用 Hexo 干系下令。安装过程大概必要一些时间，由于它必要从网络上下载 Hexo 的干系文件和依赖。
（三）初始化博客

在博客目次下继承运行hexo init下令。这个下令会主动下载 Hexo 初始化博客项目所需的文件和设置信息，并按照 Hexo 的默认布局举行构造。初始化完成后，博客目次下会出现以下告急的目次和文件：

• _config.yml：这是 Hexo 的焦点设置文件，整个博客的各种设置都在这里完成。它是一个 YAML 格式的文件，通过简单的键值对来设置博客的参数，包罗博客的标题、副标题、作者、语言、主题、插件等浩繁设置。比方，title字段用于设置博客的标题，subtitle字段用于设置副标题，author字段填写作者姓名，language字段可以指定博客利用的语言，如en（英语）、zh-CN（中文简体）等。
  
• source：这个目次是用户创建博客文章和页面的源文件存放处。默认环境下，我们利用 Markdown 格式来撰写文章。在这个目次下创建的 Markdown 文件将被 Hexo 分析并转换为网页内容。比方，您可以在source/_posts子目次下创建新的博客文章文件。
  
• themes：存放博客主题文件的目次。Hexo 有大量丰富多样的开源主题可供选择，每个主题都有其独特的计划风格和功能。差别的主题可以让您的博客出现出完全差别的表面和交互体验。
  
• public：这个目任命于存放 Hexo 根据source目次中的内容和_config.yml的设置天生的静态文件。这些静态文件包罗 HTML、CSS、JavaScript 等，它们将被摆设到服务器（如 GitHub）上，供用户通过欣赏器访问。
  
• 别的，另有其他一些辅助文件和文件夹，如scaffolds用于天生文章或页面的模板，package.json用于管理项目的依赖等。
  

四、设置 Hexo

（一）修改设置文件

利用文本编辑器（如 Windows 上的 Notepad++、Sublime Text，Mac OS 上的 Visual Studio Code 等）打开_config.yml文件。在文件中找到并修改以下关键信息：

• 根本信息修改
  
  
  
  • 博客标题（title）：输入您为博客想好的名称，这个名称将表现在博客的首页和欣赏器标签页上，比方“知识探索者的博客”。
    
  • 副标题（subtitle）：可以填写一个简短的形貌性语句，进一步分析博客的主题或特色，如“分享科技与人文的点滴”。
    
  • 作者（author）：填写您的姓名大概您盼望在博客上表现的作者名称。
    
  
  
• 其他设置
  
  
  
  • url字段：假如您已经有了自界说的域名，可以填写完备的域名所在，如https://www.myblog.com。假如暂时没有域名，可先留空。
    
  • permalink字段（可选）：用于设置文章的永世链接格式。默认的格式大概比力复杂，您可以根据本身的喜好举行简化，比方设置为:year/:month/:day/:title/，如许文章的链接会更清楚易读。
    
  
  

（二）选择主题

• 主题搜索与选择
  前往 Hexo 主题官网（https://hexo.io/themes/）欣赏各种主题的展示和先容，大概在 GitHub 上通过搜索“Hexo theme”来查找更多主题。在浩繁主题中，根据本身的审美和博客功能需求选择一个心仪的主题。比方，假如您喜好轻巧当代的风格，next主题是一个很不错的选择；假如您寻求个性化和丰富的视觉结果，landscape等主题大概更符合您的口胃。
  
• 主题下载与安装
  以next主题为例，在博客目次下的下令行中运行git clone https://github.com/iissnan/hexo-theme-next themes/next。这条下令利用 Git 从指定的 GitHub 堆栈下载next主题的文件，并将其存放在themes/next目次下。差别的主题大概有差别的安装方式，但通过 Git 克隆堆栈是一种常见且便捷的方法。
  
• 主题启用
  主题下载完成后，必要在_config.yml文件中修改theme的值。找到theme字段，并将其值修改为您所下载的主题文件夹名称，比方对于next主题，将theme: landscape（假如之前是其他主题）修改为theme: next。修改完成后生存设置文件。
  

五、创建并撰写博客文章

（一）创建新文章

在博客目次下打开下令行，运行hexo new "文章标题"下令。这里的“文章标题”是您要创建的新文章的标题，比方hexo new "我的第一篇博客文章"。运行此下令后，Hexo 会在source/_posts目次下创建一个新的 Markdown 文件，文件名是根据文章标题天生的，同时会主动添加一些根本的头部信息，如文章的创建日期、标题等。
（二）撰写文章

利用文本编辑器打开新创建的 Markdown 文件。在 Markdown 文件中，您可以按照 Markdown 语法来撰写文章内容。以下是一些常用的 Markdown 语法：

• 标题
  利用#号来表现标题，#号的数目表现标题的级别。比方，# 一级标题、## 二级标题，以此类推。标题级别一样寻常不发起凌驾六级。
  
• 段落
  直接在文本中换行即可表现新的段落。假如必要在段落之间添加空行，可以在两个段落之间额外添加一行空行。
  
• 字体样式
  
  
  
  • 加粗：利用**或__将必要加粗的笔墨困绕起来，如**这是加粗的笔墨**。
    
  • 斜体：利用*或_将必要斜体的笔墨困绕起来，如*这是斜体笔墨*。
    
  
  
• 列表
  
  
  
  • 无序列表：利用-、+或*作为列表项的前缀，比方：
    
  
  

1. - 列表项 1
2. - 列表项 2

复制代码

1. - **有序列表**：使用数字和`.`作为列表项的前缀，例如：

复制代码

1. 1. 第一项
2. 2. 第二项

复制代码

• 链接
  利用[链接笔墨](链接所在)的格式来创建链接，如[百度](https://www.baidu.com)。
  
• 图片
  利用的格式来插入图片。假如图片是当舆图片，必要将图片放置在博客项目的符合目次下，并在 Markdown 文件中利用相对路径指向图片。假如是网络图片，则直接利用图片的网络所在。
  

在撰写文章过程中，您可以充实发挥想象力，团结笔墨、图片、链接等元素，使文章内容更加丰富生动。
六、当地预览博客

启动当地服务器

在博客目次下的下令行中运行hexo server下令。此下令会启动一个当地服务器，默认环境下，它会监听当地的4000端口。启动乐成后，下令行中会表现服务器启动信息，包罗当地访问所在http://localhost:4000。打开欣赏器，在所在栏中输入这个所在，就可以看到您的博客在当地的预览结果。在当地预览过程中，您可以对博客的表面、文章内容、布局等举行查抄和调解，确保齐备符合您的预期。假如在预览过程中发现题目，可以及时回到相应的文件（如文章内容文件、设置文件、主题文件等）举行修改，然后革新欣赏器页面查察修改结果。
七、将博客摆设到 GitHub

（一）创建 GitHub 堆栈

登录到您的 GitHub 账号，在 GitHub 页面右上角点击“+”号，在弹出的下拉菜单中选择“New repository”。在创建堆栈页面，填写以下信息：

• 堆栈名称：发起定名为你的用户名.github.io，这里的用户名是您在 GitHub 注册的账号用户名。这个定名方式是 GitHub Pages 的特殊要求，用于辨认和摆设个人网站或博客。
  
• 堆栈形貌（可选）：可以扼要形貌一下这个堆栈的用途，比如“我的个人博客堆栈”。
  
• 堆栈范例：选择“Public”（公开）或“Private”（私有），根据您的需求来决定。假如您盼望博客可以或许被任何人访问和欣赏，选择“Public”；假如您只想本身可见大概仅对特定用户可见，可以选择“Private”。不外必要留意的是，私有堆栈大概会有一些访问限定和额外的付费要求（假如凌驾肯定的免费利用额度）。
  填写完成后，点击“Create repository”按钮完成堆栈创建。
  

（二）安装 hexo - deployer - git 插件

在博客目次下的下令行中运行npm install hexo - deployer - git --save。这个插件是 Hexo 用于将天生的静态文件摆设到 GitHub 的关键工具。--save参数表现将这个插件添加到项目的依赖列表中，以便在项目的其他环境中也能准确利用。安装完成后，插件会被下载并安装到博客项目的node_modules目次下。
（三）设置摆设信息

在_config.yml文件中添加以下摆设设置：

1. deploy:
2.   type: git
3.   repo: https://github.com/你的用户名/你的用户名.github.io.git
4.   branch: main

复制代码

这里必要留意，要将上述设置中的“你的用户名”更换为您本身的 GitHub 用户名。type字段指定摆设范例为git，repo字段是 GitHub 堆栈的所在，branch字段指定要推送的分支，通常是main（假如您的堆栈利用的是默认的主分支）。
（四）摆设博客

在博客目次下运行hexo deploy下令。这个下令会起首根据source目次中的内容和设置信息天生静态文件，然后利用 hexo - deployer - git 插件将这些静态文件推送到 GitHub 堆栈中。在推送过程中，下令行大概会提示您输入 GitHub 的用户名和暗码（假如您没有设置 SSH 密钥）。输入准确的信息后，推送利用会继承举行。推送完成后，稍等半晌（一样寻常几分钟内），就可以通过你的用户名.github.io访问您的个人博客了。假如遇到访问题目，可以查抄堆栈设置、域名分析（假如有自界说域名）以及文件推送是否完备等环境。
八、总结

通过以上详细的步调，我们乐成地利用 GitHub 和 Hexo 搭建了个人博客。在后续的利用过程中，您可以不绝更新博客文章，分享更多有代价的内容；也可以根据本身的喜好更换主题，为博客带来新的表面；还可以添加各种 Hexo 插件来扩展博客的功能，如添加批评体系、搜索功能等。盼望这篇文章能成为您搭建博客之旅的有力指南，让您在网络天下中拥有一个属于本身的精彩空间。
   版权声明：
原创博主：牛哄哄的柯南
博主原文链接：https://keafmd.blog.csdn.net/
个人博客链接：https://keafmd.top/
  看完假如对你有资助，感谢点击下面的点赞支持！
[哈哈][抱拳]

加油！
共同积极！
Keafmd
感谢支持牛哄哄的柯南，等待你的三连+关注~~
keep accumulate for my dream【共勉】
   假如遇到题目，可以在下方找到我。
                                                         ↓   ↓   ↓   相助 互换  ↓   ↓   ↓