通过Hexo在Github上搭建博客教程

作者: Andrew_liu | 来源:发表于2014-11-23 14:06 被阅读23742次

    Hexo简介


    hexo是一个基于Node.js的静态博客程序,可以方便的生成静态网页托管在github和Heroku上。作者是来自台湾的@tommy351

    A fast, simple & powerful blog framework, powered by Node.js.

    为什么我要使用Hexo:

    1. 之前使用过CSDN,博客园和jekyll博客,其中前两个不能算是这个博客吧,主要是使用别的提供的平台发博文,第三个jekyll,我记得是Ruby语言写的,是Github Page着力推荐的, 但其中有繁琐的git操作, 而且有一些资源加载的问题(主要是我不太懂Ruby)
    2. 最近在学习JS后端Node.js, 现在火的不行, 异步IO的机制, 所以在学习过程中发现了Hexo
    3. Hexo更加简单优雅, 而且风格多变, 适合程序员搭建个人博客,而且支持多平台的搭建

    使用的软硬件

    Mac Pro    #软件的安装基本都是基于brew
    Node.js    #v0.10.33
    npm        #2.1.6 包管理,类似于Python中的pip
    

    下面正式讲述如何部署:

    1. Git安装和Github设置


    使用Mac电脑可以直brew安装,

    brew install git         #Mac电脑使用brew安装
    sudo apt-get install git #Ubuntu系统使用这条命令安装
    

    git操作和github上SSH设置请看这篇博文

    使用Github Page搭建博客, 需要遵循一定的规则, 需要在github建立仓库,仓库名为Github用户.github.io, 更多详情请参考官方文档

    2. Node.js安装


    mac电脑可以直接通过brew安装

    #安装命令
    brew install node  #如果我没记错的话,最新版的node.js的包中已经集成了npm包管理工具
    
    使用以下命令验证是否安装成功
    node -v
    npm -v
    

    Node.js的详细内容请参考Node.js学习笔记

    3. Hexo安装与设置


    Node, npm和Git都安装成功, 开始安装hexo,

    npm install hexo -g  #-g表示全局安装, npm默认为当前项目安装
    

    Hexo使用命令:

    hexo init <folder>  #执行init命令初始化hexo到你指定的目录
    hexo generate       #自动根据当前目录下文件,生成静态网页
    hexo server         #运行本地服务, 
    

    浏览器输入http://localhost:4000就可以看到效果。

    4. 添加博文


    hexo new "postName"  #新建博文,其中postName是博文题目
    

    博文会自动生成在博客目录下source/_posts\postName.md

    #文件自动生成格式:
    title: "It Starts with iGaze: Visual Attention Driven Networkingwith Smart Glasses"  #博文题目
    date: 2014-11-21 11:25:38      #生成时间
    tags: Paper                    #标签, 多个标签使用格式[Paper1, Paper2, Paper3,...]
    ---
    

    如果不想博文在首页全部显示, 并能出现阅读全文按钮效果, 需要在你想在首页显示的部分下添加``

    此处及以上的内容会在首页显示
    <!--more-->
    一下是在首页隐藏的部分
    

    5. 主题更改


    Hexo提供了官网的主题, 初始化hexo时也会自动生成一个主题, Hexo还支持个性定制主题, 可以根据自己的喜好对主题进行修改, 更多主题可以在官网中找到

    • 个性化博客的设置
      博客的根目录下对喜爱的主题进行主题进行克隆
    git clone git@github.com:yunlzheng/hexo-themes.git themes/writing
    
    #在./_config.yml,修改主题为writing
    theme: writing
    
    #查看本地效果
    hexo g       #hexo generate简写
    hexo s       #hexo server简写
    

    6. 部署到Github


    以上内容都是在本地进行查看, 现在将博客部署到github上
    打开./_config.yml

    # Hexo Configuration
    ## Docs: http://hexo.io/docs/configuration.html
    ## Source: https://github.com/hexojs/hexo/
    
    # Site
    title: Snow Memory    #博客名
    subtitle: 雪忆, 如雪般单纯, 冷静思考.  #博客副标题
    description:          #网站描述, 用于爬虫抓取的关键词
    author: Andrew Liu    #作者名称
    email: Liu.bin.coder@gmail.com  #作者邮箱
    language: zh-CN       #网页编码,中文
    
    # URL
    ## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
    url: http://andrewliu.tk   #用于绑定域名, 其他的不需要配置
    root: /
    permalink: :year/:month/:day/:title/
    tag_dir: tags
    archive_dir: archives
    category_dir: categories
    code_dir: downloads/code
    permalink_defaults:
    
    # Directory
    source_dir: source  
    public_dir: public
    
    # Writing, 设置生成博文的默认格式,不修改
    new_post_name: :title.md # File name of new posts
    default_layout: post
    titlecase: false # Transform title into titlecase
    external_link: true # Open external links in new tab
    filename_case: 0
    render_drafts: false
    post_asset_folder: false
    relative_link: false
    highlight:
      enable: true
      line_number: true
      tab_replace:
    
    # Category & Tag
    default_category: uncategorized
    category_map:
    tag_map:
    
    # Archives
    #Archives 默认值为2,修改为1,Archives页面就只会列出标题,而非全文
    ## 2: Enable pagination
    ## 1: Disable pagination
    ## 0: Fully Disable
    archive: 1
    category: 1
    tag: 1
    
    # Server服务器设置, 不修改
    ## Hexo uses Connect as a server
    ## You can customize the logger format as defined in
    ## http://www.senchalabs.org/connect/logger.html
    port: 4000
    server_ip: localhost
    logger: false
    logger_format: dev
    
    # Date / Time format 日期格式
    ## Hexo uses Moment.js to parse and display date
    ## You can customize the date format as defined in
    ## http://momentjs.com/docs/#/displaying/format/
    date_format: MMM D YYYY
    time_format: H:mm:ss
    
    # Pagination 分页, 设置每页显示多少篇博文
    ## Set per_page to 0 to disable pagination
    per_page: 10
    pagination_dir: page
    
    # Disqus  disqus评论,  与多说类似, 国内一般使用多说
    disqus_shortname: 
    
    # Extensions
    ## Plugins: https://github.com/hexojs/hexo/wiki/Plugins
    ## Themes: https://github.com/hexojs/hexo/wiki/Themes
    theme: yilia    #主题设置
    exclude_generator:
    
    # Deployment  站点部署到github要配置这里, 非常重要
    ## Docs: http://hexo.io/docs/deployment.html
    deploy:
      type: github    #部署类型, 本文使用Github
      repository: git@github.com:Andrew-liu/Andrew-liu.github.io.git  #部署的仓库的SSH
      branch: master   #部署分支,一般使用master主分支
    plugins: 
    - hexo-generator-feed   #此插件用于RSS订阅, 以后有时间再介绍
    

    在配置文件中设置号部署设置后,

    hexo deploy  #进行部署
    
    Initialized empty Git repository in /Users/andrew_liu/Andrew-liu.github.io/.deploy/.git/
    [master (root-commit) bb3079b] First commit
     1 file changed, 0 insertions(+), 0 deletions(-)
     create mode 100644 placeholder
    [info] Clearing .deploy folder...
    [info] Copying files from public folder...
    [master 6e24e8d] Site updated: 2014-11-21 11:16:23
     172 files changed, 34969 insertions(+)
     create mode 100644 2014/09/08/Hello-World/index.html
     ...
     create mode 100644 "tags/\345\277\203\350\267\257\346\234\255\350\256\260/index.html"
    To git@github.com:Andrew-liu/Andrew-liu.github.io.git
     + 11237d0...6e24e8d master -> master (forced update)
    Branch master set up to track remote branch master from git@github.com:Andrew-liu/Andrew-liu.github.io.git.
    [info] Deploy done: github
    
    
    #表示部署成功
    

    可以使用Github用户名.github.io进行访问, 或者设置个性域名

    相关文章

      网友评论

      • thinkhejie:如何升级hexo的版本?
      • 香脆的大鸡排:真棒,学习了
      • 巴图鲁:不错
      • stormxue:部署成功,但是无法通过使用Github用户名.github.io进行访问,这是什么原因?
      • Raybon_lee:亲,换电脑了,hexo 该如何操作呢, :smile: ,之前环境搭建在本地了,有没有托管平台
      • 我叫小灿灿:部署这块太复杂了,没看明白.
      • 我叫小灿灿:你的这个主页很好看,能告诉我是那个主题么?
      • Bianfei:正好需要
      • 606fd5f5448c:楼主,我也遇到了这个问题-bash: syntax error near unexpected token `newline'
      • 5aa6a3666dad:ranho@A56CM:~/MyBlog$ sudo hexo server
        Native thread-sleep not available.
        This will result in much slower performance, but it will still work.
        You should re-install spawn-sync or upgrade to the lastest version of node if possible.
        Check /usr/lib/node_modules/hexo/node_modules/hexo-util/node_modules/cross-spawn/node_modules/spawn-sync/error.log for more details
      • Hanwen1001:http://zhonghanwen.github.io/ 部署后访问404,请问是什么原因
      • 2f2ccef765c8:请问部署好了,为什么还是打不开呢,又没有报错。
      • Gutierrez:初始化了之后需要npm install
      • iHTCboy:安装hexo报错,改下面命令:

        sudo npm install --unsafe-perm --verbose -g hexo
      • 886955d2f2ad:博主你好,有一个问题,就是不管我使用的是哪一个主题,使用:http://localhost:4000都会显示和原本的不同,好像有很多css没有加载进来,试了很多主题都是这样子,hexo是3.1.1的版本,十分感谢。
      • 886955d2f2ad:博主你好,有一个问题,就是不管我使用的是哪一个主题,使用:http://localhost:4000都会显示和原本的不同,好像有很多css没有加载进来,试了很多主题都是这样子,hexo是3.1.1的版本,十分感谢。
      • aceebf116ba8:你好,请问hexo deploy之后,在github上相应的仓库中只有public文件夹中的内容,这样是对的么?我在本地localhost:4000显示正常的博客首页,而在github.io上,只有在public加个index.html才能显示html中的内容,不然就404。这是为什么呢……
      • 骨骨:执行 npm install hexo -g 这个命令后,等待了几分钟后出错了,不知道该怎么操作了,求助:

        ![](http://ww2.sinaimg.cn/large/674d24fegw1es87ctjie6j215011gwuu.jpg)
      • Andrew_liu: @原力烹小鲜 你试试放在source文件夹下
      • 加乘:@Andrew_liu 但现在问题又来了,不知为何每次deploy 后CNAME 文件就自动不见了好不开心😢请帮助我~~
      • 加乘: @Andrew_liu 现已正式入门yeah谢谢大大
      • 加乘: @Andrew_liu 现已正式入门yeah谢谢大大
      • Andrew_liu:@原力烹小鲜 启动hexo的内置调试server
      • 加乘:求问安装完毕后为何localhost没有反应??😢
      • Andrew_liu: @豆子糖 你加了$符号?
      • 豆子糖:$ hexo init <folder>这一步显示-bash: syntax error near unexpected token `newline'
        求解?
      • 杨少侠:@悟道问心 已解决 没有执行 npm install
      • 杨少侠: 你好,为什么我hexo s 后 出现的页面总是代码,诸如此类:
        <%- partial('_partial/head') %>
        <%- partial('_partial/header') %>
        <%- body %>
        <%- partial('_partial/footer') %>
        <%- partial('_partial/after-footer') %>
      • Andrew_liu:@fishwood 可以管理两个博客, git不需要账号, 你说的是github吧, 设置根据上面的来就行了
      • 3e354400518e:您好,感谢分享。初学者请教,我想同时管理两个博客,请问是否可行,是否复杂?需要两个git帐号?本机设置上需要注意哪些?谢谢
      • sH2nxy:@Andrew_liu 我再去看看吧,我这里一堆bug,完全不知道肿么回事
      • Andrew_liu:@Linyiem 是的, 你可以查看hexo官方部署文档
      • sH2nxy:repository: git@github.com:Andrew-liu/Andrew-liu.github.io.git #部署的仓库的SSH
        这句话的意思是说会把这些代码上传到git上你的Andrew-liu.github.io仓库里吗?
      • Andrew_liu: @Linyiem 代码在本地呀,命令会用git上床的
      • sH2nxy:@Andrew_liu 谢谢,deploy语句我看到了。其实我的问题是我一开始简历hexo文件夹的时候就没上传到git上面,然后用github客户端上传,多次提示failed。
        我想问你的代码是一早就放在github上的对吧?
        (git初学者)
      • Andrew_liu:@Linyiem deploy:
        type: github #部署类型, 本文使用Github
        repository: git@github.com:Andrew-liu/Andrew-liu.github.io.git #部署的仓库的SSH
        branch: master #部署分支,一般使用master主分支

        然后使用 hexo deploy部署, 查看文章最后
      • sH2nxy:我现在博客还在本地,还是通过localhost访问的。请问要怎么才能用域名访问呢
      • sH2nxy:刚才那个错误没有了,现在的错误是 hexo :command not found 已经安装了呀,也到了hexo文件夹目录下了,怎么显示找不到命令呢
        jnunp:@iHTCboy 不行啊 加上sudo就变成了 sudo :command not found
        iHTCboy:@Linyiem 出现以上错误是因为权限问题,在执行hexo命令前,加上sudo即可。
      • sH2nxy:安装hexo报错,错误代码贴不过来……
      • Andrew_liu:@机智的阿卡林酱 我在Mac下使用node -v正常打印版本好, 阿卡林酱有关注你的微博, 希望能交流一下
      • 帅灰:Mark
      • Andrew_liu:@侯爷 我一般使用多说, 感觉还不错
      • 侯爷:@Andrew_liu ok,我博客上用的评论模块就是disqus :grin:
      • Andrew_liu:@侯爷 已经修改了 感谢提醒
      • Andrew_liu:@侯爷 说错了, 这是一个外国的, 和多说类似
      • 侯爷:disqus不是多说

      本文标题:通过Hexo在Github上搭建博客教程

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