open source static doc site generator teedoc

Official website: teedoc.neucrack.com or teedoc.github.io
Source file of this document: github.com/teedoc/teedoc.github.io
Source code: https://github.com/teedoc/teedoc Welcome star

Convert documents in Markdown or Jupyter Notebook format into HTML static web pages

teedoc can be used in the following scenarios:

  • Build a document website, and it is best to support multiple documents (for example, you have two books called Python Learning and C++ Learning, they have separate directories, and teedoc is the library)
  • Documents and web pages coexist, support custom HTML pages
  • Build a WiKi website
  • Build a personal or corporate knowledge base
  • Build a personal or corporate website
  • Blog

If you encounter problems during use, you can find similar problems in here (you need to register and log in to github) to find similar issues, or create an issue

Features

  • Multi-document support
  • Simple to use, cross-platform, only dependent on Python3
  • No database required, all static pages of the website
  • The deployment is simple, the generated website is a fully static page, which can be directly copied to the server or uploaded to a third party organization for deployment
  • Easy to write, using Markdown syntax编写
  • Jupyter notebook support
  • HTML support, you can directly use HTML to write pages, with great freedom
  • Plug-in support
  • Multi-theme support (implemented by plug-in)
  • Control the style accurate to the page through css (implemented by customizing the id and class of each page)
  • Multi-level directory support(infinite levels)
  • Multi-language support (manual translation) (Internationalization/i18n)
  • Multilingual support (translation plugin)
  • Multi-version support (implementation method is the same as multi-language)
  • Search support
  • SEO friendly
  • Real-time preview of changes
  • Parallel build, faster build speed
  • Blog support
  • Switch from gitbook is easy, just config route and convert SUMMARY.md by summary2yaml command
  • Comments(Plugins), e.g. gitalk

Demo

This website is generated using teedoc, what you see now is what the generated website looks like.

In addition, there are other websites that use teedoc, please see here for details

Similar tools

In fact, there are many tools of this type, but each one is slightly different. Just choose one according to your needs.

If you have choice difficulties, you are recommended to use teedoc if you meet some of the following conditions:

  • Used as a document website? You have a lot of document sites in your hand, want to unify them into one site? Also websites in various languages? Use teedoc
  • Use Jupyter notebook to write documents or code? Decisively choose teedoc
  • Does the function meet your needs?
  • Does the interface meet your aesthetics (you can customize css, or change the theme plug-in)
  • Familiar with Python? Plug-ins and functions can be customized at any time

Other similar tools:

  • docusaurus: teedoc's UI layout is almost similar to it, but it is written by ract, teedoc is native js, if you are using ract, you can consider this
  • gitbook: a tool that used to be very useful, but it is no longer maintained by the government, and it is switched to commercial use. It is not recommended to use it
  • docsify: only one page is needed, markdown is rendered in the browser, instead of pre-rendered as HTML, the advantage is that it is lightweight, but SEO is not very friendly, you can use its SSR function, nodejs written
  • readthedocs(Sphinx): In fact, it uses Sphinx as a generation tool. The official website documentation of Python is generated by this tool. Many open source projects use tools. readthedocs is just a public document website. You don’t need to build your own website, you can start writing documents after registering and logging in, and it is friendly to RST format support
  • mkdoc: It is also a tool written by python. It is easy to use and has many plugins. If your document is a single language document, you can use this tool

Some usage suggestions

  • Add Generate with teedoc in footer to help more people discover teedoc and promote the growth of the project
  • Use the template project to start a new document project, you can run it first, and then modify it according to your own needs, so that you can get started faster

Quick start

Visitquick start to install and quick start