这是FEX团队对外首页的源码,将文章提交到这里后就会在https://fex.baidu.com上展现。
环境搭建这个系统是基于jekyll搭建的,为了方便本地编辑和看效果,需要将本项目clone至本地环境,并在本机安装jekyll环境。
Mac/Linux下请使用如下命令(其中gem是Ruby 的包管理工具)安装jekyll(如果遇到权限问题请在前面加sudo):
gem install jekyll如果在Mac下安装遇到编译报错,可以试试用Brew安装新版ruby
brew install rubyWindows下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 -h本地预览完成jekyll的安装后,在源码目录运行如下命令,就能在localhost:4000中预览了:
jekyll serve --watch如何编辑?新建草稿新文章编写时请先浏览_drafts目录,这里存放的是草稿,它不会在首页显示,请参考里面的2014-05-06-empty.md文件,新建文件名要遵循这样的格式,以日期开头,后面接着是文章的对外url子路径,中间以-分隔,后续标题有多个单词时也以-作为分隔符,建议只用英文单词或拼音,目前不确定中文是否可行。
需要注意的是草稿不会出现在首页列表中,如果想本地预览草稿效果,可以加--drafts参数,如下所示:
jekyll serve --watch --drafts个人信息每篇文章都会附上个人相关信息,所以请先编辑_data\authors.yml文件,按照其中的格式新增一项,需要注意以下几点:
这是YAML格式,每行的开头是两个空格,而不是TAB
author字段需要和你所写文章开头的author属性保持一致,这样才能正确展现
url字段可以连接到个人主页或微博等
intro是个人简介,会在每篇文章中展现
avatar是个人头像,尺寸暂定120x120,请放在img/avatar目录下
为何不用gavatar?因为不是所有人都希望公开自己的邮箱,而且这样操作起来会简单些
图片存放地请将图片放在img目录里,每篇文章新建一个目录,在文章中的引用方式为:
![](/img/<文章名>/xx.png)发布如果觉得文章可以对外展示了,不过还得先找个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
评论