我用Python2.7编程，我使用beautifulsoup4从一系列文档的标签中提取信息。但是，文档中的字符串与以下字符串一样：
<!
浏览 3提问于2013-04-10得票数 1
在Python中，当注释函数时，您可以使用一种更容易自动生成文档的方式进行注释。他们将其称为文档字符串。
既然我已经在Groovy中创建了一个想要传递的抽象类，那么有没有一种标准的方式来注释它呢？有没有Groovy工具可以从代码注释中生成基本文档？
浏览 6提问于2014-10-03得票数 7
我完全搞不懂python中注释的用法……如果它是完全可选的，那么为什么我们在python中使用它呢？
浏览 2提问于2016-07-29得票数 0
在编写了包含文档注释的python脚本之后，是否可以将文档注释从多个脚本聚合到一些独立的文档文件中，比如自述文件？谢谢。
浏览 0提问于2015-03-19得票数 0
我希望尽可能准确地计算多文件Python项目中的代码行数，但不包括注释、文档字符串或空行。
我首先尝试使用cloc，它以Debian包的形式提供。但是cloc将大多数文档字符串视为代码-即使它们是注释。( Python：不再-最新版本的cloc现在将Python文档字符串视为注释。)我注意到下面的一些评论说文档字符串应该包括在总数中，因为它们可能被代码用来影响运行时的行为，因此被计入程序代码/数据/
浏览 115提问于2012-01-31得票数 21
回答已采纳
5回答
我喜欢Doxygen来创建C或PHP代码的文档。我有一个即将到来的Python项目，我想我记得Python没有/* .. */注释，而且还有自己的自我文档工具，这似乎是Python的文档编制方式。既然我熟悉Doxygen，那么我如何使用它来生成我的Python文档呢？有什么特别需要我注意的吗？
浏览 0提问于2008-09-12得票数 99
回答已采纳
2回答
是否可以自定义emacs，使python文档字符串以与注释相同的方式突出显示？以下是python文档字符串的示例 """
may be multiline
浏览 4提问于2016-02-24得票数 1
1回答
我想有一个可以从源代码注释生成文档的工具，我找到了一个叫pythondoc的工具，它可以从python源代码生成HTML或XML，但它不支持提取文档字符串，只支持附加‘#’注释，有没有工具可以支持文档字符串提取
浏览 0提问于2013-05-24得票数 0
回答已采纳
2回答
许多现代编程语言支持作为文档字符串的注释系统。在Python或Clojure等语言中，这种特性被认为是理所当然的，在这些语言中，文档字符串可能有助于理解函数的用途，而如果不是这样，则可能不清楚： ''' given我在D编程方面还相当初级，但还没有找到用于以客户机可以访问的方式编写文档字符串注释的文档(例如，help(gen_ast)中的Python)。D提供对文档
浏览 0提问于2016-11-19得票数 2
回答已采纳
有没有可以像这样运行的程序：其中orig.py包含带有注释和文档字符串的python源代码，而smaller.py包含相同的、可运行的源代码，但没有注释和文档字符串？最初看起来像这样的代码："""Do something"""
# Beware the fr
浏览 2提问于2009-10-26得票数 6
回答已采纳
我有一个现有的书面应用程序，API是以下列方式编写的：def hello():我想从这类API生成Swagger文档到目前为止，我尝试了很少的选项，但大多数选项都是从特定方法的docstring中的yml文件或yml字符串生成文档。
我想使用基于注释的方法。
浏览 2提问于2017-05-04得票数 4
我非常不清楚“操作符”->在创建函数时所做的事情。def create(self) -> None:或def to(self) -> Identifier:我尝试过搜索，但是我不知道“操作符”被调用了什么，或者它是否是一个操作符，并且在搜索时使用->并不真正有效：
浏览 4提问于2016-04-25得票数 4
回答已采纳
我在GitHub上有一个README.rst，它也被合并到一个Python项目的Sphinx生成的文档中。我想在文件的顶部添加一条注释，该注释将显示在GitHub上(它只是呈现.rst)，但不会显示在由Sphinx生成的文档中。我知道可以使用.. blah blah blah在.rst文件中包含注释，但是有没有什么方法可以包含只被Sphinx视为注释的行呢？(或者，让Sphinx忽略该行。)
浏览 0提问于2016-03-07得票数 3
我正在广泛地使用Sphinx进行文档编写，并且对它感到很舒服。
然而，我发现自己更多地是在做Javascript (前端)，而不是Python。是否有任何插件或方法可以使用Sphinx从JavaScript代码注释中执行与Python文档字符串类似的应用程序编程接口文档？
浏览 2提问于2012-09-16得票数 2
我为python函数定义创建了一个vscode片段，我想知道这是否是转义python块注释(“)的唯一和/或推荐的方法。全局片段文件 "def ": { "prefix": "def func","def $1 ():
\"\"\"\&quo
浏览 12提问于2022-01-02得票数 1
回答已采纳
扫码
添加站长 进交流群
领取专属 10元无门槛券
手把手带您无忧上云
相关资讯
热门标签
云服务器
ICP备案
对象存储
腾讯会议
实时音视频活动推荐
腾讯云开发者
