Skip to content

Latest commit

 

History

History

guide

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 

介绍

图雀(Tuture)是一个尝试为 IT 知识和技能的传播加速的解决方案,它由两大部分组成:

  • 书写教程的工具,即图雀写作工具 Tuture ,它能够帮助你在本地轻松地书写高质量的技术教程
  • 分享教程的平台,即图雀社区,它们能够让你分享自己的教程,或是阅读他人的教程

如果你已经迫不及待想要开始使用我们的写作工具,请直接从安装开始阅读。

挑战传统的学习方式

图雀的核心是基于真实项目和应用场景的文字教程。

为什么我们会选择这种方式作为学习和传播技术的首要途径?首先让我们来对比一下其他的学习途径。

视频

视频作为课堂的延续,是很多人所习惯的接受知识的方式,因为它相对而言比较符合认知规律。但是视频作为学习媒介本身就存在以下缺陷:

  • 很难系统地展现知识体系
  • 不便于检索,很难有针对性地获取知识
  • 不能完全适应所有人的学习节奏

并且由于制作视频教程非常耗时耗力,对作者的要求非常苛刻,产生了更多局限性:

  • 普遍需要收取高额的费用才能观看,不能惠及大众
  • 更新换代不够及时,很难应对技术浪潮的快速变化
  • 视频教程的总量不够大,因此无法涉及到各个技术的方方面面

图雀社区上的教程都是完全免费的,并且由于书写方便、制作周期短,产出教程的数量和速度远胜于视频。

书籍

书籍是人类文明最悠久、最重要的传播途径之一,当然也适用于 IT 技术的传播,但由于以下缺陷(很多都和视频类似),它并不是最合适的选择:

  • 学习周期一般都很长,并不适合快速学习和运用
  • 无法跟上 IT 界日新月异的变化,内容很难保持最新
  • 书籍质量参差不齐,错误连篇的糟糕作品不在少数
  • 作者与读者的互动和交流非常有限

图雀社区上大多数教程只需要十几分钟的时间即可完成学习,我们会为你精心挑选高质量的教程,你也可以根据教程的收藏次数、浏览量或是自身的兴趣来自由选择。更有趣的是,你可以很方便地与教程的作者或是其他学习者沟通交流。

官方文档

官方文档凭借其权威性和及时性,公认为最重要的资源之一,部分优秀项目的文档更是极佳的学习资源。然而大部分文档都是用英语写的,对于国内不少学习者来说存在语言上的障碍。

而且大部分项目的官方文档都把重心放在概念的讲解和 API 的列举。如果类比语言的学习,那么官方文档便相当于权威词典。很显然,“啃词典”并不是一种理想的学习方式。而所有图雀教程都会手把手带你搭建一个真实的项目,在实际运用中快速掌握技术的精髓。

技术博客

技术博客的兴起已有很多年,国内外很多乐于分享的极客已经为我们带来了海量的技术博文。我们只需在搜索引擎输入想要学习的内容,就能看到长长的教程清单。

图雀起源于传统的技术博客,但是却致力于解决一些根本性的问题:

  • 传统博文的书写具有很大的随意性,导致文章质量差异很大,而图雀试图用一种统一的模式去书写教程(查看开始书写教程)——即基于一个真实的 Git 仓库的提交记录构成教程,确保每一篇教程的可实践性
  • 优质的技术博客散落在互联网的各个角落,很难“一网打尽”,而图雀试图提供一个汇聚优质博文和作者的平台,让学习者不必再苦苦寻找
  • 传统博客的互动非常有限(一般都只有文后评论),而图雀试图提供一个方便且强大的社区功能:1)每篇教程都会标明作者和其撰写教程的 Github 仓管,使得读者可以以 Github Issue 的方式和作者直接交流改进教程内容;2)我们同时开通了 Gitter 交流频道,使得作者和读者可以更加实时的交流想法,沉淀知识

写作体验的革命

图雀革新了技术教程写作的方式。

  • 直接从真实的代码库中生成:你的教程会真实地反映代码库。只需从一个 Git 仓库开始,搭建一个有趣的东西,并且写好提交信息,Tuture 就会把所有的精彩带到你的教程中。随着灵感的累积,你的代码库会成长,你的教程也会
  • 自动提取代码变化:写教程最大的痛点之一便是要手动提取每一步骤中每个文件的代码变化。幸运的是,Tuture 会为你处理这个艰巨且容易出错的任务,因此你只需专注于书写优秀的教程
  • 对着代码写教程:对着你的代码去写一些东西显然更简单,思路更清晰。搭配完整的 Markdown 编辑功能和一系列方便的工具,书写优质技术文章从未如此有趣
  • 轻松分享你的作品:只需一条命令,你的教程便可以构建成即可发表的 Markdown 文件。除此之外,我们还提供了专门的平台(图雀社区)来分享你的教程。

关于“实战”

基于实战的学习(Learn by doing)是一种颇受欢迎的学习模式,Manning 出版社也出版了一系列《XXX in Action》书籍(例如国内广为流传的《机器学习实战》等等),而这也是图雀所一直奉行的理念。

计算机科学本身就是一门实践性极强的学科,死记硬背的学习方式不仅低效,而且会让你逐渐失去兴趣,失去前进的动力。遗憾的是,如今学习资源普遍提供不了理想的实践途径,大多都专注于概念的罗列阐释,使得众多入门者望而生畏。

而图雀鼓励通过实践学习,亲身参与到项目中,让你不仅能快速得到最正确的知识和经验,更能充分感受这个行业的魅力,而且所获得的成就感也是无法衡量的。

运行机制

创作者通过在本地安装图雀 (Tuture) 工具以两种不同的方式进行教程的编写:

  1. 一开始没有明确目的写教程,拥有已经完成的 Git 项目,通过图雀将此项目初始化成一个教程,然后在通过图雀提供的编辑器为对应的每一步提交的代码提供文字讲解,最终写成一篇教程;
  2. 一开始有明确的目的写教程,可以在项目的创建时就开始通过图雀初始化成教程,随着项目代码的提交,图雀会自动读取 Git 提交变化并展示在编辑器中,然后针对刚刚的提交的代码进行文字解说,如此往复,当你的项目做完,你的教程也随之写完。

::: tip 提示 关于教程的创作,请查看开始写作。 :::

当创作者写完一篇教程之后,可以把本地的代码仓库上传到 GitHub,然后通过 Pull Request 的方式向图雀社区的 GitHub 仓库贡献自己的教程。经过社区仓库维护者的质量评估之后,教程会最终部署到图雀社区的网站,提供给其他学习者查看和学习。

因为每篇教程都是基于一个可运行的实战项目进行创作,所以读者在学习教程的同时,能一步一步地跟着教程的讲解敲代码,当教程看完,最终能完成一个可运行的实际项目,加深学习体验,提高乐趣和信息。同时,因为代码是可运行的,所以可以保证教程每步讲解代码的正确性,这样就很好地解决了传统文字技术教程中繁杂且容易出错的代码展示问题。且每篇教程的代码都是托管在 Github 上,所以如果遇到讲解不清楚的内容可以直接在我们 图雀社区(Tuture Hub) 的 Github Issue 中提问题,并且每篇展示在图雀社区网站的教程都会有对应作者的教程 Github 仓库链接,学习教程的用户也可以直接给对应的教程仓库的 Github Issue 提问题,所以在社区成员的学习和监督下,每篇教程都会保证快速更新、快速纠错,并且质量上乘。

图雀社区中的每篇教程都是基于社区成员开源创作,所以查看和学习每篇教程也是免费的。同时因为汇聚社区的想法和意见,积聚社区的力量共同去创作教程,我们可以期待,随着图雀社区的不断发展,我们的教程所涵盖的技术领域会逐渐扩张到计算机世界的每个角落,同时以一种便于阅读和学习、成体系的方式展示出来,为现在快速发展的计算机世界注入一股强劲的驱动能量。

为什么叫图雀(Tuture)?

Tuture 意为 Tutorials from the future(来自未来的教程),我们致力于让教程变得足够“现代化”,足够适应未来,让它们发挥出最大效能。

小若燕“雀”,亦可一展宏“图”。在互联网的世界,只要你有闯荡的激情和热血,无论出身,无论背景,终能一飞冲天,实现自身的理想和价值。