基于github的Next主题博客搭建

有关github搭建免费博客的方法已有很多,再次赘述的目的是为了记录自己在搭建时所遇到的诸多比较麻烦的问题,方便以后查阅.

1. 准备工作(github,git bash,node.js,npm,Next主题)
  • github
    新建一个名称为 github用户名.github.io 的仓库,作为存放博客文件和代码的地方

  • git
    在自己的计算机上安装git,用于将写好的博客和配置文件推送到github的远程仓库

  • node.js
    node.js是JavaScript的一种运行环境,npm是包含在npm的,具体的下载可以百度

  • npm
    npm用来安装hexo(简洁高效的博客框架),在git bash使用以下命令安装

      npm install -g hexo
    
  • hexo
    在本地新建一个文件夹作为本地仓库(在本地仓库写博客修改再推送到远程仓库),在文件夹内输入以下命令

      hexo init
    
hexo的几个常用命令 作用
hexo clean 清除缓存
hexo g 生成静态网页
hexo s 本地生成博客网站
hexo d 部署到远程
2. Next主题配置

Next主题的安装,建议去github上下载zip包,本地解压放进博客根目录下的themes文件夹下,对应的修改站点配置文件_config.yml里的theme项为next(next是存放主题的文件名称)

  • 修改Next主题风格
    Next通过四种风格可选,个人比较偏好最后一个,可以自己尝试修改

      # Schemes
      # scheme: Muse
      # scheme: Mist
      # scheme: Pisces
      scheme: Gemini
    
  • 菜单设置
    Next默认只有两个菜单导航条,可以在主题配置文件中修改

      menu:
      home: /                       #主页
      categories: /categories #分类页(需手动创建)
      about: /about       #关于页面(需手动创建)
      archives: /archives     #归档页
      tags: /tags         #标签页(需手动创建)
      commonweal: /404.html        #公益 404 (需手动创建)
    

    手动创建是指,举个例子,譬如要打开tags导航条,在git bash下运行,

      hexo new page "tags"
    

    并修改/source/categories目录下的index.md文件

      title: tags
      date: 2015-09-29 14:47:21
      type: "tags"
      ---
    
  • sitmap插件
    Sitemap 可方便管理员通知搜索引擎他们网站上有哪些可供抓取的网页,有助于让别人更好地通过搜索到自己的博客

      安装
      npm install hexo-generator-sitemap --save
    
3. 评论系统Gitalk的配置使用

首先,你得有一个Github账号(这个就不多说了吧),下面,打开这个链接,具体填法如下:

    Application name //应用名称,随便填
    Homepage URL //没有过多要求,可以填自己的博客地址
    Application description //应用描述,描述一下,无要求
    Authorization callback URL //这个就有要求了,填自己要使用Gitment的博客地址,不可乱填

对应到主题配置文件下的gitalk

    enable: true #指的是是否开启Gitalk
    ClientID: xxxxxx #之前的Client ID
    ClientSecret: xxxxxxxxxxxx #之前的Client Secret
    repo: gitalk #你要存放的项目名,下文会详细再说
    owner: geedme #这个项目名的拥有者(GitHub账号或组织)
    adminUser: geedme #管理员用户,下文也会详细讲
    ID: location.pathname #页面ID,不知道就默认的就好了
    labels: gitalk #GitHub issues的标签,下面会详细说
    perPage: 15 #每页多少个评论
    pagerDirection: last #排序方式是从旧到新(first)还是从新到旧(last)
    createIssueManually: true #如果当前页面没有相应的 isssue ,且登录的用户属            于 admin,则会自动创建 issue。如果设置为 true,则显示一个初始化页面,创建 issue 需要点击 init 按钮。
    distractionFreeMode: false #是否启用快捷键(cmd|ctrl + enter) 提交评论.
4. 推送远程仓库的常见问题
    deploy:
    type: git
    repository: git@github.com:xxx/xxx.github.io.git
    branch: master
参考附录
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,776评论 6 496
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,527评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,361评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,430评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,511评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,544评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,561评论 3 414
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,315评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,763评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,070评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,235评论 1 343
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,911评论 5 338
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,554评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,173评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,424评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,106评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,103评论 2 352

推荐阅读更多精彩内容