mkdocs-document-dates 3.2__tar.gz → 3.2.1__tar.gz

mkdocs_document_dates-3.2.1/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Aaron Wang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

{mkdocs_document_dates-3.2/mkdocs_document_dates.egg-info → mkdocs_document_dates-3.2.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: mkdocs-document-dates
-Version: 3.2
-Summary: An easy-to-use, lightweight MkDocs plugin for displaying the exact creation time, last modification time and author info of markdown documents.
+Version: 3.2.1
+Summary: A new generation MkDocs plugin for displaying exact meta-info of documents, such as creation time, last update time, authors, email, etc.
 Home-page: https://github.com/jaywhj/mkdocs-document-dates
 Author: Aaron Wang
 Author-email: aaronwqt@gmail.com
@@ -30,7 +30,7 @@ English | [简体中文](README_zh.md)
 
 
 
-An easy-to-use, lightweight MkDocs plugin for displaying the <mark>exact</mark> creation time, last modification time and author info of markdown documents.
+A new generation MkDocs plugin for displaying exact meta-info of documents, such as **creation time, last update time, authors, email**, etc.
 
 ## Features
 
@@ -43,6 +43,7 @@ An easy-to-use, lightweight MkDocs plugin for displaying the <mark>exact</mark>
   - Intelligent repositioning to always float optimally in view
   - Supports automatic theme switching following Material's light/dark color scheme
 - Multi-language support, cross-platform support (Windows, macOS, Linux)
+- Ultimate build efficiency O(1), typically less than 0.2 seconds, regardless of whether the number of documents is 1,000 or 10,000
 
 ## Showcases
 
@@ -75,7 +76,7 @@ plugins:
       time_format: '%H:%M:%S'  # Time format strings (valid only if type=datetime)
       exclude:                 # List of excluded files
         - temp.md              # Exclude specific file
-        - private/*            # Exclude all files in private directory, including subdirectories
+        - private/*            # Exclude all files in private folder, including subfolders
       show_author: true        # Show author or not, default: true
 ```
 
@@ -83,7 +84,7 @@ plugins:
 
 The plugin will automatically get the exact time of the document, will automatically cache the creation time, but of course, you can also specify it manually in `Front Matter`
 
-Priority order: `Front Matter` > `Cache Files` > `File System Timestamps`
+Priority order: `Front Matter` > `File System Timestamps(Cached)` > `Git Timestamps`
 
 ```yaml
 ---
@@ -101,7 +102,7 @@ modified: 2025-02-23
 
 The plugin will automatically get the author of the document, will parse the email and make a link, also you can specify it manually in `Front Matter`
 
-Priority order: `Front Matter` > `Git Author` > `site_author (mkdocs.yml)` > `PC Username`
+Priority order: `Front Matter` > `Git Author` > `site_author(mkdocs.yml)` > `PC Username`
 
 ```yaml
 ---
@@ -117,7 +118,7 @@ email: e-name@gmail.com
 
 ## Customization
 
-The plugin supports deep customization, such as **icon style, theme color, font, animation, dividing line**, etc. Everything is customizable (I've already written the code, you just need to turn on the uncomment switch):
+The plugin supports deep customization, such as **icon style, theme color, font, animation, dividing line**, etc. Everything is customizable (Find the file below and turn on the uncomment switch):
 
 |        Category:        | Location:                               |
 | :----------------------: | ---------------------------------------- |
@@ -146,7 +147,7 @@ The plugin supports deep customization, such as **icon style, theme color, font,
 ![06-change-theme](mkdocs_document_dates/demo_images/06-change-theme.png)
 ![08-pop-up-from-bottom](mkdocs_document_dates/demo_images/08-pop-up-from-bottom.png)
 
-## Used in templates
+## Template Variables
 
 You can access the meta-info of a document in a template using the following variables:
 

{mkdocs_document_dates-3.2 → mkdocs_document_dates-3.2.1}/README.md

@@ -4,7 +4,7 @@ English | [简体中文](README_zh.md)
 
 
 
-An easy-to-use, lightweight MkDocs plugin for displaying the <mark>exact</mark> creation time, last modification time and author info of markdown documents.
+A new generation MkDocs plugin for displaying exact meta-info of documents, such as **creation time, last update time, authors, email**, etc.
 
 ## Features
 
@@ -17,6 +17,7 @@ An easy-to-use, lightweight MkDocs plugin for displaying the <mark>exact</mark>
   - Intelligent repositioning to always float optimally in view
   - Supports automatic theme switching following Material's light/dark color scheme
 - Multi-language support, cross-platform support (Windows, macOS, Linux)
+- Ultimate build efficiency O(1), typically less than 0.2 seconds, regardless of whether the number of documents is 1,000 or 10,000
 
 ## Showcases
 
@@ -49,7 +50,7 @@ plugins:
       time_format: '%H:%M:%S'  # Time format strings (valid only if type=datetime)
       exclude:                 # List of excluded files
         - temp.md              # Exclude specific file
-        - private/*            # Exclude all files in private directory, including subdirectories
+        - private/*            # Exclude all files in private folder, including subfolders
       show_author: true        # Show author or not, default: true
 ```
 
@@ -57,7 +58,7 @@ plugins:
 
 The plugin will automatically get the exact time of the document, will automatically cache the creation time, but of course, you can also specify it manually in `Front Matter`
 
-Priority order: `Front Matter` > `Cache Files` > `File System Timestamps`
+Priority order: `Front Matter` > `File System Timestamps(Cached)` > `Git Timestamps`
 
 ```yaml
 ---
@@ -75,7 +76,7 @@ modified: 2025-02-23
 
 The plugin will automatically get the author of the document, will parse the email and make a link, also you can specify it manually in `Front Matter`
 
-Priority order: `Front Matter` > `Git Author` > `site_author (mkdocs.yml)` > `PC Username`
+Priority order: `Front Matter` > `Git Author` > `site_author(mkdocs.yml)` > `PC Username`
 
 ```yaml
 ---
@@ -91,7 +92,7 @@ email: e-name@gmail.com
 
 ## Customization
 
-The plugin supports deep customization, such as **icon style, theme color, font, animation, dividing line**, etc. Everything is customizable (I've already written the code, you just need to turn on the uncomment switch):
+The plugin supports deep customization, such as **icon style, theme color, font, animation, dividing line**, etc. Everything is customizable (Find the file below and turn on the uncomment switch):
 
 |        Category:        | Location:                               |
 | :----------------------: | ---------------------------------------- |
@@ -120,7 +121,7 @@ The plugin supports deep customization, such as **icon style, theme color, font,
 ![06-change-theme](mkdocs_document_dates/demo_images/06-change-theme.png)
 ![08-pop-up-from-bottom](mkdocs_document_dates/demo_images/08-pop-up-from-bottom.png)
 
-## Used in templates
+## Template Variables
 
 You can access the meta-info of a document in a template using the following variables:
 

{mkdocs_document_dates-3.2 → mkdocs_document_dates-3.2.1}/mkdocs_document_dates/cache_manager.py

@@ -1,7 +1,7 @@
 import logging
 import subprocess
 from pathlib import Path
-from .utils import read_json_cache, read_jsonl_cache, write_jsonl_cache, get_file_creation_time, get_git_first_commit_time
+from .utils import read_json_cache, read_jsonl_cache, write_jsonl_cache, get_file_creation_time
 
 logger = logging.getLogger("mkdocs.plugins.document_dates")
 logger.setLevel(logging.WARNING)  # DEBUG, INFO, WARNING, ERROR, CRITICAL
@@ -57,7 +57,7 @@ def update_cache():
 
             docs_dir = project_dir / 'docs'
             if not docs_dir.exists():
-                logger.error(f"Document directory does not exist: {docs_dir}")
+                logger.warning(f"Document directory does not exist: {docs_dir}")
                 continue
 
             # 设置.gitattributes文件
@@ -93,11 +93,7 @@ def update_cache():
                         jsonl_dates_cache[rel_path] = json_dates_cache[rel_path]
                         project_updated = True
                     elif full_path.exists():
-                        created_time = get_file_creation_time(full_path)
-                        if not jsonl_cache_file.exists() and not json_cache_file.exists():
-                            git_time = get_git_first_commit_time(full_path)
-                            if git_time:
-                                created_time = min(created_time, git_time)
+                        created_time = get_file_creation_time(full_path).astimezone()
                         jsonl_dates_cache[rel_path] = {
                             "created": created_time.isoformat()
                         }

{mkdocs_document_dates-3.2 → mkdocs_document_dates-3.2.1}/mkdocs_document_dates/plugin.py

@@ -7,12 +7,30 @@ from pathlib import Path
 from mkdocs.plugins import BasePlugin
 from mkdocs.config import config_options
 from mkdocs.structure.pages import Page
-from .utils import Author, read_json_cache, read_jsonl_cache, check_git_repo, get_file_creation_time, get_git_first_commit_time, get_git_authors
+from .utils import get_file_creation_time, load_git_cache, read_jsonl_cache
 
 logger = logging.getLogger("mkdocs.plugins.document_dates")
 logger.setLevel(logging.WARNING)  # DEBUG, INFO, WARNING, ERROR, CRITICAL
 
 
+class Author:
+    def __init__(self, name="", email="", **kwargs):
+        self.name = name
+        self.email = email
+        # 扩展属性
+        self.attributes = kwargs
+    
+    def __getattr__(self, name):
+        return self.attributes.get(name)
+    
+    def to_dict(self):
+        return {
+            'name': self.name,
+            'email': self.email,
+            **self.attributes
+        }
+
+
 class DocumentDatesPlugin(BasePlugin):
     config_scheme = (
         ('type', config_options.Type(str, default='date')),
@@ -34,7 +52,6 @@ class DocumentDatesPlugin(BasePlugin):
         super().__init__()
         self.translation = {}
         self.dates_cache = {}
-        self.is_git_repo = False
 
     def on_config(self, config):
         try:
@@ -44,25 +61,23 @@ class DocumentDatesPlugin(BasePlugin):
         except Exception:
             self.config['locale'] = 'en'
 
-        # 检查是否为 Git 仓库
-        self.is_git_repo = check_git_repo()
-
         docs_dir_path = Path(config['docs_dir'])
 
         # 加载 json 语言文件
         self._load_translation(docs_dir_path)
 
-        # 加载日期缓存
+        # 加载 git 缓存
+        self.dates_cache = load_git_cache(docs_dir_path)
+        # 加载 jsonl 缓存覆盖
         jsonl_cache_file = docs_dir_path / '.dates_cache.jsonl'
-        self.dates_cache = read_jsonl_cache(jsonl_cache_file)
-
-        # 兼容旧版缓存文件
-        if not self.dates_cache:
-            json_cache_file = docs_dir_path / '.dates_cache.json'
-            self.dates_cache = read_json_cache(json_cache_file)
+        if jsonl_cache_file.exists():
+            jsonl_cache = read_jsonl_cache(jsonl_cache_file)
+            for filename, new_info in jsonl_cache.items():
+                if filename in self.dates_cache:
+                    self.dates_cache[filename].update(new_info)
 
         """
-        Tippy.js
+        Tippy.js, for Tooltip
         # core
             https://unpkg.com/@popperjs/core@2/dist/umd/popper.min.js
             https://unpkg.com/tippy.js@6/dist/tippy.umd.min.js
@@ -83,7 +98,11 @@ class DocumentDatesPlugin(BasePlugin):
         for dir_name in ['tippy', 'core']:
             source_dir = Path(__file__).parent / 'static' / dir_name
             target_dir = dest_dir / dir_name
-            shutil.copytree(source_dir, target_dir, dirs_exist_ok=True)
+            # shutil.copytree(source_dir, target_dir, dirs_exist_ok=True)
+            target_dir.mkdir(parents=True, exist_ok=True)
+            for item in source_dir.iterdir():
+                if item.is_file():
+                    shutil.copy2(item, target_dir / item.name)
         
         # 复制配置文件模板到用户目录（如果不存在）
         config_files = ['user.config.css', 'user.config.js']
@@ -150,7 +169,7 @@ class DocumentDatesPlugin(BasePlugin):
             modified = self._get_file_modification_time(file_path)
         
         # 获取作者信息
-        authors = self._get_author_info(file_path, page, config)
+        authors = self._get_author_info(rel_path, page, config)
         
         # 在排除前暴露 meta 信息给前端使用
         page.meta['document_dates_created'] = created.isoformat()
@@ -202,17 +221,14 @@ class DocumentDatesPlugin(BasePlugin):
 
     def _is_excluded(self, rel_path):
         for pattern in self.config['exclude']:
-            # if fnmatch.fnmatch(rel_path, pattern):
-            if self._matches_exclude_pattern(rel_path, pattern):
-                return True
+            if pattern.endswith('*'):
+                if rel_path.startswith(pattern.partition('*')[0]):
+                    return True
+            else:
+                if rel_path == pattern:
+                    return True
         return False
 
-    def _matches_exclude_pattern(self, rel_path: str, pattern: str):
-        if '*' not in pattern:
-            return rel_path == pattern
-        else:
-            return rel_path.startswith(pattern.partition('*')[0])
-
 
     def _find_meta_date(self, meta, field_names):
         for field in field_names:
@@ -229,29 +245,16 @@ class DocumentDatesPlugin(BasePlugin):
         # 优先从缓存中读取
         if rel_path in self.dates_cache:
             return datetime.fromisoformat(self.dates_cache[rel_path]['created'])
-        
         # 从文件系统获取
-        fs_time = get_file_creation_time(file_path)
-        
-        # 获取Git首次提交时间
-        if self.is_git_repo:
-            git_time = get_git_first_commit_time(file_path)
-            # 取两者更早的时间
-            if git_time:
-                return min(fs_time, git_time)
-        return fs_time
+        return get_file_creation_time(file_path).astimezone()
 
     def _get_file_modification_time(self, file_path):
-        # 从git获取最后修改时间
-        # if self.is_git_repo:
-        #     return get_git_last_commit_time(file_path)
-
         # 从文件系统获取最后修改时间
         stat = os.stat(file_path)
-        return datetime.fromtimestamp(stat.st_mtime)
+        return datetime.fromtimestamp(stat.st_mtime).astimezone()
 
 
-    def _get_author_info(self, file_path, page, config):
+    def _get_author_info(self, rel_path, page, config):
         if not self.config['show_author']:
             return None
         # 1. meta author
@@ -259,10 +262,10 @@ class DocumentDatesPlugin(BasePlugin):
         if authors:
             return authors
         # 2. git author
-        if self.is_git_repo:
-            authors = get_git_authors(file_path)
-            if authors:
-                return authors
+        if rel_path in self.dates_cache:
+            authors_list = self.dates_cache[rel_path].get('authors')
+            if authors_list:
+                return [Author(**dict) for dict in authors_list]
         # 3. site_author 或 PC username
         return [Author(name=config.get('site_author') or Path.home().name)]
 
@@ -334,7 +337,11 @@ class DocumentDatesPlugin(BasePlugin):
             if self.config['show_author'] and authors:
                 if len(authors) == 1:
                     author, = authors
-                    author_tooltip = f'<a href="mailto:{author.email}">{author.name}</a>' if author.email else author.name
+                    if author.email:
+                        # 使用 HTML 实体编码避免 Tippy.js 转义问题
+                        author_tooltip = f'&lt;a href="mailto:{author.email}"&gt;{author.name}&lt;/a&gt;'
+                    else:
+                        author_tooltip = author.name
                     html += (
                         f"<span data-tippy-content='{self.translation.get('author', 'Author')}: {author_tooltip}'>"
                         f"<span class='material-icons' data-icon='doc_author'></span>"
@@ -344,7 +351,13 @@ class DocumentDatesPlugin(BasePlugin):
                 else:
                     # 多个作者的情况
                     authors_info = ', '.join(a.name for a in authors if a.name)
-                    authors_tooltip = ',&nbsp;'.join(f'<a href="mailto:{a.email}">{a.name}</a>' if a.email else a.name for a in authors)
+                    authors_tooltip_parts = []
+                    for a in authors:
+                        if a.email:
+                            authors_tooltip_parts.append(f'&lt;a href="mailto:{a.email}"&gt;{a.name}&lt;/a&gt;')
+                        else:
+                            authors_tooltip_parts.append(a.name)
+                    authors_tooltip = ',&nbsp;'.join(authors_tooltip_parts)
                     html += (
                         f"<span data-tippy-content='{self.translation.get('authors', 'Authors')}: {authors_tooltip}'>"
                         f"<span class='material-icons' data-icon='doc_authors'></span>"
@@ -361,9 +374,46 @@ class DocumentDatesPlugin(BasePlugin):
 
     def _insert_date_info(self, markdown: str, date_info: str):
         if self.config['position'] == 'top':
-            before, _, after = markdown.lstrip().partition('\n')
-            if before.startswith('# '):
-                return f"{before}\n{date_info}\n{after}"
+            first_line, insert_pos = self.find_markdown_body_start(markdown)
+            if first_line.startswith(('# ', '<h1')):
+                return markdown[:insert_pos] + date_info + '\n' + markdown[insert_pos:]
             else:
                 return f"{date_info}\n{markdown}"
         return f"{markdown}\n\n{date_info}"
+
+    def find_markdown_body_start(self, text: str):
+        pos = 0
+        length = len(text)
+        in_comment = False
+        WHITESPACE = {' ', '\t', '\r', '\n'}
+
+        while pos < length:
+            next_newline = text.find('\n', pos)
+            if next_newline == -1:
+                next_newline = length
+
+            start = pos
+            while start < next_newline and text[start] in WHITESPACE:
+                start += 1
+
+            if start < next_newline:
+                if not in_comment:
+                    if text.startswith('<!--', start):
+                        in_comment = True
+                        start += 4
+                
+                if in_comment:
+                    comment_end = text.find('-->', start, next_newline)
+                    if comment_end != -1:
+                        in_comment = False
+                        pos = comment_end + 3
+                        continue
+                    pos = next_newline + 1
+                    continue
+
+                # 找到正文行
+                return text[start:next_newline], next_newline + 1 if next_newline < length else length
+
+            pos = next_newline + 1
+
+        return '', length

{mkdocs_document_dates-3.2 → mkdocs_document_dates-3.2.1}/mkdocs_document_dates/static/config/user.config.css

@@ -2,11 +2,11 @@
     including icons, fonts, colors, etc
     */
 /* 
-.document-dates-plugin {
+.md-main .document-dates-plugin {
     color: rgba(109, 157, 204, 0.7);
     font-size: 0.75rem;
 }
-.document-dates-plugin .material-icons {
+.md-main .document-dates-plugin .material-icons {
     font-size: 0.9rem;
 } */
 
@@ -34,13 +34,12 @@
 
 
 /* 2. Plug-in wrapper styles
-    including divider, margin, padding, etc
+    including divider line, margin, padding, etc
+    for example, remove the divider line like below:
     */
 /* 
-.document-dates-plugin-wrapper.document-dates-top {
-    border-bottom: 1px solid rgba(142, 142, 142, 0.15);
-}
-.document-dates-plugin-wrapper.document-dates-bottom {
+.md-main .document-dates-plugin-wrapper.document-dates-top,
+.md-main .document-dates-plugin-wrapper.document-dates-bottom {
     border-bottom: none;
 } */
 

{mkdocs_document_dates-3.2 → mkdocs_document_dates-3.2.1}/mkdocs_document_dates/static/config/user.config.js

@@ -76,10 +76,18 @@ const localeFunc = (number, index) => {
 };
 const localeStr = 'whatever';
 timeago.register(localeStr, localeFunc);
-
-if (typeof timeago !== 'undefined') {
-    document.querySelectorAll('.document-dates-plugin time').forEach(timeElement => {
-        timeElement.textContent = timeago.format(timeElement.getAttribute('datetime'), localeStr);
-    });
+function formatTimeagoElements() {
+    if (typeof timeago !== 'undefined') {
+        document.querySelectorAll('.document-dates-plugin time').forEach(timeElement => {
+            timeElement.textContent = timeago.format(timeElement.getAttribute('datetime'), localeStr);
+        });
+    }
+}
+if (typeof window.document$ !== 'undefined' && !window.document$.isStopped) {
+    // Compatible with Material for MkDocs 'navigation.instant'
+    window.document$.subscribe(formatTimeagoElements);
+} else {
+    // Fallback to standard DOMContentLoaded for other themes
+    formatTimeagoElements();
 }
 */

{mkdocs_document_dates-3.2 → mkdocs_document_dates-3.2.1}/mkdocs_document_dates/static/core/core.css

@@ -3,13 +3,17 @@
     including icons, fonts, colors, etc
     */
 .document-dates-plugin {
-    color: rgba(142, 142, 142, 0.7);
-    font-size: 0.75rem;
+    color: #666;
+    font-size: 0.9rem;
     padding: 0.2rem 0;
     display: flex;
     align-items: center;
     margin-bottom: 0.3rem;
 }
+.md-main .document-dates-plugin {
+    color: rgba(142, 142, 142, 0.7);
+    font-size: 0.75rem;
+}
 .document-dates-plugin span:not(:first-child) {
     margin-left: 1.5rem;
 }
@@ -18,9 +22,13 @@
     align-items: center;
 }
 .document-dates-plugin .material-icons {
+    font-size: 1rem;
+    opacity: 0.85;
+    margin-right: 0.3rem;
+}
+.md-main .document-dates-plugin .material-icons {
     font-size: 0.9rem;
     opacity: 0.7;
-    margin-right: 0.3rem;
 }
 
 /* Customized icons, just change the icon name.
@@ -48,16 +56,15 @@
 /* 2. Plug-in wrapper styles
     including divider, margin, padding, etc
     */
-.document-dates-plugin-wrapper.document-dates-top {
-    margin: -1rem 0 1rem 0;
-    padding-bottom: 0.3rem;
-    border-bottom: 1px solid rgba(142, 142, 142, 0.15);
-}
+.document-dates-plugin-wrapper.document-dates-top,
 .document-dates-plugin-wrapper.document-dates-bottom {
     margin: 1rem 0;
     padding-bottom: 0.3rem;
     border-bottom: 1px solid rgba(142, 142, 142, 0.15);
 }
+.md-main .document-dates-plugin-wrapper.document-dates-top {
+    margin: -1rem 0 1rem 0;
+}
 
 /* Hide the footnote divider immediately following the date information with the CSS adjacent sibling selector */
 .document-dates-plugin-wrapper + .footnote hr {

{mkdocs_document_dates-3.2 → mkdocs_document_dates-3.2.1}/mkdocs_document_dates/static/core/core.js

@@ -62,13 +62,20 @@ function getCurrentTheme() {
 
 // Main initialization
 async function init() {
-    await executeHooks('beforeInit', { tippy_config });
+    // Create context object to pass to hooks and return from function
+    const context = { tippy_config };
+    
+    // Execute beforeInit hooks
+    await executeHooks('beforeInit', context);
 
     // Configure the properties of the Tooltip here, available documents: https://atomiks.github.io/tippyjs/
     const tippyInstances = tippy('[data-tippy-content]', {
         ...tippy_config.tooltip,
         theme: getCurrentTheme()    // Initialize Tooltip's theme based on Material's light/dark color scheme
     });
+    
+    // Store instances in context
+    context.tippyInstances = tippyInstances;
 
     // Automatic theme switching. Set Tooltip's theme to change automatically with the Material's light/dark color scheme
     const observer = new MutationObserver((mutations) => {
@@ -86,25 +93,66 @@ async function init() {
         attributes: true,
         attributeFilter: ['data-md-color-scheme']
     });
-
-    await executeHooks('afterInit', { tippyInstances });
+    
+    // Store observer in context
+    context.observer = observer;
+
+    // Execute afterInit hooks
+    await executeHooks('afterInit', context);
+    
+    // Return context with instances and observer for cleanup
+    return context;
 }
 
-// Singleton Initialization
+// Initialization Manager
 const initManager = (() => {
-    let initialized = false;
+    let tippyInstances = [];
+    let observer = null;
+    
+    // Function to clean up previous instances
+    function cleanup() {
+        // Destroy previous tippy instances if they exist
+        if (tippyInstances.length > 0) {
+            tippyInstances.forEach(instance => instance.destroy());
+            tippyInstances = [];
+        }
+        
+        // Disconnect previous observer if it exists
+        if (observer) {
+            observer.disconnect();
+            observer = null;
+        }
+    }
+    
     return {
+        // This can be called multiple times, especially with navigation.instant
         initialize() {
-            if (initialized) return;
-            init();
-            initialized = true;
+            // Clean up previous instances first
+            cleanup();
+            
+            // Initialize new instances
+            init().then(context => {
+                if (context && context.tippyInstances) {
+                    tippyInstances = context.tippyInstances;
+                }
+                if (context && context.observer) {
+                    observer = context.observer;
+                }
+            });
         }
     };
 })();
 
-// Entrance
-document.addEventListener('DOMContentLoaded', initManager.initialize);
 
+// Entrance - Compatible with Material for MkDocs 'navigation.instant'
+// Check if Material for MkDocs document$ observable is available
+if (typeof window.document$ !== 'undefined' && !window.document$.isStopped) {
+    // Use Material's document$ observable for both initial load and navigation.instant
+    window.document$.subscribe(initManager.initialize);
+} else {
+    // Fallback to standard DOMContentLoaded for other themes
+    document.addEventListener('DOMContentLoaded', initManager.initialize);
+}
 
 
 // Export API

mkdocs_document_dates-3.2.1/mkdocs_document_dates/static/core/timeago-load.js

@@ -0,0 +1,18 @@
+// Function to format timeago elements
+function formatTimeagoElements() {
+    if (typeof timeago !== 'undefined') {
+        document.querySelectorAll('.document-dates-plugin time').forEach(timeElement => {
+            timeElement.textContent = timeago.format(timeElement.getAttribute('datetime'), timeElement.getAttribute('locale'));
+        });
+    }
+}
+
+// Compatible with Material for MkDocs 'navigation.instant'
+// Check if Material for MkDocs document$ observable is available
+if (typeof window.document$ !== 'undefined' && !window.document$.isStopped) {
+    // Use Material's document$ observable for both initial load and navigation.instant
+    window.document$.subscribe(formatTimeagoElements);
+} else {
+    // Fallback to standard DOMContentLoaded for other themes
+    formatTimeagoElements();
+}

{mkdocs_document_dates-3.2 → mkdocs_document_dates-3.2.1}/mkdocs_document_dates/utils.py

@@ -5,27 +5,54 @@ import logging
 import subprocess
 from pathlib import Path
 from datetime import datetime
+from collections import defaultdict
 
 logger = logging.getLogger("mkdocs.plugins.document_dates")
 logger.setLevel(logging.WARNING)  # DEBUG, INFO, WARNING, ERROR, CRITICAL
 
-class Author:
-    def __init__(self, name="", email="", **kwargs):
-        self.name = name
-        self.email = email
-        # 扩展属性
-        self.attributes = kwargs
-    
-    def __getattr__(self, name):
-        return self.attributes.get(name)
-    
-    def to_dict(self):
-        return {
-            'name': self.name,
-            'email': self.email,
-            **self.attributes
-        }
 
+def load_git_cache(docs_dir_path: Path):
+    dates_cache = {}
+    try:
+        cmd = ['git', 'log', '--reverse', '--no-merges', '--name-only', '--format=%an|%ae|%aI', '--', '*.md']
+        process = subprocess.run(cmd, cwd=docs_dir_path, capture_output=True, text=True)
+        if process.returncode == 0:
+            git_root = Path(subprocess.check_output(
+                ['git', 'rev-parse', '--show-toplevel'],
+                cwd=docs_dir_path,
+                text=True, encoding='utf-8'
+            ).strip())
+            docs_prefix = docs_dir_path.relative_to(git_root).as_posix()
+
+            authors_dict = defaultdict(set)
+            first_commit = {}
+            current_commit = None
+
+            for line in process.stdout.splitlines():
+                line = line.strip()
+                if not line:
+                    continue
+                if '|' in line:
+                    name, email, created = line.split('|', 2)
+                    current_commit = {'name': name, 'email': email, 'created': created}
+                elif line.endswith('.md') and current_commit:
+                    if line.startswith(docs_prefix + '/'):
+                        line = line[len(docs_prefix) + 1:]
+                    authors_dict[line].add((current_commit['name'], current_commit['email']))
+                    if line not in first_commit:
+                        first_commit[line] = current_commit['created']
+
+            for file_path in sorted(first_commit):
+                dates_cache[file_path] = {
+                    'created': first_commit[file_path],
+                    'authors': [
+                        {'name': name, 'email': email}
+                        for name, email in sorted(authors_dict[file_path])
+                        ]
+                }
+    except Exception as e:
+        logger.info(f"Error getting git info in {docs_dir_path}: {e}")
+    return dates_cache
 
 def get_file_creation_time(file_path):
     try:
@@ -44,58 +71,6 @@ def get_file_creation_time(file_path):
         logger.error(f"Failed to get file creation time for {file_path}: {e}")
         return datetime.now()
 
-def check_git_repo():
-    try:
-        check_git = subprocess.run(['git', 'rev-parse', '--is-inside-work-tree'], capture_output=True, text=True)
-        if check_git.returncode == 0:
-            return True
-    except Exception as e:
-        logger.info(f"Not a Git repository: {str(e)}")
-    return False
-
-def get_git_first_commit_time(file_path):
-    try:
-        # git log --reverse --format="%aI" -- {file_path} | head -n 1
-        cmd_list = ['git', 'log', '--reverse', '--format=%aI', '--', file_path]
-        process = subprocess.run(cmd_list, capture_output=True, text=True)
-        if process.returncode == 0 and process.stdout.strip():
-            first_line = process.stdout.partition('\n')[0].strip()
-            return datetime.fromisoformat(first_line).replace(tzinfo=None)
-    except Exception as e:
-        logger.info(f"Error getting git first commit time for {file_path}: {e}")
-    return None
-
-def get_git_last_commit_time(file_path):
-    try:
-        cmd_list = ['git', 'log', '-1', '--format=%aI', '--', file_path]
-        process = subprocess.run(cmd_list, capture_output=True, text=True)
-        if process.returncode == 0 and process.stdout.strip():
-            git_time = process.stdout.strip()
-            return datetime.fromisoformat(git_time).replace(tzinfo=None)
-    except Exception as e:
-        logger.info(f"Error getting git last commit time for {file_path}: {e}")
-    return None
-
-def get_git_authors(file_path):
-    try:
-        # 为了兼容性，不采用管道命令，在 python 中处理去重
-        # git log --format="%an|%ae" -- {file_path} | sort | uniq
-        # git log --format="%an|%ae" -- {file_path} | grep -vE "bot|noreply|ci|github-actions|dependabot|renovate" | sort | uniq
-        cmd_list = ['git', 'log', '--format=%an|%ae', '--', file_path]
-        process = subprocess.run(cmd_list, capture_output=True, text=True)
-        if process.returncode == 0 and process.stdout.strip():
-            # 使用字典去重和存储作者
-            authors_map = {}
-            for line in process.stdout.splitlines():
-                if not line.strip() or line in authors_map:
-                    continue
-                name, email = line.split('|')
-                authors_map[line] = Author(name=name, email=email)
-            return list(authors_map.values()) or None
-    except Exception as e:
-        logger.warning(f"Failed to get git author info: {str(e)}")
-    return None
-
 def read_json_cache(cache_file: Path):
     dates_cache = {}
     if cache_file.exists():
@@ -141,7 +116,7 @@ def write_jsonl_cache(jsonl_file: Path, dates_cache, tracked_files):
         logger.info(f"Successfully updated JSONL cache file: {jsonl_file}")
         return True
     except (IOError, json.JSONDecodeError) as e:
-        logger.error(f"Failed to write JSONL cache file {jsonl_file}: {e}")
+        logger.warning(f"Failed to write JSONL cache file {jsonl_file}: {e}")
     except Exception as e:
-        logger.error(f"Failed to add JSONL cache file to git: {e}")
+        logger.warning(f"Failed to add JSONL cache file to git: {e}")
     return False

{mkdocs_document_dates-3.2 → mkdocs_document_dates-3.2.1/mkdocs_document_dates.egg-info}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: mkdocs-document-dates
-Version: 3.2
-Summary: An easy-to-use, lightweight MkDocs plugin for displaying the exact creation time, last modification time and author info of markdown documents.
+Version: 3.2.1
+Summary: A new generation MkDocs plugin for displaying exact meta-info of documents, such as creation time, last update time, authors, email, etc.
 Home-page: https://github.com/jaywhj/mkdocs-document-dates
 Author: Aaron Wang
 Author-email: aaronwqt@gmail.com
@@ -30,7 +30,7 @@ English | [简体中文](README_zh.md)
 
 
 
-An easy-to-use, lightweight MkDocs plugin for displaying the <mark>exact</mark> creation time, last modification time and author info of markdown documents.
+A new generation MkDocs plugin for displaying exact meta-info of documents, such as **creation time, last update time, authors, email**, etc.
 
 ## Features
 
@@ -43,6 +43,7 @@ An easy-to-use, lightweight MkDocs plugin for displaying the <mark>exact</mark>
   - Intelligent repositioning to always float optimally in view
   - Supports automatic theme switching following Material's light/dark color scheme
 - Multi-language support, cross-platform support (Windows, macOS, Linux)
+- Ultimate build efficiency O(1), typically less than 0.2 seconds, regardless of whether the number of documents is 1,000 or 10,000
 
 ## Showcases
 
@@ -75,7 +76,7 @@ plugins:
       time_format: '%H:%M:%S'  # Time format strings (valid only if type=datetime)
       exclude:                 # List of excluded files
         - temp.md              # Exclude specific file
-        - private/*            # Exclude all files in private directory, including subdirectories
+        - private/*            # Exclude all files in private folder, including subfolders
       show_author: true        # Show author or not, default: true
 ```
 
@@ -83,7 +84,7 @@ plugins:
 
 The plugin will automatically get the exact time of the document, will automatically cache the creation time, but of course, you can also specify it manually in `Front Matter`
 
-Priority order: `Front Matter` > `Cache Files` > `File System Timestamps`
+Priority order: `Front Matter` > `File System Timestamps(Cached)` > `Git Timestamps`
 
 ```yaml
 ---
@@ -101,7 +102,7 @@ modified: 2025-02-23
 
 The plugin will automatically get the author of the document, will parse the email and make a link, also you can specify it manually in `Front Matter`
 
-Priority order: `Front Matter` > `Git Author` > `site_author (mkdocs.yml)` > `PC Username`
+Priority order: `Front Matter` > `Git Author` > `site_author(mkdocs.yml)` > `PC Username`
 
 ```yaml
 ---
@@ -117,7 +118,7 @@ email: e-name@gmail.com
 
 ## Customization
 
-The plugin supports deep customization, such as **icon style, theme color, font, animation, dividing line**, etc. Everything is customizable (I've already written the code, you just need to turn on the uncomment switch):
+The plugin supports deep customization, such as **icon style, theme color, font, animation, dividing line**, etc. Everything is customizable (Find the file below and turn on the uncomment switch):
 
 |        Category:        | Location:                               |
 | :----------------------: | ---------------------------------------- |
@@ -146,7 +147,7 @@ The plugin supports deep customization, such as **icon style, theme color, font,
 ![06-change-theme](mkdocs_document_dates/demo_images/06-change-theme.png)
 ![08-pop-up-from-bottom](mkdocs_document_dates/demo_images/08-pop-up-from-bottom.png)
 
-## Used in templates
+## Template Variables
 
 You can access the meta-info of a document in a template using the following variables:
 

{mkdocs_document_dates-3.2 → mkdocs_document_dates-3.2.1}/setup.py

@@ -26,9 +26,9 @@ try:
     with open("README.md", "r", encoding="utf-8") as fh:
         long_description = fh.read()
 except FileNotFoundError:
-    long_description = "An easy-to-use, lightweight MkDocs plugin for displaying the exact creation time, last modification time and author info of markdown documents."
+    long_description = "A new generation MkDocs plugin for displaying exact meta-info of documents, such as creation time, last update time, authors, email, etc."
 
-VERSION = '3.2'
+VERSION = '3.2.1'
 
 setup(
     name="mkdocs-document-dates",
@@ -36,7 +36,7 @@ setup(
     author="Aaron Wang",
     author_email="aaronwqt@gmail.com",
     license="MIT",
-    description="An easy-to-use, lightweight MkDocs plugin for displaying the exact creation time, last modification time and author info of markdown documents.",
+    description="A new generation MkDocs plugin for displaying exact meta-info of documents, such as creation time, last update time, authors, email, etc.",
     long_description=long_description,
     long_description_content_type="text/markdown",
     url="https://github.com/jaywhj/mkdocs-document-dates",

mkdocs_document_dates-3.2/LICENSE

@@ -1,11 +0,0 @@
-MIT License
-
-Copyright (c) 2024 Aaron Wang
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-

mkdocs_document_dates-3.2/mkdocs_document_dates/static/core/timeago-load.js

@@ -1,5 +0,0 @@
-if (typeof timeago !== 'undefined') {
-    document.querySelectorAll('.document-dates-plugin time').forEach(timeElement => {
-        timeElement.textContent = timeago.format(timeElement.getAttribute('datetime'), timeElement.getAttribute('locale'));
-    });
-}