mkdocs-document-dates 3.4.9__tar.gz → 3.5.1__tar.gz

{mkdocs_document_dates-3.4.9/mkdocs_document_dates.egg-info → mkdocs_document_dates-3.5.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: mkdocs-document-dates
-Version: 3.4.9
-Summary: A new generation MkDocs plugin for displaying exact creation time, last update time, authors, email of documents
+Version: 3.5.1
+Summary: A new generation MkDocs plugin for displaying exact creation date, last updated date, authors, email of documents
 Home-page: https://github.com/jaywhj/mkdocs-document-dates
 Author: Aaron Wang
 Author-email: aaronwqt@gmail.com
@@ -30,28 +30,26 @@ English | [简体中文](README_zh.md)
 
 <br />
 
-A new generation MkDocs plugin for displaying exact **creation time, last update time, authors, email** of documents
+A new generation MkDocs plugin for displaying exact **creation date, last updated date, authors, email** of documents
 
 ![render](render.gif)
 
 ## Features
 
-- [x] Always displays **exact** meta information of the document and works in any environment (no Git, Git environments, Docker containers, all CI/CD build systems, etc.)
-- [x] Support list display of recently updated documents (in descending order of update time)
-- [x] Support for manually specifying time and author in `Front Matter`
-- [x] Support for multiple time formats (date, datetime, timeago)
+- [x] Always displays **exact** meta information of the document and works in any environment (no-Git, Git environments, Docker, all CI/CD build systems, etc.)
+- [x] Support list display of recently updated documents (in descending order of update date)
+- [x] Support for manually specifying date and author in `Front Matter`
+- [x] Support for multiple date formats (date, datetime, timeago)
 - [x] Support for multiple author modes (avatar, text, hidden)
 - [x] Support for manually configuring author's name, link, avatar, email, etc.
 - [x] Flexible display position (top or bottom)
 - [x] Elegant styling (fully customizable)
-- [x] Smart Tooltip Hover Tips
 - [x] Multi-language support, localization support, intelligent recognition of user language, automatic adaptation
-- [x] Cross-platform support (Windows, macOS, Linux)
 - [x] **Ultimate build efficiency**: O(1), no need to set the env var `!ENV` to distinguish runs
 
 | Build Speed Comparison:     | 100 md: | 1000 md: | Time Complexity: |
 | --------------------------- | :-----: | :------: | :----------: |
-| git-revision-date-localized |  > 3 s   |  > 30 s   |    O(n)    |
+| git-revision-date-localized<br />git-authors |  ＞ 3 s   |  ＞ 30 s   |    O(n)    |
 | document-dates              | < 0.1 s  | < 0.15 s  |    O(1)    |
 
 ## Installation
@@ -74,28 +72,41 @@ Or, full configuration:
 ```yaml
 plugins:
   - document-dates:
-      position: top            # Display position: top(after title) bottom(end of document)
+      position: top            # Display position: top(after title) bottom(end of document), default: top
       type: date               # Date type: date datetime timeago, default: date
       exclude:                 # List of excluded files
         - temp.md                  # Example: exclude the specified file
         - blog/*                   # Example: exclude all files in blog folder, including subfolders
       date_format: '%Y-%m-%d'  # Date format strings (e.g., %Y-%m-%d, %b %d, %Y)
       time_format: '%H:%M:%S'  # Time format strings (valid only if type=datetime)
-      show_author: true        # Author display mode: true(avatar) text(text) false(hidden)
+      show_created: true       # Show creation date: true false, default: true
+      show_updated: true       # Show last updated date: true false, default: true
+      show_author: true        # Show author: true(avatar) text(text) false(hidden), default: true
 ```
 
 ## Customization Settings
 
 In addition to the above basic configuration, the plug-in also provides a wealth of customization options to meet a variety of individual needs:
 
-- [Specify Datetime](https://jaywhj.netlify.app/document-dates-en#Specify-Datetime): You can manually specify the creation time and last update time for each document
-- [Specify Author](https://jaywhj.netlify.app/document-dates-en#Specify-Author): You can manually specify the author information for each document, such as name, link, avatar, email, etc.
-- [Specify Avatar](https://jaywhj.netlify.app/document-dates-en#Specify-Avatar): You can manually specify the avatar for each author
-- [Set Plugin Style](https://jaywhj.netlify.app/document-dates-en#Set-Plugin-Style): Such as icons, themes, colors, fonts, animations, dividing line, etc.
+- [Specify Datetime](https://jaywhj.netlify.app/document-dates-en#Specify-Datetime): Introduces the mechanism for obtaining document dates and methods for personalized customization, you can manually specify the creation date and last updated date for each document
+- [Specify Author](https://jaywhj.netlify.app/document-dates-en#Specify-Author): Introduces the mechanism for obtaining document authors and methods for personalized customization, you can manually specify the author information for each document, such as name, link, avatar, email, etc.
+- [Specify Avatar](https://jaywhj.netlify.app/document-dates-en#Specify-Avatar): You can manually specify the avatar for each author, support local file path and URL path
+- [Set Plugin Style](https://jaywhj.netlify.app/document-dates-en#Set-Plugin-Style): You can quickly set the plugin styles through preset entrances, such as icons, themes, colors, fonts, animations, dividing line and so on
+- [Use Template Variables](https://jaywhj.netlify.app/document-dates-en#Use-Template-Variables): Can be used to optimize `sitemap.xml` for site SEO; Can be used to re-customize plug-ins, etc.
+- [Add Recently Updated Module](https://jaywhj.netlify.app/document-dates-en#Add-Recently-Updated-Module): Enable list of recently updated documents (in descending order of update date), this is ideal for sites with a large number of documents, so that readers can quickly see what's new
 - [Add Localization Language](https://jaywhj.netlify.app/document-dates-en#Add-Localization-Language): More localization languages for `timeago` and `tooltip` 
-- [Use Template Variables](https://jaywhj.netlify.app/document-dates-en#Use-Template-Variables): Can be used to optimize `sitemap.xml` for site SEO, can be used to re-customize plug-ins, etc.
-- [Add Recently Updated Module](https://jaywhj.netlify.app/document-dates-en#Add-Recently-Updated-Module): Enable list of recently updated documents (in descending order of update time)
-- [Other Tips](https://jaywhj.netlify.app/document-dates-en#Other-Tips): Introduction to technical principles, caching mechanisms, and how to use it in Docker
+- [Other Tips](https://jaywhj.netlify.app/document-dates-en#Other-Tips): Introducing the Do's of using plugin in Docker
 - [Development Stories](https://jaywhj.netlify.app/document-dates-en#Development-Stories): Describes the origin of the plug-in, the difficulties and solutions encountered in development, and the principles and directions of product design
 
 See the documentation for details: https://jaywhj.netlify.app/document-dates-en
+
+
+<br />
+
+## Chat Group
+
+**Discord**: https://discord.gg/cvTfge4AUy
+
+**Wechat**: 
+
+<img src="wechat-group.jpg" width="140" />

{mkdocs_document_dates-3.4.9 → mkdocs_document_dates-3.5.1}/README.md

@@ -4,28 +4,26 @@ English | [简体中文](README_zh.md)
 
 <br />
 
-A new generation MkDocs plugin for displaying exact **creation time, last update time, authors, email** of documents
+A new generation MkDocs plugin for displaying exact **creation date, last updated date, authors, email** of documents
 
 ![render](render.gif)
 
 ## Features
 
-- [x] Always displays **exact** meta information of the document and works in any environment (no Git, Git environments, Docker containers, all CI/CD build systems, etc.)
-- [x] Support list display of recently updated documents (in descending order of update time)
-- [x] Support for manually specifying time and author in `Front Matter`
-- [x] Support for multiple time formats (date, datetime, timeago)
+- [x] Always displays **exact** meta information of the document and works in any environment (no-Git, Git environments, Docker, all CI/CD build systems, etc.)
+- [x] Support list display of recently updated documents (in descending order of update date)
+- [x] Support for manually specifying date and author in `Front Matter`
+- [x] Support for multiple date formats (date, datetime, timeago)
 - [x] Support for multiple author modes (avatar, text, hidden)
 - [x] Support for manually configuring author's name, link, avatar, email, etc.
 - [x] Flexible display position (top or bottom)
 - [x] Elegant styling (fully customizable)
-- [x] Smart Tooltip Hover Tips
 - [x] Multi-language support, localization support, intelligent recognition of user language, automatic adaptation
-- [x] Cross-platform support (Windows, macOS, Linux)
 - [x] **Ultimate build efficiency**: O(1), no need to set the env var `!ENV` to distinguish runs
 
 | Build Speed Comparison:     | 100 md: | 1000 md: | Time Complexity: |
 | --------------------------- | :-----: | :------: | :----------: |
-| git-revision-date-localized |  > 3 s   |  > 30 s   |    O(n)    |
+| git-revision-date-localized<br />git-authors |  ＞ 3 s   |  ＞ 30 s   |    O(n)    |
 | document-dates              | < 0.1 s  | < 0.15 s  |    O(1)    |
 
 ## Installation
@@ -48,28 +46,41 @@ Or, full configuration:
 ```yaml
 plugins:
   - document-dates:
-      position: top            # Display position: top(after title) bottom(end of document)
+      position: top            # Display position: top(after title) bottom(end of document), default: top
       type: date               # Date type: date datetime timeago, default: date
       exclude:                 # List of excluded files
         - temp.md                  # Example: exclude the specified file
         - blog/*                   # Example: exclude all files in blog folder, including subfolders
       date_format: '%Y-%m-%d'  # Date format strings (e.g., %Y-%m-%d, %b %d, %Y)
       time_format: '%H:%M:%S'  # Time format strings (valid only if type=datetime)
-      show_author: true        # Author display mode: true(avatar) text(text) false(hidden)
+      show_created: true       # Show creation date: true false, default: true
+      show_updated: true       # Show last updated date: true false, default: true
+      show_author: true        # Show author: true(avatar) text(text) false(hidden), default: true
 ```
 
 ## Customization Settings
 
 In addition to the above basic configuration, the plug-in also provides a wealth of customization options to meet a variety of individual needs:
 
-- [Specify Datetime](https://jaywhj.netlify.app/document-dates-en#Specify-Datetime): You can manually specify the creation time and last update time for each document
-- [Specify Author](https://jaywhj.netlify.app/document-dates-en#Specify-Author): You can manually specify the author information for each document, such as name, link, avatar, email, etc.
-- [Specify Avatar](https://jaywhj.netlify.app/document-dates-en#Specify-Avatar): You can manually specify the avatar for each author
-- [Set Plugin Style](https://jaywhj.netlify.app/document-dates-en#Set-Plugin-Style): Such as icons, themes, colors, fonts, animations, dividing line, etc.
+- [Specify Datetime](https://jaywhj.netlify.app/document-dates-en#Specify-Datetime): Introduces the mechanism for obtaining document dates and methods for personalized customization, you can manually specify the creation date and last updated date for each document
+- [Specify Author](https://jaywhj.netlify.app/document-dates-en#Specify-Author): Introduces the mechanism for obtaining document authors and methods for personalized customization, you can manually specify the author information for each document, such as name, link, avatar, email, etc.
+- [Specify Avatar](https://jaywhj.netlify.app/document-dates-en#Specify-Avatar): You can manually specify the avatar for each author, support local file path and URL path
+- [Set Plugin Style](https://jaywhj.netlify.app/document-dates-en#Set-Plugin-Style): You can quickly set the plugin styles through preset entrances, such as icons, themes, colors, fonts, animations, dividing line and so on
+- [Use Template Variables](https://jaywhj.netlify.app/document-dates-en#Use-Template-Variables): Can be used to optimize `sitemap.xml` for site SEO; Can be used to re-customize plug-ins, etc.
+- [Add Recently Updated Module](https://jaywhj.netlify.app/document-dates-en#Add-Recently-Updated-Module): Enable list of recently updated documents (in descending order of update date), this is ideal for sites with a large number of documents, so that readers can quickly see what's new
 - [Add Localization Language](https://jaywhj.netlify.app/document-dates-en#Add-Localization-Language): More localization languages for `timeago` and `tooltip` 
-- [Use Template Variables](https://jaywhj.netlify.app/document-dates-en#Use-Template-Variables): Can be used to optimize `sitemap.xml` for site SEO, can be used to re-customize plug-ins, etc.
-- [Add Recently Updated Module](https://jaywhj.netlify.app/document-dates-en#Add-Recently-Updated-Module): Enable list of recently updated documents (in descending order of update time)
-- [Other Tips](https://jaywhj.netlify.app/document-dates-en#Other-Tips): Introduction to technical principles, caching mechanisms, and how to use it in Docker
+- [Other Tips](https://jaywhj.netlify.app/document-dates-en#Other-Tips): Introducing the Do's of using plugin in Docker
 - [Development Stories](https://jaywhj.netlify.app/document-dates-en#Development-Stories): Describes the origin of the plug-in, the difficulties and solutions encountered in development, and the principles and directions of product design
 
 See the documentation for details: https://jaywhj.netlify.app/document-dates-en
+
+
+<br />
+
+## Chat Group
+
+**Discord**: https://discord.gg/cvTfge4AUy
+
+**Wechat**: 
+
+<img src="wechat-group.jpg" width="140" />

{mkdocs_document_dates-3.4.9 → mkdocs_document_dates-3.5.1}/mkdocs_document_dates/plugin.py

@@ -10,7 +10,7 @@ from mkdocs.config import config_options
 from mkdocs.structure.pages import Page
 from mkdocs.utils import get_relative_url
 from urllib.parse import urlparse
-from .utils import get_file_creation_time, load_git_cache, read_jsonl_cache,is_excluded, get_recently_updated_files
+from .utils import get_file_creation_time, load_git_metadata, load_git_last_updated_date, read_jsonl_cache,is_excluded, get_recently_updated_files
 
 logger = logging.getLogger("mkdocs.plugins.document_dates")
 logger.setLevel(logging.WARNING)  # DEBUG, INFO, WARNING, ERROR, CRITICAL
@@ -34,7 +34,9 @@ class DocumentDatesPlugin(BasePlugin):
         ('position', config_options.Type(str, default='top')),
         ('exclude', config_options.Type(list, default=[])),
         ('created_field_names', config_options.Type(list, default=['created', 'date'])),
-        ('modified_field_names', config_options.Type(list, default=['modified', 'updated'])),
+        ('updated_field_names', config_options.Type(list, default=['updated', 'modified'])),
+        ('show_created', config_options.Type(bool, default=True)),
+        ('show_updated', config_options.Type(bool, default=True)),
         ('show_author', config_options.Choice((True, False, 'text'), default=True)),
         ('recently-updated', config_options.Type((dict, bool), default={}))
     )
@@ -52,21 +54,19 @@ class DocumentDatesPlugin(BasePlugin):
         docs_dir_path = Path(config['docs_dir'])
 
         # 加载 author 配置
-        if self.config['show_author']:
-            self._extract_github_username(config.get('repo_url'))
-            authors_file = docs_dir_path / 'authors.yml'
-            if not authors_file.exists():
-                try:
-                    blog_config = config['plugins']['material/blog'].config
-                    authors_file_resolved = blog_config.authors_file.format(blog=blog_config.blog_dir)
-                    authors_file = docs_dir_path / authors_file_resolved
-                except Exception:
-                    pass
-            self._load_authors_from_yaml(authors_file)
-
-        # 加载 git 缓存
-        self.dates_cache = load_git_cache(docs_dir_path)
-        # 覆盖 jsonl 文件缓存
+        authors_file = docs_dir_path / 'authors.yml'
+        if not authors_file.exists():
+            try:
+                blog_config = config['plugins']['material/blog'].config
+                authors_file_resolved = blog_config.authors_file.format(blog=blog_config.blog_dir)
+                authors_file = docs_dir_path / authors_file_resolved
+            except Exception:
+                pass
+        self._load_authors_from_yaml(authors_file)
+
+        # 加载文档元数据
+        self.dates_cache = load_git_metadata(docs_dir_path)
+        # 覆盖 jsonl 缓存
         jsonl_cache_file = docs_dir_path / '.dates_cache.jsonl'
         if jsonl_cache_file.exists():
             jsonl_cache = read_jsonl_cache(jsonl_cache_file)
@@ -74,6 +74,10 @@ class DocumentDatesPlugin(BasePlugin):
                 if filename in self.dates_cache:
                     self.dates_cache[filename].update(new_info)
 
+        # 加载文档最近更新时间
+        self.last_updated_dates = load_git_last_updated_date(docs_dir_path)
+
+
         # 复制配置文件到用户目录（如果不存在）
         dest_dir = docs_dir_path / 'assets' / 'document_dates'
         dest_dir.mkdir(parents=True, exist_ok=True)
@@ -136,35 +140,6 @@ class DocumentDatesPlugin(BasePlugin):
 
         return config
 
-    def on_nav(self, nav, config, files):
-        recently_updated_config = self.config.get('recently-updated')
-        if recently_updated_config:
-            self.recent_enable = True
-
-        # 兼容 true 配置
-        if recently_updated_config is True:
-            recently_updated_config = {}
-
-        # 获取配置
-        exclude_list = recently_updated_config.get('exclude', [])
-        limit = recently_updated_config.get('limit', 10)
-        template_path = recently_updated_config.get('template')
-
-        # 获取最近更新日期和最近更新的文档数据
-        docs_dir = Path(config['docs_dir'])
-        self.last_updated_dates, recently_updated_docs = get_recently_updated_files(docs_dir, files, exclude_list, limit, self.recent_enable)
-
-        # 将数据注入到 config['extra'] 中供全局访问
-        if 'extra' not in config:
-            config['extra'] = {}
-        config['extra']['recently_updated_docs'] = recently_updated_docs
-
-        # 渲染HTML
-        if self.recent_enable:
-            self.recent_docs_html = self._render_recently_updated_html(docs_dir, template_path, recently_updated_docs)
-
-        return nav
-
     def on_page_markdown(self, markdown, page: Page, config, files):
         # 获取相对路径，src_uri 总是以"/"分隔
         rel_path = getattr(page.file, 'src_uri', page.file.src_path)
@@ -174,38 +149,65 @@ class DocumentDatesPlugin(BasePlugin):
         
         # 获取时间信息
         created = self._find_meta_date(page.meta, self.config['created_field_names'])
-        modified = self._find_meta_date(page.meta, self.config['modified_field_names'])
+        updated = self._find_meta_date(page.meta, self.config['updated_field_names'])
         if not created:
             created = self._get_file_creation_time(file_path, rel_path)
-        if not modified:
-            modified = self._get_file_modification_time(file_path, rel_path)
+        if not updated:
+            updated = self._get_file_modification_time(file_path, rel_path)
         
         # 获取作者信息
         authors = self._get_author_info(rel_path, page, config)
-        if authors and len(authors) == 1:
-            a = authors[0]
-            if not a.avatar and self.github_username:
-                a.avatar = f"https://avatars.githubusercontent.com/{self.github_username}"
         
         # 在排除前暴露 meta 信息给前端使用
         page.meta['document_dates_created'] = created.isoformat()
-        page.meta['document_dates_modified'] = modified.isoformat()
+        page.meta['document_dates_updated'] = updated.isoformat()
         page.meta['document_dates_authors'] = authors
         
-        # 占位符替换
-        if self.recent_enable and '\n<!-- RECENTLY_UPDATED_DOCS -->' in markdown:
-            markdown = markdown.replace('\n<!-- RECENTLY_UPDATED_DOCS -->', self.recent_docs_html or '')
-        
         # 检查是否需要排除
         if is_excluded(rel_path, self.config['exclude']):
             return markdown
         
         # 生成日期和作者信息 HTML
-        info_html = self._generate_html_info(created, modified, authors)
+        info_html = self._generate_html_info(created, updated, authors)
         
         # 将信息写入 markdown
         return self._insert_date_info(markdown, info_html)
 
+    def on_env(self, env, config, files):
+        recently_updated_config = self.config.get('recently-updated')
+        if recently_updated_config:
+            self.recent_enable = True
+
+        # 兼容 true 配置
+        if recently_updated_config is True:
+            recently_updated_config = {}
+
+        # 获取配置
+        exclude_list = recently_updated_config.get('exclude', [])
+        limit = recently_updated_config.get('limit', 10)
+        template_path = recently_updated_config.get('template')
+
+        # 获取最近更新的文档数据
+        recently_updated_docs = get_recently_updated_files(self.last_updated_dates, files, exclude_list, limit, self.recent_enable)
+
+        # 将数据注入到 config['extra'] 中供全局访问
+        if 'extra' not in config:
+            config['extra'] = {}
+        config['extra']['recently_updated_docs'] = recently_updated_docs
+
+        # 渲染HTML
+        if self.recent_enable:
+            docs_dir = Path(config['docs_dir'])
+            self.recent_docs_html = self._render_recently_updated_html(docs_dir, template_path, recently_updated_docs)
+
+        return env
+
+    def on_post_page(self, output, page, config):
+        if self.recent_enable and '\n<!-- RECENTLY_UPDATED_DOCS -->' in output:
+            output = output.replace('\n<!-- RECENTLY_UPDATED_DOCS -->', self.recent_docs_html or '')
+
+        return output
+
     def on_post_build(self, config):
         site_dest_dir = Path(config['site_dir']) / 'assets' / 'document_dates'
         for dir_name in ['tippy', 'core', 'fonts']:
@@ -218,17 +220,6 @@ class DocumentDatesPlugin(BasePlugin):
                     shutil.copy2(item, target_dir / item.name)
 
 
-    def _extract_github_username(self, url):
-        try:
-            parsed = urlparse(url)
-            if parsed.netloc != 'github.com':
-                return
-            path_parts = [p for p in parsed.path.split('/') if p]
-            if path_parts:
-                self.github_username = path_parts[0]
-        except Exception as e:
-            logger.info(f"Error parsing URL: {e}")
-
     def _load_authors_from_yaml(self, file_path: Path):
         if not file_path.exists():
             return
@@ -258,8 +249,8 @@ class DocumentDatesPlugin(BasePlugin):
 
         # 加载模板
         env = Environment(
-            loader=FileSystemLoader(str(template_dir)),
-            autoescape=select_autoescape(["html", "xml"])
+            loader = FileSystemLoader(str(template_dir)),
+            autoescape = select_autoescape(["html", "xml"])
         )
         template = env.get_template(template_file)
 
@@ -295,9 +286,6 @@ class DocumentDatesPlugin(BasePlugin):
 
 
     def _get_author_info(self, rel_path, page, config):
-        if not self.config['show_author']:
-            return None
-
         # 1. meta author
         authors = self._process_meta_author(page.meta, page.url)
         if authors:
@@ -374,9 +362,14 @@ class DocumentDatesPlugin(BasePlugin):
             return date.strftime(f"{self.config['date_format']} {self.config['time_format']}")
         return date.strftime(self.config['date_format'])
 
-    def _generate_html_info(self, created: datetime, modified: datetime, authors=None):
+    def _generate_html_info(self, created: datetime, updated: datetime, authors=None):
         try:
-            # 构建基本的日期信息 HTML
+            show_dates = self.config['show_created'] or self.config['show_updated']
+            show_plugin = show_dates or self.config['show_author']
+            if not show_plugin:
+                return ""
+
+            # 构建插件骨架 HTML
             html_parts = []
             position_class = 'document-dates-top' if self.config['position'] == 'top' else 'document-dates-bottom'
             html_parts.append(f"<div class='document-dates-plugin-wrapper {position_class}'>")
@@ -385,16 +378,23 @@ class DocumentDatesPlugin(BasePlugin):
             def build_time_icon(time_obj: datetime, icon: str):
                 formatted = time_obj.strftime(self.config['date_format'])
                 return (
-                    f"<span data-tippy-content data-tippy-raw='{formatted}'>"
+                    f"<span class='dd-item' data-tippy-content data-tippy-raw='{formatted}'>"
                     f"<span class='material-icons' data-icon='{icon}'></span>"
-                    f"<time datetime='{time_obj.isoformat()}'>"
-                    f"{self._get_formatted_date(time_obj)}</time></span>"
+                    f"<time datetime='{time_obj.isoformat()}'>{self._get_formatted_date(time_obj)}</time>"
+                    f"</span>"
                 )
 
-            html_parts.append(build_time_icon(created, 'doc_created'))
-            html_parts.append(build_time_icon(modified, 'doc_modified'))
-
-            # 添加作者信息
+            # 构建日期
+            if show_dates:
+                html_parts.append("<div class='dd-left'>")
+            if self.config['show_created']:
+                html_parts.append(build_time_icon(created, 'doc_created'))
+            if self.config['show_updated']:
+                html_parts.append(build_time_icon(updated, 'doc_updated'))
+            if show_dates:
+                html_parts.append("</div>")
+
+            # 构建作者
             if self.config['show_author'] and authors:
                 def get_author_tooltip(author):
                     if author.url:
@@ -403,22 +403,22 @@ class DocumentDatesPlugin(BasePlugin):
                         return f'<a href="mailto:{author.email}">{author.name}</a>'
                     return author.name
 
+                if show_dates:
+                    html_parts.append("<div class='dd-right'>")
+                else:
+                    html_parts.append("<div class='dd-right dd-right-start'>")
+                icon = 'doc_author' if len(authors) == 1 else 'doc_authors'
+                html_parts.append(f"<span class='material-icons' data-icon='{icon}'></span>")
+                html_parts.append("<div class='author-group'>")
                 if self.config['show_author'] == 'text':
                     # 显示文本模式
-                    tooltip_text = ',&nbsp;'.join(get_author_tooltip(author) for author in authors)
-                    author_text = ', '.join(author.name for author in authors)
-                    icon = 'doc_author' if len(authors) == 1 else 'doc_authors'
-                    html_parts.append(
-                        f"<span data-tippy-content data-tippy-raw='{tooltip_text}'>"
-                        f"<span class='material-icons' data-icon='{icon}'></span>"
-                        f"{author_text}"
-                        f"</span>"
-                    )
+                    for index, author in enumerate(authors):
+                        if index > 0:
+                            html_parts.append(",&nbsp;&nbsp;")
+                        tooltip = get_author_tooltip(author)
+                        html_parts.append(f"<span class='text-wrapper' data-tippy-content data-tippy-raw='{ tooltip }'>{ tooltip }</span>")
                 else:
                     # 显示头像模式（默认）
-                    icon = 'doc_author' if len(authors) == 1 else 'doc_authors'
-                    html_parts.append(f"<span class='material-icons' data-icon='{icon}'></span>")
-                    html_parts.append("<div class='avatar-group'>")
                     for author in authors:
                         tooltip = get_author_tooltip(author)
                         html_parts.append(
@@ -427,7 +427,8 @@ class DocumentDatesPlugin(BasePlugin):
                             f"<img class='avatar' src='{author.avatar}' onerror=\"this.style.display='none'\" />"
                             f"</div>"
                         )
-                    html_parts.append("</div>")
+                html_parts.append("</div>")
+                html_parts.append("</div>")
 
             html_parts.append("</div></div>")
             return ''.join(html_parts)
@@ -438,6 +439,8 @@ class DocumentDatesPlugin(BasePlugin):
 
 
     def _insert_date_info(self, markdown: str, date_info: str):
+        if not date_info:
+            return markdown
         if self.config['position'] == 'top':
             first_line, insert_pos = self._find_markdown_body_start(markdown)
             if first_line.startswith(('# ', '<h1')):

{mkdocs_document_dates-3.4.9 → mkdocs_document_dates-3.5.1}/mkdocs_document_dates/static/config/user.config.css

@@ -1,7 +1,20 @@
-/* 1. Plug-in styles
-    including icons, fonts, colors, etc
+/* 1. Plug-in wrapper styles
+    including divider line, margin, padding, and the hiding of this plugin, etc
     */
+
+/* Remove the divider line: */
 /* 
+.document-dates-plugin-wrapper.document-dates-top,
+.document-dates-plugin-wrapper.document-dates-bottom {
+    border-bottom: none;
+} */
+
+
+
+/* 2. Plug-in styles
+    including icons, fonts, colors, etc
+    */
+/*
 .md-main .document-dates-plugin {
     color: rgba(109, 157, 204, 0.7);
     font-size: 0.75rem;
@@ -14,14 +27,15 @@
     Google Fonts Icons (2500+): https://fonts.google.com/icons
 
     doc_created:  add_circle, add_circle, note_add, more_time
-    doc_modified: update, check_circle, task, refresh
+    doc_updated:  update, check_circle, task, refresh
     doc_author:   person, account_circle
     doc_authors:  group, groups */
-/* 
+
+/*
 .document-dates-plugin .material-icons[data-icon="doc_created"]::before {
     content: "more_time";
 }
-.document-dates-plugin .material-icons[data-icon="doc_modified"]::before {
+.document-dates-plugin .material-icons[data-icon="doc_updated"]::before {
     content: "refresh";
 }
 .document-dates-plugin .material-icons[data-icon="doc_author"]::before {
@@ -33,22 +47,28 @@
 
 
 
-/* 2. Plug-in wrapper styles
-    including divider line, margin, padding, and the hiding of this plugin, etc
+/* 3. Author Avatar styles
+    e.g. shape, hover scale, grayscale mode
     */
-/* Remove the divider line: */
 /* 
-.document-dates-plugin-wrapper.document-dates-top,
-.document-dates-plugin-wrapper.document-dates-bottom {
-    border-bottom: none;
+.avatar-wrapper {
+    border-radius: 4px;
+    filter: grayscale(0%);
+}
+.avatar-wrapper:hover {
+    transform: scale(1.08);
 } */
 
 
 
-/* 3. Tooltip styles
+/* 4. Tooltip styles
     including theme, arrow, font, color, background color, etc
     */
 
+/* .tippy-box {
+    font-size: 12px;
+} */
+
 /* Demo of the custom theme 'sorrel' and 'sublime', you can configure it in user.config.js (optional) */
 /* 
 .tippy-box[data-theme~='sorrel'] {
@@ -66,17 +86,3 @@
 .tippy-box[data-theme~='sublime'] > .tippy-arrow::before {
     color: #474747;
 } */
-
-
-
-/* 4. Author Avatar styles
-    e.g. shape, hover scale, grayscale mode
-    */
-/* 
-.avatar-wrapper {
-    border-radius: 4px;
-    filter: grayscale(0%);
-}
-.avatar-wrapper:hover {
-    transform: scale(1.08);
-} */

{mkdocs_document_dates-3.4.9 → mkdocs_document_dates-3.5.1}/mkdocs_document_dates/static/config/user.config.js

@@ -8,6 +8,7 @@ Part 1:
 // tooltip_config.theme.light = 'tomato';
 // tooltip_config.placement = 'top';
 // tooltip_config.arrow = false;
+// tooltip_config.zIndex = 2;
 
 /* Or, override all configuration items: */
 /*
@@ -23,6 +24,7 @@ TooltipConfig.setConfig({
     interactive: true,      // content in Tooltip is interactive
     animation: 'scale',     // animation type: scale shift-away
     inertia: true,          // animation inertia
+    // zIndex: 2,              // control the display layer(z-index) of the tooltip element
     // arrow: false,           // whether to allow arrows
     // animateFill: true,      // determines if the background fill color should be animated
     // delay: [400, null],     // delay: [show, hide]: show is 400ms, and hide is null for the default value
@@ -70,7 +72,7 @@ Part 3:
 // Way 1: User-defined one language
 TooltipLanguage.register('en', {
     created_time: "Custom Created",
-    modified_time: "Custom Last Update",
+    updated_time: "Custom Last Update",
     author: "Custom Author",
     authors: "Custom Authors"
 });
@@ -79,13 +81,13 @@ TooltipLanguage.register('en', {
 const userLanguages = {
     en: {
         created_time: "Created",
-        modified_time: "Last Update",
+        updated_time: "Last Update",
         author: "Author",
         authors: "Authors"
     },
     zh: {
         created_time: "创建时间",
-        modified_time: "最后更新",
+        updated_time: "最后更新",
         author: "作者",
         authors: "作者"
     }