Tuture is a tool for writing high-quality tutorials with both ease and speed based on Git repositories.
Read this in other languages: 简体中文.
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).
Install with package managers
You may need
sudoto 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
Visit our Github release page to download binary distribution suited to your machine.
Extract the binary file
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/tuturesudo mv tuture /usr/local/bin
- For Windows users, simply move the binary to
C:\Windowsfolder as Administrator.
- Checkout whether
tuturebinary works by running
Install from source
Clone this repo to your machine,
cd into the project root and run following command:
# install all dependenciesnpm i# build editor and CLInpm run build# install tuture globallynpm i -g
Ready to learn more? Visit our homepage.
Why this name, Tuture?
Tutorials from the future.