一飞开源，介绍创意、新奇、有趣、实用的开源应用、系统、软件、硬件及技术，一个探索、发现、分享、使用与互动交流的开源技术社区平台。致力于打造活力开源社区，共建开源新生态！

一、开源项目简介teedoc

静态网站/文档网站生成工具，快速使用 markdown 或者 jupyter notebook 编写并生成 html 文档网站，建官网和文档以及知识库均适用，使用 python 编写，无需数据库，轻量稳定实用。可替代gitbook。

二、开源协议

使用MIT开源协议

三、界面展示四、功能概述

将 Markdown 或者 Jupyter Notebook 格式的文档转换为 HTML 网页

以下场景可使用teedoc：

建文档网站，并且最好支持放多份文档，和自定义页面组织或者企业有很多份文档分散在各个域名，希望统一到一个域名下建WiKi网站建个人或者企业知识库建个人或者企业网站特性使用简单， 跨平台，只依赖 Python3部署简单， 生成的网站是全静态页面，直接拷贝到服务器或者上传到三方机构即可部署书写简单，使用 Markdown 语法编写Jupyter notebook 支持多文档支持插件支持多主题支持（由插件实现）通过 css 控制精确到页的样式（通过自定义每页的 id 和 class 实现）多级目录支持多语言支持（手动翻译）(国际化/i18n)多语言支持（翻译插件）搜索支持SEO 友好实时预览更改并行构建，更快的构建速度博客支持Jinja2 HTML 布局模板支持五、技术选型快速开始安装 python3

Windows 或 macOS, 从 python.org 下载安装包安装

Linux, 如 Ubuntu:

sudo apt install python3 python3-pip

这条命令会 安装 teedoc 主程序

pip3 install -U teedoc

mkdir my_sitecd my_siteteedoc init

或者

teedoc -d my_site init

根据提示选择 minimal 模板

安装插件

这条命令会 安装文档需要的插件(在site_config.json里设置)

cd my_siteteedoc install

teedoc serve

然后浏览器访问

如果只需要构建生成网页:

teedoc build

访问一飞开源：