diff options
| author | wiemann <wiemann@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2005-08-17 18:11:50 +0000 |
|---|---|---|
| committer | wiemann <wiemann@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2005-08-17 18:11:50 +0000 |
| commit | 824690c22d79e37f313df4564ed1e2caed9f6fce (patch) | |
| tree | 71d085686e64eb9054d5d958c5fac313fb02d0fd /docutils/FAQ.txt | |
| parent | 187a158a093ac33fbb74f03bf9757d8e0c221690 (diff) | |
| download | docutils-824690c22d79e37f313df4564ed1e2caed9f6fce.tar.gz | |
added reference to link list in round-tripping FAQ entry
git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@3821 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Diffstat (limited to 'docutils/FAQ.txt')
| -rw-r--r-- | docutils/FAQ.txt | 23 |
1 files changed, 14 insertions, 9 deletions
diff --git a/docutils/FAQ.txt b/docutils/FAQ.txt index c1db00035..c3504e74a 100644 --- a/docutils/FAQ.txt +++ b/docutils/FAQ.txt @@ -361,20 +361,25 @@ If anyone knows of other/better solutions, please `let us know`_. Are there any tools for HTML/XML-to-reStructuredText? (Round-tripping) ----------------------------------------------------------------------- -People have tossed the idea around, but little if any actual work has -ever been done. There's no reason why reStructuredText should not be -round-trippable to/from XML; any technicalities which prevent -round-tripping would be considered bugs. Whitespace would not be -identical, but paragraphs shouldn't suffer. The tricky parts would be -the smaller details, like links and IDs and other bookkeeping. +People have tossed the idea around, and some implementations of +reStructuredText-generating tools can be found in the `Docutils Link +List`_. + +There's no reason why reStructuredText should not be round-trippable +to/from XML; any technicalities which prevent round-tripping would be +considered bugs. Whitespace would not be identical, but paragraphs +shouldn't suffer. The tricky parts would be the smaller details, like +links and IDs and other bookkeeping. For HTML, true round-tripping may not be possible. Even adding lots of extra "class" attributes may not be enough. A "simple HTML" to RST filter is possible -- for some definition of "simple HTML" -- but HTML is used as dumb formatting so much that such a filter may not be -particularly useful. No general-purpose filter exists. An 80/20 -approach should work though: build a tool that does 80% of the work -automatically, leaving the other 20% for manual tweaks. +particularly useful. An 80/20 approach should work though: build a +tool that does 80% of the work automatically, leaving the other 20% +for manual tweaks. + +.. _Docutils Link List: docs/user/links.html Are there any Wikis that use reStructuredText syntax? |
