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.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | b7e8489052acf78aacbcf88686f4b43f1fcc9a0b756b3586ba555ce226f6fdb1 |
|
MD5 | 62ded30155463e499ebe1b86bccd3ca7 |
|
BLAKE2b-256 | 8b96bc1e06b099ba91d4121dafde3e7bdb8cc3cbfd6c43e8b090e98a0b1d3bcd |
Hashes for secretflow_doctools-0.4.2-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3302397d621bc4636d5f51d02289c22a3c9057cd741ae1045265339eb4166c8c |
|
MD5 | 48b9d922eff5cb53a9e19a6f4587b175 |
|
BLAKE2b-256 | f7caac375249a55c5420ac385c31a054d8b467fa5e6c6a9ee954c106b3046d53 |
Hashes for secretflow_doctools-0.4.2-py3-none-manylinux_2_17_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 73bc9dd7f6006dbc5f1d35187f05614bf67e0db382ce614b72ef14be5c445fa9 |
|
MD5 | d1d4a776459b96f511838e306eb6d9d5 |
|
BLAKE2b-256 | 58e8a2e6492b564cf78f552829b881016f8c9175f14161ae1023e95cbbd4129d |
Hashes for secretflow_doctools-0.4.2-py3-none-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 70049d0f4f4b072b92b6d8361573b7ed055c7cd4e3d78f0a372634249a3b2247 |
|
MD5 | 7b11dda73c126389dd1af26666420727 |
|
BLAKE2b-256 | 5d5b3aea82cc7974b77a3efc80c677facd07e50c42bdcca64ca58f622178bd73 |
Hashes for secretflow_doctools-0.4.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0e48a7d9301831712128de406f51c7a7bd0e3d0a42437ba8d0489c7a63c51927 |
|
MD5 | 8ef5c4c6baa69c7ed0ce1a4979b35423 |
|
BLAKE2b-256 | 3075b76a52e2c2c9e378ba5c15bc370d76233afa459e42a257d219945f09535c |