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.4.4.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 75004775ee1f38455e0c065217916b421c16795014c5b7198d7b05f2a0841cd3 |
|
MD5 | c84f138c294437f3caece87000f45e37 |
|
BLAKE2b-256 | 97a138677ae41ed16fbc795c0293afd18829f2a036fbf99bbc5edde0a61f6704 |
Hashes for secretflow_doctools-0.4.4-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4f95827bb0d26c2bf91dd82fdf293b101b38d3c46b57771dc923c71e8ad886eb |
|
MD5 | 9b555c929699c8a960e1f132bb6d7a4a |
|
BLAKE2b-256 | aa658e8cfc462e012abbd141f7268de5620900f678e381a548ad51bfb99e6f0e |
Hashes for secretflow_doctools-0.4.4-py3-none-manylinux_2_17_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2cf6a228b5acee962d5983ef40d83c1fdfc96e0c7451ee79404ade987d3a039f |
|
MD5 | 3ade3bb573565e4f74fb16e6fe495ea6 |
|
BLAKE2b-256 | 2d3c26ae8fca4dd326825d525496931c245c54670d3cd98fa2629172c3985d30 |
Hashes for secretflow_doctools-0.4.4-py3-none-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3863953a389837900d4b8d50d2eea92daf9a4ff928babd249bfcf07cb1de0a22 |
|
MD5 | 01f7968f054d1950af92c9b0261aec87 |
|
BLAKE2b-256 | a542b7d9ddc8a7ce05a8847a7615c94e0ab7266a549362c95d77f38fa6d58623 |
Hashes for secretflow_doctools-0.4.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c755f169ca501ee48c2f86340d10ff0c091dc2052d2e1ea787366d83e49f2369 |
|
MD5 | 678a0f950268f96199f43136d068fd2d |
|
BLAKE2b-256 | ea83bd725627cfe316f82444ac7c9f29cab01467098717b85520574d12963fcd |