From 04aa5d0d12d404fa03744d2c531deb048990a6b9 Mon Sep 17 00:00:00 2001 From: GeoJulien Date: Thu, 13 Nov 2025 08:56:30 +0100 Subject: [PATCH 1/3] fix(integrations): decrease log level --- mkdocs_rss_plugin/integrations/theme_material_blog_plugin.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/mkdocs_rss_plugin/integrations/theme_material_blog_plugin.py b/mkdocs_rss_plugin/integrations/theme_material_blog_plugin.py index 385408f..6ee3da5 100644 --- a/mkdocs_rss_plugin/integrations/theme_material_blog_plugin.py +++ b/mkdocs_rss_plugin/integrations/theme_material_blog_plugin.py @@ -142,14 +142,14 @@ def is_page_a_blog_post(self, mkdocs_page: Post | MkdocsPageSubset) -> bool: bool: True if the given page is a Material Blog post. """ if self.IS_ENABLED and isinstance(mkdocs_page, Post): - logger.info( + logger.debug( f"page '{mkdocs_page.file.src_uri}' identified as Material Blog post." ) return True elif isinstance(mkdocs_page, MkdocsPageSubset) and Path( mkdocs_page.src_uri ).is_relative_to(self.blog_plugin_cfg.config.blog_dir): - logger.info( + logger.debug( f"page '{mkdocs_page.src_uri}' identified as Material Blog post " f"by src_uri matching." ) From 712e21b09f1e3bb223ec48199ccbe58b26bcfe2e Mon Sep 17 00:00:00 2001 From: GeoJulien Date: Thu, 13 Nov 2025 08:56:56 +0100 Subject: [PATCH 2/3] update(tests): pretty print blog related fixture --- ...cial_cards_blog_directory_url_disabled.yml | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/tests/fixtures/mkdocs_item_image_social_cards_blog_directory_url_disabled.yml b/tests/fixtures/mkdocs_item_image_social_cards_blog_directory_url_disabled.yml index 49ff755..acefde9 100644 --- a/tests/fixtures/mkdocs_item_image_social_cards_blog_directory_url_disabled.yml +++ b/tests/fixtures/mkdocs_item_image_social_cards_blog_directory_url_disabled.yml @@ -5,14 +5,15 @@ site_url: https://guts.github.io/mkdocs-rss-plugin use_directory_urls: false plugins: - - blog: - blog_dir: blog - authors_profiles: true - - rss: - match_path: blog/posts/.* - - social: - enabled: true - cards: true + - blog: + blog_dir: blog + authors_profiles: true + - rss: + match_path: blog/posts/.* + pretty_print: true + - social: + enabled: true + cards: true theme: - name: material + name: material From cf19489cfaf8563f327e4b6b6ffcba5951672dcd Mon Sep 17 00:00:00 2001 From: GeoJulien Date: Thu, 13 Nov 2025 08:57:31 +0100 Subject: [PATCH 3/3] improve(integrations): add some debug logs --- .../integrations/theme_material_social_plugin.py | 6 ++++++ mkdocs_rss_plugin/util.py | 4 +++- 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/mkdocs_rss_plugin/integrations/theme_material_social_plugin.py b/mkdocs_rss_plugin/integrations/theme_material_social_plugin.py index e190e26..7852114 100644 --- a/mkdocs_rss_plugin/integrations/theme_material_social_plugin.py +++ b/mkdocs_rss_plugin/integrations/theme_material_social_plugin.py @@ -336,10 +336,16 @@ def get_social_card_cache_path_for_page( self.integration_material_blog.IS_BLOG_PLUGIN_ENABLED and self.integration_material_blog.is_page_a_blog_post(mkdocs_page) ): + logger.debug( + f"Looking for social card in cache for blog post: {mkdocs_page.src_uri}" + ) expected_cached_card_path = self.social_cards_cache_dir.joinpath( f"assets/images/social/{Path(mkdocs_page.dest_uri).parent}.png" ) else: + logger.debug( + f"Looking for social card in cache for page: {mkdocs_page.src_uri}" + ) expected_cached_card_path = self.social_cards_cache_dir.joinpath( f"assets/images/social/{Path(mkdocs_page.src_uri).with_suffix('.png')}" ) diff --git a/mkdocs_rss_plugin/util.py b/mkdocs_rss_plugin/util.py index f7afdbb..332a769 100644 --- a/mkdocs_rss_plugin/util.py +++ b/mkdocs_rss_plugin/util.py @@ -571,7 +571,9 @@ def load_images_for_pages( page_info._mkdocs_page_ref and id(page_info._mkdocs_page_ref) not in processed_refs ): - logger.debug(f"Get image for '{page_info.title}'") + logger.debug( + f"Get image for '{page_info.title}' ({page_info.abs_path})" + ) page_info.image = self.get_image( in_page=page_info._mkdocs_page_ref, base_url=base_url )