Edgewall Software

Opened 7 years ago

Last modified 4 years ago

#12835 closed task

Improve ReST export — at Version 8

Reported by: Ryan J Ollos Owned by: Ryan J Ollos
Priority: normal Milestone: 1.5.2
Component: general Version:
Severity: normal Keywords:
Cc: Branch:
Release Notes:
API Changes:
Internal Changes:

Description (last modified by Ryan J Ollos)

Copied from 11914#comment:22:


Remained issues:

  • `mod_python`_ and `CGI`_ don't work. Link and italic markups cannot be nested in ReST.
  • One of `trac- admin`_ doesn't work due to wrapped the link.
  • `SilverCity`_ doesn't work.
  • ` [trac] htdocs_location`_ doesn't work.
  • Some Title level inconsistent:// errors.

Also:

  • Links to anchors in the document direct back to wiki trac.edgewall.org

Using pypandoc rather than html2rest fixes some of the title level inconsistencies, and other markup problems. It also appears to be well-maintained, whereas html2rest hasn't been updated since 2012.

Change History (8)

comment:1 by Ryan J Ollos, 7 years ago

Description: modified (diff)

comment:2 by Ryan J Ollos, 7 years ago

Milestone: 1.0.151.0.16

comment:3 by Ryan J Ollos, 7 years ago

It appears that html2rest is inserting ZWSPs (r16171):

@@ -106,15 +79,15 @@ See `<U+200B>DatabaseBackend`_ for details.
 For the MySQL database
 ``````````````````````

-Trac works well with MySQL, provided you follow the guidelines:
+Trac works well with MySQL, provided you use the following:


 + `<U+200B>MySQL`_, version 5.0 or later
-+ `<U+200B>MySQLdb`_, version 1.2.2 or later
++ `<U+200B>PyMySQL`_


 Given the caveats and known issues surrounding MySQL, read carefully
-the `<U+200B>MySqlDb*`_ page before creating the database.
+the `<U+200B>MySqlDb`_ page before creating the database.


 Optional Dependencies

comment:4 by Ryan J Ollos, 7 years ago

Milestone: 1.0.161.3.3

comment:5 by Ryan J Ollos, 6 years ago

Milestone: 1.3.31.4

in reply to:  3 comment:6 by Ryan J Ollos, 5 years ago

Replying to Ryan J Ollos:

It appears that html2rest is inserting ZWSPs (r16171):

Or failing to strip them out, rather.

See also: comment:2:ticket:13177.

comment:7 by Ryan J Ollos, 5 years ago

Committed variant of comment:2:ticket:13177 patch in r17001, updated INSTALL.rst and UPGRADE.rst in r17002.

comment:8 by Ryan J Ollos, 5 years ago

Description: modified (diff)
Note: See TracTickets for help on using tickets.