[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.