Add an option for page exclusion, issue #4.

Author: orzih

README.md

@@ -73,7 +73,9 @@ plugins:
         #excludes_children:
         #    - 'release-notes/:upgrading'
         #    - 'release-notes/:changelog'
-        #
+        #exclude_pages:
+        #    - 'bugs/'
+        #    - 'appendix/contribute/'
         #output_path: any-place/document.pdf
         #enabled_if_env: ENABLE_PDF_EXPORT
         #
@@ -149,6 +151,14 @@ plugins:
     Set the page `id` of `nav` url. If the `id` matches in this list, it will be excluded from the heading number addition and table of contents.  
     **default**: `[]`
 
+##### for Page
+
+* `exclude_pages`
+
+    Set the page `id` of `nav` url. If the `id` matches in this list, it will be excluded page contents.  
+    **default**: `[]`  
+    _**since**: `v0.3.0`_
+
 ##### ... and more
 
 * `output_path`

mkdocs_with_pdf/generator.py

@@ -33,6 +33,16 @@ def on_nav(self, nav):
 
     def on_post_page(self, output_content: str, page, pdf_path: str) -> str:
         """ on_post_page """
+
+        def is_excluded(url: str) -> bool:
+            return url in self._options.exclude_pages
+
+        if is_excluded(page.url):
+            self.logger.info(f'Page skipped: [{page.title}]({page.url})')
+            return f"<!-- skipped '{page}' -->"
+        else:
+            self.logger.debug(f' (post: [{page.title}]({page.url})')
+
         soup = self._soup_from_content(output_content, page)
 
         self._remove_empty_tags(soup)

mkdocs_with_pdf/options.py

@@ -31,7 +31,9 @@ class Options(object):
         ('heading_shift', config_options.Type(bool, default=True)),
         ('toc_level', config_options.Type(int, default=2)),
         ('ordered_chapter_level', config_options.Type(int, default=3)),
-        ('excludes_children', config_options.Type(list, default=[]))
+        ('excludes_children', config_options.Type(list, default=[])),
+
+        ('exclude_pages', config_options.Type(list, default=[]))
     )
 
     def __init__(self, local_config, config, logger: logging):
@@ -63,6 +65,9 @@ def __init__(self, local_config, config, logger: logging):
         self.ordered_chapter_level = local_config['ordered_chapter_level']
         self.excludes_children = local_config['excludes_children']
 
+        # Page
+        self.exclude_pages = local_config['exclude_pages']
+
         # Theming
         self.theme_name = config['theme'].name
         self.theme_handler_path = config.get('theme_handler_path', None)