summaryrefslogtreecommitdiff
path: root/docs/modules/migrate
diff options
context:
space:
mode:
authorGuillaume Grossetie <ggrossetie@gmail.com>2022-08-22 20:47:27 +0200
committerGitHub <noreply@github.com>2022-08-22 12:47:27 -0600
commitd72fe54346aa6963ae835f48681fa1ed917fb3fe (patch)
tree4896c6906efb3ee81aebde948580dd46767eb7c4 /docs/modules/migrate
parent81e3e772f1294f85a5be7d34d06e132494c44e5b (diff)
proofread documentation (PR #4336)
Diffstat (limited to 'docs/modules/migrate')
-rw-r--r--docs/modules/migrate/pages/asciidoc-py.adoc4
-rw-r--r--docs/modules/migrate/pages/ms-word.adoc10
2 files changed, 7 insertions, 7 deletions
diff --git a/docs/modules/migrate/pages/asciidoc-py.adoc b/docs/modules/migrate/pages/asciidoc-py.adoc
index a7a99906..26a1ffb2 100644
--- a/docs/modules/migrate/pages/asciidoc-py.adoc
+++ b/docs/modules/migrate/pages/asciidoc-py.adoc
@@ -62,7 +62,7 @@ There are similar attributes to control how additional resources are resolved.
As the steward of the AsciiDoc language, Asciidoctor reworked some of the AsciiDoc syntax originally introduced by AsciiDoc.py in an effort to make it more consistent, easier to learn, and, in some cases, more concise.
This section outlines those improvements to the modern AsciiDoc syntax and how it differs from the legacy AsciiDoc recognized by AsciiDoc.py.
-*If a feature or attribute isn't mentioned in the following tables, than it works in Asciidoctor just like it worked in AsciiDoc.py.*
+*If a feature or attribute isn't mentioned in the following tables, then it works in Asciidoctor just like it worked in AsciiDoc.py.*
=== Inline formatting
@@ -306,7 +306,7 @@ If you can't migrate right now, you can activate compat mode by setting the `com
$ asciidoctor -a compat-mode document.adoc
-You can also enable compat mode implicitly by beginning the document with an setext-style (i.e., two-line) document title:
+You can also enable compat mode implicitly by beginning the document with a setext-style (i.e., two-line) document title:
[,asciidoc]
----
diff --git a/docs/modules/migrate/pages/ms-word.adoc b/docs/modules/migrate/pages/ms-word.adoc
index 4f855ff9..b16d37a8 100644
--- a/docs/modules/migrate/pages/ms-word.adoc
+++ b/docs/modules/migrate/pages/ms-word.adoc
@@ -8,7 +8,7 @@
== Pandoc
-{url-pandoc}[Pandoc^] is a swiss army knife for converting one markup format to another.
+{url-pandoc}[Pandoc^] is a Swiss army knife for converting one markup format to another.
It does an admirable job converting simple docx files to AsciiDoc.
NOTE: Generally, we don't like to recommend pandoc because it doesn't create AsciiDoc the way we prefer.
@@ -96,7 +96,7 @@ See <<remove-refs,how to remove hyperlinks>> to fix it.
== Optimizing for Pandoc
The basic usage documented above is fine for one-off imports.
-If you have a lot to do, it's worth while cleaning the input document first, and automating the post-conversion tidy up.
+If you have a lot to do, it's worthwhile cleaning the input document first, and automating the post-conversion tidy up.
. Clean up the MS Word document:
// Title pages are usually easier to recreate manually
@@ -128,7 +128,7 @@ If you have a lot to do, it's worth while cleaning the input document first, and
** Optional: insert ids and cross references using AsciiDoc notation
(You might find it easier doing it now rather than in the AsciiDoc document later.)
// Not sure if it is significant, but pandoc seems to be designed against this spec, rather than the normal docx.
-** Save as "`Strict Open-xml document (docx)``"
+** Save as "`Strict Open XML document (docx)``"
. Convert using pandoc as shown above.
. Check that the output document looks OK, and that all images have been extracted.
+
@@ -180,7 +180,7 @@ It will get confused by abbreviations, but there is no way around that.
$ perl -W -pe 's!^Figure (\d+)\s?(.*)![[fig-$1]]\n.$2\n!g' -i output.adoc
-* Replace references to figures with asciidoc xref
+* Replace references to figures with AsciiDoc xref
$ perl -W -pe 's!Figure (\d+)!<<fig-$1>>!g' -i output.adoc
@@ -196,7 +196,7 @@ The source for the add-on can be found in {url-google-asciidoc-source}[its repos
This method is only useful for very small files or if the other methods are not available.
* It keeps the text, and _fixes_ fields like auto-numbered lists and cross references.
-* It loses tables (converted to plain paragraphs), images, symbols, form fields, and textboxes.
+* It loses tables (converted to plain paragraphs), images, symbols, form fields, and text boxes.
In MS Word, use "Save as > Plain text", then when the File Conversion dialog appears, set: