筹备了两周多，凹凸实验室博客 V1.0.0 正式发布啦，欢迎同学们体验并提供建议。
它是一个托管于Github的静态博客，基于HEXO搭建，主题的定做参考自future-imperfect的扁平简约，暂且命名为o2。主题单独开源于 hexo-theme-o2，有兴趣的朋友可以自由下载使用。

博客的一些特性

  1. 使用github头像

    记得将你们在github的头像更新到最帅，将你github的用户名在文章内头部填好即可！

  2. hexo-wordcount 显示博文字数

  3. 不蒜子 统计博文的pv
  4. 每日一句英文警句
  5. 多说评论

使用指引

  1. 安装hexo

    1
    npm i hexo-cli -g

  2. 将o2team.github.io的源码拉到本地

    1
    git clone git@github.com:o2team/o2team.github.io.git o2team

  3. 初始化子模块(submodules)

    1
    2
    3
    4
    5
    6
    7
    cd o2team
    git submodule init
    git submodule update

    # 切换至themes/o2目录，签出master分支
    cd ../themes/o2
    git checkout master

  4. 安装nodejs包

    1
    2
    3
    # 切换回根目录下
    cd ../../
    npm install

  5. 运行hexo s --watch

    运行上述命令后，浏览器打开 http://localhost:4000 即可本地访问我们的网站

创建文章

有两种方法创建文章，可任选其一：

注意：文件名不要出现中文!!!

  1. 使用hexo new 命令

    1
    $ hexo new "My New Post"

  2. 拷贝现有的文章进行修改

    hexo使用markdown来编辑文章，在source目录下，拷贝任意md文件进行创建新的文章。具体可参考下hexo的官方说明

文章规范

  1. 使用markdown写博文

  2. 博文图片统一位置：source/img/post/
    在博客内容中可以使用 pimg 自定义标签来引用图片。注意别覆盖了别人的图片!!!
    其语法格式为：
    {% pimg imageName [alt text] [JSONImageAttibutes] %}
    例如：
    {% pimg post-aotu.jpg "空格请用%20来区分" "{"title":"hello","class":"test_img"}" %}
    需要注意的是：pimg 利用空格来划分字段属性，如果一个属性的值需要空格，请将空格用%20代替!!!

  3. 为了保证博客整体美观，每个文章需要一张配图(大小：840x340)

  4. 指明文章的副标题、作者信息、封面图片地址

    1
    2
    3
    4
    5
    6
    7
    8
    subtitle: "凹凸实验室博客是一个托管于Github的静态博客，基于HEXO搭建..."
    date: 2015-11-20 00:24:35
    cover: "封面图片地址"
    tags:
    - Hexo
    author:
        nick: LV主唱大人
        github_name: mamboer

  5. 利用<!-- more -->设置文章的摘要

    示例：

    1
    2
    3
    4
    5
    title: 文章标题
    ---
    这部分是文章摘要，这部分是文章摘要。在hexo模版里可通过 {% raw %}{{ post.excerpt }}{% endraw %} 来引用。
    <!-- more --> 
    这里是文章的剩余部分。在hexo模版里可通过{% raw %}{{ post.more }}{% endraw %} 来引用。

    实际使用请参考本文。

关于博客的发布

为了便于统一维护，博客的发布由LV负责。同学们写好博文并在本地预览OK后直接提交Github即可。