doc: generic grammar, formatting, etc.

Signed-off-by: James Knight <[email protected]>

Author: jdknight

doc/configuration.rst

@@ -1650,7 +1650,7 @@ Advanced publishing configuration
     no changes are detected on the Confluence instance. When a page is
     published by this extension, a hash of the page will be stored on the
     Confluence page. This hash can be referred to later by hosts using this
-    extension, by query the hash and comparing it against a locally prepared
+    extension, by querying the hash and comparing it against a locally prepared
     page update. If hashes match, no attempt will be made to update the
     specific page. If users are experiencing issues with this check, they may
     force publishing by configuring this option to ``True``. By default, this
@@ -1695,7 +1695,7 @@ Advanced publishing configuration
 
     .. versionadded:: 1.3
 
-    A publish event will from this extension will typically upload new pages or
+    A publish event from this extension will typically upload new pages or
     update existing pages on future attempts. In select cases, a user may not
     wish to modify existing pages and only permit adding new content to a
     Confluence space. To achieve this, a user can enable an "only-new" flag
@@ -1733,7 +1733,7 @@ Advanced publishing configuration
 
     .. versionadded:: 2.1
 
-    The page identifier of the page to hold orphan pages. The parent page
+    The identifier of the page to hold orphan pages. The parent page
     associated to an orphan page can vary per configuration. When a user
     configures for a parent page/root, orphan pages will be placed under the
     respective parent page/root configuration. If no parent page/root is
@@ -2080,7 +2080,7 @@ Advanced processing configuration
 
     .. code-block:: rst
 
-        For more information, contact :confluence_mention:`myuser`:
+        For more information, contact :confluence_mention:`myuser`.
 
     The value ``myuser`` will be replaced with the configured account
     identifier. This can be useful for when trying to manage multiple
@@ -2205,6 +2205,10 @@ Third-party related options
         include Mermaid JS support. For example, adding the following content
         on the page planning to render diagrams:
 
+        .. raw:: latex
+
+            {\footnotesize 
+
         .. code-block:: rst
 
             .. confluence_html::
@@ -2213,6 +2217,10 @@ Third-party related options
                 import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs';
                 </script>
 
+        .. raw:: latex
+
+            }
+
     When using the `sphinxcontrib-mermaid`_ extension, this option can be
     used pass raw Mermaid figures into an HTML macro.
 

doc/events.rst

@@ -3,6 +3,9 @@ Events
 
 The following outlines additional `events`_ supported by this extension.
 
+Generic events
+--------------
+
 .. event:: confluence-publish-point (app, point_url)
 
    :param app: :class:`.Sphinx`

doc/features.rst

@@ -298,9 +298,9 @@ Other
 -----
 
 If a feature or extension is not listed above, is not working as expected or
-brings up another concern, feel free to bring up an issue:
+has another concern, feel free to bring up an issue:
 
-    | Atlassian Confluence Builder for Confluence - Issues
+    | Atlassian Confluence Builder for Confluence — Issues
     | https://github.com/sphinx-contrib/confluencebuilder/issues
 
 

doc/guide-confluence-macros.rst

@@ -33,7 +33,8 @@ the following in a reStructuredText document:
 
     .. raw:: confluence_storage
 
-        <ac:structured-macro ac:name="cheese" ac:macro-id="5d87ef61-1fcf-4d30-8d3b-82305e13233a" />
+        <ac:structured-macro ac:name="cheese"
+            ac:macro-id="5d87ef61-1fcf-4d30-8d3b-82305e13233a" />
 
 Or create an `"Info" macro`_  in a Markdown document:
 

doc/install-virtualenv.rst

@@ -93,7 +93,7 @@ Windows (virtualenv)
 
 If not already installed, download the most recent version of Python_:
 
-    | Python - Downloads
+    | Python — Downloads
     | https://www.python.org/downloads/
 
 When invoking the installer, it is recommended to select the option to "Add

doc/install.rst

@@ -99,7 +99,7 @@ Windows
 
 If not already installed, download the most recent version of Python_:
 
-    | Python - Downloads
+    | Python — Downloads
     | https://www.python.org/downloads/
 
 When invoking the installer, it is recommended to select the option to "Add

doc/roles.rst

@@ -110,7 +110,7 @@ generated Confluence documents.
         See :confluence_mention:`3c5369:fa8b5c24-17f8-4340-b73e-50d383307c59`.
 
     For Confluence Data Center, a mention to a specific user can either
-    be set to the username value, or a user's key value:
+    be set to the username value or a user's key value:
 
     .. code-block:: rst
 

doc/tips.rst

@@ -108,7 +108,7 @@ Asking for help
 Having trouble or concerns using this extension? Do not hesitate to bring up an
 issue:
 
-    | Atlassian Confluence Builder for Confluence - Issues
+    | Atlassian Confluence Builder for Confluence — Issues
     | https://github.com/sphinx-contrib/confluencebuilder/issues
 
 For issues when using this extension, generating a report and including this