Sphinx，literalinclude，linenos：如何在文件的文档代码片段上显示源代码文件的实际行号？

Question

我正在使用Sphinx来记录网页上的JavaScript代码部分。

我使用的是

.. literalinclude:: ../examples/mapviz-step1-simple.html
   :language: javascript
   :lines: 47-51
   :linenos:

我得到了：

代码片段来自实际源代码文件的47-51行，而不是1-5行。

如何显示此代码片段的实际行号？

- b_dev

Answer 1

2011年提问时还没有这个功能，但从Sphinx 1.3版本开始引入了lineno-start选项。请参见此增强请求：https://github.com/sphinx-doc/sphinx/issues/668。

当前文档:

• literalinclude
• code-block

- mzjn

Answer 2

Sphinx 1.3 将会拥有 lineno-start 特性，专门为此而设。

- anatoly techtonik