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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocs-document-dates
-Version: 3.5.1
+Version: 3.5.2
 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
@@ -79,9 +79,6 @@ plugins:
         - 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_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
@@ -91,7 +88,7 @@ In addition to the above basic configuration, the plug-in also provides a wealth
 - [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
+- [Configuration Structure and Style](https://jaywhj.netlify.app/document-dates-en#Structure-and-Style): You can freely configure the plugin's display structure in mkdocs.yml or Front Matter. 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` 

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

@@ -53,9 +53,6 @@ plugins:
         - 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_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
@@ -65,7 +62,7 @@ In addition to the above basic configuration, the plug-in also provides a wealth
 - [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
+- [Configuration Structure and Style](https://jaywhj.netlify.app/document-dates-en#Structure-and-Style): You can freely configure the plugin's display structure in mkdocs.yml or Front Matter. 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` 

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

@@ -132,6 +132,7 @@ class DocumentDatesPlugin(BasePlugin):
         
         # 添加自定义 JS 文件
         config['extra_javascript'].extend([
+            'assets/document_dates/core/md5.min.js',
             'assets/document_dates/core/default.config.js',
             'assets/document_dates/user.config.js',
             'assets/document_dates/core/utils.js',
@@ -168,7 +169,7 @@ class DocumentDatesPlugin(BasePlugin):
             return markdown
         
         # 生成日期和作者信息 HTML
-        info_html = self._generate_html_info(created, updated, authors)
+        info_html = self._generate_html_info(page.meta, created, updated, authors)
         
         # 将信息写入 markdown
         return self._insert_date_info(markdown, info_html)
@@ -362,10 +363,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, updated: datetime, authors=None):
+    def _generate_html_info(self, meta, created: datetime, updated: datetime, authors=None):
         try:
-            show_dates = self.config['show_created'] or self.config['show_updated']
-            show_plugin = show_dates or self.config['show_author']
+            show_created = self.config['show_created'] and meta.get('show_created') is not False
+            show_updated = self.config['show_updated'] and meta.get('show_updated') is not False
+            show_author  = self.config['show_author']  and meta.get('show_author')  is not False
+
+            show_dates = show_created or show_updated
+            show_plugin = show_dates or show_author
             if not show_plugin:
                 return ""
 
@@ -387,15 +392,15 @@ class DocumentDatesPlugin(BasePlugin):
             # 构建日期
             if show_dates:
                 html_parts.append("<div class='dd-left'>")
-            if self.config['show_created']:
+            if show_created:
                 html_parts.append(build_time_icon(created, 'doc_created'))
-            if self.config['show_updated']:
+            if 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:
+            if show_author and authors:
                 def get_author_tooltip(author):
                     if author.url:
                         return f'<a href="{author.url}" target="_blank">{author.name}</a>'
@@ -410,7 +415,8 @@ class DocumentDatesPlugin(BasePlugin):
                 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':
+                show_text = self.config['show_author'] == 'text' or meta.get('show_author') == 'text'
+                if show_text:
                     # 显示文本模式
                     for index, author in enumerate(authors):
                         if index > 0:
@@ -424,7 +430,7 @@ class DocumentDatesPlugin(BasePlugin):
                         html_parts.append(
                             f"<div class='avatar-wrapper' data-name='{author.name}' data-tippy-content data-tippy-raw='{tooltip}'>"
                             f"<span class='avatar-text'></span>"
-                            f"<img class='avatar' src='{author.avatar}' onerror=\"this.style.display='none'\" />"
+                            f"<img class='avatar' data-src='{author.avatar}' data-email='{author.email}' />"
                             f"</div>"
                         )
                 html_parts.append("</div>")

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

@@ -23,11 +23,11 @@
     color: #666;
     font-size: 0.9rem;
     display: flex;
-    /* flex-wrap: nowrap; */
     align-items: center;
+    flex-wrap: nowrap;
     justify-content: space-between;
-    padding: 0.2rem 0;
-    margin-bottom: 0.6rem;
+    padding: 0.1rem 0;
+    margin-bottom: 0.5rem;
 }
 .md-main .document-dates-plugin {
     color: rgba(142, 142, 142, 0.7);
@@ -38,9 +38,6 @@
     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;
@@ -70,17 +67,17 @@
 .dd-left {
     display: flex;
     align-items: center;
-    margin-right: 1.5rem;
+    flex-shrink: 0;
+    margin-right: 1.4rem;
 }
 .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;
+    margin-left: 1.4rem;
 }
 
 .dd-right {
@@ -88,13 +85,25 @@
     align-items: center;
     justify-content: flex-end;
     flex: 1 1 auto;
-    min-width: 110px;
+    min-width: 0;
+    overflow: hidden;
 }
-
+/* Left-aligned when only dd-right */
 .dd-right.dd-right-start {
     justify-content: flex-start;
 }
 
+/* JS control toggle */
+.document-dates-plugin.is-wrapped {
+    flex-wrap: wrap;
+}
+.document-dates-plugin.is-wrapped .dd-right {
+    flex: 0 0 100%;
+    justify-content: flex-start;
+    margin-top: 10px;
+}
+
+
 /* ==========================================================================
    3. Author Avatar styles
    ========================================================================== */
@@ -111,9 +120,11 @@
 
     margin-right: 10px;
 
+    /* Hide Firefox, IE scrollbar */
     scrollbar-width: none;
     -ms-overflow-style: none;
 }
+/* Hide Chrome/Safari scrollbar */
 .author-group::-webkit-scrollbar {
     display: none;
 }
@@ -168,18 +179,6 @@
     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

mkdocs_document_dates-3.5.2/mkdocs_document_dates/static/core/core.js

@@ -0,0 +1,393 @@
+/*
+    1.加载头像
+*/
+function isLatin(name) {
+    return /^[A-Za-z\s]+$/.test(name.trim());
+}
+function extractInitials(name) {
+    name = name.trim();
+    if (!name) return '?';
+    if (isLatin(name)) {
+        const parts = name.toUpperCase().split(/\s+/).filter(Boolean);
+        return parts.length >= 2 ? parts[0][0] + parts[parts.length - 1][0] : parts[0][0];
+    } else {
+        return name[0];
+    }
+}
+function nameToHSL(name, s = 50, l = 55) {
+    let hash = 0;
+    for (let i = 0; i < name.length; i++) {
+        hash = name.charCodeAt(i) + ((hash << 5) - hash);
+    }
+    const hue = hash % 360;
+    return `hsl(${hue}, ${s}%, ${l}%)`;
+}
+
+function loadAvatars() {
+    document.querySelectorAll('.avatar-wrapper').forEach(wrapper => {
+        const name = wrapper.dataset.name || '';
+        const initials = extractInitials(name);
+        const bgColor = nameToHSL(name);
+
+        const textEl = wrapper.querySelector('.avatar-text');
+        textEl.textContent = initials;
+        textEl.style.backgroundColor = bgColor;
+
+        const imgEl = wrapper.querySelector('img.avatar');
+        if (imgEl) {
+            const urls = [];
+            const dataSrc = (imgEl.dataset.src || '').trim();
+            const email = (imgEl.dataset.email || '').trim();
+
+            if (dataSrc) {
+                urls.push(dataSrc);
+            }
+            if (email && AvatarService.base) {
+                const hash = md5(email.trim().toLowerCase());
+                urls.push(AvatarService.build(hash));
+            }
+            if (urls.length === 0) {
+                imgEl.style.display = 'none';
+                return;
+            }
+
+            bindAvatar(imgEl, urls);
+        }
+    });
+}
+function bindAvatar(imgEl, urls) {
+    let index = 0;
+    function next() {
+        if (index >= urls.length) {
+            imgEl.style.display = 'none';
+            return;
+        }
+        imgEl.src = urls[index++];
+    }
+    imgEl.onerror = next;
+    // 加载成功后清掉 onerror
+    imgEl.onload = () => imgEl.onerror = null;
+
+    next();
+}
+
+const AVATAR_CDNS = {
+    // gravatar: 全球通用头像服务商，国内访问不稳定
+    // weavatar: gravatar 国内镜像，实测发现国内外访问都正常，数据跟 gravatar 一致
+    // cravatar: 国内头像服务商，有国际 CDN，很多开源项目在用，实测发现只包含部分 gravatar 数据
+
+    gravatar: 'https://www.gravatar.com/avatar',
+    weavatar: 'https://weavatar.com/avatar'
+    // cravatar: 'https://cravatar.cn/avatar'
+};
+const PROBE_TARGETS = [
+    { name: 'gravatar', probe: 'https://www.gravatar.com/favicon.ico' },
+    { name: 'weavatar', probe: 'https://weavatar.com/favicon.ico' }
+];
+
+let avatarServiceInited = false;
+const AvatarService = {
+    base: null,
+    async init() {
+        if (avatarServiceInited) return;
+        avatarServiceInited = true;
+
+        const winner = await raceAvatarCDN(PROBE_TARGETS.map(t => t.probe));
+        if (!winner) return;
+
+        const hit = PROBE_TARGETS.find(t => t.probe === winner);
+        this.base = AVATAR_CDNS[hit.name];
+    },
+
+    // style: '404' 'wavatar' 'retro' 'identicon' 'mp' 'monsterid' 'robohash' 'blank'
+    // size: avatar size in pixels (1~2048)
+    build(emailHash, style = '404', size = 128) {
+        if (!this.base) return null;
+        return `${this.base}/${emailHash}?d=${style}&s=${size}`;
+    }
+};
+function raceAvatarCDN(urls, timeout = 500) {
+    return new Promise(resolve => {
+        let done = false;
+        urls.forEach(url => {
+            const img = new Image();
+            const timer = setTimeout(() => {
+                img.src = '';
+            }, timeout);
+            img.onload = () => {
+                if (done) return;
+                done = true;
+                clearTimeout(timer);
+                resolve(url);
+            };
+            img.onerror = () => {
+                clearTimeout(timer);
+            };
+            img.src = url;
+        });
+        // 兜底（全部失败 / 全部超时），不让 Promise 永远 pending
+        setTimeout(() => {
+            if (!done) resolve(null);
+        }, timeout);
+    });
+}
+
+
+
+/*
+    2.处理内容赋值
+*/
+// 图标键映射表
+const iconKeyMap = {
+    doc_created: 'created_time',
+    doc_updated: 'updated_time',
+    doc_author: 'author',
+    doc_authors: 'authors'
+};
+// 处理数据加载
+function processDataLoading() {
+    document.querySelectorAll('.document-dates-plugin').forEach(ddpEl => {
+        // 获取 locale，优先级：用户主动选择 > 服务端显式配置 > 用户浏览器语言 > 站点HTML语言 > 默认英语
+        const rawLocale =
+            ddUtils.getSavedLanguage() ||
+            ddpEl.getAttribute('locale') ||
+            navigator.language ||
+            navigator.userLanguage ||
+            document.documentElement.lang ||
+            'en';
+
+        // 处理 time 元素（使用 timeago 时）
+        if (typeof timeago !== 'undefined') {
+            const tLocale = ddUtils.resolveTimeagoLocale(rawLocale);
+            ddpEl.querySelectorAll('time').forEach(timeEl => {
+                timeEl.textContent = timeago.format(timeEl.getAttribute('datetime'), tLocale);
+            });
+        }
+
+        // 动态处理 tooltip 内容
+        const langData = TooltipLanguage.get(rawLocale);
+        ddpEl.querySelectorAll('[data-tippy-content]').forEach(tippyEl => {
+            const iconEl = tippyEl.querySelector('[data-icon]');
+            const rawIconKey = iconEl ? iconEl.getAttribute('data-icon') : '';
+            const iconKey = iconKeyMap[rawIconKey] || 'author';
+            if (langData[iconKey]) {
+                const content = langData[iconKey] + ': ' + tippyEl.dataset.tippyRaw;
+                if (tippyEl._tippy) {
+                    tippyEl._tippy.setContent(content);
+                }
+            }
+        });
+    });
+}
+
+// 供外部使用：更新文档日期和 tippy 内容到指定语言（可持久化）
+function updateDocumentDates(locale) {
+    ddUtils.saveLanguage(locale);
+    processDataLoading();
+}
+window.ddPlugin = {
+    updateLanguage: updateDocumentDates
+};
+
+
+
+/*
+    3.初始化 tippyManager，创建和管理 tippy 实例
+*/
+function getCurrentTheme() {
+    // 基于 Material's light/dark 配色方案返回对应的 tooltip 主题
+    const scheme = (document.body && document.body.getAttribute('data-md-color-scheme')) || 'default';
+    return scheme === 'slate' ? tooltip_config.theme.dark : tooltip_config.theme.light;
+}
+
+function initTippy() {
+    // 创建上下文对象，将其传递给钩子并从函数中返回
+    const context = { tooltip_config };
+
+    // 创建 tippy 实例
+    const tippyInstances = tippy('[data-tippy-content]', {
+        ...tooltip_config,
+        theme: getCurrentTheme()
+    });
+    context.tippyInstances = tippyInstances;
+
+    // 添加观察者，监控 Material's 配色变化，自动切换 tooltip 主题
+    const observer = new MutationObserver((mutations) => {
+        mutations.forEach((mutation) => {
+            if (mutation.attributeName === 'data-md-color-scheme') {
+                const newTheme = getCurrentTheme();
+                tippyInstances.forEach(instance => {
+                    instance.setProps({ theme: newTheme });
+                });
+            }
+        });
+    });
+    observer.observe(document.body, {
+        attributes: true,
+        attributeFilter: ['data-md-color-scheme']
+    });
+    context.observer = observer;
+
+    // 返回包含 tippyInstances 和 observer 的上下文，用于后续清理
+    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 tippyTargets = groupEl.querySelectorAll('[data-tippy-content]');
+        const hideAllTippies = () => {
+            tippyTargets.forEach(tippyEl => {
+                if (tippyEl._tippy) {
+                    tippyEl._tippy.hide();
+                }
+            });
+        };
+        // true: 浏览器立刻执行默认行为。这个事件监听器只是‘看看’，绝不会阻止浏览器的默认行为
+        const opts = { passive: true, signal: controller.signal };
+        groupEl.addEventListener('scroll', hideAllTippies, opts);
+        groupEl.addEventListener('touchmove', hideAllTippies, opts);
+    });
+}
+
+// 通过 IIFE（立即执行的函数表达式）创建 tippyManager
+const tippyManager = (() => {
+    let tippyInstances = [];
+    let observer = null;
+    function cleanup() {
+        // 销毁之前的 tippy 实例
+        if (tippyInstances.length > 0) {
+            tippyInstances.forEach(instance => instance.destroy());
+            tippyInstances = [];
+        }
+        // 断开之前的观察者连接
+        if (observer) {
+            observer.disconnect();
+            observer = null;
+        }
+    }
+    return {
+        // 每一次调用都生成新的实例（兼容 navigation.instant）
+        initialize() {
+            // 先清理以前的实例
+            cleanup();
+            // 初始化新实例
+            const context = initTippy();
+            if (context && context.tippyInstances) {
+                tippyInstances = context.tippyInstances;
+            }
+            if (context && context.observer) {
+                observer = context.observer;
+            }
+            initAuthorGroupTippyGuard();
+        }
+    };
+})();
+
+
+// 为 author-group 启用横向滚轮滚动
+function enableHorizontalWheelScroll() {
+    // 移动端不接管滚轮
+    const isTouchDevice =
+        'ontouchstart' in window ||
+        navigator.maxTouchPoints > 0 ||
+        navigator.msMaxTouchPoints > 0;
+    if (isTouchDevice) return;
+
+    document.querySelectorAll('.author-group').forEach(groupEl => {
+        // 先取消旧监听器，避免重复绑定
+        if (groupEl._ddWheelAbortController) {
+            groupEl._ddWheelAbortController.abort();
+        }
+        const controller = new AbortController();
+        groupEl._ddWheelAbortController = controller;
+
+        groupEl.addEventListener('wheel', function (event) {
+            // 只处理纵向滚轮（触控板横向滑动不干预）
+            if (Math.abs(event.deltaY) <= Math.abs(event.deltaX)) return;
+            // 在 author-group 内，始终阻止页面纵向滚动
+            event.preventDefault();
+
+            const scrollWidth = groupEl.scrollWidth;
+            const clientWidth = groupEl.clientWidth;
+            // 元素不可横向滚动时返回
+            if (scrollWidth <= clientWidth) return;
+
+            const delta = event.deltaY;
+            const atLeft = groupEl.scrollLeft <= 0;
+            const atRight = groupEl.scrollLeft + clientWidth >= scrollWidth - 1;
+
+            if ((delta < 0 && !atLeft) || (delta > 0 && !atRight)) {
+                groupEl.scrollLeft += delta;
+            }
+        }, {
+            // false: 浏览器你先别急着执行默认行为，等 JS 跑完，再决定要不要动，因为可能会调用 event.preventDefault()
+            passive: false,
+            signal: controller.signal
+        });
+    });
+}
+
+
+// 为 author-group 添加自适应动态布局
+function handleDocumentDatesAutoWrap() {
+    // 设定作者区域最小的显示宽度，大概2个作者宽度
+    const AUTHOR_THRESHOLD = 140;
+    document.querySelectorAll('.document-dates-plugin').forEach(ddpEl => {
+        const leftPart = ddpEl.querySelector('.dd-left');
+        const rightPart = ddpEl.querySelector('.dd-right');
+        if (!leftPart || !rightPart) return;
+
+        // 使用 getBoundingClientRect 更加精确（包含小数）
+        const containerWidth = ddpEl.getBoundingClientRect().width;
+        const leftWidth = leftPart.getBoundingClientRect().width;
+        if (containerWidth <= leftWidth) return;
+
+        // 如果: 容器总宽度 < 日期宽度 + 2个作者宽度，则换行
+        const shouldWrap = containerWidth < (leftWidth + AUTHOR_THRESHOLD);
+        // 只有在状态确实需要改变时才操作 DOM
+        if (ddpEl.classList.contains('is-wrapped') !== shouldWrap) {
+            ddpEl.classList.toggle('is-wrapped', shouldWrap);
+        }
+    });
+}
+
+
+/*
+    入口
+*/
+let datesAutoWrapObserver = null;
+function initPluginFeatures() {
+    tippyManager.initialize();
+    processDataLoading();
+    AvatarService.init().then(() => {
+        loadAvatars();
+    });
+    enableHorizontalWheelScroll();
+
+    // 观察插件尺寸变化，resize 时动态处理布局
+    if (datesAutoWrapObserver) datesAutoWrapObserver.disconnect();
+    datesAutoWrapObserver = new ResizeObserver(() => {
+        // 使用 RAF 确保在浏览器重绘前处理，减少视觉跳动
+        window.requestAnimationFrame(() => {
+            handleDocumentDatesAutoWrap();
+        });
+    });
+    document.querySelectorAll('.document-dates-plugin').forEach(ddpEl => datesAutoWrapObserver.observe(ddpEl));
+}
+
+// 兼容 Material 主题的 'navigation.instant' 属性
+if (window.document$ && !window.document$.isStopped) {
+    window.document$.subscribe(initPluginFeatures);
+} else if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', initPluginFeatures);
+} else {
+    initPluginFeatures();
+}

mkdocs_document_dates-3.5.2/mkdocs_document_dates/static/core/md5.min.js

@@ -0,0 +1,2 @@
+!function(n){"use strict";function d(n,t){var r=(65535&n)+(65535&t);return(n>>16)+(t>>16)+(r>>16)<<16|65535&r}function f(n,t,r,e,o,u){return d((u=d(d(t,n),d(e,u)))<<o|u>>>32-o,r)}function l(n,t,r,e,o,u,c){return f(t&r|~t&e,n,t,o,u,c)}function g(n,t,r,e,o,u,c){return f(t&e|r&~e,n,t,o,u,c)}function v(n,t,r,e,o,u,c){return f(t^r^e,n,t,o,u,c)}function m(n,t,r,e,o,u,c){return f(r^(t|~e),n,t,o,u,c)}function c(n,t){var r,e,o,u;n[t>>5]|=128<<t%32,n[14+(t+64>>>9<<4)]=t;for(var c=1732584193,f=-271733879,i=-1732584194,a=271733878,h=0;h<n.length;h+=16)c=l(r=c,e=f,o=i,u=a,n[h],7,-680876936),a=l(a,c,f,i,n[h+1],12,-389564586),i=l(i,a,c,f,n[h+2],17,606105819),f=l(f,i,a,c,n[h+3],22,-1044525330),c=l(c,f,i,a,n[h+4],7,-176418897),a=l(a,c,f,i,n[h+5],12,1200080426),i=l(i,a,c,f,n[h+6],17,-1473231341),f=l(f,i,a,c,n[h+7],22,-45705983),c=l(c,f,i,a,n[h+8],7,1770035416),a=l(a,c,f,i,n[h+9],12,-1958414417),i=l(i,a,c,f,n[h+10],17,-42063),f=l(f,i,a,c,n[h+11],22,-1990404162),c=l(c,f,i,a,n[h+12],7,1804603682),a=l(a,c,f,i,n[h+13],12,-40341101),i=l(i,a,c,f,n[h+14],17,-1502002290),c=g(c,f=l(f,i,a,c,n[h+15],22,1236535329),i,a,n[h+1],5,-165796510),a=g(a,c,f,i,n[h+6],9,-1069501632),i=g(i,a,c,f,n[h+11],14,643717713),f=g(f,i,a,c,n[h],20,-373897302),c=g(c,f,i,a,n[h+5],5,-701558691),a=g(a,c,f,i,n[h+10],9,38016083),i=g(i,a,c,f,n[h+15],14,-660478335),f=g(f,i,a,c,n[h+4],20,-405537848),c=g(c,f,i,a,n[h+9],5,568446438),a=g(a,c,f,i,n[h+14],9,-1019803690),i=g(i,a,c,f,n[h+3],14,-187363961),f=g(f,i,a,c,n[h+8],20,1163531501),c=g(c,f,i,a,n[h+13],5,-1444681467),a=g(a,c,f,i,n[h+2],9,-51403784),i=g(i,a,c,f,n[h+7],14,1735328473),c=v(c,f=g(f,i,a,c,n[h+12],20,-1926607734),i,a,n[h+5],4,-378558),a=v(a,c,f,i,n[h+8],11,-2022574463),i=v(i,a,c,f,n[h+11],16,1839030562),f=v(f,i,a,c,n[h+14],23,-35309556),c=v(c,f,i,a,n[h+1],4,-1530992060),a=v(a,c,f,i,n[h+4],11,1272893353),i=v(i,a,c,f,n[h+7],16,-155497632),f=v(f,i,a,c,n[h+10],23,-1094730640),c=v(c,f,i,a,n[h+13],4,681279174),a=v(a,c,f,i,n[h],11,-358537222),i=v(i,a,c,f,n[h+3],16,-722521979),f=v(f,i,a,c,n[h+6],23,76029189),c=v(c,f,i,a,n[h+9],4,-640364487),a=v(a,c,f,i,n[h+12],11,-421815835),i=v(i,a,c,f,n[h+15],16,530742520),c=m(c,f=v(f,i,a,c,n[h+2],23,-995338651),i,a,n[h],6,-198630844),a=m(a,c,f,i,n[h+7],10,1126891415),i=m(i,a,c,f,n[h+14],15,-1416354905),f=m(f,i,a,c,n[h+5],21,-57434055),c=m(c,f,i,a,n[h+12],6,1700485571),a=m(a,c,f,i,n[h+3],10,-1894986606),i=m(i,a,c,f,n[h+10],15,-1051523),f=m(f,i,a,c,n[h+1],21,-2054922799),c=m(c,f,i,a,n[h+8],6,1873313359),a=m(a,c,f,i,n[h+15],10,-30611744),i=m(i,a,c,f,n[h+6],15,-1560198380),f=m(f,i,a,c,n[h+13],21,1309151649),c=m(c,f,i,a,n[h+4],6,-145523070),a=m(a,c,f,i,n[h+11],10,-1120210379),i=m(i,a,c,f,n[h+2],15,718787259),f=m(f,i,a,c,n[h+9],21,-343485551),c=d(c,r),f=d(f,e),i=d(i,o),a=d(a,u);return[c,f,i,a]}function i(n){for(var t="",r=32*n.length,e=0;e<r;e+=8)t+=String.fromCharCode(n[e>>5]>>>e%32&255);return t}function a(n){var t=[];for(t[(n.length>>2)-1]=void 0,e=0;e<t.length;e+=1)t[e]=0;for(var r=8*n.length,e=0;e<r;e+=8)t[e>>5]|=(255&n.charCodeAt(e/8))<<e%32;return t}function e(n){for(var t,r="0123456789abcdef",e="",o=0;o<n.length;o+=1)t=n.charCodeAt(o),e+=r.charAt(t>>>4&15)+r.charAt(15&t);return e}function r(n){return unescape(encodeURIComponent(n))}function o(n){return i(c(a(n=r(n)),8*n.length))}function u(n,t){return function(n,t){var r,e=a(n),o=[],u=[];for(o[15]=u[15]=void 0,16<e.length&&(e=c(e,8*n.length)),r=0;r<16;r+=1)o[r]=909522486^e[r],u[r]=1549556828^e[r];return t=c(o.concat(a(t)),512+8*t.length),i(c(u.concat(t),640))}(r(n),r(t))}function t(n,t,r){return t?r?u(t,n):e(u(t,n)):r?o(n):e(o(n))}"function"==typeof define&&define.amd?define(function(){return t}):"object"==typeof module&&module.exports?module.exports=t:n.md5=t}(this);
+//# sourceMappingURL=md5.min.js.map

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

@@ -3,8 +3,6 @@ import platform
 import json
 import heapq
 import logging
-import hashlib
-import requests
 import subprocess
 from pathlib import Path
 from datetime import datetime
@@ -68,8 +66,6 @@ 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
@@ -85,14 +81,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, get_avatar_url(email)), None)
+                    authors_dict[line].setdefault((name, email), None)
                     first_commit.setdefault(line, created)
 
             # 构建最终的缓存数据
             for file_path in first_commit:
                 authors_list = [
-                    {'name': name, 'email': email, 'avatar': avatar}
-                    for name, email, avatar in authors_dict[file_path].keys()  # 这里的 keys() 是有序的
+                    {'name': name, 'email': email}
+                    for name, email in authors_dict[file_path].keys()  # 这里的 keys() 是有序的
                 ]
                 dates_cache[file_path] = {
                     'created': first_commit[file_path],
@@ -212,43 +208,3 @@ 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.1 → mkdocs_document_dates-3.5.2/mkdocs_document_dates.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocs-document-dates
-Version: 3.5.1
+Version: 3.5.2
 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
@@ -79,9 +79,6 @@ plugins:
         - 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_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
@@ -91,7 +88,7 @@ In addition to the above basic configuration, the plug-in also provides a wealth
 - [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
+- [Configuration Structure and Style](https://jaywhj.netlify.app/document-dates-en#Structure-and-Style): You can freely configure the plugin's display structure in mkdocs.yml or Front Matter. 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` 

{mkdocs_document_dates-3.5.1 → mkdocs_document_dates-3.5.2}/mkdocs_document_dates.egg-info/SOURCES.txt

@@ -20,6 +20,7 @@ mkdocs_document_dates/static/config/user.config.js
 mkdocs_document_dates/static/core/core.css
 mkdocs_document_dates/static/core/core.js
 mkdocs_document_dates/static/core/default.config.js
+mkdocs_document_dates/static/core/md5.min.js
 mkdocs_document_dates/static/core/timeago.full.min.js
 mkdocs_document_dates/static/core/timeago.min.js
 mkdocs_document_dates/static/core/utils.js

{mkdocs_document_dates-3.5.1 → mkdocs_document_dates-3.5.2}/setup.py

@@ -23,7 +23,7 @@ class CustomInstallCommand(install):
         install.run(self)
 
 
-VERSION = '3.5.1'
+VERSION = '3.5.2'
 
 setup(
     name="mkdocs-document-dates",

mkdocs_document_dates-3.5.1/mkdocs_document_dates/static/core/core.js

@@ -1,225 +0,0 @@
-/*
-    1.生成头像
-*/
-function isLatin(name) {
-    return /^[A-Za-z\s]+$/.test(name.trim());
-}
-function extractInitials(name) {
-    name = name.trim();
-    if (!name) return '?';
-    if (isLatin(name)) {
-        const parts = name.toUpperCase().split(/\s+/).filter(Boolean);
-        return parts.length >= 2 ? parts[0][0] + parts[parts.length - 1][0] : parts[0][0];
-    } else {
-        return name[0];
-    }
-}
-function nameToHSL(name, s = 50, l = 55) {
-    let hash = 0;
-    for (let i = 0; i < name.length; i++) {
-        hash = name.charCodeAt(i) + ((hash << 5) - hash);
-    }
-    const hue = hash % 360;
-    return `hsl(${hue}, ${s}%, ${l}%)`;
-}
-function generateAvatar() {
-    document.querySelectorAll('.avatar-wrapper').forEach(wrapper => {
-        const name = wrapper.dataset.name || '';
-        const initials = extractInitials(name);
-        const bgColor = nameToHSL(name);
-
-        const textEl = wrapper.querySelector('.avatar-text');
-        textEl.textContent = initials;
-        textEl.style.backgroundColor = bgColor;
-
-        const imgEl = wrapper.querySelector('img.avatar');
-        if (imgEl) {
-            const src = (imgEl.getAttribute('src') || '').trim();
-            if (!src) {
-                imgEl.style.display = 'none';
-            }
-        }
-    });
-}
-
-
-
-/*
-    2.处理内容赋值
-*/
-// 图标键映射表
-const iconKeyMap = {
-    doc_created: 'created_time',
-    doc_updated: 'updated_time',
-    doc_author: 'author',
-    doc_authors: 'authors'
-};
-// 处理文档日期和提示内容
-function processDocumentDates() {
-    document.querySelectorAll('.document-dates-plugin').forEach(ddpEl => {
-        // 获取 locale，优先级：用户主动选择 > 服务端显式配置 > 用户浏览器语言 > 站点HTML语言 > 默认英语
-        const rawLocale =
-            ddUtils.getSavedLanguage() ||
-            ddpEl.getAttribute('locale') ||
-            navigator.language ||
-            navigator.userLanguage ||
-            document.documentElement.lang ||
-            'en';
-
-        // 处理 time 元素（使用 timeago 时）
-        if (typeof timeago !== 'undefined') {
-            const tLocale = ddUtils.resolveTimeagoLocale(rawLocale);
-            ddpEl.querySelectorAll('time').forEach(timeEl => {
-                timeEl.textContent = timeago.format(timeEl.getAttribute('datetime'), tLocale);
-            });
-        }
-
-        // 处理 tooltip 内容
-        const langData = TooltipLanguage.get(rawLocale);
-        ddpEl.querySelectorAll('[data-tippy-content]').forEach(tippyEl => {
-            const iconEl = tippyEl.querySelector('[data-icon]');
-            const rawIconKey = iconEl ? iconEl.getAttribute('data-icon') : '';
-            const iconKey = iconKeyMap[rawIconKey] || 'author';
-            if (langData[iconKey]) {
-                const content = langData[iconKey] + ': ' + tippyEl.dataset.tippyRaw;
-                // 更新 data-tippy-content 属性
-                tippyEl.dataset.tippyContent = content;
-                // 如果 tippy 实例已存在，直接更新内容
-                if (tippyEl._tippy) {
-                    tippyEl._tippy.setContent(content);
-                }
-            }
-        });
-    });
-}
-
-// 供外部使用：更新文档日期和 tippy 内容到指定语言（可持久化）
-function updateDocumentDates(locale) {
-    ddUtils.saveLanguage(locale);
-    processDocumentDates();
-}
-window.ddPlugin = {
-    updateLanguage: updateDocumentDates
-};
-
-
-
-/*
-    3.初始化 tippyManager，创建和管理 tippy 实例
-*/
-function getCurrentTheme() {
-    // 基于 Material's light/dark 配色方案返回对应的 tooltip 主题
-    const scheme = (document.body && document.body.getAttribute('data-md-color-scheme')) || 'default';
-    return scheme === 'slate' ? tooltip_config.theme.dark : tooltip_config.theme.light;
-}
-
-function initTippy() {
-    // 创建上下文对象，将其传递给钩子并从函数中返回
-    const context = { tooltip_config };
-
-    // 创建 tippy 实例
-    const tippyInstances = tippy('[data-tippy-content]', {
-        ...tooltip_config,
-        theme: getCurrentTheme()
-    });
-    context.tippyInstances = tippyInstances;
-
-    // 添加观察者，监控 Material's 配色变化，自动切换 tooltip 主题
-    const observer = new MutationObserver((mutations) => {
-        mutations.forEach((mutation) => {
-            if (mutation.attributeName === 'data-md-color-scheme') {
-                const newTheme = getCurrentTheme();
-                tippyInstances.forEach(instance => {
-                    instance.setProps({ theme: newTheme });
-                });
-            }
-        });
-    });
-    observer.observe(document.body, {
-        attributes: true,
-        attributeFilter: ['data-md-color-scheme']
-    });
-    context.observer = observer;
-
-    // 返回包含 tippyInstances 和 observer 的上下文，用于后续清理
-    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 = [];
-    let observer = null;
-    function cleanup() {
-        // 销毁之前的 tippy 实例
-        if (tippyInstances.length > 0) {
-            tippyInstances.forEach(instance => instance.destroy());
-            tippyInstances = [];
-        }
-        // 断开之前的观察者连接
-        if (observer) {
-            observer.disconnect();
-            observer = null;
-        }
-    }
-    return {
-        // 每一次调用都生成新的实例（兼容 navigation.instant）
-        initialize() {
-            // 先清理以前的实例
-            cleanup();
-            // 初始化新实例
-            const context = initTippy();
-            if (context && context.tippyInstances) {
-                tippyInstances = context.tippyInstances;
-            }
-            if (context && context.observer) {
-                observer = context.observer;
-            }
-            initAuthorGroupTippyGuard();
-        }
-    };
-})();
-
-
-
-/*
-    入口: 兼容 Material 主题的 'navigation.instant' 属性
-*/
-if (typeof window.document$ !== 'undefined' && !window.document$.isStopped) {
-    window.document$.subscribe(() => {
-        processDocumentDates();
-        generateAvatar();
-        // 通过 tippyManager 创建 tippy 实例
-        tippyManager.initialize();
-    });
-} else {
-    processDocumentDates();
-    generateAvatar();
-    document.addEventListener('DOMContentLoaded', tippyManager.initialize);
-}