Learn how easy it is to sync an existing GitHub or Google Code repo to a SourceForge project!

## docutils-develop — For developer discussions of the implementation.

You can subscribe to this list here.

2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 Jan Feb Mar Apr (5) May (27) Jun (22) Jul (72) Aug (82) Sep (86) Oct (138) Nov (100) Dec (62) Jan (122) Feb (147) Mar (92) Apr (82) May (101) Jun (153) Jul (37) Aug (34) Sep (46) Oct (46) Nov (6) Dec (38) Jan (64) Feb (81) Mar (36) Apr (194) May (329) Jun (272) Jul (68) Aug (74) Sep (150) Oct (57) Nov (62) Dec (63) Jan (78) Feb (30) Mar (137) Apr (78) May (54) Jun (122) Jul (72) Aug (110) Sep (80) Oct (75) Nov (125) Dec (79) Jan (100) Feb (15) Mar (41) Apr (67) May (30) Jun (11) Jul (14) Aug (22) Sep (20) Oct (14) Nov (11) Dec (15) Jan (17) Feb (16) Mar (35) Apr (21) May (33) Jun (50) Jul (12) Aug (7) Sep (2) Oct (6) Nov (5) Dec (2) Jan (14) Feb (20) Mar (35) Apr (9) May (57) Jun (21) Jul (42) Aug (4) Sep (13) Oct (76) Nov (40) Dec (55) Jan (26) Feb (15) Mar (3) Apr (67) May (32) Jun (39) Jul (59) Aug (31) Sep (59) Oct (64) Nov (21) Dec (10) Jan (21) Feb (3) Mar (116) Apr (33) May (6) Jun (28) Jul (21) Aug (23) Sep (146) Oct (70) Nov (31) Dec (57) Jan (33) Feb (22) Mar (11) Apr (21) May (51) Jun (47) Jul (35) Aug (26) Sep (25) Oct (34) Nov (61) Dec (51) Jan (75) Feb (31) Mar (26) Apr (16) May (24) Jun (24) Jul (31) Aug (46) Sep (36) Oct (28) Nov (37) Dec (21) Jan (16) Feb (56) Mar (31) Apr (44) May (45) Jun (29) Jul (38) Aug (18) Sep (12) Oct (16) Nov (21) Dec (11) Jan (13) Feb (14) Mar (28) Apr (7) May (72) Jun (33) Jul (21) Aug (1) Sep (6) Oct (14) Nov (18) Dec (22) Jan (23) Feb (108) Mar (76) Apr (100) May Jun Jul Aug Sep Oct Nov Dec
S M T W T F S

1
(3)
2
(3)
3

4

5
(1)
6

7

8
(3)
9
(2)
10
(2)
11
(3)
12

13

14
(1)
15
(2)
16
(4)
17
(1)
18
(1)
19

20
(1)
21

22

23

24

25

26

27

28
(1)
29

30

31

Showing results of 28

1 2 > >> (Page 1 of 2)
 [Docutils-develop] Custom bullet symbol? From: Boris Kheyfets - 2012-10-28 17:38:11 Attachments: Message as HTML How do I use custom bullet char? Is there a way I can give a bullet list a class -- so to assign "–" char as a bullet char for a given list (and have the default bullets in other lists)? I need it to cite dialogs: -- The next time I tell You that I saw something -- You believe me! -- Oh, relax -- now that we saw Dracula, the Wolfman and a Monster -- there's nobody to fright us anymore. *(and the Invisible man in the rostrum -- lights a cigar)* But there's no list directive -- so I could not assign it a class, and customize list through a css. Boris.
 [Docutils-develop] [ docutils-Bugs-3578709 ] rst2latex uses quote environment for literal blocks From: SourceForge.net - 2012-10-20 14:11:32 Bugs item #3578709, was opened at 2012-10-20 07:11 Message generated for change (Tracker Item Submitted) made by aisaac0 You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=422030&aid=3578709&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: Alan (aisaac0) Assigned to: Nobody/Anonymous (nobody) Summary: rst2latex uses quote environment for literal blocks Initial Comment: The rst2latex writer places literal blocks in a quote environment. This abuse of the quote environment means that quotes cannot be styled without affecting literal blocks, which is clearly a bug in the writer. Proposed solution: wrap literal blocks in a custom environment. Comment: the reason literal blocks are wrapped in the quote environment is simply to force indentation of literal blocks. **Separately** from this bug, I would urge the developers to rethink this decision and leave it up to users. Forcing indentation introduces many problems. E.g., as a result of this imposition, the rst2beamer writer output is horrible when literal blocks are included. Although I have proposed a solution above that allows continuation of the current practice, I believe that a better solution is not to wrap literal blocks in an extra environment, and leave indentation decisions up to users. (Who can e.g. set the indentation of the listings environment.) ---------------------------------------------------------------------- You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=422030&aid=3578709&group_id=38414
 Re: [Docutils-develop] Configuring MathJax URL From: Guenter Milde - 2012-10-18 11:19:17 On 2012-10-16, Dmitry Shachnev wrote: > Guenter Milde users.sf.net> writes: >> > You are right, it is not as bad as I thought of it. But handling some common >> > things such as \sum_{…}^{…} or \int_{…}^{…} is still broken… >> Could you elaborate? The example file >> docutils/test/functional/expected/math_output_html.html >> shows that some tweaking of the size of the sum/integral sign and the >> indices is required (is is reasonably well inside the fraction in the >> "modulation transfer function"). > Well, compare > http://mandriver.users.sourceforge.net/files/retext-math-html.png and > http://mandriver.users.sourceforge.net/files/retext-math-mathjax.png … Comparing this I can just re-state the comments above - I would not call this "broken" but suboptimal. >> Display of math-output=html requires math fonts, which should become a >> suggestion of the Debian python-docutils package... > Which package are those fonts in? I do have fonts-stix installed, > but it seems that's not what you mean. > I can't find any special fonts mentions in the CSS file either. Sorry for not beeing clear: with "math font" in this context I mean a Unicode-encoded font that contains the required mathematical symbols. Some examples are Asana-Math, STIX, DejaVu (to a large extend), Cambria or the Mathematica fonts. Günter
 [Docutils-develop] [ docutils-Feature Requests-3577850 ] adding pygments options to code directive From: SourceForge.net - 2012-10-17 15:29:44 Feature Requests item #3577850, was opened at 2012-10-17 08:29 Message generated for change (Tracker Item Submitted) made by You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=422033&aid=3577850&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: rndblnch () Assigned to: Nobody/Anonymous (nobody) Summary: adding pygments options to code directive Initial Comment: some pygments lexers support options (notably the pycon lexer supports a python3 flag that enables python3 support). the attached patch propose to support passing options to pygments using this syntax: .. code:: pycon :pygments-options: python3 >>> print("coucou") coucou remark: the attached patch supports a list of key[=value] as pygments-options content, but values can not be lists, which would be needed to support all pygments lexer options. ---------------------------------------------------------------------- You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=422033&aid=3577850&group_id=38414
 Re: [Docutils-develop] Configuring MathJax URL From: Dmitry Shachnev - 2012-10-16 17:31:03 Guenter Milde users.sf.net> writes: > > You are right, it is not as bad as I thought of it. But handling some common > > things such as \sum_{…}^{…} or \int_{…}^{…} is still broken… > > Could you elaborate? The example file > docutils/test/functional/expected/math_output_html.html > shows that some tweaking of the size of the sum/integral sign and the > indices is required (is is reasonably well inside the fraction in the > "modulation transfer function"). Well, compare http://mandriver.users.sourceforge.net/files/retext-math-html.png and http://mandriver.users.sourceforge.net/files/retext-math-mathjax.png … > Display of math-output=html requires math fonts, which should become a > suggestion of the Debian python-docutils package... Which package are those fonts in? I do have fonts-stix installed, but it seems that's not what you mean. I can't find any special fonts mentions in the CSS file either. -- Dmitry Shachnev
 Re: [Docutils-develop] Developing a true WYSIWYG rst editor From: Silas Silva - 2012-10-16 12:25:05 Hi Gunter, On Tue, Oct 16, 2012 at 07:57:04AM +0000, Guenter Milde wrote: > Did you try the (seemingly abandoned) DocFactory in the sandbox? > (I never did, so I cannot tell whether it is "true enough".) DocFactory is not yet what I thought about. It a "IDE" for reStructuredText that render simultaneously at the really same screen. > Thanks for you offer. As the interaction between Docutils and the future > editor is limited to a quite cleanly defined interface (the rst source and > program calls) it might be simpler to run the development either > independent or as a parallel project__. > > __ http://docutils.sourceforge.net/docs/dev/policies.html#parallel-projects > > > You may start this as a sandbox project__ or using some independent > host, whatever better suits your needs. Once it is set up, we can add a > link in the Docutils link list. > In any way, I'd appreciate to keep contact via the docutils-devel mail list. > > Thanks a lot, Thank YOU for the answer and such a great project. I'll try it in a separated project and repository and keep contact by here (the docutils-devel list). I'm studying docutils code and soon will have some questions and/or enhancement proposals (specially for the documentation in website). Thank you again. -- Silas Silva
 Re: [Docutils-develop] Nested parsing of inline markup From: Guenter Milde - 2012-10-16 08:18:14 On 2012-10-11, Marcin Szamotulski wrote: > I would like to ask what is the status of the nested parsing of inline > markup in docutils. The nesting branch in svn repository is quite old > (last commit in Feb 2006). Was this abandoned by a reason? I would be > interested in getting this work. This would allow for both html and > latex writers of Sphinx to produce better quality stuff. Also since > latex allow for nested commands like > \macro_1{\macro_2{ ... }} > it would be nice to have nested roles: > :role1: :role2: ...  Nested inline markup is, still a pending task. Besides the old branch, there is also a set of (outdated) patches at the docutils tracker. However, there is unfortunately no developer with the time and expertise to take up the ends and implement this in a clean and compatible way :-( This means you still have to rely on custom roles for cases like:: .. role:: macro_1 .. role:: macro_2 :class: macro_1 macro2 Emulate :macro_2:nesting. resulting in ::

Emulate nesting.

or :: Emulate \DUrole{macro-1}{\DUrole{macro2}{nesting}}. with Docutils rst2html and rst2latex respectively. (The Sphinx LaTeX output may differ, because Sphinx uses a quite old fork of the LaTeX writer that is missing many fixes and additions.) You can inherit standard roles like:: .. role:: special-sub(sub) resulting in

this is a special subscript.

or this is a \textsubscript{\DUrole{special-sub}{special subscript}}. with Docutils rst2html and rst2latex respectively. Günter
 Re: [Docutils-develop] Developing a true WYSIWYG rst editor From: Guenter Milde - 2012-10-16 07:57:31 Dear Silas, On 2012-10-11, Silas Silva wrote: > But I needed a WYSIWYG editor. Why? Some would argue: "Oh, but rst is > already WYSIWYG and how simple it is!". Yes, you are right. The > problem is that some people just don't understand simple plain text. > I'm working in a department where people make documentation and are used > to MS Word and other rich text processors. We needed a format to > document a lot of things on, but it should have to be easily convertible > to HTML, XML, PDF and other formats. We chose DocBook (argh!), mainly > because there are (buggy) text processors that users like to use. Of course there cannot be a full what-you-see-is-what-you-get editor for all this formats, as what-you-get depends on the output format, but I assume you are aware of this and use WYSIWYG meaning "rich text editor" (or what LyX_ calls WYSIWYM). .. _LyX: http://www.lyx.org > I've looked for a true WYSIWYG editor for rst and, the closest thing I > got was dual panel editors, where you type rst in one side and it > renders another. Did you try the (seemingly abandoned) DocFactory in the sandbox? (I never did, so I cannot tell whether it is "true enough".) > So, since I'd really *love* to switch from DocBook to reStructuredText, > I'm here to offer my work for this team. Although I'm a reasonable > experienced programmer with C, C++, Tcl and /bin/sh languages, I'm not > used to Python, but after reading the first chapters of Dive Into Python > and something about PyGTK, I'm pretty secure of starting up this idea. > The question is: > If you are interesting in this: > I'll follow docutils developers instructions and get in touch > frequently with you about how to develop it, what libraries use, > etc. The project could eventually be merged to docutils tree. > Else > I'll start a independent project and chose alone what widgets and > architecture to use (WebKit vs. GTK TextBuffer is my dilemma > nowadays). Thanks for you offer. As the interaction between Docutils and the future editor is limited to a quite cleanly defined interface (the rst source and program calls) it might be simpler to run the development either independent or as a parallel project__. __ http://docutils.sourceforge.net/docs/dev/policies.html#parallel-projects You may start this as a sandbox project__ or using some independent host, whatever better suits your needs. Once it is set up, we can add a link in the Docutils link list. In any way, I'd appreciate to keep contact via the docutils-devel mail list. Thanks a lot, Günter
 Re: [Docutils-develop] Configuring MathJax URL From: Guenter Milde - 2012-10-15 12:21:32 On 2012-10-15, Dmitry Shachnev wrote: > Guenter Milde users.sf.net> writes: >> HTML+CSS supports 90% of the LaTeX-Math MathJax supports (but without >> specials like downloading web-fonts etc.) >> HTML+CSS works out of the box everywhere -- also without internet connection >> or a local MathJax installation. >> HTML+CSS does not need JavaScript - so you can keep safe browser settings. >> HTML+CSS does not download scripts from somewhere over the net - which the >> abovementioned Debian bug calls a grave security breach. >> Günter > You are right, it is not as bad as I thought of it. But handling some common > things such as \sum_{…}^{…} or \int_{…}^{…} is still broken… Could you elaborate? The example file docutils/test/functional/expected/math_output_html.html shows that some tweaking of the size of the sum/integral sign and the indices is required (is is reasonably well inside the fraction in the "modulation transfer function"). Display of math-output=html requires math fonts, which should become a suggestion of the Debian python-docutils package... > Also, the CSS file isn't installed during setup.py build+install. It's also > missing from the Debian package. You may want to apply this: > --- a/docutils/setup.py > +++ b/docutils/setup.py > @@ -147,6 +147,7 @@ what-you-see-is-what-you-get plaintext markup syntax.""", # > wrap at col 60 > glob.glob('docutils/parsers/rst/include/*.txt')), > ('docutils/writers/html4css1', > ['docutils/writers/html4css1/html4css1.css', > + 'docutils/writers/html4css1/math.css', > 'docutils/writers/html4css1/template.txt']), > ('docutils/writers/latex2e', > ['docutils/writers/latex2e/default.tex', Done, thanks for the patch. Günter
 Re: [Docutils-develop] Configuring MathJax URL From: Dmitry Shachnev - 2012-10-15 08:45:43 Guenter Milde users.sf.net> writes: > HTML+CSS supports 90% of the LaTeX-Math MathJax supports (but without > specials like downloading web-fonts etc.) > > HTML+CSS works out of the box everywhere -- also without internet connection > or a local MathJax installation. > > HTML+CSS does not need JavaScript - so you can keep safe browser settings. > > HTML+CSS does not download scripts from somewhere over the net - which the > abovementioned Debian bug calls a grave security breach. > > Günter You are right, it is not as bad as I thought of it. But handling some common things such as \sum_{…}^{…} or \int_{…}^{…} is still broken… Also, the CSS file isn't installed during setup.py build+install. It's also missing from the Debian package. You may want to apply this: --- a/docutils/setup.py +++ b/docutils/setup.py @@ -147,6 +147,7 @@ what-you-see-is-what-you-get plaintext markup syntax.""", # wrap at col 60 glob.glob('docutils/parsers/rst/include/*.txt')), ('docutils/writers/html4css1', ['docutils/writers/html4css1/html4css1.css', + 'docutils/writers/html4css1/math.css', 'docutils/writers/html4css1/template.txt']), ('docutils/writers/latex2e', ['docutils/writers/latex2e/default.tex', Cheers, -- Dmitry Shachnev
 [Docutils-develop] [ docutils-Bugs-3573416 ] Change transscription of special german chars From: SourceForge.net - 2012-10-14 09:21:43 Bugs item #3573416, was opened at 2012-10-01 03:42 Message generated for change (Comment added) made by smerten You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=422030&aid=3573416&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: HTML writer Group: None >Status: Closed >Resolution: Rejected Priority: 5 Private: No Submitted By: Norman Jäckel (normanjaeckel) Assigned to: Nobody/Anonymous (nobody) Summary: Change transscription of special german chars Initial Comment: The function make_id() in nodes.py converts a string into an identifier. Therefor some non-ascii-chars were escaped or changed. In German the normal way to change umlauts and eszett is: ä -> ae; ö -> oe, ü -ue, ß -> ss. Docutils does ä -> a, ö -> o, ü -> u, ß -> sz, but this is wrong. The dict _non_id_translate_digraphs should be changed (0x00df: u'ss', # ligature sz/ss) and updated (0x00e4: u'ae', 0x00f6: u'oe', 0x00fc: u'ue'). ---------------------------------------------------------------------- >Comment By: Stefan Merten (smerten) Date: 2012-10-14 02:21 Message: Stability of ids in URLs is considered a feature. Regenerating a target document with the suggested logic would break this stability. Thus this request is rejected. See https://sourceforge.net/mailarchive/forum.php?thread_name=CABiJP%3DJzdcsGO6yDG79KkjZbXa3MyfV-eqr%3DvuQDVoWMK6v1-Q%40mail.gmail.com&forum_name=docutils-develop for more details. ---------------------------------------------------------------------- You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=422030&aid=3573416&group_id=38414
 [Docutils-develop] Developing a true WYSIWYG rst editor From: Silas Silva - 2012-10-11 17:30:40 Hello all guys, I'm user of docutils for years. Just love it. Have website, personal documentation etc. in reStructuredText. I even set the default filetype of my \$EDITOR to rst when editing plain text. But I needed a WYSIWYG editor. Why? Some would argue: "Oh, but rst is already WYSIWYG and how simple it is!". Yes, you are right. The problem is that some people just don't understand simple plain text. I'm working in a department where people make documentation and are used to MS Word and other rich text processors. We needed a format to document a lot of things on, but it should have to be easily convertible to HTML, XML, PDF and other formats. We chose DocBook (argh!), mainly because there are (buggy) text processors that users like to use. And, yes, those are that category of people that will call us crazy if we ask them to make their text 80 column wide or not to confuse tabs with spaces. I've looked for a true WYSIWYG editor for rst and, the closest thing I got was dual panel editors, where you type rst in one side and it renders another. So, since I'd really *love* to switch from DocBook to reStructuredText, I'm here to offer my work for this team. Although I'm a reasonable experienced programmer with C, C++, Tcl and /bin/sh languages, I'm not used to Python, but after reading the first chapters of Dive Into Python and something about PyGTK, I'm pretty secure of starting up this idea. The question is: If you are interesting in this: I'll follow docutils developers instructions and get in touch frequently with you about how to develop it, what libraries use, etc. The project could eventually be merged to docutils tree. Else I'll start a independent project and chose alone what widgets and architecture to use (WebKit vs. GTK TextBuffer is my dilemma nowadays). I will be happy with any answer. Just need to know in order to follow the respective development line. Thank you! -- Silas Silva
 [Docutils-develop] Nested parsing of inline markup From: Marcin Szamotulski - 2012-10-11 10:49:12 Hello, I would like to ask what is the status of the nested parsing of inline markup in docutils. The nesting branch in svn repository is quite old (last commit in Feb 2006). Was this abandoned by a reason? I would be interested in getting this work. This would allow for both html and latex writers of Sphinx to produce better quality stuff. Also since latex allow for nested commands like \macro_1{\macro_2{ ... }} it would be nice to have nested roles: :role1: :role2: ...  Best regards, Marcin Szamotulski
 Re: [Docutils-develop] Configuring MathJax URL From: Dmitry Shachnev - 2012-10-10 16:15:08 Guenter Milde users.sf.net> writes: > Thanks for the patch and sorry for taking so long. > > I have some problems with the patch as it is now: > > 1. I opt for whitespace as separator between keyword and mathjax-URL: > > 2. The configuration part of the URL (?config=TeX-AMS-MML_HTMLorMML) > should not be hardcoded but part of the configurable URL. (See the > mathjax homepage for the many options that users may want to specify.) > > 3. There should be a test case. Hi Guenter, I didn't receive your reply in time (did you CC me?), but I managed to find your reply in the list archives. Updated patches are now attached to the bug report. I am not sure if I've put the test case to a correct file (test/test_writers/test_html4css1_misc.py), so I've split it to a separate patch so that you could change it. > > See also http://bugs.debian.org/677929 for the corresponding bug report > > in Debian. > > My preference for solving this bug is changing the default math-output of > the html4css1 writer to HTML+CSS. My question how to handle the required > math.css style sheet still waits for a comment from co-developers. HTML+CSS supports 0% of what MathJax supports — doesn't it? — and I think we shouldn't break users who think "My formulas will work everywhere out of the box". > If noone responds, I may end up implementing automatic loading of the > stylesheet if there is math content with the option to add an alternative > stylesheet URL to the math-output option (similar to the mathjax-URL). +1 to this idea, though. -- Dmitry Shachnev
 [Docutils-develop] [ docutils-Bugs-3575838 ] Incorrect using identity instead equality From: SourceForge.net - 2012-10-09 21:55:42 Bugs item #3575838, was opened at 2012-10-09 14:55 Message generated for change (Tracker Item Submitted) made by storchaka You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=422030&aid=3575838&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: latex2e writer Group: None Status: Open Resolution: None Priority: 5 Private: No Submitted By: Serhiy Storchaka (storchaka) Assigned to: Nobody/Anonymous (nobody) Summary: Incorrect using identity instead equality Initial Comment: In writers/latex2e/__init__.py identity used instead equality. The result of this operation is implementation detail. As proposed on http://comments.gmane.org/gmane.comp.python.ideas/16547 such code even can be syntax error in future Python version. ---------------------------------------------------------------------- You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=422030&aid=3575838&group_id=38414
 Re: [Docutils-develop] write (buffer) error when writing to terminal python3 From: Guenter Milde - 2012-10-09 15:35:28 On 2012-10-08, Paul Tremblay wrote: > [-- Type: text/plain, Encoding: quoted-printable --] > Gives the same errors when using --encoding ascii; --encoding utf8; as > well as using rst2latex.py and rst2html.py I can reproduce this with python3 on Debian Gnu/Linux. Will have a look into the problem. Seems to be triggered by difference between output-encoding setting and encoding of sys.stdout. (Still the error message is misleading, something that I am not used to with Python...) Thanks for reporting. Günter
 Re: [Docutils-develop] [ docutils-Bugs-3573416 ] Change transscription of special german chars From: David Goodger - 2012-10-08 19:04:32 On Mon, Oct 8, 2012 at 4:37 AM, Stefan Merten wrote: > Hi! > > Last week (7 days ago) SourceForge net wrote: >> Bugs item #3573416, was opened at 2012-10-01 03:42 >> Message generated for change (Tracker Item Submitted) made by normanjaeckel >> You can respond by visiting: >> https://sourceforge.net/tracker/?func=detail&atid=422030&aid=3573416&group_id=38414 > [...] >> Initial Comment: >> The function make_id() in nodes.py converts a string into an >> identifier. Therefor some non-ascii-chars were escaped or changed. >> In German the normal way to change umlauts and eszett is: ä -> ae; ö >> -> oe, ü -ue, ß -> ss. Docutils does ä -> a, ö -> o, ü -> u, ß -> >> sz, but this is wrong. >> >> The dict _non_id_translate_digraphs should be changed (0x00df: >> u'ss', # ligature sz/ss) and updated (0x00e4: u'ae', 0x00f6: u'oe', >> 0x00fc: u'ue'). > > Well, I didn't look into this really. I understand that this > suggestion will change the way ids are generated for HTML. > > I think this is really a bad idea. I for one love to use deep links > into documents and for reStructuredText this means that I'm using the > ids generated for one document often in other documents. After all > that is what hypertext is all about. > > If you now change the way ids are generated then external deep links > break. This is particularly bad in scenarios where the target document > is likely to be regenerated - for instance because it is part of a > Plone site or a MoinMoin Wiki. > > Therefore I'd suggest to keep the id generation as is and refuse this > bug. Agreed. Also, languages don't all transcribe accents the same way. We shouldn't give preference to one language over others. -- David Goodger ;
 Re: [Docutils-develop] [ docutils-Bugs-3573416 ] Change transscription of special german chars From: Stefan Merten - 2012-10-08 17:48:43 Attachments: Message as HTML Hi! Last week (7 days ago) SourceForge net wrote: > Bugs item #3573416, was opened at 2012-10-01 03:42 > Message generated for change (Tracker Item Submitted) made by normanjaeckel > You can respond by visiting: > https://sourceforge.net/tracker/?func=detail&atid=422030&aid=3573416&group_id=38414 [...] > Initial Comment: > The function make_id() in nodes.py converts a string into an > identifier. Therefor some non-ascii-chars were escaped or changed. > In German the normal way to change umlauts and eszett is: ä -> ae; ö > -> oe, ü -ue, ß -> ss. Docutils does ä -> a, ö -> o, ü -> u, ß -> > sz, but this is wrong. > > The dict _non_id_translate_digraphs should be changed (0x00df: > u'ss', # ligature sz/ss) and updated (0x00e4: u'ae', 0x00f6: u'oe', > 0x00fc: u'ue'). Well, I didn't look into this really. I understand that this suggestion will change the way ids are generated for HTML. I think this is really a bad idea. I for one love to use deep links into documents and for reStructuredText this means that I'm using the ids generated for one document often in other documents. After all that is what hypertext is all about. If you now change the way ids are generated then external deep links break. This is particularly bad in scenarios where the target document is likely to be regenerated - for instance because it is part of a Plone site or a MoinMoin Wiki. Therefore I'd suggest to keep the id generation as is and refuse this bug. Grüße Stefan