Skip to main content

Documentation toolchain for SecretFlow

Project description

@secretflow/doctools

License: MIT CI status

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

MIT © SecretFlow


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

许可证

MIT © SecretFlow

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

secretflow_doctools-0.7.0.tar.gz (50.1 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

secretflow_doctools-0.7.0-py3-none-win_amd64.whl (14.6 MB view details)

Uploaded Python 3Windows x86-64

secretflow_doctools-0.7.0-py3-none-manylinux_2_17_x86_64.whl (17.6 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

secretflow_doctools-0.7.0-py3-none-macosx_10_9_x86_64.whl (17.7 MB view details)

Uploaded Python 3macOS 10.9+ x86-64

secretflow_doctools-0.7.0-py3-none-any.whl (50.3 MB view details)

Uploaded Python 3

File details

Details for the file secretflow_doctools-0.7.0.tar.gz.

File metadata

  • Download URL: secretflow_doctools-0.7.0.tar.gz
  • Upload date:
  • Size: 50.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-httpx/0.27.0

File hashes

Hashes for secretflow_doctools-0.7.0.tar.gz
Algorithm Hash digest
SHA256 505dc14ab6807fc425a800db41b800f83cf5e3e4ab521ee0f106f4aa372f4305
MD5 2ae85f4bbf68414f9ca64bf6b56411d2
BLAKE2b-256 8ac8e2750554992a4041610b50a35f8c903de6d7e07a271722f3a5d3c5fad667

See more details on using hashes here.

File details

Details for the file secretflow_doctools-0.7.0-py3-none-win_amd64.whl.

File metadata

File hashes

Hashes for secretflow_doctools-0.7.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 83b2bedad18d11a9811156958264cd6bd7329f7fba79644eff12b65927f94919
MD5 449eb7a67660131996d54626785f6f43
BLAKE2b-256 1a73aebd25e64320cabc9553389aebaa7aaf56805d2df700d23b6ef4833a32ce

See more details on using hashes here.

File details

Details for the file secretflow_doctools-0.7.0-py3-none-manylinux_2_17_x86_64.whl.

File metadata

File hashes

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

See more details on using hashes here.

File details

Details for the file secretflow_doctools-0.7.0-py3-none-macosx_10_9_x86_64.whl.

File metadata

File hashes

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

See more details on using hashes here.

File details

Details for the file secretflow_doctools-0.7.0-py3-none-any.whl.

File metadata

File hashes

Hashes for secretflow_doctools-0.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4f495d252c3e511e3dc02cf88cde2795f9bfe190c953ffa170cd0bbc3603c12f
MD5 65c746869bfd74e47976abf231e9c627
BLAKE2b-256 1373a83268b0733e045460ea3b1aa25b92c09a04a0e209c322e68d7a4e659b6c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page