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

{mkdocs_document_dates-3.5/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.5
-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
@@ -44,9 +44,7 @@ A new generation MkDocs plugin for displaying exact **creation date, last update
 - [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: |
@@ -94,10 +92,21 @@ In addition to the above basic configuration, the plug-in also provides a wealth
 - [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
-- [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.
+- [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` 
 - [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.5 → mkdocs_document_dates-3.5.1}/README.md

@@ -18,9 +18,7 @@ A new generation MkDocs plugin for displaying exact **creation date, last update
 - [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: |
@@ -68,10 +66,21 @@ In addition to the above basic configuration, the plug-in also provides a wealth
 - [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
-- [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.
+- [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` 
 - [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.5 → mkdocs_document_dates-3.5.1}/mkdocs_document_dates/plugin.py

@@ -54,7 +54,6 @@ class DocumentDatesPlugin(BasePlugin):
         docs_dir_path = Path(config['docs_dir'])
 
         # 加载 author 配置
-        self._extract_github_username(config.get('repo_url'))
         authors_file = docs_dir_path / 'authors.yml'
         if not authors_file.exists():
             try:
@@ -158,10 +157,6 @@ class DocumentDatesPlugin(BasePlugin):
         
         # 获取作者信息
         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()
@@ -225,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
@@ -380,7 +364,12 @@ class DocumentDatesPlugin(BasePlugin):
 
     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}'>")
@@ -389,18 +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>"
                 )
 
+            # 构建日期
+            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:
@@ -409,23 +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"{tooltip_text}"
-                        # 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(
@@ -434,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)
@@ -445,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.5 → 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;
@@ -18,7 +31,7 @@
     doc_author:   person, account_circle
     doc_authors:  group, groups */
 
-/* 
+/*
 .document-dates-plugin .material-icons[data-icon="doc_created"]::before {
     content: "more_time";
 }
@@ -34,23 +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'] {
@@ -68,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.5 → 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

{mkdocs_document_dates-3.5 → mkdocs_document_dates-3.5.1}/mkdocs_document_dates/static/core/core.css

@@ -1,12 +1,31 @@
+/* ==========================================================================
+   1. Plug-in wrapper styles
+   ========================================================================== */
+.document-dates-plugin-wrapper.document-dates-top,
+.document-dates-plugin-wrapper.document-dates-bottom {
+    margin: 1rem 0;
+    border-bottom: 1px solid rgba(142, 142, 142, 0.1);
+}
+.md-main .document-dates-plugin-wrapper.document-dates-top {
+    margin: -1rem 0 1rem 0;
+}
 
-/* 1. Plug-in styles
-    including icons, fonts, colors, etc
-    */
+/* Hide the footnote divider immediately following the date information with the CSS adjacent sibling selector */
+.document-dates-plugin-wrapper + .footnote hr {
+    display: none;
+}
+
+
+/* ==========================================================================
+   2. Plug-in Layout & Fonts
+   ========================================================================== */
 .document-dates-plugin {
     color: #666;
     font-size: 0.9rem;
     display: flex;
+    /* flex-wrap: nowrap; */
     align-items: center;
+    justify-content: space-between;
     padding: 0.2rem 0;
     margin-bottom: 0.6rem;
 }
@@ -14,17 +33,14 @@
     color: rgba(142, 142, 142, 0.7);
     font-size: 0.75rem;
 }
-.document-dates-plugin > span {
-    display: inline-flex;
-    align-items: center;
-}
-.document-dates-plugin > span:not(:first-child) {
-    margin-left: 1.5rem;
-}
+
 .document-dates-plugin .material-icons {
     font-size: 1rem;
     opacity: 0.85;
     margin-right: 0.3rem;
+    display: inline-flex;
+    align-items: center;
+    line-height: 1;
 }
 .md-main .document-dates-plugin .material-icons {
     font-size: 0.9rem;
@@ -51,92 +67,79 @@
     content: "group";
 }
 
-
-
-/* 2. Plug-in wrapper styles
-    including divider, margin, padding, etc
-    */
-.document-dates-plugin-wrapper.document-dates-top,
-.document-dates-plugin-wrapper.document-dates-bottom {
-    margin: 1rem 0;
-    border-bottom: 1px solid rgba(142, 142, 142, 0.1);
+.dd-left {
+    display: flex;
+    align-items: center;
+    margin-right: 1.5rem;
 }
-.md-main .document-dates-plugin-wrapper.document-dates-top {
-    margin: -1rem 0 1rem 0;
+.dd-item {
+    display: inline-flex;
+    align-items: center;
+    white-space: nowrap;
+    flex-shrink: 0;
+    line-height: 1;
+}
+.dd-left > .dd-item + .dd-item {
+    margin-left: 1.5rem;
 }
 
-/* Hide the footnote divider immediately following the date information with the CSS adjacent sibling selector */
-.document-dates-plugin-wrapper + .footnote hr {
-    display: none;
+.dd-right {
+    display: flex;
+    align-items: center;
+    justify-content: flex-end;
+    flex: 1 1 auto;
+    min-width: 110px;
 }
 
+.dd-right.dd-right-start {
+    justify-content: flex-start;
+}
 
+/* ==========================================================================
+   3. Author Avatar styles
+   ========================================================================== */
+.author-group {
+    display: flex;
+    align-items: center;
+    flex-wrap: nowrap;
 
-/* 3. Tooltip styles
-    including theme, arrow, font, color, background color, etc
-    */
+    overflow-x: auto;
+    overflow-y: hidden;
 
-/* .tippy-box {
-    font-size: 12px;
-} */
+    /* Prevent overflow of child elements when scaling */
+    padding: 0.15rem 0.15rem 0.15rem 0;
 
-/* Demo of the custom theme 'tomato' (optional) */
-.tippy-box[data-theme~='tomato'] {
-    background-color: tomato;
-    color: white;
-}
-/* Customize the arrow corresponding to the theme tomato */
-.tippy-box[data-theme~='tomato'] > .tippy-arrow::before {
-    color: tomato;
-}
-/* 
-Recommended Colors:
-    tomato: rgb(241, 112, 91);
-    mung_bean: rgb(122, 145, 109);
-    cloisonné: rgb(15, 89, 164);
-    soft_blue: rgb(16, 104, 152);
-*/
+    margin-right: 10px;
 
-/* Customize arrows, resize */
-.tippy-arrow::before {
-    -webkit-transform: scale(0.75);
-    -ms-transform: scale(0.75);
-    transform: scale(0.75);
+    scrollbar-width: none;
+    -ms-overflow-style: none;
 }
-
-
-
-/* 4. Author Avatar styles */
-.avatar-group {
-    display: flex;
-    align-items: center;
-    flex-wrap: wrap;
-    margin: -0.15rem;
-    padding-left: 0.15rem;
+.author-group::-webkit-scrollbar {
+    display: none;
 }
+
 .avatar-wrapper {
-    margin: 0.15rem;
+    margin-left: 0.3rem;
     position: relative;
-    width: 30px;
-    height: 30px;
+    width: 32px;
+    height: 32px;
     border-radius: 50%;
     overflow: hidden;
     flex-shrink: 0;
-    opacity: 0.7;
+    opacity: 0.85;
     filter: grayscale(90%);
     transition: transform 0.2s ease, filter 0.2s ease;
+    display: block;
+
+    /* Fix bug in Safari: rounded corners may blink to show square corners */
+    will-change: transform;
+    transform: translateZ(0);
 }
 .avatar-wrapper:hover {
     transform: scale(1.08);
     filter: grayscale(0%);
     cursor: pointer;
 }
-.avatar-wrapper img.avatar {
-    position: absolute;
-    width: 100%;
-    height: 100%;
-    object-fit: cover;
-}
 .avatar-wrapper .avatar-text {
     position: absolute;
     width: 100%;
@@ -150,3 +153,62 @@ Recommended Colors:
     justify-content: center;
     text-transform: capitalize;
 }
+.avatar-wrapper img.avatar {
+    position: absolute;
+    width: 100%;
+    height: 100%;
+    object-fit: cover;
+}
+
+/* Show authors in text mode */
+.author-group .text-wrapper {
+    display: inline-flex;
+    align-items: center;
+    white-space: nowrap;
+    flex-shrink: 0;
+}
+
+/* Optimize the experience with line breaks on very narrow screens */
+@media screen and (max-width: 359px) {
+    .document-dates-plugin {
+        flex-wrap: wrap;
+    }
+    .dd-right {
+        justify-content: flex-start;
+        width: 100%;
+        margin: 10px 0 0 0;
+    }
+}
+
+
+/* ==========================================================================
+   4. Tooltip styles, including theme, arrow, font, color, background color, etc
+   ========================================================================== */
+
+/* .tippy-box {
+    font-size: 12px;
+} */
+
+/* Demo of the custom theme 'tomato' (optional) */
+.tippy-box[data-theme~='tomato'] {
+    background-color: tomato;
+    color: white;
+}
+/* Customize the arrow corresponding to the theme tomato */
+.tippy-box[data-theme~='tomato'] > .tippy-arrow::before {
+    color: tomato;
+}
+/* 
+Recommended Colors:
+    tomato: rgb(241, 112, 91);
+    mung_bean: rgb(122, 145, 109);
+    cloisonné: rgb(15, 89, 164);
+    soft_blue: rgb(16, 104, 152);
+*/
+
+/* Customize arrows, resize */
+.tippy-arrow::before {
+    -webkit-transform: scale(0.75);
+    -ms-transform: scale(0.75);
+    transform: scale(0.75);
+}

{mkdocs_document_dates-3.5 → mkdocs_document_dates-3.5.1}/mkdocs_document_dates/static/core/core.js

@@ -145,6 +145,33 @@ function initTippy() {
     return context;
 }
 
+// 在滚动时隐藏 author-group 的 tooltip
+function initAuthorGroupTippyGuard() {
+    document.querySelectorAll('.author-group').forEach(groupEl => {
+        if (groupEl._ddTippyGuardAbortController) {
+            groupEl._ddTippyGuardAbortController.abort();
+        }
+        const controller = new AbortController();
+        groupEl._ddTippyGuardAbortController = controller;
+
+        const getInstances = () => {
+            return Array.from(groupEl.querySelectorAll('[data-tippy-content]'))
+                .map(el => el._tippy)
+                .filter(Boolean);
+        };
+        const hideNow = () => {
+            const instances = getInstances();
+            instances.forEach(instance => {
+                instance.hide();
+            });
+        };
+
+        const opts = { passive: true, signal: controller.signal };
+        groupEl.addEventListener('scroll', hideNow, opts);
+        groupEl.addEventListener('touchmove', hideNow, opts);
+    });
+}
+
 // 通过 IIFE（立即执行的函数表达式）创建 tippyManager
 const tippyManager = (() => {
     let tippyInstances = [];
@@ -174,6 +201,7 @@ const tippyManager = (() => {
             if (context && context.observer) {
                 observer = context.observer;
             }
+            initAuthorGroupTippyGuard();
         }
     };
 })();

{mkdocs_document_dates-3.5 → mkdocs_document_dates-3.5.1}/mkdocs_document_dates/static/core/default.config.js

@@ -13,6 +13,7 @@ const ttDefaultConfig = {
     interactive: true,      // 是否允许内容交互
     animation: 'scale',     // 动画类型: scale shift-away
     inertia: true,          // 是否允许动画惯性
+    zIndex: 2,              // 控制 tooltip 元素的显示层级(z-index)
     // arrow: false,           // 是否允许箭头
     // animateFill: true,      // 背景填充颜色是否应为动画效果
     // delay: [400, null],     // 动画延迟: [show, hide]: show 为 400 毫秒, hide 为 null 表示默认值

{mkdocs_document_dates-3.5 → mkdocs_document_dates-3.5.1}/mkdocs_document_dates/utils.py

@@ -3,6 +3,8 @@ import platform
 import json
 import heapq
 import logging
+import hashlib
+import requests
 import subprocess
 from pathlib import Path
 from datetime import datetime
@@ -66,10 +68,11 @@ def load_git_metadata(docs_dir_path: Path):
         cmd = ['git', 'log', '--reverse', '--no-merges', '--use-mailmap', '--name-only', '--format=%aN|%aE|%aI', f'--relative={rel_docs_path}', '--', '*.md']
         process = subprocess.run(cmd, cwd=docs_dir_path, capture_output=True, encoding='utf-8')
         if process.returncode == 0:
+            init_avatar_provider()
+
             authors_dict = defaultdict(dict)
             first_commit = {}
             current_commit = None
-
             for line in process.stdout.splitlines():
                 line = line.strip()
                 if not line:
@@ -82,14 +85,14 @@ def load_git_metadata(docs_dir_path: Path):
                     # 使用 defaultdict(dict)结构，处理有序与去重
                         # a.巧用 Python 字典的 setdefault 特性来去重（setdefault 为不存在的键提供初始值，不会覆盖已有值）
                         # b.巧用 Python 字典的插入顺序特性来保留内容插入顺序（Python 3.7+ 字典会保持插入顺序）
-                    authors_dict[line].setdefault((name, email), None)
+                    authors_dict[line].setdefault((name, email, get_avatar_url(email)), None)
                     first_commit.setdefault(line, created)
 
             # 构建最终的缓存数据
             for file_path in first_commit:
                 authors_list = [
-                    {'name': name, 'email': email}
-                    for name, email in authors_dict[file_path].keys()  # 这里的 keys() 是有序的
+                    {'name': name, 'email': email, 'avatar': avatar}
+                    for name, email, avatar in authors_dict[file_path].keys()  # 这里的 keys() 是有序的
                 ]
                 dates_cache[file_path] = {
                     'created': first_commit[file_path],
@@ -209,3 +212,43 @@ def write_jsonl_cache(jsonl_file: Path, dates_cache, tracked_files):
     except Exception as e:
         logger.warning(f"Failed to add JSONL cache file to git: {e}")
     return False
+
+
+_GRAVATAR = "https://www.gravatar.com/avatar"   # Gravatar 头像，全球通用头像服务商，国内访问不稳定 ✓
+_WEAVATAR = "https://weavatar.com/avatar"       # Gravatar 国内镜像，实测发现国内外访问都正常，数据跟 Gravatar 一致 ✓
+_CRAVATAR = "https://cravatar.cn/avatar"        # 国内头像服务商，有国际 CDN，很多开源项目在用，实测发现只包含部分 Gravatar 数据
+_BASE: str = None
+
+def get_avatar_url(email: str, size: int = 64, default: str = "404") -> str:
+    """
+    Generate a avatar URL from an email address.
+
+    :param email: Author email
+    :param size: Avatar size in pixels (1~2048)
+    :param default: Default avatar style when no avatar exists
+        options: '404' 'wavatar' 'retro' 'identicon' 'mp' 'monsterid' 'robohash' 'blank'
+    :return: Avatar URL
+    """
+
+    if not _BASE or not email:
+        return ""
+
+    email_hash = hashlib.md5(email.strip().lower().encode("utf-8")).hexdigest()
+    return f"{_BASE}/{email_hash}?d={default}&s={size}"
+
+def init_avatar_provider(timeout: float = 0.5) -> None:
+    global _BASE
+
+    if _BASE is not None:
+        return
+
+    for base in (_GRAVATAR, _WEAVATAR):
+        try:
+            r = requests.head(f"{base}/", timeout=timeout, allow_redirects=True)
+            if r.status_code < 500:
+                _BASE = base
+                return
+        except requests.RequestException:
+            continue
+
+    _BASE = ""

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

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: mkdocs-document-dates
-Version: 3.5
-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
@@ -44,9 +44,7 @@ A new generation MkDocs plugin for displaying exact **creation date, last update
 - [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: |
@@ -94,10 +92,21 @@ In addition to the above basic configuration, the plug-in also provides a wealth
 - [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
-- [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.
+- [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` 
 - [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.5 → mkdocs_document_dates-3.5.1}/setup.py

@@ -23,7 +23,7 @@ class CustomInstallCommand(install):
         install.run(self)
 
 
-VERSION = '3.5'
+VERSION = '3.5.1'
 
 setup(
     name="mkdocs-document-dates",
@@ -31,7 +31,7 @@ setup(
     author="Aaron Wang",
     author_email="aaronwqt@gmail.com",
     license="MIT",
-    description="A new generation MkDocs plugin for displaying exact creation time, last update time, authors, email of documents",
+    description="A new generation MkDocs plugin for displaying exact creation date, last updated date, authors, email of documents",
     long_description=open("README.md", encoding="utf-8").read(),
     long_description_content_type="text/markdown",
     url="https://github.com/jaywhj/mkdocs-document-dates",