Pre-release
This release is a pre-release and may not be stable for production use.
liteyuki-autodoc
为你的Python库模块生成清晰的markdown文档
功能：i18n支持，多风格注释支持，多主题支持
安装
pip install litedoc
使用方法
python -m litedoc <your_module_path> -o|--output <output_path>
详细命令参数
-o|--output: "doc-output" 输出路径，默认为doc-output
-l|--lang: "zh-Hans" 语言，支持en, zh-Hans，zh-Hant，ja，默认zh-Hans
-t|--theme: "vitepress" 主题，支持vitepress, vuepress, 默认vitepress
-s|--style: "google" 风格，支持google, numpy, reStructuredText, 默认google，但目前只实现了google，欢迎PR
-c|--contain-top #是否包含顶部文件夹信息，即在输出目录再套一层module_path的basedir
在输出的目录下markdown文档是以模块原有的目录结构生成的，可以直接把输出内容移到目前主流的文档框架中，如VuePress，VitePress等，如果想优化用户体验，还可启用动态侧边栏
代码编写建议
- 在编写库的时候，尽量写上标准的注释，这样对用户和自己都有好处
- 生成器默认不处理"私有"变量和函数，即以
_开头的变量和函数（尽管Python没有真正的私有变量），也默认不处理没有注释的变量 - 如果你不想展示某个函数和变量，可以在函数文档字串任意处加上
@litedoc-hide - 变量注释支持在同一行内使用
#添加的注释，也支持在下一行使用"""注释内容"""添加的注释
示例项目
1 maintainer
Metadata
1 maintainer
Release files for litedoc 0.1.0.dev20240829074319
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| litedoc-0.1.0.dev20240829074319.tar.gz | 21.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| litedoc-0.1.0.dev20240829074319-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 38.1 kB
Release files / litedoc-0.1.0.dev20240829074319.tar.gz
| Download URL | litedoc-0.1.0.dev20240829074319.tar.gz |
|---|---|
| Size | 21.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
25a297183f9e19b3d98a0316b502da2771c0d68755c906a6f2f4d4e4e85344d5
|
|
BLAKE2b-256 checksum How to use checksums |
d1f4092518c5eaa48bd34141fc839e9694b551c2ce1da8b029ceb015a731d841
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
pdm/2.18.1 CPython/3.10.12 Linux/6.5.0-1025-azure
|
Release files / litedoc-0.1.0.dev20240829074319-py3-none-any.whl
| Download URL | litedoc-0.1.0.dev20240829074319-py3-none-any.whl |
|---|---|
| Size | 16.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
609991c2fd6ae6a264c6a962f6283fe2ea721ea5f11e6b603d2789da2d36fd3a
|
|
BLAKE2b-256 checksum How to use checksums |
40d44f73d0ce2065b292af3201d3f3f2eeebe3d9ce5da77b96c962f574420464
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
pdm/2.18.1 CPython/3.10.12 Linux/6.5.0-1025-azure
|
