docs reviewed with grammar and spell checker (PR #2171)

11 files changed, 14 insertions, 14 deletions

diff --git a/docs/modules/theme/pages/apply-theme.adoc b/docs/modules/theme/pages/apply-theme.adoc
index ea7c223b..e4e232c2 100644
--- a/docs/modules/theme/pages/apply-theme.adoc
+++ b/docs/modules/theme/pages/apply-theme.adoc
@@ -18,7 +18,7 @@ If you use images in your theme, image paths are resolved relative to this direc
 If `pdf-theme` ends with `.yml`, and `pdf-themesdir` is not specified, then `pdf-themesdir` defaults to the directory of the path specified by `pdf-theme`.
 
 pdf-fontsdir:: The directory or directories where the fonts used by your theme, if any, are located.
-Multiple entries must be separated by either a comma or a semi-colon.
+Multiple entries must be separated by either a comma or a semicolon.
 To reference a file inside a JAR file on the classpath, prefix with the path with `uri:classloader:` (AsciidoctorJ only).
 _Specifying an absolute path is recommended._
 
@@ -54,7 +54,7 @@ However, in this case, image paths in your theme won't be resolved properly.
 
 Paths are resolved relative to the current directory.
 However, in the future, this may change so that paths are resolved relative to the base directory (typically the document's directory).
-Therefore, it's recommend that you specify absolute paths for now to future-proof your configuration.
+Therefore, it's recommended that you specify absolute paths for now to future-proof your configuration.
 
  $ asciidoctor-pdf -a pdf-themesdir=/path/to/resources/themes -a pdf-theme=basic -a pdf-fontsdir=/path/to/resources/fonts
 
diff --git a/docs/modules/theme/pages/block-images.adoc b/docs/modules/theme/pages/block-images.adoc
index f9d15e53..fa389519 100644
--- a/docs/modules/theme/pages/block-images.adoc
+++ b/docs/modules/theme/pages/block-images.adoc
@@ -3,7 +3,7 @@
 
 In general, the xref:blocks.adoc[] apply to block images and their captions.
 You can further customize how the block images, alt text, and captions are arranged and styled using the xref:block-image.adoc[].
-The following sections provide information and examples about the keys and values that are unique to the block images.
+The following sections provide information and examples of the keys and values that are unique to the block images.
 
 [#caption-align]
 == Caption alignment
diff --git a/docs/modules/theme/pages/callout.adoc b/docs/modules/theme/pages/callout.adoc
index f5a3a034..786f22e8 100644
--- a/docs/modules/theme/pages/callout.adoc
+++ b/docs/modules/theme/pages/callout.adoc
@@ -91,7 +91,7 @@ callout-list:
 
 The keys in the `conum` category control the style of callout numbers inside verbatim blocks and in callout lists.
 These keys don't affect the callout list item content.
-The appearance of the callout list and the content of the list items is controlled independently by the keys in <<callout-list,callout-list category>>.
+The appearance of the callout list and the content of the list items are controlled independently by the keys in <<callout-list,callout-list category>>.
 Also see <<inherit>> for more information.
 
 [cols="2,5,5a"]
diff --git a/docs/modules/theme/pages/code.adoc b/docs/modules/theme/pages/code.adoc
index 12b77d2e..a9c37fe5 100644
--- a/docs/modules/theme/pages/code.adoc
+++ b/docs/modules/theme/pages/code.adoc
@@ -124,7 +124,7 @@ code:
 == code-linenum
 
 The key in the `code-linenum` category only applies when you use Pygments as the source highlighter.
-Otherwise, the font color of line numbers are controlled by the source highlighter theme.
+Otherwise, the font color of line numbers is controlled by the source highlighter theme.
 
 [cols="2,4,6a"]
 |===
diff --git a/docs/modules/theme/pages/color.adoc b/docs/modules/theme/pages/color.adoc
index ab69e4cf..8d3c4aa0 100644
--- a/docs/modules/theme/pages/color.adoc
+++ b/docs/modules/theme/pages/color.adoc
@@ -56,7 +56,7 @@ Here's how to specify the color red in RGB:
 
 * [255, 0, 0]
 
-Here's how a RGB color value appears in the theme file:
+Here's how an RGB color value appears in the theme file:
 
 [,yaml]
 ----
diff --git a/docs/modules/theme/pages/custom-font.adoc b/docs/modules/theme/pages/custom-font.adoc
index 0041573c..d7db6874 100644
--- a/docs/modules/theme/pages/custom-font.adoc
+++ b/docs/modules/theme/pages/custom-font.adoc
@@ -148,5 +148,5 @@ Effectively, it subsets the font.
 While that saves space taken up by the generated PDF, you may still be storing the full font in your source repository.
 
 To minimize the size of the source font, you can use {url-fontforge}[FontForge^] to subset the font ahead of time.
-Subsetting a font means remove glyphs you don't plan to use.
+Subsetting a font means removing glyphs you don't plan to use.
 Doing so is not a requirement, simply a personal preference.
diff --git a/docs/modules/theme/pages/font-support.adoc b/docs/modules/theme/pages/font-support.adoc
index 3f20ef2b..21756981 100644
--- a/docs/modules/theme/pages/font-support.adoc
+++ b/docs/modules/theme/pages/font-support.adoc
@@ -83,7 +83,7 @@ Asciidoctor PDF bundles several fonts that are used by the default theme or a fa
 You can also declare these fonts in your custom theme.
 These fonts provide more characters than the built-in PDF fonts, but still only a subset of UTF-8 (to reduce the size of the gem).
 
-The family name of the fonts bundled with Asciidoctor PDF are as follows:
+The family names of the fonts bundled with Asciidoctor PDF are as follows:
 
 {url-mplus-onemn}[M+ 1mn^]::
 A monospaced font that maps different thicknesses to the styles `normal`, `italic`, `bold`, and `bold_italic`.
@@ -129,4 +129,4 @@ Notice the `-a scripts=cjk` option.
 That's important.
 It tells the converter to insert break opportunities between CJK characters so that lines wrap properly when mixing English and a CJK language like Japanese.
 
-If the built-in theme with the fallback font doesn't go far enough, you'll need create a xref:cjk.adoc[custom CJK theme].
+If the built-in theme with the fallback font doesn't go far enough, you'll need to create a xref:cjk.adoc[custom CJK theme].
diff --git a/docs/modules/theme/pages/language.adoc b/docs/modules/theme/pages/language.adoc
index dd608bb8..521e56c0 100644
--- a/docs/modules/theme/pages/language.adoc
+++ b/docs/modules/theme/pages/language.adoc
@@ -108,7 +108,7 @@ Also note the presence of the colon (`:`) after each key name.
 
 == Inheritance
 
-Like CSS, inheritance is a principle feature in the Asciidoctor PDF theme language.
+Like CSS, inheritance is a principal feature in the Asciidoctor PDF theme language.
 For many of the properties, if a key is not specified, the key inherits the value applied to the parent content in the content hierarchy.
 This behavior saves you from having to specify properties unless you want to override the inherited value.
 
diff --git a/docs/modules/theme/pages/page-numbers.adoc b/docs/modules/theme/pages/page-numbers.adoc
index 638536d3..2b591b21 100644
--- a/docs/modules/theme/pages/page-numbers.adoc
+++ b/docs/modules/theme/pages/page-numbers.adoc
@@ -95,7 +95,7 @@ See xref:add-running-content.adoc#page-number[Modify page number position] for a
 [#display]
 == Displaying the page numbers
 
-To adjust on what page the page numbers begin to be displayed on, you need change the page on which the running content starts.
+To adjust on what page the page numbers begin to be displayed on, you need to change the page on which the running content starts.
 This is controlled by the xref:add-running-content.adoc#start-at[running-content-start-at key].
 For example, to start the running content on the title page, assuming the title page is enabled, set `running-content-start-at: title` in your theme file.
 To learn more about customizing the running content, see xref:add-running-content.adoc[].
diff --git a/docs/modules/theme/pages/source-highlighting-theme.adoc b/docs/modules/theme/pages/source-highlighting-theme.adoc
index 0aefee37..c0d0c272 100644
--- a/docs/modules/theme/pages/source-highlighting-theme.adoc
+++ b/docs/modules/theme/pages/source-highlighting-theme.adoc
@@ -77,7 +77,7 @@ Use the `Text` token to set the background color of the source block and the def
 The complete list of tokens can be found in the {url-jneen-rouge}/blob/master/lib/rouge/token.rb[token.rb file^] from Rouge.
 Refer to the {url-jneen-rouge}/tree/master/lib/rouge/themes[bundled themes^] to find more examples.
 
-Once you've defined your theme, you need to enable it use it using the `rouge-style` document attribute, which you specify in the document header or via the Asciidoctor CLI or API.
+Once you've defined your theme, you need to enable it to use it using the `rouge-style` document attribute, which you specify in the document header or via the Asciidoctor CLI or API.
 
 [,asciidoc]
 ----
diff --git a/docs/modules/theme/pages/table.adoc b/docs/modules/theme/pages/table.adoc
index 00854f09..e59fb011 100644
--- a/docs/modules/theme/pages/table.adoc
+++ b/docs/modules/theme/pages/table.adoc
@@ -108,8 +108,8 @@ table:
 == table-head
 
 The keys in the `table-head` category control the arrangement and style of the table header.
-See <<header>> for the theme keys that apply to individual header cells
-.
+See <<header>> for the theme keys that apply to individual header cells.
+
 [cols="3,4,6a"]
 |===
 |Key |Value Type |Example