Sphinx, literalinclude, linenos: Как отобразить фактические номера строк из файла исходного кода в фрагменте кода документа?

Question

Я использую Sphinx для документирования частей кода Javascript на веб-странице.

Я использую

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

Я получаю

Фрагмент кода взят из строк 47-51 фактического файла исходного кода, а не 1-5.

Как я могу отобразить фактические номера строк вместе с этим фрагментом кода?

Answer 1

Это было невозможно, когда вопрос задавался в 2011 году, но теперь есть функция lineno-start (добавлена ​​в Sphinx 1.3). Посмотрите этот запрос на улучшение: https://github.com/sphinx-doc/sphinx/issues/668.

Answer 2

Sphinx 1.3 будет иметь функцию lineno-start, доступную только для этой цели.