README.adoc in reverse_asciidoctor-0.1.0 vs README.adoc in reverse_asciidoctor-0.2.0

- old
+ new

@@ -47,14 +47,16 @@ * `li`, `ol`, `ul` (added: `dir`) * `p`, `pre` * `strong`, `b` * `table`, `td`, `th`, `tr` -NOTE: +[NOTE] +==== * reverse_asciidoctor does *not* support `del` or `strike`, because Asciidoctor out of the box does not * As with reverse_markdown, `pre` is only treated as sourcecode if it is contained in a `div@class = highlight-` element, or has a `@brush` attribute naming the language (Confluence). * The gem does not support `p@align`, because Asciidoctor doesn't +==== In addition, it supports: * `aside` * `audio`, `video` (with `@src` attributes) @@ -124,23 +126,26 @@ ---- $ bin/reverse_asciidoctor file.html > file.adoc $ cat file.html | bin/reverse_asciidoctor > file.adoc ---- -In addition, the `bin/w2m` script ( -adapted from https://github.com/benbalter/word-to-markdown[Ben Balter's word-to-markdown]) -script extracts HTML from Word docx documents, and converts it to Asciidoc. +In addition, the `bin/w2a` script (adapted from the `bin/w2m` script in +https://github.com/benbalter/word-to-markdown[Ben Balter's word-to-markdown]) +extracts HTML from Word docx documents, and converts it to Asciidoc. [source,console] ---- -$ bundle exec bin/w2m document.docx > document.adoc +$ bundle exec bin/w2a document.docx > document.adoc ---- The script presumes that LibreOffice has already been installed: it uses LibreOffice's export to XHTML. LibreOffice's export of XHTML is superior to the native Microsoft Word export to HTML: it exports lists (which Word keeps as paragraphs), and it exports OOMML into MathML. -On the other hand, the LibreOffice export relies on +On the other hand, the LibreOffice export relies on default styling being used in the +document, and it may not cope with ordered lists or headings with customised appearance. +For best results, reset the styles in the document you're converting to those in +the default Normal.dot template. === Configuration The following options are available: @@ -182,5 +187,6 @@ * https://github.com/xijo/reverse_markdown/wiki/Write-your-own-converter[Write custom converters] - Wiki entry about how to write your own converter * https://github.com/harlantwood/html_massage[html_massage] - A gem by Harlan T. Wood to convert regular sites into markdown using reverse_markdown * https://github.com/benbalter/word-to-markdown[word-to-markdown] - Convert word docs into markdown while using reverse_markdown, by Ben Balter * https://github.com/asciidocfx/HtmlToAsciidoc[HtmlToAsciidoc] - Javascript regexp-based converter of HTML to Asciidoctor * https://asciidoctor.org/docs/user-manual/[The Asciidoctor User Manual] +