文章目录
  1. 1. 常用命令
  2. 2. 在github上创建一个仓库
    1. 2.1. 安装hexo
  • !/usr/bin/env nodejs
    1. 0.1. 使用hexo初始化hexo_wiki
    2. 0.2. 启动hexo服务端进程
  • 1. 更换hexo主题
  • 2. 创建gh-pages分支
  • 3. 发布
  • 4. 配置
  • 5. 网址
  • 6. 添加RSS订阅
  • 7. 使用LaTex书写数学公式
  • 环境: ubuntu14.04
    hexo是一款基于Node.js的静态博客框架,可以将生成的静态网页放到Github Pages,个人服务器或者BAE,SAE等平台上.

    常用命令

    1
    2
    3
    4
    5
    hexo new "postName" #新建文章
    hexo new page "pageName" #新建页面
    hexo generate #生成静态页面至public目录
    hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
    hexo deploy #将.deploy目录部署到指定的服务器

    在github上创建一个仓库

    例如地址为: https://github.com/xxxxxx/hexo_wiki
    也可以不使用github将仓库托管到自己的服务器上

    1
    git clone https://github.com/xxxxxx/hexo_wiki

    安装hexo

    首先需要安装npm (node package manager)

    1
    sudo apt-get install npm

    使用npm安装hexo

    1
    sudo npm install -g hexo

    运行hexo可能会提示错误: /usr/bin/env: node: 没有那个文件或目录

    这是因为hexo是一个Node.js脚本, 需要使用node解析器, 但是在ubuntu中node的解析器叫nodejs

    修改/usr/local/lib/node_modules/hexo/bin/hexo第一行

    !/usr/bin/env nodejs

    使用hexo初始化hexo_wiki

    hexo init hexo_wiki

    进入hexo_wiki目录, 使用npm安装依赖模块

    npm install

    新建完成后,部分文件结构如下:

    .
    ├── _config.yml
    ├── package.json
    ├── scaffolds
    ├── source
    | ├── _drafts
    | └── _posts
    └── themes

    _config.yml是网站的配置信息,可以配置大部分的参数

    package.json包含npm安装的应用程序

    scaffolds 模板文件夹,新建文章时,hexo根据scaffolds来建立文件

    启动hexo服务端进程

    在hexo_wiki目录中运行 hexo server

    hexo server默认监听的地址和端口是 127.0.0.1:4000

    所以在网页中打开127.0.0.1:4000就可以看到hello world的博客

    常用命令:

    hexo clean 删除生成的文件和cache

    hexo new filename 创建新文章

    hexo generate 生成静态网站

    hexo deploy 发布

    更换hexo主题

    下载主题到themes目录

    例如: git clone https://github.com/wuchong/jacman.git themes/jacman

    修改 _config.yml

    将theme: landscape 改为 theme: jacman

    重启hexo server就可以看到效果了

    jacman主题的使用说明见 http://wuchong.me/jacman/2014/11/20/how-to-use-jacman/

    创建gh-pages分支

    在github 仓库旁点集settings

    在GitHub Pages 点击 Automatic page generator, 为这个仓库生成一个页面

    同时也会创建一个 gh-pages的分支

    发布

    到hexo_wiki的目录

    git fetch

    编辑_config.yml, 修改deploy

    例如:

    deploy:
    type: git
    repository: https://github.com/xxxxxx/hexo_wiki
    branch: gh-pages

    在hexo_wiki目录下执行: npm install hexo-deployer-git —save

    hexo deploy —generate

    修改 _config.xml 中的url 为 创建ph-pages分支时生成的页面的地址

    例如:

    url: http://caodan4linux.github.io/hexo_wiki
    root: /hexo_wiki

    再重新发布:

    hexo clean

    hexo deploy —generate

    配置

    可以在_config.yml中修改大部分配置

    网站


    |参数|描述|
    |title|网站标题|
    |subtitle|网站副标题|
    |description|网站描述|
    |author|您的名字|
    |language|网站使用的语言|
    |timezone|网站时区。Hexo 预设使用您电脑的时区。时区列表|

    网址

    | 参数 | 描述 | 默认值 |
    | url | 网址 | |
    | root | 网站根目录 | |
    | permalink | 文章的 永久链接 格式 | :year/:month/:day/:title/ |
    | permalink_default | 永久链接中各部分的默认值 | |

    网站存放在子目录

    如果您的网站存放在子目录中,例如 http://yoursite.com/blog,

    则请将您的 url 设为 http://yoursite.com/blog 并把 root 设为 /blog/。

    添加RSS订阅

    安装 hexo-generator-feed
    pm install hexo-generator-feed —save

    修改_config.yml

    添加如下内容:

    1
    2
    3
    4
    5
    # feed, type can be atom or rss2, limit is maximum number of posts in the feed
    feed:
    type: atom
    path: atom.xml
    limit: 20

    使用LaTex书写数学公式

    MathJax 是一套开源 JavaScript 库, 它并不是将公式转化为一个图片,而是在浏览器端通过位置控制、字体、大小来显示一个公式。已经支持 LaTeX、MathML、和 AsciiMath 数学公式。

    修改themes/jacman/layout/_partial/after_footer.ejs文件(不同主题的用户,文件位置可能不一样),在文件末尾添加下面的代码:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    <script type="text/x-mathjax-config">
    MathJax.Hub.Config({
    tex2jax: {
    inlineMath: [['$','$'], ['\\(','\\)']]
    }
    });
    </script>
    <script type="text/x-mathjax-config">
    MathJax.Hub.Config({
    tex2jax: {
    skipTags: ['script', 'noscript', 'style', 'textarea', 'pre', 'code']
    }
    });
    </script>
    <script type="text/javascript"
    src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
    </script>

    调用LaTex公式的方法:

    $表示行内公式(嵌入到文本段中), 例如

    使用$E=mc^2$ 来表达:$E=mc^2$

    $$ 表示整行公式(独自称为一个段落):

    1
    $$\sum_{i=1}^n a_i=0$$

    $$\sum_{i=1}^n a_i=0$$

    1
    $$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$

    $$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$

    文章目录
    1. 1. 常用命令
    2. 2. 在github上创建一个仓库
      1. 2.1. 安装hexo
  • !/usr/bin/env nodejs
    1. 0.1. 使用hexo初始化hexo_wiki
    2. 0.2. 启动hexo服务端进程
  • 1. 更换hexo主题
  • 2. 创建gh-pages分支
  • 3. 发布
  • 4. 配置
  • 5. 网址
  • 6. 添加RSS订阅
  • 7. 使用LaTex书写数学公式