<p align="center"><img src="https://user-gold-cdn.xitu.io/2020/4/8/171577bb979987bd?w=330&h=400&f=svg&s=3342"/></p>

<p align="center" style="font-size: 24px;">Git + Tuture = Tutorial（教程），专为实战教程创作而生</p>

> <p align="center" style="font-size: 16px;">”       教程文档界的 Github     “</p>

<br />

<br /><br />

![编组 2](https://tva1.sinaimg.cn/large/00831rSTgy1gdm6uwl8cij31qt0u0try.jpg)

<a name="9hhWt"></a>

## 介绍

<br />Tuture 是一个基于 Git 的实战技术教程写作工具，它可以让你以先做一个项目，然后对照刚刚做的项目的每次代码提交进行讲解的方式来撰写实战技术教程，这样写教程的过程中不再是先组织概念，而是变为先做一个项目，程序员擅长做项目解决问题，而 Tuture 正是顺应了程序员的这一点偏好，专注于辅助你写好项目代码的注解，解放你的技术实战教程写作过程，为实战技术教程创作 ”提效“。<br />

<a name="cBPxr"></a>

## 生态

|                     **项目**                     | **状态** |                 **描述**                  |
| :----------------------------------------------: | :------: | :---------------------------------------: |
|  [Tuture](https://github.com/tuture-dev/tuture)  |   活跃   |         基于 Git 快速撰写技术教程         |
| [Editure](https://github.com/tuture-dev/editure) |   活跃   | 基于 Slate 的 Markdown 富文本一体的编辑器 |
|  [图雀社区](https://github.com/tuture-dev/hub)   |   活跃   |    发布使用 Tuture 写作而成的技术教程     |

<a name="PUOxn"></a>

## 如何快速使用？

<br />在一个已有提交的 Git 项目根目录下运行如下命令：<br />
<br />1）安装 `npm install -g tuture`<br />2）克隆我们为你准备的代码： `git clone git@github.com:tuture-dev/our-tuture.git` <br />3) 进入项目根目录并使用 `tuture` 运行命令： `cd our-tuture && tuture up` <br />

> 注意：这里的已有提交的 Git 项目只专为创作教程而生的项目，而不是那些动辄好几十上百个 Commits 的大型开发项目。

<br />
<br />这个时候你应该可以看到如下的界面：<br />

![00831rSTgy1gdm5loil8pj31580u0tib](https://tva1.sinaimg.cn/large/00831rSTgy1gdm6wsd2hfj31580u0tc1.jpg)

<br />

<a name="DXOfd"></a>

### 免责声明（郑重提醒）

<br />Tuture 为教程内容创作而生，因此 Git 仓库通常是专门用于教学演示的示例项目。我们无法担保把 Linux 内核仓库（98 万多次提交）转换成 Tuture 教程的效果哦！<br />

<a name="vRHOy"></a>

## 快速开始

<br />如果你想自己从零开始体会如何基于一个 Git 项目撰写实战技术教程，那么我们我们为你撰写了一篇 [”场景化“ 的快速上手教程](https://www.yuque.com/tuture/product-manuals)，无论你对 Git 有没有了解，你都能很好的学会使用 Tuture 写作工具。<br />

<a name="XFpXt"></a>

## 文档

<br />如果你想更多的了解 Tuture，可以阅读我们的如下文档：<br />

- [简介和优势](https://www.yuque.com/tuture/product-manuals/overview)
- [关键概念](https://www.yuque.com/tuture/product-manuals/concepts)
- [更多文档...](https://www.yuque.com/tuture/product-manuals)

<a name="trCZb"></a>

## 作品

| 名称                                                       | 封面                                                                                        | 仓库地址                                                                                                                                                                                                   |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 从零到部署：用 Vue 和 Express 实现迷你全栈电商应用（系列） | <img width="200" src="https://tva1.sinaimg.cn/large/00831rSTgy1gdmdz6q1hjj309g048t9r.jpg"/> | - [仓库地址](https://github.com/tuture-dev/vue-online-shop-frontend)<br />- [图雀社区](https://tuture.co/2019/10/17/0b662ce/)<br />- [微信公众号](https://mp.weixin.qq.com/s/1YdC9mY3JTqxSuJ9G4l1Qw)<br /> |
| Taro 小程序开发大型实战（系列）                            | <img width="200" src="https://tva1.sinaimg.cn/large/00831rSTgy1gdme080rr4j30ao04mmyg.jpg"/> | - [仓库地址](https://github.com/tuture-dev/ultra-club)<br />- [图雀社区](https://tuture.co/2019/12/26/34a473b/)<br />- [微信公众号](https://mp.weixin.qq.com/s/KtnhfEx-cq1V-TDV67V-Qg) <br />              |
| Docker 筑梦师系列                                          | <img width="200" src="https://tva1.sinaimg.cn/large/00831rSTgy1gdme151sflj30as04uta5.jpg"/> | - [仓库地址](https://github.com/tuture-dev/docker-dream)<br />- [图雀社区](https://tuture.co/2020/01/01/442cc8d/)<br />- [微信公众号](https://mp.weixin.qq.com/s/GmkMFd0frqBNZN0u4sy8Ow)<br />             |
| 类型即定义：TypeScript 从入门到实践系列                    | <img width="200" src="https://tva1.sinaimg.cn/large/00831rSTgy1gdme83j3apj30aq04qabx.jpg"/> | - [仓库地址](https://github.com/tuture-dev/typescript-tea)<br />- [图雀社区](https://tuture.co/2020/04/06/C_ao1Yv/) <br />- [微信公众号](https://mp.weixin.qq.com/s/u230EnsNh-WMSC07FSi2wg)<br />          |

<br />

<p align="center"><a href="https://tuture.co/">查看更多 （30+篇）使用 Tuture 写作工具写作的教程 →</a></p>

<br />

<a name="HA2Gq"></a>

## 作者

<br />感谢所有图雀社区的作者名，写出了这些精彩的技术文章，让我们的技术世界更加美好！✌️<br />
<br />

|           ![4.svg](https://user-gold-cdn.xitu.io/2020/4/8/171577bbb918aa78?w=60&h=60&f=svg&s=492835)           | ![3.svg](https://user-gold-cdn.xitu.io/2020/4/8/171577bbdff59747?w=60&h=60&f=svg&s=534459) | ![2.svg](https://user-gold-cdn.xitu.io/2020/4/8/171577bbe1b9897e?w=60&h=60&f=svg&s=1104039) | ![1.svg](https://user-gold-cdn.xitu.io/2020/4/8/171577bbe7b239e0?w=60&h=60&f=svg&s=371524) | ![6.svg](https://user-gold-cdn.xitu.io/2020/4/8/171577bbfa9b7eb6?w=60&h=60&f=svg&s=365355) |
| :------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------: |
|                                      [mRcfps](https://github.com/mRcfps)                                       |                             [pftom](https://github.com/pftom)                              |                          [HolyHeart](https://github.com/HolyHeart)                          |                              [crxk](https://github.com/crxk)                               |              [晨曦时梦见兮](https://juejin.im/user/5b13f11d5188257da1245183)               |
|           ![8.svg](https://user-gold-cdn.xitu.io/2020/4/8/171577bbf9d5493a?w=60&h=60&f=svg&s=513047)           | ![7.svg](https://user-gold-cdn.xitu.io/2020/4/8/171577bc1aa37cf9?w=60&h=60&f=svg&s=453059) | ![10.svg](https://user-gold-cdn.xitu.io/2020/4/8/171577bc247bb547?w=60&h=60&f=svg&s=774349) | ![9.svg](https://user-gold-cdn.xitu.io/2020/4/8/171577bc260df131?w=60&h=60&f=svg&s=394291) | ![5.svg](https://user-gold-cdn.xitu.io/2020/4/8/171577bc27105173?w=60&h=60&f=svg&s=443283) |
| [慢一拍](https://mp.weixin.qq.com/mp/profile_ext?action=home&__biz=MzIzNjYyNjMxNg==&scene=124#wechat_redirect) |               [JowayYoung](https://juejin.im/user/584ec3a661ff4b006cd6383e)                |                        [布拉德特皮](https://github.com/SephirothKid)                        |                               [Horace\_](http://ihorace.cn/)                               |                                [婧婧](https://jinghao.xyz/)                                |

<a name="HrBeL"></a>

## 提问、联系或加入我们

<br />如果你对 Tuture 写作工具有任何疑问、改进意见，都可以关注我们的公众号进图雀社区官方反馈学习交流群：<br />
<br />![微信公众号（真）.png](https://user-gold-cdn.xitu.io/2020/4/8/171577bc36f04df9?w=900&h=500&f=png&s=138401)<br />

<a name="pWuKI"></a>

## 贡献

<br />请确保你在提交 Pull Request 之前先阅读了 [贡献指南](https://www.yuque.com/tuture/mtnpg1/xxxx) ！<br />
<br />感谢所有已经给 Tuture 提交贡献的人！<br />

| <img style="width: 200px;" src="https://tva1.sinaimg.cn/large/00831rSTgy1gdm6rv9wx5j308o08odhc.jpg" /> | <img style="width: 200px;"  src="https://tva1.sinaimg.cn/large/00831rSTgy1gdm6scg251j308o08oq58.jpg"/> | <img style="width: 200px;" src="https://tva1.sinaimg.cn/large/00831rSTgy1gdm6soy5jhj308o08omyb.jpg"/> | <img style="width: 200px" src="https://tva1.sinaimg.cn/large/00831rSTgy1gdm6tje8qtj308o08o781.jpg" /> |
| ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| [mRcfps](https://github.com/mRcfps)<br />Tuture & Editure <br />Tuture 共同创始人                      | [pftom](https://github.com/pftom)<br />Tuture & Editure<br />Tuture 共同创始人                         | [studytoohard](https://github.com/studytoohard)<br />Tuture<br />Tuture 核心贡献者                    | [HolyHeart](https://github.com/HolyHeart)<br />Tuture<br />Tuture 核心贡献者                          |

<a name="gu9wh"></a>

## 协议

<br />[MIT](https://github.com/tuture-dev/tuture/blob/master/LICENSE)<br />
<br />Copyright (c) 2018-present, Tuture Devlopers
