Skip to content
🎩 Magically turn your repositories into juicy tutorials. 『图雀写作工具』
TypeScript JavaScript Other
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
bin
commands
editor Add auto-saving feature (#185) Dec 7, 2019
scripts Update release script and add workflow Nov 8, 2019
test Improve codeblock compatibility for building plain markdown Dec 13, 2019
utils
.editorconfig
.gitignore Ignore tuture-error.log Oct 12, 2019
.prettierrc.js Add tslint support (#41) Jul 1, 2018
CHANGELOG.md 2.1.0 Dec 14, 2019
LICENSE Add MIT License Jul 30, 2018
README.md
README.zh-CN.md
base.ts Remove error logging Oct 27, 2019
config.ts
constants.ts
index.ts Integrate CLI into tuture Sep 26, 2018
package.json
server.ts
tsconfig.json
tslint.json
types.ts
yarn.lock

README.md

Tuture logo

Build Status Version License Node Version Chat

Tuture

Tuture is a tool for writing high-quality tutorials with both ease and speed based on Git repositories.

Read this in other languages: 简体中文.

Features

Tuture revolutionizes the way of writing tech tutorials.

  • Generated directly from a live codebase: Your tutorial will be a faithful mirror of your code. Just start from a Git repo, build something interesting with nicely-written commit messages, and Tuture will bring all the good things to your tutorial. Your codebase will grow as more inspiration come in, so will your tutorial.

  • Automatic extraction of code diff: One of the greatest pain point of writing tutorials is the daunting manual work of collecting code snippets of each changed file for each step. Fortunately, Tuture will handle this boring and error-prone work for you, so you can just focus on writing amazing tuturials.

  • Edit tutorials alongside your code: It can be much clearer and easier to write something just next to your code. With full-fleged markdown support and a series of handy tools, writing high-quality tech posts has never been this fun.

  • Share your tutorial with ease: Your tutorial can be built into a publish-ready markdown file with a single command. Apart from this, we also provide a platform for sharing your tutorials (currently only those in Chinese).

Installation

Make sure you have Git installed on your machine. You can check by running git version. If not, head to Git downloads page.

Install with package managers

We assume that Node.js (>= 8.0.0) and npm (>= 5.0.0) are already avaiable.

You may need sudo to install npm packages globally.

  • install with npm
npm i -g tuture
  • install with yarn
yarn global add tuture

Installing global binaries via yarn can fail sometimes (check out this issue), so it's not recommended. But you can export PATH="$PATH:$(yarn global bin)" if you insist.

Download ready-to-use binaries

  1. Visit our Github release page to download binary distribution suited to your machine.

  2. Extract the binary file tuture (or tuture.exe on Windows).

  3. Move the binary to your system path:

  • For Linux/macOS users, open your terminal and navigate to where the tuture binary resides:
cd /path/to/tuture
sudo mv tuture /usr/local/bin
  • For Windows users, simply move the binary to C:\Windows folder as Administrator.
  1. Checkout whether tuture binary works by running tuture --version.

Install from source

Clone this repo to your machine, cd into the project root and run following command:

# install all dependencies
npm i
# build editor and CLI
npm run build
# install tuture globally
npm i -g

Documentation

Ready to learn more? Visit our homepage.

Why this name, Tuture?

Tutorials from the future.

License

Definitely MIT.

You can’t perform that action at this time.