teedoc 1.18.0

doc site generator with multiple doc support

teedoc

中文 | English

Official site: teedoc.neucrack.com or teedoc.github.io

documentation generate tool from markdown and jupyter notebook to html

teedoc can be used in the following scenarios:

• Build a document website, and it is best to support multiple documents and custom pages
• Build a WiKi website
• Build personal or corporate knowledge base
• Build personal or corporate website

Features

• Easy to use, cross platform, only need Python3
• Easy to deploy, only copy generated staitc HTML files to your server or other host
• Easy to write, markdown support
• Jupyter notebook support
• Multiple docs support
• Plugin support
• Multiple theme support(support by plugin)
• Control the style accurate to the page through css (implemented by customizing the id and class of each page)
• Multi-level directory support
• Multiple language support(manually translate)
• Multiple language support(auto translate)
• Multiple version support
• Search support
• SEO friendly
• Real-time preview file changes
• Multiple thread support, faster build speed
• Blog support
• Jinja2 HTML layout template support

Get Started

Visit official site: teedoc.github.io or teedoc.gitee.io

Create your website on github pages in minutes

See template repo

Quik start

• Install python3

On Windows or macOS, download from python.org

On Linux, Ubuntu for example:

sudo apt install python3 python3-pip

• Install teedoc

This command will install teedoc program

pip3 install teedoc

• Initialize document

mkdir my_site
cd my_site
teeedoc init

or

teeedoc -d my_site init

• Install plugins

This command will install plugins used by doc(set in site_config.json)

cd my_site
teedoc install

• build or serve

teedoc serve

then visit http://127.0.0.1:2333 in browser

If you only want to generate htmls:

teedoc build