tuture
Tuture magically turns your repositories into juicy tutorials.
Last updated a year ago by powerformarc .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install tuture -g
SYNC missed versions from official npm registry.

Tuture

Build Status

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 work in a breeze: Sharing is one of the time-honored conventions within the geek community, which is fully valued and appreciated by Tuture. Fortunately, publishing your tutorials is just one command away (tuture publish and you are done). Come and visit tuture.co for tutorials written by you and others!

Installation

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

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 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.

  • install from source

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

$ npm i -g

Documentation

Learn more about Tuture here.

Why this name, Tuture?

Tutorials from the future.

License

Definitely MIT.

Current Tags

  • 1.5.0                                ...           latest (a year ago)

18 Versions

  • 1.5.0                                ...           a year ago
  • 1.4.0                                ...           a year ago
  • 1.3.2                                ...           a year ago
  • 1.3.1                                ...           a year ago
  • 1.3.0                                ...           a year ago
  • 1.2.1                                ...           a year ago
  • 1.2.0                                ...           a year ago
  • 1.1.0                                ...           a year ago
  • 1.0.1                                ...           a year ago
  • 0.3.1                                ...           a year ago
  • 0.3.0                                ...           a year ago
  • 0.2.4                                ...           a year ago
  • 0.2.3                                ...           a year ago
  • 0.2.2                                ...           a year ago
  • 0.2.1                                ...           a year ago
  • 0.2.0                                ...           a year ago
  • 0.1.0                                ...           a year ago
  • 1.0.0                                ...           a year ago
Downloads
Today 0
This Week 0
This Month 1
Last Day 0
Last Week 0
Last Month 4
Dependencies (19)
Dev Dependencies (21)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |