Welcome to Jekyll, Markdown, and Atom!

2 minute read

这个网站使用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。设置好七牛的账号既可以非常方便地使用图床了。赞。

qiniu-uploader

Atom的Git上传插件

接着又找到了git-plus这个强大的插件,可以直接在atom里上传了。好吧!社区的力量真强大。太好了。

  • command+shift+H打开操作界面。
  • 选择add all commit+push就可以上传了!只需要填写commit的内容,按command+s保存即可上传

surprise

震惊脸!!!!

Atom的atom-html-preview插件

如果你需要修改的html文件的话,可以很方便地使用atom-html-preview插件。

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

jekyll serve

参考文献

Tags:

Categories:

Updated: