Skip to content

TsinghuaHigh/become-a-maker

Repository files navigation

《成为创客》

https://tsinghuahigh.github.io/ Build Status

这是一本正在合作撰写中的电子书(divide-and-conquer法),面向大学/中学生还有对于创客感兴趣的成人。其中创客课和学校社团这一章还会可以给对创客感兴趣的学校/老师/学生社团看。
为什么要写这本书?因为其中的作者在开创客课开了四年了,感觉需要把经验知识传播出去啊,否则影响的人太少。另外要是多一些被动收入也不错。

如果要将此书用于商业用途,请联系作者。

TODO:

  • 建立gitbook,上传到github上
  • 书籍目录结构
  • 定出整体书籍的思路(把成为创客进阶和网游升级进行类比,做导读,而不是大而全)
  • 用travis自动编译到gh_pages(大概需要花三四个小时吧) https://gist.github.com/domenic/ec8b0fc8ab45f39403dd
  • 列出各个章节的提纲,技能和副本(截止日期7月15日)
  • 采访各个职业的顶级人才,最好能够招募进来一起做这件事情
  • 列出作者感觉吃力的章节(很明显除了产品经理以外的所有好不好),找到解决方案
  • 思考商业模式(最简单就是加上捐款链接,或者未来出纸板书,不会有太多钱。显然电子书收费在国内不现实,但是或许可以跟在行、知乎、网易公开课、mooc,众筹网站有什么增值服务/引流合作?或者是部分内容隐藏进行增值服务的收费?)
  • 找一个好的插画师帮忙加插画
  • 找各个可以在线学习的网站和资源,引导学生去那里学习
  • 开始正式撰写每一章,最好有一个编辑天天来催稿!外加审阅和校对。
  • 未来,运营微信公众号?(我觉得最可行的就是经常加新的挑战)
  • 脑洞,如果每一个章节都有一个人物,加上背景故事,会不会更有意思呢?
  • 脑洞,在线做题

本书用gitbook构建,gitbook版本:{{ gitbook.version }}

下载安装到本机

Mac安装+预览方法:

  1. 下载以下软件

    • Homebrew 在命令行里运行:/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    • 使用清华大学提供的Homebrew镜像:
    cd /usr/local
    git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/brew.git
    
    cd /usr/local/Library/Taps/homebrew/homebrew-core
    git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew-core.git
    
    brew update
    • node 在命令行里运行:brew install node
    • gitbook 在命令行里运行:sudo npm install gitbook-cli -g 管理员权限要的是当前mac用户的密码
    • 推荐下载git可视化sourcetree
    • 推荐下载编辑器atom
  2. 下载书籍 $ git clone https://github.com/TsinghuaHigh/become-a-maker.git (前提是已经加入到这个项目里了,这里输入的是github的用户名密码)

  3. 在书的目录下(有book.json的那个目录)安装插件 $ gitbook install

  4. 本地预览 $ gitbook serve

  5. 打开浏览器 http://localhost:4000

Windows安装+预览方法:

  1. 下载以下软件
  1. 通过tortoisegit拉取代码(在目录里右键git clone)地址为:https://github.com/TsinghuaHigh/become-a-maker.git 注意要先让项目负责人开通自己的github账号的查看/修改权限。
  2. 安装gitbook,命令行里运行npm install gitbook-cli -g
  3. 切换到项目的目录里(用cd)然后安装插件gitbook install
  4. 本地预览 $ gitbook serve
  5. 打开浏览器 http://localhost:4000

安装后预览方法:

  1. 本地预览 $ gitbook serve
  2. 打开浏览器 http://localhost:4000

自定义端口号: $ gitbook serve -p 8080 默认是4000

导出为文件方法

保存为静态网站: $ gitbook build . (一定要注意里面的.,会发布到_build目录底下)

保存为pdf:使用gitbook-pdf 可能会有bug,请参考这个网站 http://blog.csdn.net/xiaocainiaoshangxiao/article/details/46882921

项目的目录结构

  • book.json 文档配置文件
  • summary.md 目录树
  • intro.md 序言
  • license.md 版权声明
  • readme.md 有关书的什么

Markdown的规范

Markdown语法

另外可以看这个说明:http://www.jianshu.com/p/1e402922ee32/

社区公认的Markdown语法标准是CommonMark,官网为http://commonmark.org/。CommonMark官网提供了Markdown的参考细节标准教程和一个用于尝试Markdown的Playground

Gitbook特有的语法

  • 页面中插入一个目录导览:<!- - toc --> (注意:去掉横线之间的空格)
  • 页面中插入其他页面:{% include "SUMMARY.md" %}

如何用git进行协作

贡献者

  • @tianshuo (脑洞大,笑点低,拖延症)

Releases

No releases published

Packages

No packages published

Languages