当前位置:  软件>JavaScript软件

fex-team.github.io

    来源:    发布时间:2014-12-26

    本文导语:  这是 FEX 团队对外首页的源码,将文章提交到这里后就会在 http://fex.baidu.com 上展现。 环境搭建 这个系统是基于 jekyll 搭建的,为了方便本地编辑和看效果,需要将本项目 clone 至本地环境,并在本机安装 jekyll 环境。 Mac/Linux 下 ...

这是 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 介绍环境变量的配置:

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

  • 为 PATH 变量添加如下内容:%JEKYLL_HOME%rubybin;%JEKYLL_HOME%devkitbin;%JEKYLL_HOME%gitbin;%JEKYLL_HOME%PythonApp;%JEKYLL_HOME%devkitmingwbin;%JEKYLL_HOME%curlbin

  • 完成 jekyll 配置后,通过如下命令检查是否配置成功:

    jekyll -h
    本地预览

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

    jekyll serve --watch
    如何编辑? 新建草稿

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

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

    jekyll serve --watch --drafts
    个人信息

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

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

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

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

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

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

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

    图片存放地

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

    ![](/img//xx.png)
    发布

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

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

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

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

    写什么?

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

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

    • 技术介绍、经验总结

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

    • 优秀文章的翻译

    • 优秀资源(书籍、开源项目)等的推荐

    • 内部分享的 PPT(推荐使用 Speaker Deck 存放)

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

    对于写作风格的约定

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

    其它问题
    • 为什么某篇文章没显示出来?

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

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

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

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

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

    • 为何不用 WordPress?

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

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

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

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

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

      • 真的?可以啊,请提 pull request



        
     
     

    您可能感兴趣的文章:

     
    本站(WWW.)旨在分享和传播互联网科技相关的资讯和技术,将尽最大努力为读者提供更好的信息聚合和浏览方式。
    本站(WWW.)站内文章除注明原创外,均为转载、整理或搜集自网络。欢迎任何形式的转载,转载请注明出处。












  • 相关文章推荐


  • 站内导航:


    特别声明:169IT网站部分信息来自互联网,如果侵犯您的权利,请及时告知,本站将立即删除!

    ©2012-2021,,E-mail:www_#163.com(请将#改为@)

    浙ICP备11055608号-3