zoukankan      html  css  js  c++  java
  • 使用hexo搭建博客并上传GitHub

    之前在博客园、简书、CSDN等地儿都开过博,一篇文章写好了,我希望能在几个平台可以同步发布,可是操作起来成本不低。几个平台下的富文本编辑器比较起来还是博客园更顺手,看着更舒服,尤其是代码块的操作灵活、准确。而CSDN对代码块内的文字加粗、修改字色后就会出现html文无法解析的情况,混杂着代码和html文本实在太难看了,后来我知道原来是Markdown的代码块规则限制。而且CSDN刚刚才取消了提交文章要审核通过才能发布的限制,审核没有完成之前,连自己都看不到,且不能修改,这让我一度放弃CSDN平台。如果是写普通的文章写作体验最好的是简书,大气、简洁。但简书更适合一般的写作,比较技术化的中间掺杂大量代码的支持还不够好。

    作为一名程序员,应该到GitHub上开博,这里是程序员的圣城。花了两天时间研究了一下,发现还蛮简单的,而且md格式也被博客园、简书、CSDN所支持,写完一份应该比较容易复制到这三个平台。我喜欢在本地编辑markdown文件,使用sublime 及其插件Markdown Editing 和 OmniMarkupPreviewer。完成后底稿、资源文件都悉数保存到GitHub,日后查找、修改都很容易。

    我用hexo作为静态页面生成器,操作过程遇到不少问题,搞定之后留一份操作记录吧。以后就把[http://palanceli.github.io/blog/]作为我的首发平台了;)

    安装环境

    • 安装node.js,去官网下载安装即可,我安装的是最新稳定版。

    • 安装Hexo
      sudo npm install -g hexo

    • 创建hexo目录并初始化

    $ mkdir hexo
    $ cd hexo
    $ hexo init
    
    • 然后就可以生成网站,启动服务了:
    $ hexo clean
    $ hexo generate
    $ hexo server
    
    • hexo文件夹
      先来看一下hexo文件夹下的内容:
    hexo/
      |- node_modules/  # hexo需要的模块,不需要上传GitHub
      |- themes/        # 主题文件,需要上传GitHub的dev分支
      |- sources/       # 博文md文件,需要上传GitHub的dev分支
      |- public/        # 生成的静态页面,由hexo deploy自动上传到gh-page分支
      |- package.json   # 记录hexo需要的包信息,不需要上传GitHub
      |- _config.yml    # 全局配置文件,需要上传GitHub的dev分支
      |- .gitignore     # hexo生成默认的.gitignore,它已经配置好了不需要上传的hexo文件
    

    关联GitHub

    首次先创建GitHub工程blog,并且使用“Launch automatic page generator”生成页面,它会给该工程创建分支gh-pages。
    手动为之创建dev分支,未来工程源码会放到dev分支下;hexo生成的网站静态页面会放到gh-pages分支。

    • 首次创建GitHub工程后操作dev分支代码

    如果是刚创建的GitHub工程,clone dev分支的代码到本地blog-dev/,然后把前面hexo/文件夹下的内容全部拷贝到blog-dev/,注意包括一个隐藏文件.gitignore。

    • 已存在GitHub工程的恢复
      仍是clone dev分支的代码到本地blog-dev/,然后把hexo/node_modules/拷贝到blog-dev/
      再试试生成页面、启动服务,确保是正常的:
    $ hexo clean
    $ hexo generate
    $ hexo server
    

    网上有介绍把package.json文件同步到GitHub,以后每次恢复时执行

    $ npm install hexo
    $ npm install
    $ npm install hexo-deployer-git --save
    

    可是我在不同的机器上试总是出错。只好采取笨办法,每次先hexo init出一个完整文件夹,再把相关文件拷贝到GitHub目录下。千万不要先clone 了blog目录,再在该目录下执行hexo init,因为init会把.git信息删掉。

    配置自己的_config.yml

    按照如下内容修改blog-dev/_config.yml:

    title: Palance's Blog   # 标题
    subtitle:
    description:
    author: Palance Li
    language: zh-CN         # 语言设置
    url: http://palanceli.github.io/blog
    root: /blog/
    

    翻到最下面,改成:

    deploy:
      type: git
      repository: https://github.com/<自己的github账号>/blog.git
      branch: gh-pages
    

    主题

    这里有大量的主题https://github.com/hexojs/hexo/wiki/Themes
    我非常喜欢Maupassant:https://www.haomwei.com/technology/maupassant-hexo.html,
    简洁清晰,而且适配手机、PC各个平台。

    • 安装方法
      首次在blog-dev/目录下执行如下命令
    $ git clone https://github.com/tufu9441/maupassant-hexo.git themes/maupassant
    $ npm install hexo-renderer-jade --save
    $ npm install hexo-renderer-sass --save
    

    以后建议把blog-dev/themes/maupassant/.git文件夹删掉,把maupassant文件夹随自己的blog-dev上传到GitHub。
    以后clone blog-dev后,执行完前面的安装操作步骤后记得执行

    $ npm install hexo-renderer-jade --save
    $ npm install hexo-renderer-sass --save
    
    • 配置
      在blog-dev/themes/maupassant/_config.yml中根据自己的情况修改,比如:
    links:
      - title: 我的博客园
        url: http://www.cnblogs.com/palance/
      - title: 我的CSDN
        url: http://blog.csdn.net/zchongr
      - title: 我的简书
        url: http://www.jianshu.com/users/5e527164a8c2
    

    在blog-dev/_config.yml中修改:

    theme: maupassant
    

    第一次的工作就完成了,可以提交github到blog-dev了。

    上传生成页面

    执行

    $ cd blog-dev
    $ npm install hexo-deployer-git
    

    以后每次执行完

    $ hexo clean
    $ hexo generate
    $ hexo server
    

    生成了静态页面后就可以执行

    hexo deploy
    

    完成页面上传。

    其它

    图片

    首先确认_config.yml中有:

    post_asset_folder: true
    

    然后在blog-dev/下执行

    npm install https://github.com/CodeFalling/hexo-asset-image --save
    

    确保在blog-dev/source/_posts下创建和md文件同名的目录,在里面放该md需要的图片,然后在md中插入

    ![](目录名/文件名.png)
    

    即可在hexo generate时正确生成插入图片。比如:

    _posts
        |- post1.md
        |_ post1
            |- pic1.png
    

    在md文件中插入图片时只需写

    ![](post1/pic1.png)
    

    即可。首次配置完了需要执行一次清除操作,再生成页面:

    $ hexo clean
    $ hexo generate
    $ hexo server
    

    如果没做清除,直接生成页面,在我这里会出现路径错误的情况。

  • 相关阅读:
    计算机网络学习资料
    操作系统学习资料
    2020 Multi-University Training Contest 6 1005 Fragrant numbers(区间dp)
    2020 Multi-University Training Contest 6 1010 Expectation(矩阵树定理)
    2020 Multi-University Training Contest 4 1012 Last Problem(01背包)
    2020 Multi-University Training Contest 4 1012 Last Problem(构造)
    2020 Multi-University Training Contest 4 1007 Go Running(网络流)
    2020 Multi-University Training Contest 3 1006 X Number
    静态网页开发基础
    包装类
  • 原文地址:https://www.cnblogs.com/palance/p/5493201.html
Copyright © 2011-2022 走看看