teedoc
===========
[中文](./README_ZH.md) | English
[](./LICENSE) [](https://pypi.org/project/teedoc/#history)   [](https://github.com/teedoc/teedoc/actions/workflows/test.yml) [](https://github.com/teedoc/teedoc)
<img src="https://teedoc.github.io/static/image/logo.png" height=64/>
Official site: [teedoc.neucrack.com](https://teedoc.neucrack.com) or [teedoc.github.io](https://teedoc.github.io/)
More demo: see [here](https://teedoc.neucrack.com/get_started/zh/usage/sites.html) or [here](https://teedoc.github.io/get_started/zh/usage/sites.html)
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
* Organizations' or companies' docs spread in different domains, wish to combine them to one site(domain)
* Build a `WiKi` website
* Build personal or corporate knowledge base
* Build personal or corporate website
## Features
- [x] Easy to use, cross platform, only need `Python3`
- [x] Easy to deploy, only copy generated staitc HTML files to your server or other host
- [x] Easy to write, markdown support
- [x] Jupyter notebook support
- [x] Multiple docs support
- [x] Plugin support
- [x] Multiple theme support(support by plugin)
- [x] Control the style accurate to the page through css (implemented by customizing the id and class of each page)
- [x] Multi-level directory support
- [x] Multi-language support (manual translation) (Internationalization/i18n)
- [x] Multilingual support (translation plugin)
- [x] Multiple version support
- [x] Search support
- [x] SEO friendly
- [x] Real-time preview file changes
- [x] Parallel build, faster build speed
- [x] Blog support
- [x] Jinja2 HTML layout template support
## Get Started
Visit official site: [teedoc.github.io](https://teedoc.github.io/) or [teedoc.neucrack.com](https://teedoc.neucrack.com/)
## Create your website on github pages in minutes
See [template repo](https://github.com/teedoc/template)
## Quik start
* Install python3
On `Windows` or `macOS`, download from [python.org](https://www.python.org/downloads/)
On `Linux`, `Ubuntu` for example:
```
sudo apt install python3 python3-pip
```
* Install teedoc
This command will **install teedoc program**
```
pip3 install -U teedoc
```
* Initialize document
```
mkdir my_site
cd my_site
teedoc init
```
or
```
teedoc -d my_site init
```
> select minimal template in promot
* 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](http://127.0.0.1:2333) in browser
If you only want to generate htmls:
```
teedoc build
```
Raw data
{
"_id": null,
"home_page": "https://github.com/Neutree/teedoc",
"name": "teedoc",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "doc website markdown jupyter notbook generator teedoc",
"author": "Neucrack",
"author_email": "CZD666666@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/87/70/98ceb87cd4883081c8d2ebd4bd31f19b5cd93cf8bb54566ed9ae5c0b7024/teedoc-1.37.2.tar.gz",
"platform": null,
"description": "teedoc\n===========\n\n[\u4e2d\u6587](./README_ZH.md) | English\n\n[](./LICENSE) [](https://pypi.org/project/teedoc/#history)   [](https://github.com/teedoc/teedoc/actions/workflows/test.yml) [](https://github.com/teedoc/teedoc)\n\n<img src=\"https://teedoc.github.io/static/image/logo.png\" height=64/> \n\nOfficial site: [teedoc.neucrack.com](https://teedoc.neucrack.com) or [teedoc.github.io](https://teedoc.github.io/)\n\nMore demo: see [here](https://teedoc.neucrack.com/get_started/zh/usage/sites.html) or [here](https://teedoc.github.io/get_started/zh/usage/sites.html)\n\ndocumentation generate tool from markdown and jupyter notebook to html\n\n\n\n`teedoc` can be used in the following scenarios:\n* Build a document website, and it is best to support multiple documents and custom pages\n* Organizations' or companies' docs spread in different domains, wish to combine them to one site(domain)\n* Build a `WiKi` website\n* Build personal or corporate knowledge base\n* Build personal or corporate website\n\n\n## Features\n\n- [x] Easy to use, cross platform, only need `Python3`\n- [x] Easy to deploy, only copy generated staitc HTML files to your server or other host\n- [x] Easy to write, markdown support\n- [x] Jupyter notebook support\n- [x] Multiple docs support\n- [x] Plugin support\n- [x] Multiple theme support(support by plugin)\n- [x] Control the style accurate to the page through css (implemented by customizing the id and class of each page)\n- [x] Multi-level directory support\n- [x] Multi-language support (manual translation) (Internationalization/i18n)\n- [x] Multilingual support (translation plugin)\n- [x] Multiple version support\n- [x] Search support\n- [x] SEO friendly\n- [x] Real-time preview file changes\n- [x] Parallel build, faster build speed\n- [x] Blog support\n- [x] Jinja2 HTML layout template support\n\n\n## Get Started\n\nVisit official site: [teedoc.github.io](https://teedoc.github.io/) or [teedoc.neucrack.com](https://teedoc.neucrack.com/)\n\n## Create your website on github pages in minutes\n\nSee [template repo](https://github.com/teedoc/template)\n\n## Quik start\n\n* Install python3\n\nOn `Windows` or `macOS`, download from [python.org](https://www.python.org/downloads/)\n\nOn `Linux`, `Ubuntu` for example:\n\n```\nsudo apt install python3 python3-pip\n```\n\n* Install teedoc\n\nThis command will **install teedoc program**\n\n```\npip3 install -U teedoc\n```\n\n* Initialize document\n\n```\nmkdir my_site\ncd my_site\nteedoc init\n```\n\nor\n\n```\nteedoc -d my_site init\n```\n\n> select minimal template in promot\n\n* Install plugins\n\nThis command will **install plugins** used by doc(set in `site_config.json`)\n\n```\ncd my_site\nteedoc install\n```\n\n* build or serve\n\n```\nteedoc serve\n```\n\nthen visit [http://127.0.0.1:2333](http://127.0.0.1:2333) in browser\n\nIf you only want to generate htmls:\n\n```\nteedoc build\n```\n\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "doc site generator with multiple doc support",
"version": "1.37.2",
"project_urls": {
"Homepage": "https://github.com/Neutree/teedoc"
},
"split_keywords": [
"doc",
"website",
"markdown",
"jupyter",
"notbook",
"generator",
"teedoc"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "59e228b21b1fcccf337a4f05f0eba98237554be3e655d2515301e9450a8f0a36",
"md5": "cccd54163c33615f52e58d366130027c",
"sha256": "69c432155f785d4b2377ea780ef74d89a655539af08e00c38dc18a7ce0e98b7e"
},
"downloads": -1,
"filename": "teedoc-1.37.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cccd54163c33615f52e58d366130027c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 855915,
"upload_time": "2024-04-19T12:51:47",
"upload_time_iso_8601": "2024-04-19T12:51:47.125832Z",
"url": "https://files.pythonhosted.org/packages/59/e2/28b21b1fcccf337a4f05f0eba98237554be3e655d2515301e9450a8f0a36/teedoc-1.37.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "877098ceb87cd4883081c8d2ebd4bd31f19b5cd93cf8bb54566ed9ae5c0b7024",
"md5": "479f13b0d4240be012230fc8ad121de4",
"sha256": "dd96c037c55202c035bf7b8f3f042706b580fdc41561c569622ea4b1a5a4cbb8"
},
"downloads": -1,
"filename": "teedoc-1.37.2.tar.gz",
"has_sig": false,
"md5_digest": "479f13b0d4240be012230fc8ad121de4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 845758,
"upload_time": "2024-04-19T12:51:52",
"upload_time_iso_8601": "2024-04-19T12:51:52.159332Z",
"url": "https://files.pythonhosted.org/packages/87/70/98ceb87cd4883081c8d2ebd4bd31f19b5cd93cf8bb54566ed9ae5c0b7024/teedoc-1.37.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-19 12:51:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Neutree",
"github_project": "teedoc",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "teedoc"
}
JSON
