mkdocs-document-dates 3.6.0__tar.gz → 3.6.1__tar.gz

{mkdocs_document_dates-3.6.0/mkdocs_document_dates.egg-info → mkdocs_document_dates-3.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocs-document-dates
-Version: 3.6.0
+Version: 3.6.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
@@ -67,7 +67,7 @@ plugins:
   - document-dates
 ```
 
-Or, full configuration:
+Or, common configuration:
 
 ```yaml
 plugins:
@@ -77,8 +77,6 @@ plugins:
       exclude:                 # List of excluded files
         - temp.md                  # Example: exclude the specified file
         - blog/*                   # Example: exclude all files in blog folder, including subfolders
-      date_format: '%Y-%m-%d'  # Date format strings (e.g., %Y-%m-%d, %b %d, %Y)
-      time_format: '%H:%M:%S'  # Time format strings (valid only if type=datetime)
 ```
 
 ## Customization Settings
@@ -97,7 +95,7 @@ In addition to the above basic configuration, the plug-in also provides a wealth
 
 See the documentation for details: https://jaywhj.netlify.app/document-dates-en
 
-<br />
+![recently-updated](recently-updated-en.gif)
 
 ## Other Projects
 

{mkdocs_document_dates-3.6.0 → mkdocs_document_dates-3.6.1}/README.md

@@ -41,7 +41,7 @@ plugins:
   - document-dates
 ```
 
-Or, full configuration:
+Or, common configuration:
 
 ```yaml
 plugins:
@@ -51,8 +51,6 @@ plugins:
       exclude:                 # List of excluded files
         - temp.md                  # Example: exclude the specified file
         - blog/*                   # Example: exclude all files in blog folder, including subfolders
-      date_format: '%Y-%m-%d'  # Date format strings (e.g., %Y-%m-%d, %b %d, %Y)
-      time_format: '%H:%M:%S'  # Time format strings (valid only if type=datetime)
 ```
 
 ## Customization Settings
@@ -71,7 +69,7 @@ In addition to the above basic configuration, the plug-in also provides a wealth
 
 See the documentation for details: https://jaywhj.netlify.app/document-dates-en
 
-<br />
+![recently-updated](recently-updated-en.gif)
 
 ## Other Projects
 

{mkdocs_document_dates-3.6.0 → mkdocs_document_dates-3.6.1}/mkdocs_document_dates/plugin.py

@@ -10,7 +10,7 @@ from mkdocs.config import config_options
 from mkdocs.structure.pages import Page
 from mkdocs.utils import get_relative_url
 from urllib.parse import urlparse
-from .utils import get_file_creation_time, load_git_metadata, load_git_last_updated_date, read_jsonl_cache,is_excluded, get_recently_updated_files
+from .utils import get_file_creation_time, load_git_metadata, load_git_last_updated_date, read_jsonl_cache, compile_exclude_patterns, is_excluded, get_recently_updated_files
 
 logger = logging.getLogger("mkdocs.plugins.document_dates")
 logger.setLevel(logging.WARNING)  # DEBUG, INFO, WARNING, ERROR, CRITICAL
@@ -48,6 +48,7 @@ class DocumentDatesPlugin(BasePlugin):
         self.authors_yml = {}
         self.recent_docs_html = None
         self.recent_enable = False
+        self._exclude_patterns = []
 
     def on_config(self, config):
         docs_dir_path = Path(config['docs_dir'])
@@ -138,6 +139,8 @@ class DocumentDatesPlugin(BasePlugin):
             'assets/document_dates/core/core.js'
         ])
 
+        self._exclude_patterns = compile_exclude_patterns(self.config['exclude'])
+
         return config
 
     def on_page_markdown(self, markdown, page: Page, config, files):
@@ -164,7 +167,7 @@ class DocumentDatesPlugin(BasePlugin):
         page.meta['document_dates_authors'] = authors
         
         # 检查是否需要排除
-        if is_excluded(rel_path, self.config['exclude']):
+        if is_excluded(rel_path, self._exclude_patterns):
             return markdown
         
         # 生成日期和作者信息 HTML
@@ -187,7 +190,8 @@ class DocumentDatesPlugin(BasePlugin):
         limit = recently_updated_config.get('limit', 10)
 
         # 获取最近更新的文档数据
-        recently_updated_docs = get_recently_updated_files(self.last_updated_dates, files, exclude_list, limit, self.recent_enable)
+        recent_exclude_patterns = compile_exclude_patterns(exclude_list)
+        recently_updated_docs = get_recently_updated_files(self.last_updated_dates, files, recent_exclude_patterns, limit, self.recent_enable)
 
         # 将数据注入到 config['extra'] 中供全局访问
         if 'extra' not in config:
@@ -477,4 +481,4 @@ class DocumentDatesPlugin(BasePlugin):
 
             pos = next_newline + 1
 
-        return '', length
+        return '', length

{mkdocs_document_dates-3.6.0 → mkdocs_document_dates-3.6.1}/mkdocs_document_dates/static/core/core.css

@@ -68,6 +68,7 @@
     display: flex;
     align-items: center;
     flex-shrink: 0;
+    margin-right: 1.4rem;
 }
 .dd-item {
     display: inline-flex;
@@ -142,8 +143,8 @@
     display: block;
 
     /* Fix bug in Safari: rounded corners may blink to show square corners */
-    will-change: transform;
     transform: translateZ(0);
+    will-change: transform;
 }
 .avatar-wrapper:hover {
     transform: scale(1.08);

{mkdocs_document_dates-3.6.0 → mkdocs_document_dates-3.6.1}/mkdocs_document_dates/static/core/core.js

@@ -163,16 +163,9 @@ function applyTimeagoToTimes(timeNodes, rawLocale) {
 
 // 处理数据加载
 function processDataLoading() {
-    // 获取 locale，优先级：用户主动选择 > 服务端显式配置 > 用户浏览器语言 > 站点HTML语言 > 默认英语
-    const rawLocale =
-        ddUtils.getSavedLanguage() ||
-        // ddpEl.getAttribute('locale') ||
-        navigator.language ||
-        navigator.userLanguage ||
-        document.documentElement.lang ||
-        'en';
-
     document.querySelectorAll('.document-dates-plugin').forEach(ddpEl => {
+        const rawLocale = ddUtils.getCurrentLocale(ddpEl);
+
         // 处理 time 元素（使用 timeago 时）
         applyTimeagoToTimes(ddpEl.querySelectorAll('time'), rawLocale);
 
@@ -192,6 +185,7 @@ function processDataLoading() {
     });
 
     // 处理其他 timeago 时间
+    const rawLocale = ddUtils.getCurrentLocale();
     applyTimeagoToTimes(document.querySelectorAll('time.dd-timeago'), rawLocale);
 }
 
@@ -386,13 +380,13 @@ function initLayoutSwitcher() {
         grid.classList.toggle('is-list', savedLayout === 'list');
         grid.classList.toggle('is-detail', savedLayout === 'detail');
 
+
         // 查找或创建切换器容器
         let switcher = grid.previousElementSibling;
         if (!switcher || !switcher.classList.contains('article-layout-switcher')) {
             // 如果模板中没写，可以动态注入，但建议写在模板里以保证 UI 一致性
             return;
         }
-
         const listBtn = switcher.querySelector('.layout-list-btn');
         const detailBtn = switcher.querySelector('.layout-detail-btn');
         const gridBtn = switcher.querySelector('.layout-grid-btn');
@@ -402,9 +396,9 @@ function initLayoutSwitcher() {
             if (detailBtn) detailBtn.classList.toggle('is-active', layout === 'detail');
             if (gridBtn) gridBtn.classList.toggle('is-active', layout === 'grid');
         };
-
         updateActiveBtn(savedLayout);
 
+
         const setLayout = (layout) => {
             grid.classList.remove('is-list', 'is-detail');
             if (layout !== 'grid') {
@@ -413,7 +407,6 @@ function initLayoutSwitcher() {
             localStorage.setItem('dd_recent_docs_layout', layout);
             updateActiveBtn(layout);
         };
-
         if (listBtn) {
             listBtn.onclick = () => {
                 setLayout('list');

{mkdocs_document_dates-3.6.0 → mkdocs_document_dates-3.6.1}/mkdocs_document_dates/static/core/utils.js

@@ -44,6 +44,18 @@ window.ddUtils = {
         }
     },
 
+    // 获取当前语言环境，优先级：用户选择 > 元素配置 > 浏览器语言 > 页面语言 > 默认 'en'
+    getCurrentLocale(el) {
+        return (
+            this.getSavedLanguage() ||
+            (el ? el.getAttribute('locale') : null) ||
+            navigator.language ||
+            navigator.userLanguage ||
+            document.documentElement.lang ||
+            'en'
+        );
+    },
+
     // 清除保存的语言设置
     clearLanguage() {
         try {

{mkdocs_document_dates-3.6.0 → mkdocs_document_dates-3.6.1}/mkdocs_document_dates/static/templates/recently_updated_group.html

@@ -2,7 +2,7 @@
 .article-layout-switcher {
     display: flex;
     justify-content: flex-end;
-    margin-bottom: 12px;
+    /* margin-bottom: 20px; */
 }
 .article-layout-switcher button + button {
     margin-left: 8px;
@@ -68,8 +68,7 @@
 }
 .article-grid.is-list .card-title {
     font-weight: 400;
-    color: #0077cc;
-    /* color: var(--md-typeset-color, #1c1c1c); */
+    color: var(--md-typeset-a-color, #0077cc);
 
     white-space: nowrap;
     overflow: hidden;
@@ -110,6 +109,9 @@
     white-space: nowrap;
     margin-right: 10px;
 }
+.card-header:hover {
+    text-decoration: none !important;
+}
 .card-header:hover .card-title {
     color: var(--md-accent-fg-color, blue);
     text-decoration: underline;
@@ -146,6 +148,16 @@
     justify-content: center;
     overflow: hidden;
     margin-left: 10px;
+    transition: filter 0.3s ease;
+
+    /* Safari 圆角闪烁修复 */
+    transform: translateZ(0);              /* 建立独立合成层 */
+    will-change: transform;                /* 提前告诉浏览器 */
+    -webkit-mask-image: -webkit-radial-gradient(white, black); /* 强制圆角裁剪走 mask 管线 */
+    isolation: isolate;
+}
+.card-cover:hover {
+    filter: brightness(0.8);
 }
 .card-cover a {
     display: block;
@@ -157,13 +169,23 @@
     height: 100%;
     object-fit: cover;
     margin: 0 !important;
+
+    /* 避免 layer 升降级 */
+    transform: scale(1.1) translateZ(0);
+    transition: transform 0.4s ease-out;
+    /* 防 Safari 重绘抖动 */
+    backface-visibility: hidden;
+    will-change: transform;
+}
+.card-cover:hover img {
+    transform: scale(1.1) translateX(4px) translateZ(0);
 }
 </style>
 
 <div class="article-layout-switcher">
-    <button class="layout-list-btn" title="List View"><span class="material-icons">view_list</span></button>
-    <button class="layout-detail-btn" title="Detail View"><span class="material-icons">view_day</span></button>
-    <button class="layout-grid-btn" title="Grid View"><span class="material-icons">view_module</span></button>
+    <button class="layout-list-btn"><span class="material-icons">view_list</span></button>
+    <button class="layout-detail-btn"><span class="material-icons">view_day</span></button>
+    <button class="layout-grid-btn"><span class="material-icons">view_module</span></button>
 </div>
 
 <div class="article-grid">

{mkdocs_document_dates-3.6.0 → mkdocs_document_dates-3.6.1}/mkdocs_document_dates/utils.py

@@ -4,6 +4,7 @@ import json
 import heapq
 import logging
 import subprocess
+import fnmatch
 import re
 from pathlib import Path
 from datetime import datetime
@@ -14,15 +15,22 @@ logger = logging.getLogger("mkdocs.plugins.document_dates")
 logger.setLevel(logging.WARNING)  # DEBUG, INFO, WARNING, ERROR, CRITICAL
 
 
-def is_excluded(path, exclude_list):
+def compile_exclude_patterns(exclude_list):
     if not exclude_list:
+        return []
+    return [re.compile(fnmatch.translate(pattern)) for pattern in exclude_list]
+
+def is_excluded(path, patterns):
+    if not patterns:
         return False
-    for pattern in exclude_list:
-        if pattern.endswith('*'):
-            if path.startswith(pattern.partition('*')[0]):
+    first = patterns[0]
+    if isinstance(first, re.Pattern):
+        for regex in patterns:
+            if regex.match(path):
                 return True
-        else:
-            if path == pattern:
+    else:
+        for pattern in patterns:
+            if fnmatch.fnmatch(path, pattern):
                 return True
     return False
 
@@ -133,6 +141,7 @@ def load_git_last_updated_date(docs_dir_path: Path):
 
     return doc_mtime_map
 
+# 建议在 on_page_markdown 之后的全局事件中调用，因为需要读取 page.meta 中的信息
 def get_recently_updated_files(existing_dates: dict, files: Files, exclude_list: list, limit: int = 10, recent_enable: bool = False):
     recently_updated_results = []
     if recent_enable:

{mkdocs_document_dates-3.6.0 → mkdocs_document_dates-3.6.1/mkdocs_document_dates.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocs-document-dates
-Version: 3.6.0
+Version: 3.6.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
@@ -67,7 +67,7 @@ plugins:
   - document-dates
 ```
 
-Or, full configuration:
+Or, common configuration:
 
 ```yaml
 plugins:
@@ -77,8 +77,6 @@ plugins:
       exclude:                 # List of excluded files
         - temp.md                  # Example: exclude the specified file
         - blog/*                   # Example: exclude all files in blog folder, including subfolders
-      date_format: '%Y-%m-%d'  # Date format strings (e.g., %Y-%m-%d, %b %d, %Y)
-      time_format: '%H:%M:%S'  # Time format strings (valid only if type=datetime)
 ```
 
 ## Customization Settings
@@ -97,7 +95,7 @@ In addition to the above basic configuration, the plug-in also provides a wealth
 
 See the documentation for details: https://jaywhj.netlify.app/document-dates-en
 
-<br />
+![recently-updated](recently-updated-en.gif)
 
 ## Other Projects
 

{mkdocs_document_dates-3.6.0 → mkdocs_document_dates-3.6.1}/setup.py

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