软件简介

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

[](https://github.com/fex-team/fex-

team.github.io#%E7%8E%AF%E5%A2%83%E6%90%AD%E5%BB%BA)环境搭建

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

[](https://github.com/fex-team/fex-

team.github.io#maclinux-%E4%B8%8B)Mac/Linux 下

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

gem install jekyll

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

brew install ruby

[](https://github.com/fex-team/fex-

team.github.io#windows-%E4%B8%8B)Windows 下

jekyll 官方对 winodws 的支持程度很低，推荐使用 Building portable Jekyll for
Windows，另外这里附上网盘地址方便大家下载：PortableJekyll
1.3.0[百度网盘]

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

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

2. 为 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 -h

[](https://github.com/fex-team/fex-

team.github.io#%E6%9C%AC%E5%9C%B0%E9%A2%84%E8%A7%88)本地预览

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

jekyll serve --watch

[](https://github.com/fex-team/fex-

team.github.io#%E5%A6%82%E4%BD%95%E7%BC%96%E8%BE%91)如何编辑？

[](https://github.com/fex-team/fex-

team.github.io#%E6%96%B0%E5%BB%BA%E8%8D%89%E7%A8%BF)新建草稿

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

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

jekyll serve --watch --drafts

[](https://github.com/fex-team/fex-

team.github.io#%E4%B8%AA%E4%BA%BA%E4%BF%A1%E6%81%AF)个人信息

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

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

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

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

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

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

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

[](https://github.com/fex-team/fex-

team.github.io#%E5%9B%BE%E7%89%87%E5%AD%98%E6%94%BE%E5%9C%B0)图片存放地

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

![](/img/<文章名>/xx.png)

发布

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

[](https://github.com/fex-team/fex-

team.github.io#%E5%B0%8F%E6%8A%80%E5%B7%A7)小技巧

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

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

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

[](https://github.com/fex-team/fex-

team.github.io#%E5%86%99%E4%BB%80%E4%B9%88)写什么？

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

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

• 技术介绍、经验总结

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

• 优秀文章的翻译

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

• 内部分享的 PPT（推荐使用 Speaker Deck 存放）

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

[](https://github.com/fex-team/fex-

team.github.io#%E5%AF%B9%E4%BA%8E%E5%86%99%E4%BD%9C%E9%A3%8E%E6%A0%BC%E7%9A%84%E7%BA%A6%E5%AE%9A)对于写作风格的约定

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

[](https://github.com/fex-team/fex-

team.github.io#%E5%85%B6%E5%AE%83%E9%97%AE%E9%A2%98)其它问题

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

  • 你确定放到 _posts 下了是吧？

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

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

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

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

• 为何不用 WordPress？

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

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

• 为何不用时下流行的 c？

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

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

  • 真的？可以啊，请提 pull request