git pages/hexo建站之路,教你如何快速创建自己的精致博客

由于hexo是基于node的框架,所以关于web前端的知识我不会讲太细,如果你是python工程师、ruby工程师,都有其对应的框架,简化搭建博客的难度,不用在hexo上过分用心.
因为直到现在我才明白,我花费了很多心思搞服务器、弄域名、学后台语言,为的是自己搞一个网站,然而却忽略了最为重要的是内容

安装node环境

请移步 nodeJS中文网

安装git

请移步 起步 - 安装 Git

全局安装hexo并初始化一个工程

过程与安装大部分脚手架工具一样类似,工具可以使用命令行工具或git bash

  1. 全局安装hexo
    $ npm install hexo-cli -g
    
  2. 进入一个文件夹(你想把工程放到哪个文件夹就进入哪个文件夹,我的是 D:/files/hexo ),初始化一个工程
    $ hexo init yourProjectName
    
  3. 进入你的工程,安装需要的资源
    $ cd blog
    $ npm install
    
  4. 启动你的工程,默认监听4000端口,打开 localhost:4000 便可以访问到
    $ hexo server
    
  5. 常用的命令就四个
    • hexo clean 清空缓存
    • hexo generate 简写hexo g,生成静态文件
    • hexo serve 简写hexo s,启动一个服务,将本地静态文件可视化
    • hexo deploy 简写hexo d,发布

这时候一个最原始的hexo博客就搭建好了。

安装主题

可以去官方主题库区找,也可以去百度一下信誉比较好的主题,这个根据自己的喜好选择就行。

  1. 安装。主题一般都是托管在GitHub,可以直接将主题直接clone到你的工程下的themes文件夹下,也可以下载压缩包解压到themes文件夹下。
  2. 配置。打开_config.yml(主题文件夹内还有一个_config.yml,不要弄混)文件进行设置,比如你安装好的主题的文件夹叫themeABC,那就将theme设置为themeABC

发布到自己的GitHub pages

pages分两种,一种是对应自己的GitHub账号,一种对应GitHub上的一个工程,现在我们讲的是对应自己GitHub账号的那种。

  1. 创建。创建一个工程,格式为 nickname.github.io ,我的GitHub昵称叫做recoluan,所以我的pages名字叫做 recoluan.github.io
  2. 配置。打开_config.yml,配置自己的工程。
    deploy:
      type: git
      repo: git@github.com:recoluan/recoluan.github.io.git
      branch: master
    
  3. 在你的本体工程下使用命令行工具发布到 GitHub 工程,并使用 nickname.github.io 访问。
    $ hexo g
    $ hexo d
    

绑定域名

  1. 解析域名。在你的域名服务平台的控制台进行解析,设置两条记录,记录的类型都选择 CNAME,记录值都选择 nickname.github.io ,主机记录一条为空,另一条填写 www。
  2. 设置pages。在github上打开你的工程,点击 Settings ,然后找到 GitHub Pages 下的 Custom domain ,填写你的 www 域名,点击 save 保存,这时域名就可以访问到你的网站了。
  3. 修复本地工程。GitHub工程里会出现一个CNAME文件里面写着你域名,见这个文件放到你的本地工程的所用主题下的source文件夹下,不然下次发布时会清空这个文件。

使用gitment添加评论功能

  1. 注册 OAuth Apps。代开你的 GitHub 的设置,然后在左边菜单栏最下方找到 Developer settings 选项,点击进去找到 OAuth Apps,添加新的账号,其中“Application name”对应的你的Pages地址,我的是 recoluan.github.io ,“Homepage URL”和“Authorization callback URL”对应的是域名,我的是 http://www.recoluan.com ,这样会生成client_id和client_secret。
  2. 配置_config.yml。
    gitment:
      enable: true
      owner: recoluan
      repo: recoluan.github.io
      client_id: your client_id
      client_secret: your client_secret
      perPage: 10
    
  3. 将前端代码放到文章页或者专门的评论页
    <% if(theme.gitment.enable && is_post()) { %>
        <script type="text/javascript" src="https://imsun.github.io/gitment/dist/gitment.browser.js"></script>
        <script>
        var gitment = new Gitment({
            id: window.location.pathname,
            owner:"<%= theme.gitment.owner%>",
            repo:"<%= theme.gitment.repo%>",
            oauth: {
              client_id:"<%= theme.gitment.client_id%>",
              client_secret:"<%= theme.gitment.client_secret%>"
            },
            perPage:"<%= theme.gitment.perPage%>",
        });
        gitment.render('comments');
        </script>
    <% } else { %>
       <p>评论系统未开启,无法评论!</p>
    <%}%>
    

jsonContent配置

  1. 首先安装hexo-generator-json-content
    hexo-generator-json-content 
    
  2. 然后在当前主题中的 _config.yml 中配置
    ## 搜索
    jsonContent:
      searchLocal: true
      searchGoogle: false
      meta: false
      pages: false
      posts:
        title: true
        date: true
        path: true
        text: true
        raw: false
        content: false
        slug: false
        updated: false
        comments: false
        link: false
        permalink: false
        excerpt: false
        categories: false
        tags: true
    

设置banner图

banner:
    img: /img/banner.jpg

这里注意,/代表的是根目录,项目会去根目录去寻找,否则会自动在当前目录为基础寻找。

持续更新中。。。

个人博客:午后南杂

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,444评论 6 496
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,421评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,036评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,363评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,460评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,502评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,511评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,280评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,736评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,014评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,190评论 1 342
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,848评论 5 338
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,531评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,159评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,411评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,067评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,078评论 2 352

推荐阅读更多精彩内容