Github+jekyll+markdown个人站点

工具集

  1. git Git[1] is a version control system (VCS) for tracking changes in computer files and coordinating work on those files among multiple people. Git was created by Linus Torvalds in 2005. As a distributed revision control system it is aimed at speed, data integrity, and support for distributed, non-linear workflows.
  2. github GitHub[2] is a web-based Git or version control repository and Internet hosting service.
  3. markdown Markdown[3] is a lightweight markup language with plain text formatting syntax.
  4. jeykll 将纯文本转换为静态博客网站.GitHub Pages基于Jekyll构建。
  5. mathjax MathJax允许你在你的网页中包含公式,无论是使用LaTeX、MathML或者AsciiMath符号,这些公式都会被javascript处理为HTML、SVG或者MathML符号Markdown[4]
  6. hexo Hexo 是一个快速、简洁且高效的博客框架[6]

在Github + jekyll + markdown的组合里使用数学公式

  • starkoverflow 里对应问题 using-mathjax-with-jekyll. 答案里还碰到了 deeplearning 作者 Ian Goodfellow
  • 解决办法:
    Change the markdown line in _config.yml to
    markdown: kramdown
    并且将mathjax的js库放到_layouts/default.html里去
    1
    <script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>

markdown语法

在sublime里编辑markdown

  1. 安装Package Control
    调出python控制台,输入安装的python代码,如果代码安装失败可以选择手动安装。
    使用方法:快捷键
    Package,即可安装插件
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    2. 安装Markdown Editing和Markdown Preview
    [自定义快捷键和支持语法高亮和mathjax支持](http://www.cnblogs.com/IPrograming/p/Sublime-markdown-editor.html)
    3. 在sublime里高亮显示
    [显示方法](http://frank19900731.github.io/blog/2015/04/13/zai-sublime-zhong-pei-zhi-markdown-huan-jing/)
    #### hexo主题 next的问题
    - [Hexo和MathJax的兼容问题](https://github.com/iissnan/hexo-theme-next/issues/826)

npm uninstall hexo-renderer-marked —save
npm install hexo-renderer-kramed —save
```

参考:
[1] https://en.wikipedia.org/wiki/Git
[2] https://en.wikipedia.org/wiki/GitHub
[3] https://en.wikipedia.org/wiki/Markdown
[4] https://mathjax-chinese-doc.readthedocs.io/en/latest/start.html
[5] http://harttle.com/2013/10/18/github-homepage-tutorial.html
[6] https://hexo.io/zh-cn/docs/index.html