[Docutils-develop] [ docutils-Bugs-1830380 ] Replace with role :sup: does not work with language_code: fr

[SourceForge.net <no...@so...>]

Bugs item #1830380, was opened at 2007-11-12 12:01
Message generated for change (Tracker Item Submitted) made by Item Submitter
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=422030&aid=1830380&group_id=38414

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: None
Group: None
Status: Open
Resolution: None
Priority: 5
Private: No
Submitted By: lpezard (lpezard)
Assigned to: Nobody/Anonymous (nobody)
Summary: Replace with role :sup: does not work with language_code: fr

Initial Comment:
Here is my original posting to docutils-user mailing list and David Goodger reply:

My posting:
-----------

I've tried the following replacements:
 
     .. |Na+| replace:: Na\ :sup:`+`

     Le |Na+| est l'ion sodium.

     .. |K+| replace:: K\ :sup:`+`
 
     Le |K+| est l'ion potassium
 
every thing works fine if I leave the language_code to en, but obviously this is french so that I change my docutils.conf to language_code: fr and then I obtain the following error:

test.txt:5: (ERROR/3) Error in "replace" directive: may contain a single paragraph only.

test.txt:5: (WARNING/2) Substitution definition "Na+" empty or invalid.

 .. |Na+| replace:: Na\ :sup:`+`

test.txt:7: (ERROR/3) Undefined substitution referenced: "Na+".

It does not work for the first replacement |Na+| but works as expected for the second one |K+|. I must admit that I don't understand.

David Goodger's reply:
----------------------

I don't understand why the first replacement gives an error while the second one doesn't, either.  But I found the root cause: Docutils isn't finding the role "sup", because it expects the French "exp" or
"exposant".  If you're going to be using the French variant of Docutils, you should be using the French directive & role names too:

    .. |Na+| remplace:: Na\ :exp:`+`

    Le |Na+| est l'ion sodium.

    .. |K+| remplace:: K\ :exp:`+`

    Le |K+| est l'ion potassium

This works fine; no errors.  For a "dictionary" of equivalencies, see http://docutils.sourceforge.net/docutils/parsers/rst/languages/fr.py . I don't know if these are documented somewhere else (they ought to be).

I don't understand, yet, why there's an error at all.  There shouldn't be.  The English directive names & role names should be fallback defaults.  But I don't have time to solve it now.

Please file a bug on SourceForge so this doesn't get lost.  Please include: 

"A secondary bug is that an error in the "replace" directive isn't propagating through to the substitution definition error reporting."


----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=422030&aid=1830380&group_id=38414