Documentation toolchain for SecretFlow
Project description
@secretflow/doctools
Documentation toolchain for SecretFlow | SecretFlow 文档构建工具
English | 简体中文
What is this?
This repository contains packages for building documentation for SecretFlow projects. It provides a Sphinx extension to build MDX (Markdown + JSX) documents from a Sphinx project. It also has several Node packages for integrating MDX into Dumi.
Install
Install doctools with pip
:
pip install secretflow-doctools
Use
Add doctools as a Sphinx extension to your Sphinx project's conf.py
:
extensions = [
# ...
"secretflow_doctools",
]
Then specify mdx
as the builder:
python3 -m sphinx -b mdx [...] [sourcedir] [outputdir]
Or use make
:
make mdx
License
English | 简体中文
这是什么?
这个仓库包含了用于构建 SecretFlow 项目文档的工具。它提供了一个 Sphinx 扩展,用于从 Sphinx 项目构建 MDX(Markdown + JSX)文档。它还包含了一些 Node 包,用于将 MDX 集成到 Dumi 中。
安装
使用 pip
安装这个工具:
pip install secretflow-doctools
使用
将 doctools 作为 Sphinx 插件添加到你的 Sphinx 项目的 conf.py
中:
extensions = [
# ...
"secretflow_doctools",
]
然后将 mdx
指定为 builder:
python3 -m sphinx -b mdx [...] [sourcedir] [outputdir]
或者使用 make
:
make mdx
许可证
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for secretflow_doctools-0.7.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 505dc14ab6807fc425a800db41b800f83cf5e3e4ab521ee0f106f4aa372f4305 |
|
MD5 | 2ae85f4bbf68414f9ca64bf6b56411d2 |
|
BLAKE2b-256 | 8ac8e2750554992a4041610b50a35f8c903de6d7e07a271722f3a5d3c5fad667 |
Hashes for secretflow_doctools-0.7.0-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 83b2bedad18d11a9811156958264cd6bd7329f7fba79644eff12b65927f94919 |
|
MD5 | 449eb7a67660131996d54626785f6f43 |
|
BLAKE2b-256 | 1a73aebd25e64320cabc9553389aebaa7aaf56805d2df700d23b6ef4833a32ce |
Hashes for secretflow_doctools-0.7.0-py3-none-manylinux_2_17_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8160607a2bd1ac6f35886b88ad75d3e830218fb5de654fcbd9fb3fa1dc56e3ab |
|
MD5 | 70c85a7c4e122128ee06aa6887102592 |
|
BLAKE2b-256 | 8a7bab087a1256e040292c7e6feb7b528478c5d40a6459a86591175b3e948921 |
Hashes for secretflow_doctools-0.7.0-py3-none-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9ad468aa7daebfdf03d4ae584e7b2b4e4e50c6f31f58be211908ce47d304f9d8 |
|
MD5 | 637ad6bf67d6dc419c3f1f74ce241c1e |
|
BLAKE2b-256 | 6b008e0b186ba26fd47b58fde0acbf30fdf6706f2f0b6157d2648308bc6367e1 |
Hashes for secretflow_doctools-0.7.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4f495d252c3e511e3dc02cf88cde2795f9bfe190c953ffa170cd0bbc3603c12f |
|
MD5 | 65c746869bfd74e47976abf231e9c627 |
|
BLAKE2b-256 | 1373a83268b0733e045460ea3b1aa25b92c09a04a0e209c322e68d7a4e659b6c |