teedoc 1.2.1

doc site generator with multiple doc support

teedoc

Official site: teedoc.github.io

documentation generate tool from markdown and jupyter notebook to html

Features

• Easy to use, cross platform, only need Python3
• Easy to write, markdown support
• Jupyter notebook support
• Multiple docs support
• Plugin support
• Multiple theme support(support by plugin)
• 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
• Blog support

Usage

Install Python3 first, only support Python3

e.g. on Ubuntu:

sudo apt install python3 python3-pip

Windows or macOS just visit Python official site

Install

pip3 install teedoc

And upgrade with command:

pip3 install teedoc --upgrade

now you can use teedoc command

if not, ensure python3 bin path in your env PATH, e.g. ~/.local/bin

Build website

• Get template site source code

git clone https://github.com/teedoc/teedoc.github.io my_site

• Install pulgins

cd my_site
teedoc install

• Build HTML pages and start a HTTP server

teedoc build
teedoc serve

After show Starting server at 0.0.0.0:2333 ....

Open brower visit: http://127.0.0.1:2333

More see teedoc.github.io