Directive seelaso ignored in the gettext generation

sphinx-doc / sphinx

The Sphinx documentation generator

https://www.sphinx-doc.org/

Other

6.23k stars 2.04k forks source link

Directive seelaso ignored in the gettext generation #960

Closed shimizukawa closed 9 years ago

shimizukawa commented 9 years ago

When I generate gettext translation, the //seealso// directive content is not retrieved althought is cousin directive note is retrieved.

For directive note: Pot file https://github.com/ThomasG77/docs/blob/branch-6-0-internationalization/translated/pot/documentation.pot#L24 and original rst https://github.com/ThomasG77/docs/blob/410ba7f19cfd0b4aaf891ad1e7155686996d8083/en/documentation.txt#L7
For directive seealso: The pot file https://github.com/ThomasG77/docs/blob/branch-6-0-internationalization/translated/pot/mapfile.pot is without string "for connection information" but original rst https://github.com/ThomasG77/docs/blob/410ba7f19cfd0b4aaf891ad1e7155686996d8083/en/mapfile/layer.txt#L138 have it

Bug or enhancement?

There is an alternative to this directive if I have to wait for the enhancement?

Bitbucket: https://bitbucket.org/birkenfeld/sphinx/issue/960
Originally reported by: ThomasG77
Originally created at: 2012-07-04T21:39:30.427

shimizukawa commented 9 years ago

From Robert Lehmann on 2012-11-07 11:17:41+00:00

Reproduced successfully; you can hotfix this by inserting a blank line between the directive line and the paragraph, as in:

:::restructuredtext
.. seealso::

   Description text

shimizukawa commented 9 years ago

From Robert Lehmann on 2012-11-07 11:19:40+00:00

seealso nodes are lacking the source attribute, which means we cannot attach any translatable text to them. This is not a problem with i18n per se but a problem in the implementation of the seealso directive. I will post a patch later.

shimizukawa commented 9 years ago

From Nozomu Kaneko on 2012-11-18 17:06:28+00:00

It seems that versionadded/versionchanged have the same problem. We have no chance to translate them.

shimizukawa commented 9 years ago

From Nozomu Kaneko on 2012-11-18 17:15:49+00:00

related issues?

issue #940 Extract figure caption in gettext .pot
issue #975 gettext does not extract definition terms
issue #976 Cannot translate index entries

shimizukawa commented 9 years ago

From Nozomu Kaneko on 2012-12-16 04:33:30+00:00

fixed on pull request #95

shimizukawa commented 9 years ago

From Takayuki Shimizukawa on 2012-12-25 02:52:00+00:00

Also pull request #99 has been proposed for another solution.

shimizukawa commented 9 years ago

From Georg Brandl on 2013-01-06 11:39:03+00:00

Closes #960: Convert seealso directive to ordinary admonition.

→ <>

shimizukawa commented 9 years ago

From Georg Brandl on 2014-10-18 07:33:11+00:00

Removing version: 1.1 (automated comment)