Added documentation on new advanced blog settings

Author: squidfunk

docs/plugins/blog.md

@@ -731,14 +731,50 @@ The following placeholders are available:
 
 ---
 
+#### <!-- md:setting config.archive_pagination -->
+
+<!-- md:sponsors -->
+<!-- md:version insiders-4.44.0 -->
+<!-- md:default `true` -->
+
+Use this setting to enable or disable pagination for archive pages. The value
+of this setting is inherited from [`pagination`][config.pagination], unless it's
+explicitly set. To disable pagination, use:
+
+``` yaml
+plugins:
+  - blog:
+      archive_pagination: false
+```
+
+---
+
+#### <!-- md:setting config.archive_pagination_per_page -->
+
+<!-- md:sponsors -->
+<!-- md:version insiders-4.44.0 -->
+<!-- md:default `10` -->
+
+Use this setting to change the number of posts rendered per archive page. The
+value of this setting is inherited from [`pagination_per_page`]
+[config.pagination_per_page], unless it's explicitly set:
+
+``` yaml
+plugins:
+  - blog:
+      archive_pagination_per_page: 5
+```
+
+---
+
 #### <!-- md:setting config.archive_toc -->
 
 <!-- md:version 9.2.0 -->
 <!-- md:default `false` -->
 
 Use this setting to leverage the table of contents to display post titles on all
 archive pages. The value of this setting is inherited from [`blog_toc`]
-[config.blog_toc], unless its explicitly set:
+[config.blog_toc], unless it's explicitly set:
 
 ``` yaml
 plugins:
@@ -888,14 +924,50 @@ this list. Posts can be assigned to categories by using the [`categories`]
 
 ---
 
+#### <!-- md:setting config.categories_pagination -->
+
+<!-- md:sponsors -->
+<!-- md:version insiders-4.44.0 -->
+<!-- md:default `true` -->
+
+Use this setting to enable or disable pagination for category pages. The value
+of this setting is inherited from [`pagination`][config.pagination], unless it's
+explicitly set. To disable pagination, use:
+
+``` yaml
+plugins:
+  - blog:
+      categories_pagination: false
+```
+
+---
+
+#### <!-- md:setting config.categories_pagination_per_page -->
+
+<!-- md:sponsors -->
+<!-- md:version insiders-4.44.0 -->
+<!-- md:default `10` -->
+
+Use this setting to change the number of posts rendered per category page. The
+value of this setting is inherited from [`pagination_per_page`]
+[config.pagination_per_page], unless it's explicitly set:
+
+``` yaml
+plugins:
+  - blog:
+      categories_pagination_per_page: 5
+```
+
+---
+
 #### <!-- md:setting config.categories_toc -->
 
 <!-- md:version 9.2.0 -->
 <!-- md:default `false` -->
 
 Use this setting to leverage the table of contents to display post titles on all
 category pages. The value of this setting is inherited from [`blog_toc`]
-[config.blog_toc], unless its explicitly set:
+[config.blog_toc], unless it's explicitly set:
 
 ``` yaml
 plugins:

docs/schema/plugins/blog.json

@@ -209,6 +209,18 @@
                 }
               ]
             },
+            "archive_pagination": {
+              "title": "Pagination for archive pages",
+              "markdownDescription": "https://squidfunk.github.io/mkdocs-material/plugins/blog/#config.archive_pagination",
+              "type": "boolean",
+              "default": true
+            },
+            "archive_pagination_per_page": {
+              "title": "Posts per page for archive pages",
+              "markdownDescription": "https://squidfunk.github.io/mkdocs-material/plugins/blog/#config.archive_pagination_per_page",
+              "type": "number",
+              "default": 10
+            },
             "archive_toc": {
               "title": "Archive table of contents",
               "markdownDescription": "https://squidfunk.github.io/mkdocs-material/plugins/blog/#config.archive_toc",
@@ -263,6 +275,18 @@
               "uniqueItems": true,
               "default": []
             },
+            "categories_pagination": {
+              "title": "Pagination for categories",
+              "markdownDescription": "https://squidfunk.github.io/mkdocs-material/plugins/blog/#config.categories_pagination",
+              "type": "boolean",
+              "default": true
+            },
+            "categories_pagination_per_page": {
+              "title": "Posts per page for categories",
+              "markdownDescription": "https://squidfunk.github.io/mkdocs-material/plugins/blog/#config.categories_pagination_per_page",
+              "type": "number",
+              "default": 10
+            },
             "categories_toc": {
               "title": "Categories table of contents",
               "markdownDescription": "https://squidfunk.github.io/mkdocs-material/plugins/blog/#config.categories_toc",