Error messages from the rst3 plugin aren helpful. What can I do?
For the most part, docutils does a good job of reporting errors. docutils prints a message to the console and inserts an unmistakable error message in the generated .html file. Important: On Windows it is helpful to Run Leo from a console window. However, in some cases, docutils crashes instead of properly reporting the problem. There are several workarounds: • The crashes I have seen arise from the following bug in docutils. Hyperlinks in image:: markup must be lower case. This will work: .. |back| image:: arrow_lt.gif :target: faq_ This will crash: .. |back| image:: arrow_lt.gif :target: FAQ_ So avoid this crash by making sure to use lower case targets in :target: markup. • You can change the docutils source slightly so that it prints a traceback when it crashes. (The rst3 plugin should be able to do this, but I haven’t figured out how yet.) It’s easy enough to do this: • Find the file core.py in top-level docutils folder. Typically this folder will be in Python’s site-packages folde
