Sphinx、literalinclude、linenos:如何在文档代码片段上显示源代码文件中的实际行号?
我正在使用 Sphinx 来记录网页上的部分 Javascript 代码。
我使用
.. literalinclude:: ../examples/mapviz-step1-simple.html
:language: javascript
:lines: 47-51
:linenos:
我得到
代码片段来自实际源代码文件的第 47-51 行,而不是 1 -5。
如何显示实际的行号以及这段代码?
I am using Sphinx to document parts of Javascript code on a web page.
I use
.. literalinclude:: ../examples/mapviz-step1-simple.html
:language: javascript
:lines: 47-51
:linenos:
I get
The code snippet comes from lines 47-51 of the actual source code file, not 1-5.
How can I display the actual line numbers along with this snippet of code?
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论
评论(2)
当这个问题在 2011 年提出时,这是不可能的,但从 Sphinx 1.3 开始,就有了
lineno-start
选项。请参阅此增强请求:https://github.com/sphinx-doc/sphinx/issues /668。当前文档:
literalinclude
代码块
This was not possible when the question was asked in 2011, but since Sphinx 1.3 there is
lineno-start
option. See this enhancement request: https://github.com/sphinx-doc/sphinx/issues/668.Current documentation:
literalinclude
code-block
Sphinx 1.3 将会有
lineno-start
功能仅用于此目的。Sphinx 1.3 will have
lineno-start
feature available just for this purpose.