gpt4 book ai didi

pycharm - 在 Pycharm 中获取 Sphinx 以在生成的 html 中包含我的文档字符串

转载 作者:行者123 更新时间:2023-12-03 23:52:55 29 4
gpt4 key购买 nike

我有一个运行 3.7.2 Python 解释器的 Pycharm 项目,并且我配置了 Sphinx 以生成文档。我的项目具有以下结构:

/my_project/
/docs/
/src/
/modules/
/tools/

模块和工具中都有 python 模块,这些模块和工具都用文档字符串记录。我已将 Sphinx 配置为在/docs 中生成文档,但此文档只有一个基本的 index.rst。如何从我的文档字符串中获取 python 模块文档以填充到/docs 文件夹中?

最佳答案

也许您可以尝试以下方法:

  • 确保您尝试记录的模块具有 __init__.py文件,以便您以后可以根据需要导入它们。在您的情况下,您的 toolsmodules目录需要__init__.py文件。
  • 确保您记录的所有模块都已设置正确的sphinx注释:

  • 模块_1.py:
    """
    .. module:: module_1
    :platform: Unix, Windows
    :synopsis: A useful module indeed.
    """

    def public_fn_with_sphinxy_docstring(name, state=None):
    """This function does something.

    :param name: The name to use.
    :type name: str.
    :param state: Current state to be in.
    :type state: bool.
    :returns: int -- the return code.
    :raises: AttributeError, KeyError

    """
    return 0
  • 新建.rst文件,可能称为 code.rst ,其中包括您要记录的模块。然后引用这个新的.rst您的 index.rst 中的文件:

  • 代码.rst:
    Documentation for the Code
    **************************

    .. automodule:: an_example_pypi_project


    module #1 -- auto members
    =========================

    This is something I want to say that is not in the docstring.

    .. automodule:: an_example_pypi_project.module_1
    :members:

    index.rst:
    .. toctree::
    :maxdepth: 2
    :caption: Contents:

    # other rst files you're including in your sphinx docs

    code.rst

    这是一个非常好的解释和 tutorial如果你也想看看这个。希望这会有所帮助!

    关于pycharm - 在 Pycharm 中获取 Sphinx 以在生成的 html 中包含我的文档字符串,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/54771347/

    29 4 0
    Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
    广告合作:1813099741@qq.com 6ren.com