[docutils:bugs] #517 content_offset in directives inside grid/simple tables are off

Günter Milde via Docutils-develop <[email protected]> Wed, 31 Dec 2025 11:34:11 -0000
Newsgroups gmane.text.docutils.devel
Message-ID </p/docutils/bugs/517/44d022117eddd6752c6fd3dcc6016dbc4b1a2165.bugs@docutils.p.sourceforge.net>
This is a multi-part message in MIME format.
--===============8158635000281321507==
Content-Type: multipart/related; boundary="===============2066946765414853020=="

This is a multi-part message in MIME format.
--===============2066946765414853020==
Content-Type: multipart/alternative; boundary="===============0408530243329302244=="
MIME-Version: 1.0

--===============0408530243329302244==
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit

Thank you for the report.
Could you attach your test-directive, so that I can experiment and try a fix?


---

**[bugs:#517] content_offset in directives inside grid/simple tables are off**

**Status:** open
**Created:** Sat Dec 27, 2025 05:07 PM UTC by Felix Fontein
**Last Updated:** Sat Dec 27, 2025 05:07 PM UTC
**Owner:** nobody


When parsing a directive in a grid table or simple table, the directive's `content_offset` is off by one. (When nesting such a table in another such a table, it's off by one for every nesting level.)

For example, for the following code block directives, `content_offset` is always off from the real content line where the code block's content is in:

```rst
content_offset is off by 1:

+----------------------+
| .. code-block:: yaml |
|                      |
|    - foo             |
+----------------------+

content_offset is off by 2:

+------------------------+
|+----------------------+|
|| .. code-block:: yaml ||
||                      ||
||    - foo             ||
|+----------------------+|
+------------------------+

content_offset is off by 3:

+--------------------------+
|+------------------------+|
||+----------------------+||
||| .. code-block:: yaml |||
|||                      |||
|||    - foo             |||
||+----------------------+||
|+------------------------+|
+--------------------------+

content_offset is off by 1:

=====  =====
col 1  col 2
=====  =====
1      .. code-block:: yaml

          - foo
=====  =====

content_offset is off by 2:

=====  =====
col 1  col 2
=====  =====
1      =====  =====
       col 1  col 2
       =====  =====
       1      .. code-block:: yaml

                 - foo
       =====  =====
=====  =====
```

(I've noticed this when registering an own code block directive to find the actual location - row and column - of the code block's contents, to be able to give more precise error messages when linting.)


---

Sent from sourceforge.net because [email protected] is subscribed to https://sourceforge.net/p/docutils/bugs/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/bugs/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.
--===============0408530243329302244==
MIME-Version: 1.0
Content-Type: text/html; charset="us-ascii"
Content-Transfer-Encoding: 7bit

<div class="markdown_content"><p>Thank you for the report.<br/>
Could you attach your test-directive, so that I can experiment and try a fix?</p>
<hr/>
<p><strong><a class="alink" href="https://sourceforge.net/p/docutils/bugs/517/">[bugs:#517]</a> content_offset in directives inside grid/simple tables are off</strong></p>
<p><strong>Status:</strong> open<br/>
<strong>Created:</strong> Sat Dec 27, 2025 05:07 PM UTC by Felix Fontein<br/>
<strong>Last Updated:</strong> Sat Dec 27, 2025 05:07 PM UTC<br/>
<strong>Owner:</strong> nobody</p>
<p>When parsing a directive in a grid table or simple table, the directive's <code>content_offset</code> is off by one. (When nesting such a table in another such a table, it's off by one for every nesting level.)</p>
<p>For example, for the following code block directives, <code>content_offset</code> is always off from the real content line where the code block's content is in:</p>
<div class="codehilite"><pre><span></span><code>content_offset is off by 1:

+----------------------+
<span class="o">|</span> .. code-block:: yaml |
<span class="o">|</span>                      |
<span class="o">|</span>    - foo             |
+----------------------+

content_offset is off by 2:

+------------------------+
|+----------------------+|
|| .. code-block:: yaml ||
||                      ||
||    - foo             ||
|+----------------------+|
+------------------------+

content_offset is off by 3:

+--------------------------+
|+------------------------+|
||+----------------------+||
||| .. code-block:: yaml |||
|||                      |||
|||    - foo             |||
||+----------------------+||
|+------------------------+|
+--------------------------+

content_offset is off by 1:

=====  =====
col 1  col 2
=====  =====
1      .. code-block:: yaml

          <span class="m">-</span> foo
=====  =====

content_offset is off by 2:

=====  =====
col 1  col 2
=====  =====
1      =====  =====
       col 1  col 2
       =====  =====
       1      .. code-block:: yaml

                 <span class="m">-</span> foo
       =====  =====
=====  =====
</code></pre></div>

<p>(I've noticed this when registering an own code block directive to find the actual location - row and column - of the code block's contents, to be able to give more precise error messages when linting.)</p>
<hr/>
<p>Sent from sourceforge.net because [email protected] is subscribed to <a href="https://sourceforge.net/p/docutils/bugs/">https://sourceforge.net/p/docutils/bugs/</a></p>
<p>To unsubscribe from further messages, a project admin can change settings at <a href="https://sourceforge.net/p/docutils/admin/bugs/options.">https://sourceforge.net/p/docutils/admin/bugs/options.</a>  Or, if this is a mailing list, you can unsubscribe from the mailing list.</p></div>
--===============0408530243329302244==--

--===============2066946765414853020==--


--===============8158635000281321507==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline


--===============8158635000281321507==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline