美文网首页
Hexo+GitHub Pages免费搭建个人博客

Hexo+GitHub Pages免费搭建个人博客

作者: jiaiqi | 来源:发表于2019-03-12 00:02 被阅读0次

    关于Hexo

    Hexo中文官网

    Hexo是一个快速、简洁且高效的博客框架,Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。

    MarkDown介绍

    Markdown 是一个 Web 上使用的文本到HTML的转换工具,可以通过简单、易读易写的文本格式生成结构化的HTML文档。目前 github、Stackoverflow 等网站均支持这种格式。

    关于markdown简单几句话说不清,可以点此进入markdown中文介绍页面了解详情

    搭建前的准备

    GitHub账号

    ​ GitHub是一个面向开源及私有软件项目的托管平台,也是全球最大的开源协作社区,通过GitHub,既可以让别人参与你的开源项目,也可以参与别人的开源项目。

    ​ 而我们此次要介绍的搭建博客的方法,依赖于GitHub为其用户免费提供的GitHub Pages服务。以下是官方对于GitHub Pages的介绍

    GitHub Pages是一种静态站点托管服务,旨在直接从GitHub存储库托管您的个人,组织或项目页面。

    ​ 既然是免费的,肯定有着一些限制:

    • GitHub Pages源存储库的 建议限制为1GB
    • 发布的GitHub Pages网站可能不超过1 GB。
    • GitHub的网页的网站有一个每月100GB的带宽限制。
    • GitHub Pages网站的限制为每小时10个版本。

    安装环境

    以下配置只在我自己电脑中(Windows10 64位)安装过,不保证在其他环境也能成功。

    安装 Hexo 相当简单。然而在安装前,必须检查电脑中是否已安装下列应用程序:

    安装 Hexo

    必要的环境安装完成后,即可使用 npm 全局安装 Hexo。

    npm install -g hexo-cli
    
    安装hexo
    检查是否安装Hexo完成,查询是否成功,显示hexo-cli版本就说明成功了
    hexo -v

    建站

    安装一切所需的环境后,我们可以开始建站了 新建一个文件夹,用来管理我们的博客项目,

    新建blog文件夹
    打开命令行工具,分别运行以下命令。

    hexo init <folder> 用hexo-cli工具初始化项目文件夹
    cd <folder> 进入刚新建的文件夹
    npm install // 安装依赖
    太长了就不截图了

    访问URL

    我们可以运行看看Hexo创建的博客站是什么样的,运行以下命令

    hexo server
    /*
    选项  描述
    -p, --port  重设端口
    -s, --static    只使用静态文件
    -l, --log   启动日记记录,使用覆盖记录格式
    */
    

    或者

    hexo s
    

    在地址栏输入http://localhost:4000/访问本地Hexo服务器,按crtl+C停止运行hexo服务器

    hexo server

    好了,到这里我们已经学会了通过Hexo创建本地博客了,接下来将介绍如何将我们的博客上传到我们的GitHub服务器上

    上传到GitHub

    GitHub创建repositories

    进入GitHub官网,或者在浏览器输入https://github.com/,如果还没有账号就创建一个账号就好了,这里不教大家怎么注册账号了。登录自己的账号,直接点击new repositories或者进入You repositoriesnew repositories

    进入到创建repositories页面来,这里很重要,一定要注意哦!必须将新建的repository的名字为: 你的GitHub账户名.github.io,其他默认就好了。这里注意在创建GitHub用户名时一定要慎重考虑,因为这将决定你的GitHub Pages的域名

    配置

    GitHub的Repository创建好后。我们在回到本地的HexoMyblog项目中,我们用代码编辑器工具打开,notepad++就可以,找到在项目的根目录下_config.yml找到 deploy标签

    在该文件下面添加

    deploy:
      type: git
      repository: https://github.com/jiaiqi/jiaiqi.github.io.git # 复制过来
      branch: master
    

    注:repository: https://github.com/jiaiqi/jiaiqi.github.io.git 是自己刚刚创建的你的GitHub账户名.github.io的repository,在Clone with HTTPS里面,复制粘贴就好咯。冒号后面记得空格哦。branch后面是master就好了。
    在_config.yml找到url进行修改为:

    url: http://jiaiqi.github.io # jiaiqi是我的github用户名,修改为自己的用户名
    

    写文章

    hexo new [layout] <title>
    

    如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话,要用引号括起来。如:

    hexo new "post title with whitespace"
    

    部署

    到这里就差不到了,接下来我们需要执行一些命令,将我们的博客部署到GitHub上了,惊喜将会到来了。 打开Git Bash Here进入blog根目录下,首先我们需要安装一下hexo-deployer-git不然可能出现错误,无法部署成功,执行命令行。

    npm install hexo-deployer-git --save
    

    然后在执行以下命令
    注:每次提交时必须执行这三个命令

    1. hexo clean
    // 清除缓存文件 (db.json) 和已生成的静态文件 (public)。
    
    2. hexo generate # 生成静态文件。
    // 选项
    -d, --deploy # 文件生成后立即部署网站
    -w, --watch # 监视文件变动
    
    3. hexo deploy # 部署
    // 参数   描述
    -g, --generate  部署之前预先生成静态文件
    

    或者简写方式

    hexo clean
    
    hexo g
    
    hexo d
    

    第一次执行hexo deploy命令后可能会弹出github登录页面,千万不要没登录就直接关掉了。

    测试

    我们进行访问https://jiaiqi.github.io/http://localhost:4000/一样的页面说明是已经成功。第一篇博客是hexo创建的默认文章。

    总结

    到这里,我们已经从如何使用Hexo到部署上GitHub上,当然了,此时还未对Hexo进行一些我们对于博客的美化,hexo可以让我们自定义自己独特风格的博客,关于hexo的更多使用方法比如如何创建文章、文章分类之类的去Hexo官网自己看文档吧。如何修改以及配置主题,等我的下一篇博客(当然了,下一篇不知道什么时候了,看心情吧)或者自己Google吧~

    相关文章

      网友评论

          本文标题:Hexo+GitHub Pages免费搭建个人博客

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