美文网首页
免费博客 | Hexo搭建博客并部署到Github Pages服

免费博客 | Hexo搭建博客并部署到Github Pages服

作者: BruceOuyang | 来源:发表于2018-04-19 18:20 被阅读0次

    本文实践的操作系统是windows 10,其他OS的可以当做参考用

    一、Hexo搭建博客

    1. 环境准备

    直接上官网看指引即可,如有疑问可以在评论中留言说明

    2. Hexo初始化博客

    在命令行窗口中执行下列命令

    • 使用npm安装hexo
    npm install -g hexo-cli
    
    • 初始化你的博客项目

    执行命令

    hexo init <folder>
    cd <folder>
    npm install
    

    <folder> 是你本地的文件目录,例如:F:\bruce\hexo\bugmakerBlog,如果不写,则会在执行命令的当前目录初始化一个hexo博客项目

    初始化的过程中会去github上下载一些东西,比如说默认的主题 landscape 之类的,需要等个几分钟

    执行 hexo init 效果图 执行 npm install 效果图

    初始化完成后,你会得到一个这样的项目目录结构:

    初始项目目录结构 - 可以在idea中打开

    _config.yml
    网站的主要配置文件,可以配置你网站的大部分信息。【配置参考说明

    简单的配置示例

    key 说明 示例
    title 网站的名字 BuG制造者联盟官方主页
    author 网站的作者 Bruce
    language 语言设置 zh-CN

    package.json
    应用数据。

    scaffolds目录
    模板目录,你新建一篇博客的时候会以这个目录中的模板文件来创建。

    source目录
    资源目录,你新建的博客都存储在这里。在生成页面的时候,hexo会忽略掉命名为 _ 开头的文件或文件夹, _post 除外,会将 .md.html 后缀的文件按主题生成页面,并复制到public目录下,其他后缀的文件则直接复制过去,不进行额外转换操作。

    themes目录
    主题目录,你可以为自己的网站挑选好看的主题,然后在 _config.yml 文件中指定主题即可。

    • 写一篇博客
    hexo new [layout] <title>
    

    hexo new 会在 source目录 中创建一个以 <title> 命名的 .md 文件
    [layout] 是默认布局,在 scaffolds目录 下定义的,默认布局在 _config.yml 中指定,初始化的默认布局是 post
    <title> 是博客的标题,博客的标题可以在生成的 .md 文件中修改

    示例

    hexo new post My First Blog
    
    新写一篇博客的效果图
    • 生成页面并运行你的博客
    hexo g
    hexo s -p 80
    

    hexo g 是hexo生成页面指令 hexo generate 的缩写
    hexo s 是hexo启动本地服务的指令,默认端口是4000
    -p 80 是指定端口号80

    生成并启动hexo本地服务效果图.png

    默认访问地址 http://localhost:4000
    指定80端口访问地址 http://localhost

    初始化的博客页面

    3. 切换博客主题

    在上一步中,我们看到的博客使用的主题是默认的 landscape 主题,hexo为我们提供了很多的主题可以选择,访问网站 https://hexo.io/themes/ 挑选自己喜欢的主题

    将挑选好的主题 clonetheme目录 下,主题目录下也有一个 _config.yml 配置文件,这个配置文件即主题相关配置,具体根据主题的wiki上的说明来操作

    _config.yml 中,设置 theme 属性的值为 theme目录 下的某一款主题即可,直接写目录下的文件夹名字

    示例:

    • clone主题到 theme目录
    git clone https://github.com/klugjo/hexo-theme-alpha-dust.git
    
    • 修改根目录下的 _config.yml 配置文件,设置 theme
    theme : hexo-theme-alpha-dust
    
    • 重新生成并启动本地服务
    hexo g
    hexo s -p 80
    
    • 效果图


      切换主题测试的效果图.png

    二、了解Github Pages服务

    GitHub Pages 网站:https://pages.github.com/

    1. 有什么用

    Websites for you and your projects. 为你和你的项目提供一个网站
    Hosted directly from your GitHub repository. 直接托管存储在你的github仓库
    Just edit, push, and your changes are live. 只管去编辑提交代码到仓库,你的网站都会即时更新。

    2. 怎么玩的

    步骤其实很简单,在 Github Pages上都有
    如果你还没有github的账号,那需要先注册一个

    • 第一步:在github上创建一个仓库,命名为 username.github.io username就是你的github用户名,注意不是登录账号,我仓库名字是 BuGMakerClub.github.io

    • 第二步:将刚刚创建的仓库 clone 到本地,如 F:\bruce\bruce-private-github\BuGMakerClub.github.io

    cd F:\bruce\bruce-private-github\
    git clone https://github.com/BuGMakerClub/BuGMakerClub.github.io.git
    
    • 第三步:在 clone 下来的项目中,创建一个 index.html,内容可以是 Hello World
    cd BuGMakerClub.github.io
    echo 'Hello World' > index.html
    
    • 第四步:提交代码,把刚创建的 index.html 文件 commit & push 到你的 github仓库中

    • 第五步:结束,你可以直接访问 https://username.github.io 访问你的网站了,我的网站地址是 https://BuGMakerClub.github.io

      bugmakerclub.github.io.png
    • 第六步:设置自己的个性化域名

    如果你有自己的域名,可以在仓库的设置中绑定自己的个性化域名,然后在域名管理中心设置一个域名解析地址,这样就可以用个性化域名来访问github pages服务商的网页了

    三、结合Hexo博客和Github Pages服务

    参考:https://hexo.io/docs/deployment.html

    hexo的配置中,有一个 deploy 指令,可以将生成的博客网站部署到github仓库中,这样就形成两者的结合关系了。

    具体操作如下

    • 安装 hexo-deployer-git 插件
    npm install hexo-deployer-git --save
    
    安装hexo-deployer-git插件效果图.png
    • 修改根目录下的 _config.yml 配置文件
    deploy:
      type: git
      repo: https://github.com/BuGMakerClub/BuGMakerClub.github.io.git
    
    • 执行 deploy 指令发布代码
    hexo d
    

    相关文章

      网友评论

          本文标题:免费博客 | Hexo搭建博客并部署到Github Pages服

          本文链接:https://www.haomeiwen.com/subject/lkbwkftx.html