docutils-users — General discussions, questions, help requests.

Re: [Docutils-users] Avoid writer sections for every heading (odt)

[Xavier P. <xpe...@gm...>]

Opps, apologizes, it's shown in the Help.


On 03/08/18 18:25, Xavier Pegenaute wrote:
> Dear,
>
> is there any way to do not create a section per ReST heading while 
> converting to ODT ?
>
> Regards,
>
> Xavi
>
>

[Docutils-users] Avoid writer sections for every heading (odt)

[Xavier P. <xpe...@gm...>]

Dear,

is there any way to do not create a section per ReST heading while 
converting to ODT ?

Regards,

Xavi

Re: [Docutils-users] Internationalization

[george b. <bo...@gm...>]

2018-08-03 18:04 GMT+03:00 David Goodger <go...@py...>:
> You can also inject language modules from your custom tool:
>
>     # appropriate imports here
>     docutils.parsers.rst.languages._languages[language_code] =
> input_language_module
>     docutils.languages._languages[language_code] = output_language_module

Thanks David, I really appreciate your reply. This will do it.

Re: [Docutils-users] Internationalization

[David G. <go...@py...>]

There are actually two places for language/translation modules: one
for input (docutils/parsers/rst/languages/) and one for output
(docutils/languages/). For this info and other background &
instructions, please read "Docutils Internationalization":
http://docutils.sourceforge.net/docs/howto/i18n.html

The easiest way to develop new language modules is in-situ. Just put
the new modules in the appropriate directories; edit and test them
from there. You can also inject language modules from your custom
tool::

    # appropriate imports here
    docutils.parsers.rst.languages._languages[language_code] =
input_language_module
    docutils.languages._languages[language_code] = output_language_module

When you have completed the new language modules, please send them in
and we'll add them to Docutils!

David Goodger
<https://david.goodger.org>


On Fri, 3 Aug 2018 at 05:23, george boukeas <bo...@gm...> wrote:
>
> Hello everyone.
>
> I hope you can help me with a question: I am writing a custom tool
> that parses reST in HTML and I need the output to be in a language
> that is not currently supported, i.e. it is not in docutils/languages.
> As far as I can tell from reading the code, docutils only checks in
> docutils/languages for translation files. There doesn't seem to be a
> way for me to specify that it should also check some local user
> directory for the appropriate <language>.py file.
>
> So, is there any way to accomplish this?
>
> Thank you very much.
>
> -- George Boukeas.

[Docutils-users] Internationalization

[george b. <bo...@gm...>]

Hello everyone.

I hope you can help me with a question: I am writing a custom tool
that parses reST in HTML and I need the output to be in a language
that is not currently supported, i.e. it is not in docutils/languages.
As far as I can tell from reading the code, docutils only checks in
docutils/languages for translation files. There doesn't seem to be a
way for me to specify that it should also check some local user
directory for the appropriate <language>.py file.

So, is there any way to accomplish this?

Thank you very much.

-- George Boukeas.

Re: [Docutils-users] emacs can't create index

[Stefan M. <st...@me...>]

Hi Ed!

Yesterday Ed Brunelle wrote:
> Anyway, I m back on emacs to edit my rst docs, thanks to a friend I
> discovered that I don't need really to have the TOC on the top of the
> screen.

That is what I thought all the time.

> I can use the C-t C-t to quick navigate to the entries, all i wanted
> the TOC is when I have the rst files exported as HTML, a python util
> called rst2htl
> puts automatically a TOC on the top of each HTML file.

Exactly. These are reasons why I consider this function superfluous.
May be I should remove it entirely.


						Grüße

						Stefan

Re: [Docutils-users] emacs can't create index

[Ed B. <edm...@gm...>]

Hi,

Guys, thank you for the help, I really appreciate it.

Well, as I read on the current online manual  (its just covers the v
1.4.1 I could not find anything newer than this)
(http://docutils.sourceforge.net/docs/user/emacs.html)
the command rst-toc-update
" will automatically update an inserted table of contents following a
.. contents:: directive laid out like the example above."

I assume then its a bug, or this is not working on emacs under
windows. as the rst-toc-update  -in my case- the toc produces
duplicate lines
on its entries, indeed it refreshes the TOC, but usually the last
entries of it are duplicated all the time. Stefan i will try to record
a session of my scree to email it to you/

Anyway, I m back on emacs to edit my rst docs, thanks to a friend I
discovered that I don't need really to have the TOC on the top of the
screen.
I can use the C-t C-t to quick navigate to the entries, all i wanted
the TOC is when I have the rst files exported as HTML, a python util
called rst2htl
puts automatically a TOC on the top of each HTML file.

kind regards

Ed

On Sun, 22 Jul 2018 at 14:19, Stefan Merten <st...@me...> wrote:
>
> Hi Ed!
>
> Yesterday Ed Brunelle wrote:
> > On doing more tests, I am sorry to say that the toc update function is
> > not working as supposed to be.
>
> So what is it supposed to work like? You seem to know it while I as
> the maintainer do not. May be you can help me out? I'd be grateful.
>
> There are a couple of other functions around tocs which IMHO are far
> more useful. For instance try C-c C-t C-t (rst-toc). That is what I am
> using all the time for navigating in a long document.
>
> > looks like emacs + rst == failure, I am shifting my work to vim , bit
> > PITA but rst works better now.
>
> AFAICS you tried one function. Indeed the one which I consider a PITA
> and from my point of view could be removed without anyone noticing.
>
> I'd say the rest of `rst.el` works like a charm and frankly through
> all the years I can't remember any such complaint.
>
>
>                                                 Grüße
>
>                                                 Stefan
>
> ------------------------------------------------------------------------------
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> _______________________________________________
> Docutils-users mailing list
> Doc...@li...
> https://lists.sourceforge.net/lists/listinfo/docutils-users
>
> Please use "Reply All" to reply to the list.

Re: [Docutils-users] emacs can't create index

[Stefan M. <st...@me...>]

Hi Ed!

Yesterday Ed Brunelle wrote:
> On doing more tests, I am sorry to say that the toc update function is
> not working as supposed to be.

So what is it supposed to work like? You seem to know it while I as
the maintainer do not. May be you can help me out? I'd be grateful.

There are a couple of other functions around tocs which IMHO are far
more useful. For instance try C-c C-t C-t (rst-toc). That is what I am
using all the time for navigating in a long document.

> looks like emacs + rst == failure, I am shifting my work to vim , bit
> PITA but rst works better now.

AFAICS you tried one function. Indeed the one which I consider a PITA
and from my point of view could be removed without anyone noticing.

I'd say the rest of `rst.el` works like a charm and frankly through
all the years I can't remember any such complaint.


						Grüße

						Stefan

Re: [Docutils-users] emacs can't create index

[Ed B. <edm...@gm...>]

Hi,

On doing more tests, I am sorry to say that the toc update function is
not working as supposed to be.
buggy in fact, recreates a toc under the old toc or just inserts new
entries into the toc.

looks like emacs + rst == failure, I am shifting my work to vim , bit
PITA but rst works better now.

best of luck

Ed

Re: [Docutils-users] emacs can't create index

[Stefan M. <st...@me...>]

Hi Ed!

3 hours ago Ed Brunelle wrote:
> I have the following test.rst :
> 
> list1
> -----
> 
> list2
> -----
> 
> list3
> -----

Thanks. I can reproduce the problem.

`rst-toc-insert` is somewhat picky in what it accepts. I do not use it
myself (and have not developed it myself) and doubt it's use. Thus I
did not do anything to make it more useful. I just removed a couple of
bugs ;-) .

In fact you have found something I call a mis-feature in my unit
tests for this function.

Please read the documentation of `rst-toc-insert` carefully:

  Insert the table of contents of the current section at the current column.
  By default the top level is ignored if there is only one, because
  we assume that the document will have a single title.

Your document has neither a title nor is the cursor in a section. Try
it with this example:

=====
TITLE
=====

list1
-----

list2
-----

list3
-----


Now in the line after the title `rst-toc-insert` works as documented.

However, the intended usage of this function is to use it at the point
marked by ``^@``:

=====
TITLE
=====

.. ^@

list1
-----

list2
-----

list3
-----


						Grüße

						Stefan

Re: [Docutils-users] emacs can't create index

[Ed B. <edm...@gm...>]

HI,


that's it!

Putting a title fixed it!!

Many thanks Stefan!


Ed


On 18 July 2018 at 17:57, Stefan Merten <st...@me...> wrote:

> Hi Ed!
>
> 3 hours ago Ed Brunelle wrote:
> > I have the following test.rst :
> >
> > list1
> > -----
> >
> > list2
> > -----
> >
> > list3
> > -----
>
> Thanks. I can reproduce the problem.
>
> `rst-toc-insert` is somewhat picky in what it accepts. I do not use it
> myself (and have not developed it myself) and doubt it's use. Thus I
> did not do anything to make it more useful. I just removed a couple of
> bugs ;-) .
>
> In fact you have found something I call a mis-feature in my unit
> tests for this function.
>
> Please read the documentation of `rst-toc-insert` carefully:
>
>   Insert the table of contents of the current section at the current
> column.
>   By default the top level is ignored if there is only one, because
>   we assume that the document will have a single title.
>
> Your document has neither a title nor is the cursor in a section. Try
> it with this example:
>
> =====
> TITLE
> =====
>
> list1
> -----
>
> list2
> -----
>
> list3
> -----
>
>
> Now in the line after the title `rst-toc-insert` works as documented.
>
> However, the intended usage of this function is to use it at the point
> marked by ``^@``:
>
> =====
> TITLE
> =====
>
> .. ^@
>
> list1
> -----
>
> list2
> -----
>
> list3
> -----
>
>
>                                                 Grüße
>
>                                                 Stefan
>

Re: [Docutils-users] emacs can't create index

[Ed B. <edm...@gm...>]

just to add:

I have the following test.rst :

list1
-----

list2
-----

list3
-----

when I perform a C-c C-t C-t, a new buffer opens "Table of Contents" that
displays the 'headers'
list1
list2
list3

so I assume the index function works, but there is no way to create ir on
the top of the screen
(cursor on the top left corner + C-c C-T TAB)


thanks

ed

Re: [Docutils-users] emacs can't create index

[Ed B. <edm...@gm...>]

Many thanks of the help guys.

rst version:

*Its value is "1.5.2"*

and the emacs i am running now:

*Its value is "26.1"*

No problem to share it on public anyway.




On 16 July 2018 at 20:12, Stefan Merten <st...@me...> wrote:

> Hi Ed!
>
> I'm the maintainer of rst.el which implements the reStructuredText
> support in Emacs.
>
> Yesterday Ed Brunelle wrote:
> > I am trying rst on emacs (both versions 25 and 27) on windows 8.1.
> > The rst-toc-insert command is not working, produces nothing.
> >
> > is this a feature only for emacs on linux/unix?
>
> No, this feature does not depend on the operating system in any way.
> In general the feature is supposed to work though I'm not using it
> myself.
>
> Can you please give me some details (private mail preferred)? Please
> give me the output of
>
>   C-h v rst-version
>
> and
>
>   C-h v emacs-version
>
> In addition a small example file would be useful and a description of
> what you are trying to do.
>
>
>                                                 Grüße
>
>                                                 Stefan
>
>

Re: [Docutils-users] emacs can't create index

[Ed B. <edm...@gm...>]

No error... just nothing on the screen

Even with a "M-x rst-toc-insert"

I am getting only :

You can run the command `rst-toc-insert` with C-c C-t TAB

On 17 July 2018 at 09:47, Matěj Cepl <mc...@ce...> wrote:

> On 2018-07-15, 09:38 GMT, Ed Brunelle wrote:
> > I am trying rst on emacs (both versions 25 and 27) on windows
> > 8.1. The rst-toc-insert command is not working, produces
> >   nothing.
>
> Don't you get some error message somewhere?
>
> Best,
>
> Matěj
> --
> https://matej.ceplovi.cz/blog/, Jabber: mc...@ce...
> GPG Finger: 3C76 A027 CA45 AD70 98B5  BC1D 7920 5802 880B C9D8
>
> Basically, the only “intuitive” interface is the nipple.  After
> that, it's all learned.
>     -- Bruce Ediger when discussing intuivity of Mac OS
>        http://groups.google.com/group/comp.sys.next.advocacy\
>        /msg/7fa8c580900353d0
>
>
> ------------------------------------------------------------
> ------------------
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> _______________________________________________
> Docutils-users mailing list
> Doc...@li...
> https://lists.sourceforge.net/lists/listinfo/docutils-users
>
> Please use "Reply All" to reply to the list.
>

Re: [Docutils-users] emacs can't create index

[Matěj C. <mc...@ce...>]

On 2018-07-15, 09:38 GMT, Ed Brunelle wrote:
> I am trying rst on emacs (both versions 25 and 27) on windows 
> 8.1. The rst-toc-insert command is not working, produces 
>   nothing.

Don't you get some error message somewhere?

Best,

Matěj
-- 
https://matej.ceplovi.cz/blog/, Jabber: mc...@ce...
GPG Finger: 3C76 A027 CA45 AD70 98B5  BC1D 7920 5802 880B C9D8
 
Basically, the only “intuitive” interface is the nipple.  After
that, it's all learned.
    -- Bruce Ediger when discussing intuivity of Mac OS
       http://groups.google.com/group/comp.sys.next.advocacy\
       /msg/7fa8c580900353d0

Re: [Docutils-users] emacs can't create index

[Stefan M. <st...@me...>]

Hi Ed!

I'm the maintainer of rst.el which implements the reStructuredText
support in Emacs.

Yesterday Ed Brunelle wrote:
> I am trying rst on emacs (both versions 25 and 27) on windows 8.1.
> The rst-toc-insert command is not working, produces nothing.
> 
> is this a feature only for emacs on linux/unix?

No, this feature does not depend on the operating system in any way.
In general the feature is supposed to work though I'm not using it
myself.

Can you please give me some details (private mail preferred)? Please
give me the output of

  C-h v rst-version

and

  C-h v emacs-version

In addition a small example file would be useful and a description of
what you are trying to do.


						Grüße

						Stefan

[Docutils-users] emacs can't create index

[Ed B. <edm...@gm...>]

Hi,

I am trying rst on emacs (both versions 25 and 27) on windows 8.1.
The rst-toc-insert command is not working, produces nothing.

is this a feature only for emacs on linux/unix?

thank you in advance,

Ed

[Docutils-users] Website page on Directives missing (docutils.sourceforge.net)

[Ashim G. <ash...@gm...>]

Hello Docutils-users,

The documentation webpage about Directives_ seems to be missing.  It
has a filesize of 0 kb.

The page was available some time ago:
https://web.archive.org/web/20180521031733/http://docutils.sourceforge.net/docs/ref/rst/directives.html.
It is a valuable reference.

I'm not subscribed to this mailing list: just passing through.

Thank You for the great software.


.. _Directives: http://docutils.sourceforge.net/docs/ref/rst/directives.html

-- 
Regards,
Ashim Ghosh
:)

Re: [Docutils-users] installation issues with python3 + pipenv/pip from sourceforge SVN

[Guenter M. <mi...@us...>]

On 2018-06-09, Cédric Van Rompay wrote:
> Hi,

> In a previous email [1] I mentioned the following command to install
> docutils using pipenv from the sourceforge SVN repo:

>     pipenv install -e
> svn+https://svn.code.sf.net/p/docutils/code/trunk/docutils#egg=docutils

> Well actually it does not work. When I try to import docutils I get:

>     NameError: name 'StandardError' is not defined

> From a quick Google search this is an issue of Python 2 to Python 3
> conversion (I am using Python 3).

> Previously I was using pipenv and Python 3 but getting the code from
> the Pypi repos and had no such problem.

> My guess would be that pip (same problem if using pip instead of
> pipenv, here pipenv simply calls pip) runs the "setup.py" with the
> Python 2 runtime and not the Python 3 one. This would be a bit
> surprising though, as my pip explicitly uses Python 3:

>     $ pip --version
>     pip 10.0.1 from
> /home/cedric/.local/share/virtualenvs/docutils-from-sourceforge-UNMQpB5a/lib/python3.6/site-packages/pip
> (python 3.6)

> Any idea how to fix that ?

Unfortunately not. It seems to be a pip/pipenv problem rather than a
Docutils problem, though.

As a workaround, you may try to separate download and installation. 
Using the "traditional" install tools (as described in the documentation)
should work.

> Or alternatively, do you know when the Pypi repository will be updated
> to revision >=8217 ?

> [1]: https://sourceforge.net/p/docutils/mailman/docutils-users/thread/CAJKLPhz%2Bi3qfCXdD%3DKeC_0s7tJ%3D9x5nP8MDwnD-EJCTHkAetwg%40mail.gmail.com/#msg36338595

There are currently no plans for a new release as we have several bugfixes
in the pipeline waiting for approvement by David G.

Günter

Re: [Docutils-users] Problem when running ./buildhtml.py ../

[Guenter M. <mi...@us...>]

Dear Tongtong Shen,

Thank you for reporting the problem.

On 2018-06-25, Tongtong Shen wrote:
> Good afternoon!

> Thank you for your time.

> I encountered a problem when running 
> ./buildhtml.py ../
> with the "--traceback" output as the following:

...
> /// Processing directory: ../docs/ref/rst
...
>     ::: Processing: directives.txt
> Traceback (most recent call last):
...
>   File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 2833, in definition_list_item
>     termlist, messages = self.term(termline, lineno)
>   File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 2869, in term
>     classifier_node[0].rawsource = part
>   File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/nodes.py", line 569, in __getitem__
>     return self.children[key]
> IndexError: list index out of range

> Docutils version (0.15b.dev)
> Python version (2.7.15)
> My OS type & version: macOS High Sierra, Version 10.13.5 (17F77)
> Command line used: ./buildhtml.py ../

The problem seems to be solved with the (unpublished) changes in my local
setup (see the latest patches for bug 332
https://sourceforge.net/p/docutils/bugs/332/).

Unfortunately, I am waiting since January for an OK to commit.

Thanks again,

Günter

[Docutils-users] Problem when running ./buildhtml.py ../

[Tongtong S. <sh...@pu...>]

Good afternoon!

Thank you for your time.

I encountered a problem when running 
./buildhtml.py ../
with the "--traceback" output as the following:

/// Processing directory: ../
    ::: Processing: COPYING.txt
    ::: Processing: RELEASE-NOTES.txt
    ::: Processing: BUGS.txt
    ::: Processing: FAQ.txt
    ::: Processing: THANKS.txt
    ::: Processing: README.txt
    ::: Processing: HISTORY.txt
/// ...Skipping directory (pruned): ../tools
/// ...Skipping directory (pruned): ../test
/// ...Skipping directory (pruned): ../licenses
/// ...Skipping directory (pruned): ../docutils
/// Processing directory: ../docs
    ::: Processing: index.txt
/// Processing directory: ../docs/ref
    ::: Processing: doctree.txt
    ::: Processing: transforms.txt
/// Processing directory: ../docs/ref/rst
    ::: Processing: restructuredtext.txt
    ::: Processing: directives.txt
Traceback (most recent call last):
  File "./buildhtml.py", line 249, in <module>
    Builder().run()
  File "./buildhtml.py", line 197, in run
    self.visit(root, files, dirs)
  File "./buildhtml.py", line 220, in visit
    self.process_txt(directory, name)
  File "./buildhtml.py", line 242, in process_txt
    settings=settings)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/core.py", line 380, in publish_file
    enable_exit_status=enable_exit_status)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/core.py", line 664, in publish_programmatically
    output = pub.publish(enable_exit_status=enable_exit_status)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/core.py", line 217, in publish
    self.settings)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/readers/__init__.py", line 72, in read
    self.parse()
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/readers/__init__.py", line 78, in parse
    self.parser.parse(self.input, document)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/__init__.py", line 191, in parse
    self.statemachine.run(inputlines, document, inliner=self.inliner)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 171, in run
    input_source=document['source'])
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 3010, in text
    self.section(title.lstrip(), source, style, lineno + 1, messages)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 327, in section
    self.new_subsection(title, lineno, messages)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 395, in new_subsection
    node=section_node, match_titles=True)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 282, in nested_parse
    node=node, match_titles=match_titles)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 196, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 3010, in text
    self.section(title.lstrip(), source, style, lineno + 1, messages)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 327, in section
    self.new_subsection(title, lineno, messages)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 395, in new_subsection
    node=section_node, match_titles=True)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 282, in nested_parse
    node=node, match_titles=match_titles)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 196, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 2771, in underline
    self.section(title, source, style, lineno - 1, messages)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 327, in section
    self.new_subsection(title, lineno, messages)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 395, in new_subsection
    node=section_node, match_titles=True)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 282, in nested_parse
    node=node, match_titles=match_titles)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 196, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 2728, in indent
    blank_finish=blank_finish, blank_finish_state='Definition')
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 319, in nested_list_parse
    node=node, match_titles=match_titles)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 196, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 2910, in indent
    itemnode, blank_finish = self.definition_list_item(context)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 2833, in definition_list_item
    termlist, messages = self.term(termline, lineno)
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/parsers/rst/states.py", line 2869, in term
    classifier_node[0].rawsource = part
  File "/Users/shentongtong/Library/Python/2.7/lib/python/site-packages/docutils/nodes.py", line 569, in __getitem__
    return self.children[key]
IndexError: list index out of range

Docutils version (0.15b.dev)
Python version (2.7.15)
My OS type & version: macOS High Sierra, Version 10.13.5 (17F77)
Command line used: ./buildhtml.py ../

Thank you for your help!

Regards,
Tongtong.

[Docutils-users] HTML to reStructuredText

[Aleksandr S. <al...@go...>]

Hello!

I have a script that converts XHTML files produced by Sphinx epub 
builder back to reStructuredText.  If anyone is interested, I can 
publish the source.

The problem I had to solve is this: we have some documents in rST, and 
we've got to make a translation.  Unfortunately, CAT (Computer-assisted 
translation) tools do not play well with plain text files.  So I gave 
XHTML files to my translators, and I got back HTML files with most of 
the markup preserved.

The script parses an (X)HTML input to build a Docutils AST, and then 
runs a NodeVisitor to build rST text.  The script does not cover all of 
the Docutils nodes, but it works for me.

Best wishes,
alex.

[Docutils-users] installation issues with python3 + pipenv/pip from sourceforge SVN

[Cédric V. R. <ced...@gm...>]

Hi,

In a previous email [1] I mentioned the following command to install
docutils using pipenv from the sourceforge SVN repo:

    pipenv install -e
svn+https://svn.code.sf.net/p/docutils/code/trunk/docutils#egg=docutils

Well actually it does not work. When I try to import docutils I get:

    NameError: name 'StandardError' is not defined

>From a quick Google search this is an issue of Python 2 to Python 3
conversion (I am using Python 3).

Previously I was using pipenv and Python 3 but getting the code from
the Pypi repos and had no such problem.

My guess would be that pip (same problem if using pip instead of
pipenv, here pipenv simply calls pip) runs the "setup.py" with the
Python 2 runtime and not the Python 3 one. This would be a bit
surprising though, as my pip explicitly uses Python 3:

    $ pip --version
    pip 10.0.1 from
/home/cedric/.local/share/virtualenvs/docutils-from-sourceforge-UNMQpB5a/lib/python3.6/site-packages/pip
(python 3.6)

Any idea how to fix that ?

Or alternatively, do you know when the Pypi repository will be updated
to revision >=8217 ?

[1]: https://sourceforge.net/p/docutils/mailman/docutils-users/thread/CAJKLPhz%2Bi3qfCXdD%3DKeC_0s7tJ%3D9x5nP8MDwnD-EJCTHkAetwg%40mail.gmail.com/#msg36338595

Regards,

-- 
Cédric Van Rompay
+33631475604
cedricvanrompay.fr

[Docutils-users] quickstart guide SVN address outdated (HTTP 404)

[Cédric V. R. <ced...@gm...>]

Hi,

The quick start guide [1] gives the following address to get the latest version:

    http://docutils.svn.sourceforge.net/viewvc/docutils/trunk/docutils/?view=tar

This address leads to a HTTP 404 error.
It should be replaced with the following address:

    https://svn.code.sf.net/p/docutils/code/trunk/

By the way, I would suggest to add the instructions on how to install
docutils from the SVN repo using the new "pipenv" tool:

    $ pipenv install -e
svn+https://svn.code.sf.net/p/docutils/code/trunk/docutils#egg=docutils

Regards,

[1] http://docutils.sourceforge.net/README.html#quick-start

-- 
Cédric Van Rompay
+33631475604
cedricvanrompay.fr

Re: [Docutils-users] Removing docinfo in "body" part with html5 writer

[Guenter M. <mi...@us...>]

On 2018-05-26, Cédric Van Rompay wrote:
> Hi,

> When switching from "html" to "html5" writer, I got the following
> problem: the docinfo is now included in the "body" parts when using
> "publish_parts".

Fixed in rev. 8217
https://sourceforge.net/p/docutils/code/8217/

Thank you for reporting,

Günter