Welcome to Jekyll, Markdown, and Atom!
这个网站使用Jekyll构建。Check out the Jekyll docs for more info on how to get the most out of Jekyll. File all bugs/feature requests at Jekyll’s GitHub repo.
一、关于Jekyll
If you have questions, you can ask them on Jekyll Talk.
You’ll find this post in your _posts directory. Go ahead and edit it and re-build the site to see your changes.
To add new posts, simply add a file in the _posts directory that follows the convention YYYY-MM-DD-name-of-post.ext and includes the necessary front matter.
Take a look at the source for this post to get an idea about how it works.
二、关于Markdown
Jekyll较好地支持了markdown写作，关于markdown的简单介绍参见：
https://guides.github.com/features/mastering-markdown/
程序代码
Jekyll also offers powerful support for code snippets:
```ruby
def print_hi(name)
puts "Hi, #{name}"
end
print_hi('Tom')
#=> prints 'Hi, Tom' to STDOUT.
```
效果如下：
def print_hi(name)
puts "Hi, #{name}"
end
print_hi('Tom')
#=> prints 'Hi, Tom' to STDOUT.
参考文献
markdown可以较好地支持参考文献功能。例如：It is intended only for human readers.1
实现以上效果的方式如下：
It is intended only for human readers.[^1]
[^1]: <http://en.wikipedia.org/wiki/Syntax_highlighting>
提示
A notice displays information that explains nearby content. Often used to call attention to a particular detail.
When using Kramdown {: .notice}, {: .notice--primary}, {: .notice--info}, {: .notice--warning}, {: .notice--danger}, {: .notice--danger}, and {: .notice--success} can be added after a sentence (Start from a new line) to assign the .notice to the <p></p> element.
Changes in Service: We just updated our privacy policy here to better service our customers. We recommend reviewing the changes.
Primary Notice: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec odio. Praesent libero. Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet.
Info Notice: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec odio. Praesent libero. Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet.
Warning Notice: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec odio. Praesent libero. Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet.
Danger Notice: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec odio. Praesent libero. Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet.
Success Notice: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec odio. Praesent libero. Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet.
三、使用Atom编辑
使用Atom来编写markdown非常不错，按ctr+shift+m就可以进入预览模式，我想markdownpad可以抛弃掉了。这个软件更流畅，非常棒！因为我经常要写github的博客，使用atom时最容易的形式。减少了甚多负担，非常的自由，如果它具有上传功能就好了。
Atom的markdown预览插件
安装了markdown-preview-enhanced可以实时展示markdown文件的编辑效果，这个插件的好处是当你上下滚动浏览markdown文件的时候，右侧的预览部分也会追踪鼠标上下移动。按ctrl+ shift+ m即可进入预览。
markdown-preview-enhanced可以很方便的预览数学公式，比如 $x = y^2$。推荐设置本插件使用mathjax来预览数学公式，因为我们在github上的网站使用mathjax来展现数学公式。
使用美元符号和latex格式的数学公式即可，比如：
$E = MC^2$
效果如下：
$E = MC^2$
Atom的图片上传插件
结果就发现阿里巴巴程序员knightli的两个atom插件：qiniu-uploader和markdown-assistant。设置好七牛的账号既可以非常方便地使用图床了。赞。
Atom的Git上传插件
接着又找到了git-plus这个强大的插件，可以直接在atom里上传了。好吧！社区的力量真强大。太好了。
- 按 command+shift+H打开操作界面。
- 选择
add all commit+push就可以上传了！只需要填写commit的内容，按command+s保存即可上传
震惊脸！！！!
Atom的atom-html-preview插件
如果你需要修改的html文件的话，可以很方便地使用atom-html-preview插件。
四、在本地环境下生成网站
不鼓励在本机的环境下进行以上操作，因为有很多bug。我在实现的时候需要修改Gemfile：
source "https://rubygems.org"
gem "jekyll", "~> 3.3.0"
gem "minimal-mistakes-jekyll"
安装bundle，安装rvm，安装ruby，安装gem，安装jekyll，以及各种依赖的插件。
然后在terminal当中，cd到所在的文件夹，运行bundle install：
bundle install
You can rebuild the site in many different ways, but the most common way is to run jekyll serve, which launches a web server and auto-regenerates your site when a file is updated.
jekyll serve
Leave a Comment