常梦网 常梦网

fex-team.github.io

时间: 2024-02-11  热度:

程序员必上的开发者服务平台 —— DevStore

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

环境搭建

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

Mac/Linux 下

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

gem install jekyll

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

brew install ruby

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

本地预览

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

jekyll serve --watch

如何编辑?

新建草稿

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

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

jekyll serve --watch --drafts

个人信息

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

图片存放地

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

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

发布

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

小技巧

写什么?

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

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

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

对于写作风格的约定

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

其它问题


相关阅读