fex-team.github.io开源项目

这是FEX团队对外首页的源码，将文章提交到这里后就会在https://fex.baidu.com上展现。

这个系统是基于jekyll搭建的，为了方便本地编辑和看效果，需要将本项目clone至本地环境，并在本机安装jekyll环境。

请使用如下命令（其中gem是Ruby 的包管理工具）安装jekyll（如果遇到权限问题请在前面加sudo）：

如果在Mac下安装遇到编译报错，可以试试用Brew安装新版ruby

jekyll官方对winodws的支持程度很低，推荐使用BuildingportableJekyllforWindows，另外这里附上网盘地址方便大家下载：PortableJekyll1.3.0[百度网盘]

下边以PortableJekyll的解压目录为e:\jekyll介绍环境变量的配置：

在环境变量中新建变量：JEKYLL_HOME取值为e:\jekyll

为PATH变量添加如下内容：%JEKYLL_HOME%\ruby\bin;%JEKYLL_HOME%\devkit\bin;%JEKYLL_HOME%\git\bin;%JEKYLL_HOME%\Python\App;%JEKYLL_HOME%\devkit\mingw\bin;%JEKYLL_HOME%\curl\bin

完成jekyll配置后，通过如下命令检查是否配置成功：

完成jekyll的安装后，在源码目录运行如下命令，就能在localhost:4000中预览了：

新文章编写时请先浏览_drafts目录，这里存放的是草稿，它不会在首页显示，请参考里面的2014-05-06-empty.md文件，新建文件名要遵循这样的格式，以日期开头，后面接着是文章的对外url子路径，中间以-分隔，后续标题有多个单词时也以-作为分隔符，建议只用英文单词或拼音，目前不确定中文是否可行。

需要注意的是草稿不会出现在首页列表中，如果想本地预览草稿效果，可以加--drafts参数，如下所示：

每篇文章都会附上个人相关信息，所以请先编辑_data\authors.yml文件，按照其中的格式新增一项，需要注意以下几点：

这是YAML格式，每行的开头是两个空格，而不是TAB

author字段需要和你所写文章开头的author属性保持一致，这样才能正确展现

url字段可以连接到个人主页或微博等

intro是个人简介，会在每篇文章中展现

avatar是个人头像，尺寸暂定120x120，请放在img/avatar目录下

为何不用gavatar？因为不是所有人都希望公开自己的邮箱，而且这样操作起来会简单些

请将图片放在img目录里，每篇文章新建一个目录，在文章中的引用方式为：

如果觉得文章可以对外展示了，不过还得先找个280x150的图片作为首页封面，放到/img/<文章名>/cover.jpg下，然后将文章移到_posts目录下，提交后就可以了。

jekyll最终生成的文件会放在_site目录下，可以通过浏览这个目录来确认效果

img目录的主要用途是放图片，但也可以放其它文件静态，如zip等

不常见的语法高亮缩写可以参考这里

虽然对外会觉得这是团队Blog，但其实准确来说这里是每个团队成员的个人分享，每篇文章都只代表个人观点，所以如果有什么值得分享的话题，请不要有太多顾虑，想写什么就写什么，借助这个平台来提升自己的影响力吧。

具体内容形式将包括但不限于：

技术介绍、经验总结

FEX新开源项目及升级版本介绍

优秀文章的翻译

优秀资源（书籍、开源项目）等的推荐

内部分享的PPT（推荐使用SpeakerDeck存放）

另外，如果你对目前界面的哪些细节不满意，也欢迎直接修改相关源码。

请参考Markdown编写规范，另外在根目录下个脚本format.js，可以通过它来自动加空格。

为什么某篇文章没显示出来？

你确定放到_posts下了是吧？

有可能是用了{%xxx}%，因为页面会当成Liquid模板进行解析，所以请使用{%raw %}{%xxx%}{%endraw%}来包含起来

那你肯定没在本地预览过，估计是有报错

文章发布前需要找谁审核么？

不需要，因为每篇文章都是以个人名义发表的

为何不用WordPress？

WordPress环境搭建麻烦，不利于修改

简单来说就是：用起来不爽

为何不用时下流行的c？

Hexo是将生成后的页面放github中，多人编辑出现冲突时合并麻烦

我不是FEX团队成员，可以在这里发表文章么？

真的？可以啊，请提pullrequest