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

一、开源项目简介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

这条命令会 安装 teedoc 主程序

pip3 install -U teedoc

• 初始化文档

mkdir my_site
cd my_site
teedoc init

或者

teedoc -d my_site init

根据提示选择 minimal 模板

• 安装插件

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

cd my_site
teedoc install

• 构建（build） 或者 预览（serve）

teedoc serve

然后浏览器访问 http://127.0.0.1:2333

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

teedoc build

六、源码地址

访问一飞开源：https://code.exmay.com/