泰晓科技 -- 聚焦嵌入式 Linux - 追本溯源,见微知著!
网站地址:http://tinylab.org
微信公众号关注我们新浪微博


扫一扫

关注 @泰晓科技
『光顾开源小店,支持泰晓原创!』
请稍侯

投稿

欢迎投递原创稿件、工作机会、求职简历等

泰晓科技 作为一个 Android / Linux 原创交流平台,热烈欢迎大家参与。

而参与的最好方式莫过于创作并分享。我们欢迎各类 Android / Linux 原创、翻译文章,也欢迎发布工作机会,递送求职简历。

为了提高稿件、工作机会和简历的质量,我们也会安排严格的评审。

下面是一般的稿件投递过程。

快速上手

  • 下载博客仓库

    $ git clone https://github.com/tinyclub/cloud-lab.git
    $ cd cloud-lab/ && tools/docker/choose tinylab.org
    
  • 安装 Jekyll 编译环境

    Ubuntu 14.04 以上用户可直接执行:

    $ tools/docker/pull        # Pull from docker hub
    or
    $ tools/docker/build       # Build ourselves
    

    其他用户请先参照 官方文档安装好 docker,之后通过如下命令搭建环境:

  • 启动 Jekyll 环境

    $ tools/docker/identify    # Disable password
    $ tools/docker/run
    

    之后可通过浏览器登陆并通过桌面快捷方式进入 tinylab.org 工作目录。

    Jekyll 环境默认已经支持中文,但是输入法要通过设置手动添加一下 ibus-sunpinyin,并配置下中英文的快捷切换方式为 ALT+s,以避免跟本地的中英文切换快捷方式冲突。

  • 撰写稿件

    首先生成文章模板, slug 为链接,title 为标题。

    $ tools/post slug=the-first-post-slug title="第一篇原创文章。。。"
    

    接着,参照模板编辑文章。

    $ vim _posts/*the-first-post-slug*
    

    Markdown 基本用法请参考 Markdown 语法说明 以及上面创建的文章模板中的说明。

    如果希望使用更多样式,可参照 _posts/ 目录下的其他文章。

    如果有附件或者图片资料,请创建目录 wp-content/uploads/年/月/,并添加资料进去,然后在文章中通过 Markdown 语法引用。

    :也可以在 _data/people.yml 中添加上作者信息后直接通过如下方式创建一个快捷命令以便自动填充作者信息,例如:

    $ cd tools
    $ ln -s post falcon.post
    

    falcon 替换为你自己的昵称即可。

  • 编译和浏览文稿

    Jekyll 环境由 docker 搭建,文章会被自动编译,可实时通过桌面快捷方式 Local Page 查看编译效果。

  • 递送稿件

    测试完无误后即可通过 Github 发送 Pull Request 进行投稿。也可直接把稿件发送到 wuzhangjin [AT] gmail [DOT] com。

    这一步要求事先做如下准备:

    • 在 Github Fork 上述 文章仓库
    • 您在本地修改后先提交到刚 Fork 的仓库
    • 然后再进入自己仓库,选择合并到我们的 master 分支

    提交 Pull Request 后,我们会尽快安排人员评审,评审通过后即可发布到网站。

文章模板说明

通过 rake post 或者 tools/post 可以创建一份文章模板,这里对该模板做稍许说明,更多内容请阅读模板本身。

该模板包括两大部分,第一部分是用两个 --- 括起来的文件头,剩下的部分为文章正文。

  • 文件头包含文章的基本信息,jekyll 模板系统用它来构建文章页面
  • 文件正文即普通的 Markdown 文件主体,基本遵循 Markdown 规范

模板基本样式如下:

---
layout: post
author: "Your Name"
title: "new post"
permalink: /new-post-slug/
description: "summary"
category:
  - category1
  - category2
tags:
  - tag1
  - tag2
---


> By YOUR NICK NAME of TinyLab.org
> 2015-09-21



文章正文

模板文件头中的关键字大部分为 jekyll 默认支持,我们加入了少许关键字,这里一并说明:

关键字说明备注
layout文章均为 post必须
author作者名,同 _data/people.yml必须
title标题名,支持中、英文必须
permalink英文短链接,不能包含中文必须
tagline子标题/副标题可选
description文章摘要可选
album所属文章系列/专题可选
group默认 original,可选 translation, news, resume or jobs, 详见 _data/groups.yml可默认
category分类,每行1个,至少1个,必须在_data/categories.yml必须
tags标签,每行1个,至少1个,至多5个必须

完善作者信息

为了方便读者和潜在合作伙伴联系到您,请参考如下表格在 _data/people.yml 中编辑作者信息并发送 Pull Request 入库。

更多信息说明如下,以网站帐号 admin 为例,即 _data/people.yml 中左侧的 admin:

属性属性值说明
name泰晓科技对应中文名或者全名
nicknametinylab网络昵称或者英文名
archivetrue展示作者所有文章
articletrue生成当前文章二维码,手机可扫码阅读
sitetinylab.org作者个人站点地址,请不要写 http://
emailxxx@gmail.com作者邮箱
githubtinyclub作者 github 帐号
weibotinylaborg新浪微博帐号,务必事先配好短域名,否则须用 u/xxx
weibo-qrcodefalse新浪微博二维码,本站可自动生成,请保留为false
wechattinylab-org微信或者公众号
wechat-qrcodetrue暂时无法自动生成,需要显示二维码必须先生成一份传到 images/wechat,并以 wechat 帐号命名,该项为 true
sponsorweixin-pay-admin-9.68如希望获得打赏,请命名二维码图片为:weixin-pay-author-money
sponsor-qrcodetrue图片请存到 images/sponsor 并设该项为 true
info建议介绍专业、兴趣、特长等,如较多,请用 ; 分割,以便自动分段展示