hexo usage

发表于 | 分类于 | 阅读次数：

功能

用makrdown文件为源,生成html文件的框架

学习笔记

添加tag支持

  1. hexo new page "tags"
  2. 编辑页面:
    1
    2
    3
    4
    5
    6
    ---
    title: Tagcloud
    date: 2018-03-27 16:59:00
    type: "tags"
    # commentts: false # 如果有评论功能需要禁止评论
    ---
  3. 主题的配置文件增加tags处理,在menu中添加:
    1
    2
    3
    4
    menu:
      Home: /
      Archives: /archives
      tags: /tags
  4. 重新清理编译生成即可

添加Categories支持

快速入门(使用github,gitpage搭建自动更新博客)

  1. github上创建gitpage的仓库,格式:用户名.github.io
  2. github上创建分支source
  3. 将远程库更新到本地 
    1
    2
    git clone https://github.com/用户名.github.io 用户名.github.io # 复制
    git checkout source # 切换到分支
  4. 本机安装hexo相关软件(记得勾选环境变量)
    1. git,安装包安装
    2. node-js,安装包安装
  5. 本地创建页面 
    1
    2
    3
    4
    # mkdir 用户名.github.io # 名字随意,为了方便,统一用库名
    # cd 用户名.github.io
    hexo init
    npm install
    会产生初始文件
    • _config.yml,网站配置文件(改下名字啊什么的)
    • package.json,npm的环境配置文件(调用npm install时会调用这个文件来配置环境)
    • scaffolds模版
    • source源文件目录(就是.md文件的位置)
    • themes主题目录,下载后在_config.yml中修改为对应的文件夹名即可使用相关主题(更换主题后建议使用hexo clean清除旧数据)
  6. 本地测试 
    1
    2
    hexo g # 生成`html`静态页面
    hexo s # 本地预览测试
  7. 编写.travis.yml文件(简单配置,分支source上传才处理,自动安装hexo,自动强制推送到master分支,GH_TOKEN是在travis上的项目中定义,使用的是github上专门创建的personal access token)
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    language: node_js
    node_js: stable

    install:
      - npm install hexo --save
      #- npm install -g hexo-cli

    script:
      - hexo clean
      - hexo g

    after_script:
      - cd ./public
      - git init
      - echo "# Pan's Blog" >> README.md
      - echo "![travis](https://travis-ci.org/a/a.github.io.svg?branch=source)" >> README.md
      - git config user.name "a"
      - git config user.email "a@b.com"
      - git add .
      - git commit -m "Update docs"
      - git push --force --quiet "https://${GH_TOKEN}@${GH_REF}" master:master

    branches:
      only:
        - source

    env:
      global:
        - GH_REF: github.com/a/a.github.io.git
  8. 推送到github上:git push
  9. 等travis运行结束,即可访问https://用户名.github.io来看网页了
  10. 后续更新
    • hexo new 文件名生成.md文件
    • 编辑对应的.md文件
    • 上传到github:git commit -am "xxx" && git push
    • 等待travis完成操作
    • 刷新网页看效果