执行pnpm nx ci测试未通过的问题

[Sneaker001333]

先对项目组的工作致敬！
我在复现本工具时发现了一些小bug，想问问看是发生了什么事情。

【执行环境】

> uname -a
Linux run 5.15.0-130-generic #140-Ubuntu SMP Wed Dec 18 17:59:53 UTC 2024 x86_64 x86_64 x86_64 GNU/Linux
> node -v  
v20.19.3
> pnpm -v
10.12.4
> uv v
Using CPython 3.12.11
Creating virtual environment at: .venv
Activate with: source .venv/bin/activate

【执行命令】
pnpm nx ci

【返回结果】
其中包含如下错误：

Traceback (most recent call last):
  File "/home/ubuntu/miniconda3/envs/secretflow/lib/python3.10/site-packages/sphinx/cmd/build.py", line 514, in build_main
    app.build(args.force_all, args.filenames)
  File "/home/ubuntu/miniconda3/envs/secretflow/lib/python3.10/site-packages/sphinx/application.py", line 381, in build
    self.builder.build_update()
  File "/home/ubuntu/miniconda3/envs/secretflow/lib/python3.10/site-packages/sphinx/builders/__init__.py", line 358, in build_update
    self.build(
  File "/home/ubuntu/miniconda3/envs/secretflow/lib/python3.10/site-packages/sphinx/builders/__init__.py", line 437, in build
    self.write(docnames, list(updated_docnames), method)
  File "/home/ubuntu/miniconda3/envs/secretflow/lib/python3.10/site-packages/sphinx/builders/__init__.py", line 711, in write
    self.write_documents(docnames)
  File "/home/ubuntu/miniconda3/envs/secretflow/lib/python3.10/site-packages/secretflow_doctools/builder.py", line 259, in write_documents
    super().write_documents(docnames)
  File "/home/ubuntu/miniconda3/envs/secretflow/lib/python3.10/site-packages/sphinx/builders/__init__.py", line 725, in write_documents
    self._write_serial(sorted_docnames)
  File "/home/ubuntu/miniconda3/envs/secretflow/lib/python3.10/site-packages/sphinx/builders/__init__.py", line 744, in _write_serial
    self.write_doc(docname, doctree)
  File "/home/ubuntu/miniconda3/envs/secretflow/lib/python3.10/site-packages/secretflow_doctools/builder.py", line 281, in write_doc
    f.write(translator.export().encode("utf-8"))
  File "/home/ubuntu/miniconda3/envs/secretflow/lib/python3.10/site-packages/secretflow_doctools/translator.py", line 1205, in export
    return self.mdclient.tree_to_markdown(root)
  File "/home/ubuntu/miniconda3/envs/secretflow/lib/python3.10/site-packages/secretflow_doctools/markdown/ffi.py", line 49, in tree_to_markdown
    raise ValueError(res.text)
ValueError

The full traceback has been saved in /tmp/sphinx-err-ipdr3ujs.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
A bug report can be filed in the tracker at https://github.com/sphinx-doc/sphinx/issues. Thanks!
Warning: command ".venv/bin/python -m coverage run -m sphinx -T -E -b mdx tests/demo tests/demo/_build/mdx/demo/main/en" exited with non-zero status code

【疑问】
我编辑了ffi.py文件让它打印出res的值，结果显示为<Response [503]>，这是为什么呢？

[tonywu6]

Hi! 感谢你的报告！

工具在构建文档的过程中需要编译一些中间产物。在当前，这一步骤依赖由 JavaScript 实现的逻辑。 Python 程序与之交互的方式是一个 HTTP 服务器，该服务器在本地运行（构建过程并不依赖远端服务）。secretflow_doctools/markdown/ffi.py 负责在构建过程中自动启动/销毁服务器进程。

在预期情况下，构建工具向服务器发起请求，应当可以获得正常的 HTTP 响应。按照你提供的描述，服务器响应 res 是 <Response [503]>，这代表一个 HTTP 503 的异常响应。出现此响应的原因有很多种，可能是服务器逻辑未能正确运行，或是服务器未能正确启动，或是在本地存在其他进程或是防火墙阻止了正常响应。

目前在一个运行 Ubuntu 22.04 x86_64 的机器上未能复现这一问题。

请你按照以下步骤协助排查：

1. 单独启动服务器进程：

   • 如果是在本仓库下工作，请执行：

     node src/py/secretflow_doctools/js/cli.js ffi

     src/py/secretflow_doctools/js/cli.js 是服务器的 JavaScript 代码，该文件应当存在。如果该文件不存在，请执行构建命令 pnpm nx build:cli。

   • 如果是在其他安装了文档工具的仓库下工作，请执行：

     .venv/bin/secretflow-doctools-js-cli ffi

   应当能看到类似如下输出：

   Listening on http://127.0.0.1:3000
   

2. 在新的终端执行以下命令，直接向服务器发起 HTTP 请求：

   curl --verbose \
     --header 'content-type: application/json' \
     --data @- \
     http://127.0.0.1:3000/markdown/stringify << EOF
   {
     "type": "root",
     "children": [
       {
         "type": "heading",
         "depth": 1,
         "children": [
           {
             "type": "text",
             "value": "Hello, world!"
           }
         ]
       }
     ]
   }
   EOF

   （你可能需要按照上文输出调整 URL 中的端口号）

在预期情况下，得到的输出应当类似于：

*   Trying 127.0.0.1:3000...
* Connected to 127.0.0.1 (127.0.0.1) port 3000 (#0)
> POST /markdown/stringify HTTP/1.1
> Host: 127.0.0.1:3000
> User-Agent: curl/7.88.1
> Accept: */*
> content-type: application/json
> Content-Length: 191
>
< HTTP/1.1 200 OK
< content-type: text/plain;charset=UTF-8
< vary: Accept-Encoding
< content-length: 16
<
# Hello, world!
* Connection #0 to host 127.0.0.1 left intact

[Sneaker001333]

感谢迅速回复！单独启动ffi服务器后用curl发送请求，确实是可以得到预期输出

*   Trying 127.0.0.1:3000...
* Connected to 127.0.0.1 (127.0.0.1) port 3000 (#0)
> POST /markdown/stringify HTTP/1.1
> Host: 127.0.0.1:3000
> User-Agent: curl/7.81.0
> Accept: */*
> content-type: application/json
> Content-Length: 117
> 
* Mark bundle as not supporting multiuse
< HTTP/1.1 200 OK
< content-type: text/plain; charset=UTF-8
< Content-Length: 16
< Date: Thu, 10 Jul 2025 00:49:17 GMT
< Connection: keep-alive
< Keep-Alive: timeout=5
< 
# Hello, world!
* Connection #0 to host 127.0.0.1 left intact

我已使用netstat -ano|grep 3000确认过3000端口未被占用且本机防火墙关闭，但是直接执行pnpm nx ci或者pnpm nx test仍然报返回值为503

[tonywu6]

在 ffi.py 中，在 47 行：

doctools/src/py/secretflow_doctools/markdown/ffi.py

Lines 46 to 50 in 3d6045a

	def tree_to_markdown(self, ast: Root) -> str:
	res = self._session.post(self.endpoint("/markdown/stringify"), json=ast)
	if res.status_code != 200:
	raise ValueError(res.text)
	return res.text

其中 json=ast 的 ast 为一个文档页面的完整 AST，它可以被 json.dump。

在此处打印或者断点来获取发生错误时发出的 AST，然后通过上文步骤重新尝试请求，看看是否可以复现异常？

[Sneaker001333]

不好意思来迟了，向手动启动的Python服务器发送json.dump出来的AST，请求可以被正常响应，交互请求如下：

*   Trying 127.0.0.1:3000...
* Connected to 127.0.0.1 (127.0.0.1) port 3000 (#0)
> POST /markdown/stringify HTTP/1.1
> Host: 127.0.0.1:3000
> User-Agent: curl/7.81.0
> Accept: */*
> content-type: application/json
> Content-Length: 107497
> 
* We are completely uploaded and fine
* Mark bundle as not supporting multiuse
< HTTP/1.1 200 OK
< content-type: text/plain; charset=UTF-8
< Content-Length: 35020
< Date: Thu, 10 Jul 2025 04:47:41 GMT
< Connection: keep-alive
< Keep-Alive: timeout=5
< 
---
git_download_url: https://github.com/secretflow/doctools/raw/3d6045ac176a831fe5069a487c0afed78a648b0e/tests/demo/api.md
git_last_modified_commit: 476c73a6b34c0a169b11ee0030a0988a947a1ec9
git_last_modified_time: '2025-05-29T23:26:23+00:00'
git_origin_url: https://github.com/secretflow/doctools/blob/3d6045ac176a831fe5069a487c0afed78a648b0e/tests/demo/api.md
git_owner: secretflow
git_repo: doctools
git_revision_commit: 3d6045ac176a831fe5069a487c0afed78a648b0e
git_revision_time: '2025-06-05T12:10:18+08:00'
page_dependencies:
- path: tests/demo/api.md
  time:
    commit: 476c73a6b34c0a169b11ee0030a0988a947a1ec9
    time: '2025-05-29T23:26:23+00:00'
    type: revision
  type: content
- path: .venv/lib/python3.12/site-packages/secretflow_doctools/builder.py
  time: null
  type: attachment
- path: .venv/lib/python3.12/site-packages/myst_parser/sphinx_ext/main.py
  time: null
  type: attachment
- path: .venv/lib/python3.12/site-packages/secretflow_doctools/translator.py
  time: null
  type: attachment
---

:target{#apis}

# APIs

<Outline domain="py" objectType="function" target={"myst_parser.sphinx_ext.main.setup_sphinx"} module={"myst_parser.sphinx_ext.main"} fullname={"setup_sphinx"} parameters={["app", "load_parser"]} description={"Initialize all settings and transforms in Sphinx."}>
  <Outline.Signature fullname="setup_sphinx" id="myst_parser.sphinx_ext.main.setup_sphinx">
    <Outline.Prefix>myst\_parser.sphinx\_ext.main.</Outline.Prefix><Outline.Name>setup\_sphinx</Outline.Name><Outline.ParameterList><span>(</span><Outline.Parameter><span className="name">app</span><span>:</span><span>{" "}</span><span className="name">Sphinx</span></Outline.Parameter>, <Outline.Parameter><span className="name">load\_parser</span><span>:</span><span>{" "}</span><span className="name">bool</span><span>{" "}</span><span>=</span><span>{" "}</span><span>False</span></Outline.Parameter><span>)</span></Outline.ParameterList><Outline.ReturnType><span>{" → "}</span>None</Outline.ReturnType>
  </Outline.Signature>

......

也就是说在secretflow-doctools执行的时候能够将AST解析出来，但是因为某种原因secretflow-doctools执行的时候自动启动的Python服务器没有处理这个AST，返回了空结果。

[Sneaker001333]

我修改了ffi.py文件，把Python服务器自动启动时监听的端口打印出来，并在res = self._session.post(self.endpoint("/markdown/stringify"), json=ast) 的下一行添加了time.sleep(600)，然后使用pnpm nx test启动测试流程，并在Python服务器监听请求的600秒间隙中用curl手动给当前监听的50361端口发送AST，服务器能够正常处理AST并返回相应码200，请求及响应如下：

*   Trying 127.0.0.1:50361...
* Connected to 127.0.0.1 (127.0.0.1) port 50361 (#0)
> POST /markdown/stringify HTTP/1.1
> Host: 127.0.0.1:50361
> User-Agent: curl/7.81.0
> Accept: */*
> content-type: application/json
> Content-Length: 107497
> 
* We are completely uploaded and fine
* Mark bundle as not supporting multiuse
< HTTP/1.1 200 OK
< content-type: text/plain;charset=UTF-8
< vary: Accept-Encoding
< content-length: 35020
< date: Thu, 10 Jul 2025 05:52:59 GMT
< 
---
git_download_url: https://github.com/secretflow/doctools/raw/3d6045ac176a831fe5069a487c0afed78a648b0e/tests/demo/api.md
git_last_modified_commit: 476c73a6b34c0a169b11ee0030a0988a947a1ec9
git_last_modified_time: '2025-05-29T23:26:23+00:00'
git_origin_url: https://github.com/secretflow/doctools/blob/3d6045ac176a831fe5069a487c0afed78a648b0e/tests/demo/api.md
git_owner: secretflow
git_repo: doctools
git_revision_commit: 3d6045ac176a831fe5069a487c0afed78a648b0e
git_revision_time: '2025-06-05T12:10:18+08:00'
page_dependencies:
- path: tests/demo/api.md
  time:
    commit: 476c73a6b34c0a169b11ee0030a0988a947a1ec9
    time: '2025-05-29T23:26:23+00:00'
    type: revision
  type: content
- path: .venv/lib/python3.12/site-packages/secretflow_doctools/builder.py
  time: null
  type: attachment
- path: .venv/lib/python3.12/site-packages/myst_parser/sphinx_ext/main.py
  time: null
  type: attachment
- path: .venv/lib/python3.12/site-packages/secretflow_doctools/translator.py
  time: null
  type: attachment
---

:target{#apis}

# APIs

<Outline domain="py" objectType="function" target={"myst_parser.sphinx_ext.main.setup_sphinx"} module={"myst_parser.sphinx_ext.main"} fullname={"setup_sphinx"} parameters={["app", "load_parser"]} description={"Initialize all settings and transforms in Sphinx."}>
  <Outline.Signature fullname="setup_sphinx" id="myst_parser.sphinx_ext.main.setup_sphinx">

.......

奇怪的是用Python将AST发给Python服务器（即工具原始代码片段的方式），服务器就无法正常响应（503），此处的AST是经过repr()还原后的原始字符串，相关测试demo代码如下：

from requests import Session
import json

ast_str = """
{"type": "root", "children": [{"type": "yaml", "value": "git_download_url: https://github.com/secretflow/doctools/raw/3d6045ac176a831fe5069a487c0afed78a648b0e/tests/demo/api.md\\ngit_last_modified_commit: 476c73a6b34c0a169b11ee0030a0988a947a1ec9\\ngit_last_modified_time: \'2025-05-29T23:26:23+00:00\'\\ngit_origin_url: https://github.com/secretflow/doctools/blob/3d6045ac176a831fe5069a487c0afed78a648b0e/tests/demo/api.md\\ngit_owner: secretflow\\ngit_repo: doctools\\ngit_revision_commit: 3d6045ac176a831fe5069a487c0afed78a648b0e\\ngit_revision_time: \'2025-06-05T12:10:18+08:00\'\\npage_dependencies:\\n- path: tests/demo/api.md\\n  time:\\n    commit: 476c73a6b34c0a169b11ee0030a0988a947a1ec9\\n    time: \'2025-05-29T23:26:23+00:00\'\\n    type: revision\\n  type: content\\n- path: .venv/lib/python3.12/site-packages/secretflow_doctools/builder.py\\n  time: null\\n  type: attachment\\n- path: .venv/lib/python3.12/site-packages/myst_parser/sphinx_ext/main.py\\n  time: null\\n  type: attachment\\n- path: .venv/lib/python3.12/site-packages/secretflow_doctools/translator.py\\n  time: null\\n  type: attachment"}, {"type": "textDirective", "name": "target", "attributes": {"id": "apis"}, "children": []}, {"type": "heading", "depth": 1, "children": [{"type": "text", "value": "APIs"}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "function"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"myst_parser.sphinx_ext.main.setup_sphinx\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"myst_parser.sphinx_ext.main\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"setup_sphinx\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"load_parser\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Initialize all settings and transforms in Sphinx.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "setup_sphinx"}, {"type": "mdxJsxAttribute", "name": "id", "value": "myst_parser.sphinx_ext.main.setup_sphinx"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Prefix", "attributes": [], "children": [{"type": "text", "value": "myst_parser.sphinx_ext.main."}]}, {"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "setup_sphinx"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "app"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "Sphinx"}]}]}, {"type": "text", "value": ", "}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "load_parser"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "bool"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "False"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Initialize all settings and transforms in Sphinx."}]}, {"type": "mdxJsxFlowElement", "name": "FieldList", "attributes": [], "children": [{"type": "mdxJsxFlowElement", "name": "dl", "attributes": [], "children": [{"type": "mdxJsxFlowElement", "name": "dt", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "field-name"}], "children": [{"type": "text", "value": "Parameters"}]}, {"type": "mdxJsxFlowElement", "name": "dd", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "field-body"}], "children": [{"type": "list", "start": null, "spread": false, "ordered": false, "children": [{"type": "listItem", "spread": false, "children": [{"type": "paragraph", "children": [{"type": "mdxJsxTextElement", "name": "Outline.ParameterTarget", "attributes": [], "children": [{"type": "text", "value": "app"}]}, {"type": "text", "value": " \\u2013 "}, {"type": "text", "value": "The Sphinx application object."}]}]}, {"type": "listItem", "spread": false, "children": [{"type": "paragraph", "children": [{"type": "mdxJsxTextElement", "name": "Outline.ParameterTarget", "attributes": [], "children": [{"type": "text", "value": "load_parser"}]}, {"type": "text", "value": " \\u2013 "}, {"type": "text", "value": "Whether to load the parser."}]}]}]}]}]}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "class"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "class"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.Prefix", "attributes": [], "children": [{"type": "text", "value": "secretflow_doctools.builder."}]}, {"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "MdxBuilder"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "app"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "Sphinx"}]}]}, {"type": "text", "value": ", "}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "env"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "BuildEnvironment"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "property"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.build_info_path\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.build_info_path\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.build_info_path"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.build_info_path"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "property"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "build_info_path"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.cleanup\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.cleanup\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.cleanup"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.cleanup"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "cleanup"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Cleanup any resources."}]}, {"type": "paragraph", "children": [{"type": "text", "value": "The default implementation does nothing."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.copy_assets\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.copy_assets\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Where assets (images, static files, etc) are copied before writing\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.copy_assets"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.copy_assets"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "copy_assets"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Where assets (images, static files, etc) are copied before writing"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.create_build_info\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.create_build_info\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.create_build_info"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.create_build_info"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "create_build_info"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "BuildInfo"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.default_translator_class\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.default_translator_class\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"alias of MdxTranslator\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.default_translator_class"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.default_translator_class"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "default_translator_class"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "alias of "}, {"type": "inlineCode", "value": "MdxTranslator"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.dump_inventory\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.dump_inventory\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.dump_inventory"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.dump_inventory"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "dump_inventory"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.file_extension\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.file_extension\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.file_extension"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.file_extension"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "file_extension"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "\'.mdx\'"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.finish\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.finish\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Finish the building process.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.finish"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.finish"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "finish"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Finish the building process."}]}, {"type": "paragraph", "children": [{"type": "text", "value": "The default implementation does nothing."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.format\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.format\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"The builder\\\\u2019s output format, or \\\\u2018\\\\u2019 if no document output is produced.\\\\nThis is commonly the file extension, e.g. \\\\u201chtml\\\\u201d,\\\\nthough any string value is accepted.\\\\nThe builder\\\\u2019s format string can be used by various components\\\\nsuch as SphinxPostTransform or extensions to determine\\\\ntheir compatibility with the builder.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.format"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.format"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "format"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "\'mdx\'"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "The builder\\u2019s output format, or \\u2018\\u2019 if no document output is produced.\\nThis is commonly the file extension, e.g. \\u201chtml\\u201d,\\nthough any string value is accepted.\\nThe builder\\u2019s format string can be used by various components\\nsuch as "}, {"type": "inlineCode", "value": "SphinxPostTransform"}, {"type": "text", "value": " or extensions to determine\\ntheir compatibility with the builder."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.get_origin_url\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.get_origin_url\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"docname\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.get_origin_url"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.get_origin_url"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "get_origin_url"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "docname"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "str"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.get_outdated_docs\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.get_outdated_docs\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Return an iterable of output files that are outdated, or a string\\\\ndescribing what an update build will build.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.get_outdated_docs"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.get_outdated_docs"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "get_outdated_docs"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "Iterator"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "["}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "]"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Return an iterable of output files that are outdated, or a string\\ndescribing what an update build will build."}]}, {"type": "paragraph", "children": [{"type": "text", "value": "If the builder does not output individual files corresponding to\\nsource files, return a string here.  If it does, return an iterable\\nof those files that need to be written."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.get_source_tree_path\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.get_source_tree_path\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"docname\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.get_source_tree_path"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.get_source_tree_path"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "get_source_tree_path"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "docname"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "str"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.get_target_uri\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.get_target_uri\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"docname\\", \\"typ\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Return the target URI for a document name.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.get_target_uri"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.get_target_uri"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "get_target_uri"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "docname"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "str"}]}]}, {"type": "text", "value": ", "}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "typ"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "None"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "str"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Return the target URI for a document name."}]}, {"type": "paragraph", "children": [{"type": "mdxJsxTextElement", "name": "em", "attributes": [], "children": [{"type": "text", "value": "typ"}]}, {"type": "text", "value": " can be used to qualify the link characteristic for individual\\nbuilders."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.init\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.init\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Load necessary templates and perform initialization.  The default\\\\nimplementation does nothing.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.init"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.init"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "init"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Load necessary templates and perform initialization.  The default\\nimplementation does nothing."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.name\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.name\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"The builder\\\\u2019s name.\\\\nThis is the value used to select builders on the command line.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.name"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.name"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "name"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "\'mdx\'"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "The builder\\u2019s name.\\nThis is the value used to select builders on the command line."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "property"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.output_root\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.output_root\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.output_root"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.output_root"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "property"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "output_root"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "Path"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.resolve_metadata\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.resolve_metadata\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"docname\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.resolve_metadata"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.resolve_metadata"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "resolve_metadata"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "docname"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "str"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "link", "url": "#secretflow_doctools.builder.PageMetadata", "title": "secretflow_doctools.builder.PageMetadata", "children": [{"type": "text", "value": "PageMetadata"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "property"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.source_root\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.source_root\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.source_root"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.source_root"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "property"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "source_root"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "Path"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.supported_data_uri_images\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.supported_data_uri_images\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"If set to False, Sphinx will attempt to convert data URIs to image files.\\\\nBrowsers support data URIs, so we set this to True.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.supported_data_uri_images"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.supported_data_uri_images"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "supported_data_uri_images"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "bool"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "True"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "If set to False, Sphinx will attempt to convert data URIs to image files.\\nBrowsers support data URIs, so we set this to True."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.supported_image_types\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.supported_image_types\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Indicate images that are supported by the builder\\\\u2019s output format, so\\\\nthat Sphinx will not attempt to convert them.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.supported_image_types"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.supported_image_types"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "supported_image_types"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "list"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "["}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "]"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "[]"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Indicate images that are supported by the builder\\u2019s output format, so\\nthat Sphinx will not attempt to convert them."}]}, {"type": "paragraph", "children": [{"type": "text", "value": "Since we are generating JavaScript source code, resources are handled by\\nthe downstream bundler and loaders, we use an empty list to indicate we\\nsupport all images."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.supported_remote_images\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.supported_remote_images\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"If set to False, Sphinx will attempt to download remote images. We are\\\\nbuilding web apps so this is necessarily True.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.supported_remote_images"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.supported_remote_images"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "supported_remote_images"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "bool"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "True"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "If set to False, Sphinx will attempt to download remote images. We are\\nbuilding web apps so this is necessarily True."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.use_message_catalog\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.use_message_catalog\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.use_message_catalog"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.use_message_catalog"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "use_message_catalog"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "True"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.versioning_compare\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.versioning_compare\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.versioning_compare"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.versioning_compare"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "versioning_compare"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "False"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.versioning_method\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.versioning_method\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.versioning_method"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.versioning_method"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "versioning_method"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "\'none\'"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.write_buildinfo\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.write_buildinfo\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.write_buildinfo"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.write_buildinfo"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "write_buildinfo"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.write_doc\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.write_doc\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"docname\\", \\"doctree\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Write the output file for the document\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.write_doc"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.write_doc"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "write_doc"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "docname"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "str"}]}]}, {"type": "text", "value": ", "}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "doctree"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "document"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Write the output file for the document"}]}, {"type": "mdxJsxFlowElement", "name": "FieldList", "attributes": [], "children": [{"type": "mdxJsxFlowElement", "name": "dl", "attributes": [], "children": [{"type": "mdxJsxFlowElement", "name": "dt", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "field-name"}], "children": [{"type": "text", "value": "Parameters"}]}, {"type": "mdxJsxFlowElement", "name": "dd", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "field-body"}], "children": [{"type": "list", "start": null, "spread": false, "ordered": false, "children": [{"type": "listItem", "spread": false, "children": [{"type": "paragraph", "children": [{"type": "mdxJsxTextElement", "name": "Outline.ParameterTarget", "attributes": [], "children": [{"type": "text", "value": "docname"}]}, {"type": "text", "value": " \\u2013 "}, {"type": "text", "value": "the "}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "docname"}]}, {"type": "text", "value": "."}]}]}, {"type": "listItem", "spread": false, "children": [{"type": "paragraph", "children": [{"type": "mdxJsxTextElement", "name": "Outline.ParameterTarget", "attributes": [], "children": [{"type": "text", "value": "doctree"}]}, {"type": "text", "value": " \\u2013 "}, {"type": "text", "value": "defines the content to be written."}]}]}]}]}]}]}, {"type": "paragraph", "children": [{"type": "text", "value": "The output filename must be determined within this method,\\ntypically by calling "}, {"type": "inlineCode", "value": "get_target_uri()"}, {"type": "text", "value": "\\nor "}, {"type": "inlineCode", "value": "get_relative_uri()"}, {"type": "text", "value": "."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.write_documents\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.write_documents\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"docnames\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Write all documents in docnames.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.write_documents"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.write_documents"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "write_documents"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "docnames"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Write all documents in "}, {"type": "mdxJsxTextElement", "name": "em", "attributes": [], "children": [{"type": "text", "value": "docnames"}]}, {"type": "text", "value": "."}]}, {"type": "paragraph", "children": [{"type": "text", "value": "This method can be overridden if a builder does not create\\noutput files for each document."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.write_manifest\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.write_manifest\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.write_manifest"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.write_manifest"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "write_manifest"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "class"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "class"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.Prefix", "attributes": [], "children": [{"type": "text", "value": "secretflow_doctools.builder."}]}, {"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "PageMetadata"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "**"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "data"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "Any"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.git_download_url\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.git_download_url\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.git_download_url"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.git_download_url"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "git_download_url"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.git_last_modified_commit\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.git_last_modified_commit\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.git_last_modified_commit"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.git_last_modified_commit"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "git_last_modified_commit"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.git_last_modified_time\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.git_last_modified_time\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.git_last_modified_time"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.git_last_modified_time"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "git_last_modified_time"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.git_origin_url\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.git_origin_url\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.git_origin_url"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.git_origin_url"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "git_origin_url"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.git_owner\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.git_owner\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.git_owner"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.git_owner"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "git_owner"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.git_repo\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.git_repo\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.git_repo"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.git_repo"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "git_repo"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.git_revision_commit\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.git_revision_commit\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.git_revision_commit"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.git_revision_commit"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "git_revision_commit"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.git_revision_time\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.git_revision_time\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.git_revision_time"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.git_revision_time"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "git_revision_time"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.model_config\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.model_config\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.model_config"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.model_config"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "model_config"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "ClassVar"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "["}]}, {"type": "text", "value": "ConfigDict"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "]"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "{}"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Configuration for the model, should be a dictionary conforming to ["}, {"type": "mdxJsxTextElement", "name": "cite", "attributes": [], "children": [{"type": "text", "value": "ConfigDict"}]}, {"type": "text", "value": "][pydantic.config.ConfigDict]."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.page_dependencies\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.page_dependencies\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.page_dependencies"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.page_dependencies"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "page_dependencies"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "list"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "["}]}, {"type": "text", "value": "PageDependency"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "]"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}]}]}]}
"""

ast = json.loads(ast_str)

_session =  Session()
res = _session.post("http://localhost:50361/markdown/stringify", json=ast)
print(res.status_code)

不知道您那边能不能复现出来这个503呢？

[tonywu6]

仍然没有办法复现。麻烦尝试下用 logging 打印更多信息：

import http.client
import json
import logging

from requests import Session

logging.basicConfig(level=logging.DEBUG)
logging.getLogger("requests.packages.urllib3").setLevel(logging.DEBUG)
logging.getLogger("requests.packages.urllib3").propagate = True
http.client.HTTPConnection.debuglevel = 1

ast_str = """
{"type": "root", "children": [{"type": "yaml", "value": "git_download_url: https://github.com/secretflow/doctools/raw/3d6045ac176a831fe5069a487c0afed78a648b0e/tests/demo/api.md\\ngit_last_modified_commit: 476c73a6b34c0a169b11ee0030a0988a947a1ec9\\ngit_last_modified_time: \'2025-05-29T23:26:23+00:00\'\\ngit_origin_url: https://github.com/secretflow/doctools/blob/3d6045ac176a831fe5069a487c0afed78a648b0e/tests/demo/api.md\\ngit_owner: secretflow\\ngit_repo: doctools\\ngit_revision_commit: 3d6045ac176a831fe5069a487c0afed78a648b0e\\ngit_revision_time: \'2025-06-05T12:10:18+08:00\'\\npage_dependencies:\\n- path: tests/demo/api.md\\n  time:\\n    commit: 476c73a6b34c0a169b11ee0030a0988a947a1ec9\\n    time: \'2025-05-29T23:26:23+00:00\'\\n    type: revision\\n  type: content\\n- path: .venv/lib/python3.12/site-packages/secretflow_doctools/builder.py\\n  time: null\\n  type: attachment\\n- path: .venv/lib/python3.12/site-packages/myst_parser/sphinx_ext/main.py\\n  time: null\\n  type: attachment\\n- path: .venv/lib/python3.12/site-packages/secretflow_doctools/translator.py\\n  time: null\\n  type: attachment"}, {"type": "textDirective", "name": "target", "attributes": {"id": "apis"}, "children": []}, {"type": "heading", "depth": 1, "children": [{"type": "text", "value": "APIs"}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "function"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"myst_parser.sphinx_ext.main.setup_sphinx\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"myst_parser.sphinx_ext.main\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"setup_sphinx\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"load_parser\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Initialize all settings and transforms in Sphinx.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "setup_sphinx"}, {"type": "mdxJsxAttribute", "name": "id", "value": "myst_parser.sphinx_ext.main.setup_sphinx"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Prefix", "attributes": [], "children": [{"type": "text", "value": "myst_parser.sphinx_ext.main."}]}, {"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "setup_sphinx"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "app"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "Sphinx"}]}]}, {"type": "text", "value": ", "}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "load_parser"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "bool"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "False"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Initialize all settings and transforms in Sphinx."}]}, {"type": "mdxJsxFlowElement", "name": "FieldList", "attributes": [], "children": [{"type": "mdxJsxFlowElement", "name": "dl", "attributes": [], "children": [{"type": "mdxJsxFlowElement", "name": "dt", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "field-name"}], "children": [{"type": "text", "value": "Parameters"}]}, {"type": "mdxJsxFlowElement", "name": "dd", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "field-body"}], "children": [{"type": "list", "start": null, "spread": false, "ordered": false, "children": [{"type": "listItem", "spread": false, "children": [{"type": "paragraph", "children": [{"type": "mdxJsxTextElement", "name": "Outline.ParameterTarget", "attributes": [], "children": [{"type": "text", "value": "app"}]}, {"type": "text", "value": " \\u2013 "}, {"type": "text", "value": "The Sphinx application object."}]}]}, {"type": "listItem", "spread": false, "children": [{"type": "paragraph", "children": [{"type": "mdxJsxTextElement", "name": "Outline.ParameterTarget", "attributes": [], "children": [{"type": "text", "value": "load_parser"}]}, {"type": "text", "value": " \\u2013 "}, {"type": "text", "value": "Whether to load the parser."}]}]}]}]}]}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "class"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "class"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.Prefix", "attributes": [], "children": [{"type": "text", "value": "secretflow_doctools.builder."}]}, {"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "MdxBuilder"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "app"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "Sphinx"}]}]}, {"type": "text", "value": ", "}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "env"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "BuildEnvironment"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "property"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.build_info_path\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.build_info_path\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.build_info_path"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.build_info_path"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "property"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "build_info_path"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.cleanup\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.cleanup\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.cleanup"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.cleanup"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "cleanup"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Cleanup any resources."}]}, {"type": "paragraph", "children": [{"type": "text", "value": "The default implementation does nothing."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.copy_assets\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.copy_assets\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Where assets (images, static files, etc) are copied before writing\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.copy_assets"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.copy_assets"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "copy_assets"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Where assets (images, static files, etc) are copied before writing"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.create_build_info\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.create_build_info\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.create_build_info"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.create_build_info"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "create_build_info"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "BuildInfo"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.default_translator_class\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.default_translator_class\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"alias of MdxTranslator\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.default_translator_class"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.default_translator_class"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "default_translator_class"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "alias of "}, {"type": "inlineCode", "value": "MdxTranslator"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.dump_inventory\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.dump_inventory\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.dump_inventory"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.dump_inventory"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "dump_inventory"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.file_extension\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.file_extension\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.file_extension"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.file_extension"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "file_extension"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "\'.mdx\'"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.finish\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.finish\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Finish the building process.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.finish"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.finish"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "finish"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Finish the building process."}]}, {"type": "paragraph", "children": [{"type": "text", "value": "The default implementation does nothing."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.format\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.format\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"The builder\\\\u2019s output format, or \\\\u2018\\\\u2019 if no document output is produced.\\\\nThis is commonly the file extension, e.g. \\\\u201chtml\\\\u201d,\\\\nthough any string value is accepted.\\\\nThe builder\\\\u2019s format string can be used by various components\\\\nsuch as SphinxPostTransform or extensions to determine\\\\ntheir compatibility with the builder.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.format"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.format"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "format"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "\'mdx\'"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "The builder\\u2019s output format, or \\u2018\\u2019 if no document output is produced.\\nThis is commonly the file extension, e.g. \\u201chtml\\u201d,\\nthough any string value is accepted.\\nThe builder\\u2019s format string can be used by various components\\nsuch as "}, {"type": "inlineCode", "value": "SphinxPostTransform"}, {"type": "text", "value": " or extensions to determine\\ntheir compatibility with the builder."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.get_origin_url\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.get_origin_url\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"docname\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.get_origin_url"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.get_origin_url"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "get_origin_url"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "docname"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "str"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.get_outdated_docs\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.get_outdated_docs\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Return an iterable of output files that are outdated, or a string\\\\ndescribing what an update build will build.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.get_outdated_docs"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.get_outdated_docs"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "get_outdated_docs"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "Iterator"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "["}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "]"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Return an iterable of output files that are outdated, or a string\\ndescribing what an update build will build."}]}, {"type": "paragraph", "children": [{"type": "text", "value": "If the builder does not output individual files corresponding to\\nsource files, return a string here.  If it does, return an iterable\\nof those files that need to be written."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.get_source_tree_path\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.get_source_tree_path\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"docname\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.get_source_tree_path"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.get_source_tree_path"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "get_source_tree_path"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "docname"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "str"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.get_target_uri\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.get_target_uri\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"docname\\", \\"typ\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Return the target URI for a document name.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.get_target_uri"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.get_target_uri"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "get_target_uri"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "docname"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "str"}]}]}, {"type": "text", "value": ", "}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "typ"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "None"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "str"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Return the target URI for a document name."}]}, {"type": "paragraph", "children": [{"type": "mdxJsxTextElement", "name": "em", "attributes": [], "children": [{"type": "text", "value": "typ"}]}, {"type": "text", "value": " can be used to qualify the link characteristic for individual\\nbuilders."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.init\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.init\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Load necessary templates and perform initialization.  The default\\\\nimplementation does nothing.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.init"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.init"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "init"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Load necessary templates and perform initialization.  The default\\nimplementation does nothing."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.name\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.name\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"The builder\\\\u2019s name.\\\\nThis is the value used to select builders on the command line.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.name"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.name"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "name"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "\'mdx\'"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "The builder\\u2019s name.\\nThis is the value used to select builders on the command line."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "property"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.output_root\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.output_root\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.output_root"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.output_root"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "property"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "output_root"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "Path"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.resolve_metadata\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.resolve_metadata\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"docname\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.resolve_metadata"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.resolve_metadata"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "resolve_metadata"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "docname"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "str"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "link", "url": "#secretflow_doctools.builder.PageMetadata", "title": "secretflow_doctools.builder.PageMetadata", "children": [{"type": "text", "value": "PageMetadata"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "property"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.source_root\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.source_root\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.source_root"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.source_root"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "property"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "source_root"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "Path"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.supported_data_uri_images\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.supported_data_uri_images\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"If set to False, Sphinx will attempt to convert data URIs to image files.\\\\nBrowsers support data URIs, so we set this to True.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.supported_data_uri_images"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.supported_data_uri_images"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "supported_data_uri_images"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "bool"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "True"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "If set to False, Sphinx will attempt to convert data URIs to image files.\\nBrowsers support data URIs, so we set this to True."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.supported_image_types\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.supported_image_types\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Indicate images that are supported by the builder\\\\u2019s output format, so\\\\nthat Sphinx will not attempt to convert them.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.supported_image_types"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.supported_image_types"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "supported_image_types"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "list"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "["}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "]"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "[]"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Indicate images that are supported by the builder\\u2019s output format, so\\nthat Sphinx will not attempt to convert them."}]}, {"type": "paragraph", "children": [{"type": "text", "value": "Since we are generating JavaScript source code, resources are handled by\\nthe downstream bundler and loaders, we use an empty list to indicate we\\nsupport all images."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.supported_remote_images\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.supported_remote_images\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"If set to False, Sphinx will attempt to download remote images. We are\\\\nbuilding web apps so this is necessarily True.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.supported_remote_images"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.supported_remote_images"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "supported_remote_images"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "bool"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "True"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "If set to False, Sphinx will attempt to download remote images. We are\\nbuilding web apps so this is necessarily True."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.use_message_catalog\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.use_message_catalog\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.use_message_catalog"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.use_message_catalog"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "use_message_catalog"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "True"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.versioning_compare\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.versioning_compare\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.versioning_compare"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.versioning_compare"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "versioning_compare"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "False"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.versioning_method\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.versioning_method\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"app\\", \\"env\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.versioning_method"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.versioning_method"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "versioning_method"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "\'none\'"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.write_buildinfo\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.write_buildinfo\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.write_buildinfo"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.write_buildinfo"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "write_buildinfo"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.write_doc\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.write_doc\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"docname\\", \\"doctree\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Write the output file for the document\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.write_doc"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.write_doc"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "write_doc"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "docname"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "str"}]}]}, {"type": "text", "value": ", "}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "doctree"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "document"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.ReturnType", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\\\u2192 \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Write the output file for the document"}]}, {"type": "mdxJsxFlowElement", "name": "FieldList", "attributes": [], "children": [{"type": "mdxJsxFlowElement", "name": "dl", "attributes": [], "children": [{"type": "mdxJsxFlowElement", "name": "dt", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "field-name"}], "children": [{"type": "text", "value": "Parameters"}]}, {"type": "mdxJsxFlowElement", "name": "dd", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "field-body"}], "children": [{"type": "list", "start": null, "spread": false, "ordered": false, "children": [{"type": "listItem", "spread": false, "children": [{"type": "paragraph", "children": [{"type": "mdxJsxTextElement", "name": "Outline.ParameterTarget", "attributes": [], "children": [{"type": "text", "value": "docname"}]}, {"type": "text", "value": " \\u2013 "}, {"type": "text", "value": "the "}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "docname"}]}, {"type": "text", "value": "."}]}]}, {"type": "listItem", "spread": false, "children": [{"type": "paragraph", "children": [{"type": "mdxJsxTextElement", "name": "Outline.ParameterTarget", "attributes": [], "children": [{"type": "text", "value": "doctree"}]}, {"type": "text", "value": " \\u2013 "}, {"type": "text", "value": "defines the content to be written."}]}]}]}]}]}]}, {"type": "paragraph", "children": [{"type": "text", "value": "The output filename must be determined within this method,\\ntypically by calling "}, {"type": "inlineCode", "value": "get_target_uri()"}, {"type": "text", "value": "\\nor "}, {"type": "inlineCode", "value": "get_relative_uri()"}, {"type": "text", "value": "."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.write_documents\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.write_documents\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"docnames\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Write all documents in docnames.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.write_documents"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.write_documents"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "write_documents"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "docnames"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Write all documents in "}, {"type": "mdxJsxTextElement", "name": "em", "attributes": [], "children": [{"type": "text", "value": "docnames"}]}, {"type": "text", "value": "."}]}, {"type": "paragraph", "children": [{"type": "text", "value": "This method can be overridden if a builder does not create\\noutput files for each document."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "method"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.MdxBuilder.write_manifest\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"MdxBuilder.write_manifest\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Cleanup any resources.\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "MdxBuilder.write_manifest"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.MdxBuilder.write_manifest"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "write_manifest"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "class"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "class"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.Prefix", "attributes": [], "children": [{"type": "text", "value": "secretflow_doctools.builder."}]}, {"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "PageMetadata"}]}, {"type": "mdxJsxTextElement", "name": "Outline.ParameterList", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "("}]}, {"type": "mdxJsxTextElement", "name": "Outline.Parameter", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "**"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "data"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [{"type": "mdxJsxAttribute", "name": "className", "value": "name"}], "children": [{"type": "text", "value": "Any"}]}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ")"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.git_download_url\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.git_download_url\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.git_download_url"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.git_download_url"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "git_download_url"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.git_last_modified_commit\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.git_last_modified_commit\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.git_last_modified_commit"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.git_last_modified_commit"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "git_last_modified_commit"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.git_last_modified_time\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.git_last_modified_time\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.git_last_modified_time"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.git_last_modified_time"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "git_last_modified_time"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.git_origin_url\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.git_origin_url\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.git_origin_url"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.git_origin_url"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "git_origin_url"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.git_owner\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.git_owner\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.git_owner"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.git_owner"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "git_owner"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.git_repo\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.git_repo\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.git_repo"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.git_repo"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "git_repo"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.git_revision_commit\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.git_revision_commit\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.git_revision_commit"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.git_revision_commit"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "git_revision_commit"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.git_revision_time\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.git_revision_time\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.git_revision_time"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.git_revision_time"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "git_revision_time"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "str"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "|"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "None"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.model_config\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.model_config\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.model_config"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.model_config"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "model_config"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "ClassVar"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "["}]}, {"type": "text", "value": "ConfigDict"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "]"}]}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "="}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "{}"}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": [{"type": "paragraph", "children": [{"type": "text", "value": "Configuration for the model, should be a dictionary conforming to ["}, {"type": "mdxJsxTextElement", "name": "cite", "attributes": [], "children": [{"type": "text", "value": "ConfigDict"}]}, {"type": "text", "value": "][pydantic.config.ConfigDict]."}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline", "attributes": [{"type": "mdxJsxAttribute", "name": "domain", "value": "py"}, {"type": "mdxJsxAttribute", "name": "objectType", "value": "attribute"}, {"type": "mdxJsxAttribute", "name": "target", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder.PageMetadata.page_dependencies\\""}}, {"type": "mdxJsxAttribute", "name": "module", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"secretflow_doctools.builder\\""}}, {"type": "mdxJsxAttribute", "name": "fullname", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"PageMetadata.page_dependencies\\""}}, {"type": "mdxJsxAttribute", "name": "parameters", "value": {"type": "mdxJsxAttributeValueExpression", "value": "[\\"data\\"]"}}, {"type": "mdxJsxAttribute", "name": "description", "value": {"type": "mdxJsxAttributeValueExpression", "value": "\\"Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].\\""}}], "children": [{"type": "mdxJsxFlowElement", "name": "Outline.Signature", "attributes": [{"type": "mdxJsxAttribute", "name": "fullname", "value": "PageMetadata.page_dependencies"}, {"type": "mdxJsxAttribute", "name": "id", "value": "secretflow_doctools.builder.PageMetadata.page_dependencies"}], "children": [{"type": "mdxJsxTextElement", "name": "Outline.Name", "attributes": [], "children": [{"type": "text", "value": "page_dependencies"}]}, {"type": "mdxJsxTextElement", "name": "Outline.Keyword", "attributes": [], "children": [{"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": ":"}]}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "mdxTextExpression", "value": "\\" \\""}]}, {"type": "text", "value": "list"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "["}]}, {"type": "text", "value": "PageDependency"}, {"type": "mdxJsxTextElement", "name": "span", "attributes": [], "children": [{"type": "text", "value": "]"}]}]}]}, {"type": "mdxJsxFlowElement", "name": "Outline.Content", "attributes": [], "children": []}]}]}]}]}
"""

ast = json.loads(ast_str)

_session = Session()

res = _session.post("http://localhost:50361/markdown/stringify", json=ast)

logging.debug(f"{res.status_code=}")
logging.debug(f"{res.headers=}")
logging.debug(f"{res.text=}")

[tonywu6]

此外，在 ffi.py 中，在 83 行：

doctools/src/py/secretflow_doctools/markdown/ffi.py

Lines 83 to 86 in 3d6045a

	def find_free_port_with_race_condition():
	with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
	s.bind(("localhost", 0))
	return s.getsockname()[1]

工具在启动服务器时会尝试让系统分配空闲的端口号，因此在每次运行时端口都会不一样。目前一般会分配较高数位的端口。也请留意一下这些端口是否受限制，也可以尝试下修改该函数使之返回一个固定的、较低的端口号。

[Sneaker001333]

恩...我这边重新使用Python代码发送请求后回显200了，和curl发送请求的情况保持一致，但是在使用doctools工具全自动执行pnpm nx test得到的结果还是如下图所示

我试了下在tree_to_markdown函数开头添加time.sleep(5)等待5秒，让服务器完全启动服务后可以继续运行测试了。我猜测可能是服务器没有启动完毕，AST就发送给服务器，从而产生了503的结果。虽然接下来的测试过程仍然报了不少bug，如

 3) [chromium] › tests/specs/prod.ts:45:3 › /en/docs/spu/0.9.3b0/ ─────────────────────────────────

    Error: expect(Buffer).toMatchSnapshot(expected)

      93 pixels (ratio 0.01 of all image pixels) are different.

    Expected: /mnt/2t/doctools/tests/specs/snapshots/prod.ts/-en-docs-spu-0-9-3b0-chromium.png
    Received: /mnt/2t/doctools/test-results/prod.ts--en-docs-spu-0-9-3b0--chromium/-en-docs-spu-0-9-3b0-actual.png
        Diff: /mnt/2t/doctools/test-results/prod.ts--en-docs-spu-0-9-3b0--chromium/-en-docs-spu-0-9-3b0-diff.png


       at util/screenshot.ts:23

      21 |   test.info().attach(path, { body, contentType: "image/png" });
      22 |   if (shouldExpectScreenshot) {
    > 23 |     expect(body).toMatchSnapshot(path, screenshot);
         |                  ^
      24 |   } else {
      25 |     await alternative(elem);
      26 |   }
        at softScreenshot (/mnt/2t/doctools/tests/specs/util/screenshot.ts:23:18)
        at /mnt/2t/doctools/tests/specs/prod.ts:58:5

    attachment #1: -en-docs-spu-0-9-3b0-expected.png (image/png) ───────────────────────────────────
    tests/specs/snapshots/prod.ts/-en-docs-spu-0-9-3b0-chromium.png
    ────────────────────────────────────────────────────────────────────────────────────────────────

    attachment #2: -en-docs-spu-0-9-3b0-actual.png (image/png) ─────────────────────────────────────
    test-results/prod.ts--en-docs-spu-0-9-3b0--chromium/-en-docs-spu-0-9-3b0-actual.png
    ────────────────────────────────────────────────────────────────────────────────────────────────

    attachment #3: -en-docs-spu-0-9-3b0-diff.png (image/png) ───────────────────────────────────────
    test-results/prod.ts--en-docs-spu-0-9-3b0--chromium/-en-docs-spu-0-9-3b0-diff.png
    ────────────────────────────────────────────────────────────────────────────────────────────────

    attachment #5: screenshot (image/png) ──────────────────────────────────────────────────────────
    test-results/prod.ts--en-docs-spu-0-9-3b0--chromium/test-failed-1.png
    ────────────────────────────────────────────────────────────────────────────────────────────────

    Error Context: test-results/prod.ts--en-docs-spu-0-9-3b0--chromium/error-context.md

但是给服务器增加启动等待时间的处理方法在secretflow项目中生成doc时仍然不适用，还是报503。

[tonywu6]

测试包含浏览器截图测试，取决于操作系统及可用字体等环境因素，测试实际产生的截图与项目中保存的快照会存在像素差异，因此截图测试失败属于预期情况。

构建异常在 Docker ubuntu:22.04 以及最低配置的 GitHub Codespaces (Debian 12) 环境下均无法复现。除非有更进一步的日志或诊断信息，目前可以推断出的结论只能是“系统配置、环境或是性能不受工具支持”。

我目前已经不活跃于相关团队，因此没有办法提供更多的支持。如果想要继续解决这一缺陷，可以联系隐语团队的其他开发者。感谢理解！

(cc @Candicepan)

[Sneaker001333]

啊感谢您！我用您提到的两个环境试一试