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

{mkdocs_document_dates-3.5.2/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.5.2
+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,6 +95,12 @@ 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
 
+![recently-updated](recently-updated-en.gif)
+
+## Other Projects
+
+- [**MaterialX**](https://github.com/jaywhj/mkdocs-materialx), the next generation of mkdocs-material, is based on `mkdocs-material-9.7.0` and is named `X`. I'll be maintaining this branch continuously (since mkdocs-material will stop being maintained). 
+Updates have been released that refactor and add a lot of new features, see https://github.com/jaywhj/mkdocs-materialx/releases/
 
 <br />
 

{mkdocs_document_dates-3.5.2 → 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,6 +69,12 @@ 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
 
+![recently-updated](recently-updated-en.gif)
+
+## Other Projects
+
+- [**MaterialX**](https://github.com/jaywhj/mkdocs-materialx), the next generation of mkdocs-material, is based on `mkdocs-material-9.7.0` and is named `X`. I'll be maintaining this branch continuously (since mkdocs-material will stop being maintained). 
+Updates have been released that refactor and add a lot of new features, see https://github.com/jaywhj/mkdocs-materialx/releases/
 
 <br />
 

{mkdocs_document_dates-3.5.2 → 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
@@ -46,9 +46,9 @@ class DocumentDatesPlugin(BasePlugin):
         self.dates_cache = {}
         self.last_updated_dates = {}
         self.authors_yml = {}
-        self.github_username = None
         self.recent_docs_html = None
         self.recent_enable = False
+        self._exclude_patterns = []
 
     def on_config(self, config):
         docs_dir_path = Path(config['docs_dir'])
@@ -139,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):
@@ -165,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
@@ -186,10 +188,10 @@ class DocumentDatesPlugin(BasePlugin):
         # 获取配置
         exclude_list = recently_updated_config.get('exclude', [])
         limit = recently_updated_config.get('limit', 10)
-        template_path = recently_updated_config.get('template')
 
         # 获取最近更新的文档数据
-        recently_updated_docs = get_recently_updated_files(self.last_updated_dates, files, exclude_list, limit, self.recent_enable)
+        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:
@@ -198,8 +200,7 @@ class DocumentDatesPlugin(BasePlugin):
 
         # 渲染HTML
         if self.recent_enable:
-            docs_dir = Path(config['docs_dir'])
-            self.recent_docs_html = self._render_recently_updated_html(docs_dir, template_path, recently_updated_docs)
+            self.recent_docs_html = self._render_recently_updated_html(recently_updated_docs)
 
         return env
 
@@ -233,20 +234,10 @@ class DocumentDatesPlugin(BasePlugin):
             logger.info(f"Error parsing .authors.yml: {e}")
 
 
-    def _render_recently_updated_html(self, docs_dir, template_path, recently_updated_data):
-        # 获取自定义模板路径
-        if template_path:
-            user_full_path = docs_dir / template_path
-
-        # 选择模板路径
-        if template_path and user_full_path.is_file():
-            template_dir = user_full_path.parent
-            template_file = user_full_path.name
-        else:
-            # 默认模板路径
-            default_template_path = Path(__file__).parent / 'static' / 'templates' / 'recently_updated.html'
-            template_dir = default_template_path.parent
-            template_file = default_template_path.name
+    def _render_recently_updated_html(self, recently_updated_data):
+        default_template_path = Path(__file__).parent / 'static' / 'templates' / 'recently_updated_group.html'
+        template_dir = default_template_path.parent
+        template_file = default_template_path.name
 
         # 加载模板
         env = Environment(
@@ -490,4 +481,4 @@ class DocumentDatesPlugin(BasePlugin):
 
             pos = next_newline + 1
 
-        return '', length
+        return '', length

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

@@ -144,25 +144,30 @@ const iconKeyMap = {
     doc_author: 'author',
     doc_authors: 'authors'
 };
+
+function applyTimeagoToTimes(timeNodes, rawLocale) {
+    if (typeof timeago === 'undefined') {
+        return;
+    }
+    if (!timeNodes || !timeNodes.length) {
+        return;
+    }
+    const tLocale = ddUtils.resolveTimeagoLocale(rawLocale);
+    timeNodes.forEach(timeEl => {
+        const dt = timeEl.getAttribute('datetime');
+        if (dt) {
+            timeEl.textContent = timeago.format(dt, tLocale);
+        }
+    });
+}
+
 // 处理数据加载
 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';
+        const rawLocale = ddUtils.getCurrentLocale(ddpEl);
 
         // 处理 time 元素（使用 timeago 时）
-        if (typeof timeago !== 'undefined') {
-            const tLocale = ddUtils.resolveTimeagoLocale(rawLocale);
-            ddpEl.querySelectorAll('time').forEach(timeEl => {
-                timeEl.textContent = timeago.format(timeEl.getAttribute('datetime'), tLocale);
-            });
-        }
+        applyTimeagoToTimes(ddpEl.querySelectorAll('time'), rawLocale);
 
         // 动态处理 tooltip 内容
         const langData = TooltipLanguage.get(rawLocale);
@@ -178,6 +183,10 @@ function processDataLoading() {
             }
         });
     });
+
+    // 处理其他 timeago 时间
+    const rawLocale = ddUtils.getCurrentLocale();
+    applyTimeagoToTimes(document.querySelectorAll('time.dd-timeago'), rawLocale);
 }
 
 // 供外部使用：更新文档日期和 tippy 内容到指定语言（可持久化）
@@ -359,6 +368,65 @@ function handleDocumentDatesAutoWrap() {
     });
 }
 
+// 最近更新 - 布局切换器 (Layout Switcher)
+function initLayoutSwitcher() {
+    const grids = document.querySelectorAll('.article-grid');
+    if (!grids.length) return;
+
+    const savedLayout = localStorage.getItem('dd_recent_docs_layout') || 'grid';
+
+    grids.forEach(grid => {
+        // 应用初始布局
+        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');
+
+        const updateActiveBtn = (layout) => {
+            if (listBtn) listBtn.classList.toggle('is-active', layout === 'list');
+            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') {
+                grid.classList.add(`is-${layout}`);
+            }
+            localStorage.setItem('dd_recent_docs_layout', layout);
+            updateActiveBtn(layout);
+        };
+        if (listBtn) {
+            listBtn.onclick = () => {
+                setLayout('list');
+                listBtn.blur();
+            };
+        }
+        if (detailBtn) {
+            detailBtn.onclick = () => {
+                setLayout('detail');
+                detailBtn.blur();
+            };
+        }
+        if (gridBtn) {
+            gridBtn.onclick = () => {
+                setLayout('grid');
+                gridBtn.blur();
+            };
+        }
+    });
+}
 
 /*
     入口
@@ -367,6 +435,7 @@ let datesAutoWrapObserver = null;
 function initPluginFeatures() {
     tippyManager.initialize();
     processDataLoading();
+    initLayoutSwitcher();
     AvatarService.init().then(() => {
         loadAvatars();
     });
@@ -381,6 +450,7 @@ function initPluginFeatures() {
         });
     });
     document.querySelectorAll('.document-dates-plugin').forEach(ddpEl => datesAutoWrapObserver.observe(ddpEl));
+    setTimeout(handleDocumentDatesAutoWrap, 100);
 }
 
 // 兼容 Material 主题的 'navigation.instant' 属性

{mkdocs_document_dates-3.5.2 → 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.1/mkdocs_document_dates/static/templates/recently_updated_detail.html

@@ -0,0 +1,99 @@
+<style>
+.article-card {
+    border: 1px solid rgba(142, 142, 142, 0.2);
+    border-radius: 8px;
+    padding: 16px;
+    margin: 20px auto;
+    font-family: sans-serif;
+    box-sizing: border-box;
+    display: flex;
+    flex-direction: column;
+}
+
+/* --- 第一行：标题与时间 --- */
+.card-header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    text-decoration: none;
+}
+.card-title {
+    font-weight: 700;
+    line-height: 1.4;
+    color: var(--md-typeset-color, #1c1c1c);
+    margin-right: 16px;
+}
+.card-date {
+    font-size: 0.84em;
+    color: rgba(100, 100, 100, 0.4);
+    white-space: nowrap;
+    margin-right: 10px;
+}
+.card-header:hover .card-title {
+    color: var(--md-accent-fg-color, blue);
+    text-decoration: underline;
+}
+
+/* --- 第二行：摘要与封面图 --- */
+.card-body {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-top: 12px;
+}
+.card-summary {
+    flex: 1;
+    color: rgba(142, 142, 142, 1);
+    font-size: 0.7rem;
+    line-height: 1.6;
+    letter-spacing: 0.02rem;
+    word-break: break-all;
+    
+    /* 3 行文字截断，超出显示省略号 */
+    display: -webkit-box;
+    -webkit-box-orient: vertical;
+    -webkit-line-clamp: 3;
+    overflow: hidden;
+}
+.card-cover {
+    width: 120px;
+    height: 80px;
+    border-radius: 8px;
+    flex-shrink: 0;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    overflow: hidden;
+    margin-left: 10px;
+}
+.card-cover a {
+    display: block;
+    width: 100%;
+    height: 100%;
+}
+.card-cover img {
+    width: 100%;
+    height: 100%;
+    object-fit: cover;
+    margin: 0 !important;
+}
+</style>
+
+<div>
+    {%- for mtime, rel_path, title, url, cover, summary in recent_docs %}
+    <div class="article-card">
+        <a class="card-header" href="{{ url }}" target="_blank">
+            <div class="card-title">{{ title }}</div>
+            <time class="dd-timeago card-date" datetime="{{ mtime }}">{{ mtime[:10] }}</time>
+        </a>
+        <div class="card-body">
+            <div class="card-summary">{{ summary }}</div>
+            {%- if cover %}
+            <div class="card-cover">
+                <img src="{{ cover }}" alt="{{ title }}">
+            </div>
+            {%- endif %}
+        </div>
+    </div>
+    {%- endfor %}
+</div>

mkdocs_document_dates-3.6.1/mkdocs_document_dates/static/templates/recently_updated_grid.html

@@ -0,0 +1,106 @@
+<style>
+/* --- 网格布局容器 --- */
+.article-grid {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
+    gap: 20px;
+    margin: 20px 0;
+}
+
+.article-card {
+    border: 1px solid rgba(142, 142, 142, 0.2);
+    border-radius: 8px;
+    padding: 16px;
+    font-family: sans-serif;
+    box-sizing: border-box;
+    display: flex;
+    flex-direction: column;
+}
+
+/* --- 第一行：标题与时间 --- */
+.card-header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    text-decoration: none;
+}
+.card-title {
+    font-weight: 700;
+    line-height: 1.4;
+    color: var(--md-typeset-color, #1c1c1c);
+    margin-right: 16px;
+}
+.card-date {
+    font-size: 0.84em;
+    color: rgba(100, 100, 100, 0.4);
+    white-space: nowrap;
+    margin-right: 10px;
+}
+.card-header:hover .card-title {
+    color: var(--md-accent-fg-color, blue);
+    text-decoration: underline;
+}
+
+/* --- 第二行：摘要与封面图 --- */
+.card-body {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-top: 12px;
+}
+.card-summary {
+    flex: 1;
+    color: rgba(142, 142, 142, 1);
+    font-size: 0.7rem;
+    line-height: 1.6;
+    letter-spacing: 0.02rem;
+    word-break: break-all;
+    
+    /* 3 行文字截断，超出显示省略号 */
+    display: -webkit-box;
+    -webkit-box-orient: vertical;
+    -webkit-line-clamp: 3;
+    overflow: hidden;
+}
+.card-cover {
+    width: 120px;
+    height: 80px;
+    border-radius: 8px;
+    flex-shrink: 0;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    overflow: hidden;
+    margin-left: 10px;
+}
+.card-cover a {
+    display: block;
+    width: 100%;
+    height: 100%;
+}
+.card-cover img {
+    width: 100%;
+    height: 100%;
+    object-fit: cover;
+    margin: 0 !important;
+}
+</style>
+
+<div class="article-grid">
+    {%- for mtime, rel_path, title, url, cover, summary in recent_docs %}
+    <div class="article-card">
+        <a class="card-header" href="{{ url }}" target="_blank">
+            <div class="card-title">{{ title }}</div>
+            <time class="dd-timeago card-date" datetime="{{ mtime }}">{{ mtime[:10] }}</time>
+        </a>
+        <div class="card-body">
+            <div class="card-summary">{{ summary }}</div>
+            {%- if cover %}
+            <div class="card-cover">
+                <img src="{{ cover }}" alt="{{ title }}">
+            </div>
+            {%- endif %}
+        </div>
+    </div>
+    {%- endfor %}
+</div>

mkdocs_document_dates-3.6.1/mkdocs_document_dates/static/templates/recently_updated_group.html

@@ -0,0 +1,208 @@
+<style>
+.article-layout-switcher {
+    display: flex;
+    justify-content: flex-end;
+    /* margin-bottom: 20px; */
+}
+.article-layout-switcher button + button {
+    margin-left: 8px;
+}
+.article-layout-switcher button {
+    background: transparent;
+    border: none;
+    cursor: pointer;
+    padding: 4px;
+    border-radius: 4px;
+    display: flex;
+    align-items: center;
+    color: var(--md-typeset-color, #1c1c1c);
+    opacity: 0.4;
+    transition: all 0.2s;
+}
+.article-layout-switcher button:hover {
+    background: rgba(142, 142, 142, 0.1);
+    opacity: 0.8;
+}
+.article-layout-switcher button.is-active {
+    opacity: 1;
+    color: var(--md-accent-fg-color, blue);
+    background: rgba(142, 142, 142, 0.1);
+}
+.article-layout-switcher .material-icons {
+    font-size: 20px;
+}
+
+/* --- 网格模式 (默认) --- */
+.article-grid {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
+    gap: 20px;
+    margin: 20px 0;
+    /* transition: all 0.2s ease; */
+}
+
+/* --- 详情模式 (is-detail) --- */
+.article-grid.is-detail {
+    grid-template-columns: 1fr;
+    margin-left: auto;
+    margin-right: auto;
+}
+
+/* --- 列表模式 (is-list) --- */
+.article-grid.is-list {
+    margin-left: auto;
+    margin-right: auto;
+
+    border: 1px solid rgba(142, 142, 142, 0.2);
+    border-radius: 8px;
+    row-gap: 0;
+    padding: 11px;
+}
+.article-grid.is-list .card-body {
+    display: none;
+}
+.article-grid.is-list .article-card {
+    border: none;
+    border-radius: 0;
+    padding: 8px;
+}
+.article-grid.is-list .card-title {
+    font-weight: 400;
+    color: var(--md-typeset-a-color, #0077cc);
+
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    min-width: 0;
+}
+.article-grid.is-list .card-date {
+    margin-right: 0;
+}
+
+
+.article-card {
+    border: 1px solid rgba(142, 142, 142, 0.2);
+    border-radius: 8px;
+    padding: 16px;
+    font-family: sans-serif;
+    box-sizing: border-box;
+    display: flex;
+    flex-direction: column;
+}
+
+/* --- 第一行：标题与时间 --- */
+.card-header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    text-decoration: none;
+}
+.card-title {
+    font-weight: 700;
+    line-height: 1.4;
+    color: var(--md-typeset-color, #1c1c1c);
+    margin-right: 12px;
+}
+.card-date {
+    font-size: 0.84em;
+    color: rgba(100, 100, 100, 0.4);
+    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;
+}
+
+/* --- 第二行：摘要与封面图 --- */
+.card-body {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-top: 12px;
+}
+.card-summary {
+    flex: 1;
+    color: rgba(142, 142, 142, 1);
+    font-size: 0.7rem;
+    line-height: 1.6;
+    letter-spacing: 0.02rem;
+    word-break: break-all;
+    
+    /* 3 行文字截断，超出显示省略号 */
+    display: -webkit-box;
+    -webkit-box-orient: vertical;
+    -webkit-line-clamp: 3;
+    overflow: hidden;
+}
+.card-cover {
+    width: 120px;
+    height: 80px;
+    border-radius: 8px;
+    flex-shrink: 0;
+    display: flex;
+    align-items: center;
+    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;
+    width: 100%;
+    height: 100%;
+}
+.card-cover img {
+    width: 100%;
+    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"><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">
+    {%- for mtime, rel_path, title, url, cover, summary in recent_docs %}
+    <div class="article-card">
+        <a class="card-header" href="{{ url }}" target="_blank">
+            <div class="card-title">{{ title }}</div>
+            <time class="dd-timeago card-date" datetime="{{ mtime }}">{{ mtime[:10] }}</time>
+        </a>
+        <div class="card-body">
+            <div class="card-summary">{{ summary }}</div>
+            {%- if cover %}
+            <div class="card-cover">
+                <img src="{{ cover }}" alt="{{ title }}">
+            </div>
+            {%- endif %}
+        </div>
+    </div>
+    {%- endfor %}
+</div>

mkdocs_document_dates-3.5.2/mkdocs_document_dates/static/templates/recently_updated.html → mkdocs_document_dates-3.6.1/mkdocs_document_dates/static/templates/recently_updated_list.html

@@ -1,24 +1,24 @@
 <style>
 .recently-updated {
     display: grid;
-    grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
-    gap: 10px;
-    margin: 0;
-    padding: 16px;
-    border: 1px solid rgba(142, 142, 142, 0.15);
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    padding: 11px;
+    border: 1px solid rgba(142, 142, 142, 0.2);
     border-radius: 8px;
     font-family: system-ui, sans-serif;
 }
+
+/* 屏幕宽度 675px 及以下时切换为 1 列 */
+@media screen and (max-width: 675px) {
+    .recently-updated {
+        grid-template-columns: 1fr;
+    }
+}
 .recently-updated-item {
     display: flex;
     align-items: center;
-}
-.recently-updated-item span {
-    font-size: 0.84em;
-    color: rgba(142, 142, 142, 0.5);
-    margin-right: 4px;
-    flex-shrink: 0;
-    width: 90px;
+    justify-content: space-between;
+    margin: 5px;
 }
 .recently-updated-item a {
     overflow: hidden;
@@ -26,17 +26,25 @@
     white-space: nowrap;
     color: #0077cc;
     text-decoration: none;
-    transition: color 0.2s ease;
+    margin-left: 6px;
 }
 .recently-updated-item a:hover {
     text-decoration: underline;
 }
+.recently-updated-item time {
+    font-size: 0.84em;
+    color: rgba(142, 142, 142, 0.4);
+    margin: 0 6px;
+    flex-shrink: 0;
+    text-align: right;
+}
 </style>
+
 <div class="recently-updated">
-    {%- for mtime, rel_path, title, url in recent_docs %}
+    {%- for mtime, rel_path, title, url, cover, summary in recent_docs %}
     <div class="recently-updated-item">
-        <span>{{ mtime[:10] }}</span>
         <a href="{{ url }}" target="_blank">{{ title }}</a>
+        <time class="dd-timeago" datetime="{{ mtime }}">{{ mtime[:10] }}</time>
     </div>
     {%- endfor %}
 </div>

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

@@ -4,6 +4,8 @@ import json
 import heapq
 import logging
 import subprocess
+import fnmatch
+import re
 from pathlib import Path
 from datetime import datetime
 from collections import defaultdict
@@ -13,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
 
@@ -132,7 +141,8 @@ def load_git_last_updated_date(docs_dir_path: Path):
 
     return doc_mtime_map
 
-def get_recently_updated_files(existing_map: dict, files: Files, exclude_list: list, limit: int = 10, recent_enable: bool = False):
+# 建议在 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:
         files_meta = []
@@ -148,14 +158,23 @@ def get_recently_updated_files(existing_map: dict, files: Files, exclude_list: l
                 continue
 
             # 优先从现有数据获取 mtime，如果不存在则 fallback 到文件系统 mtime
-            mtime = existing_map.get(rel_path, os.path.getmtime(file.abs_src_path))
+            mtime = existing_dates.get(rel_path, os.path.getmtime(file.abs_src_path))
 
             # 获取文档标题和 URL
             title = file.page.title if file.page and file.page.title else file.name
             url = file.page.url if file.page and file.page.url else file.url
 
+            cover = ''
+            summary = ''
+            # authors = []
+            if file.page:
+                cover = file.page.meta.get('cover', '')
+                # authors = file.page.meta.get('document_dates_authors', [])
+                if file.page.file:
+                    summary = extract_summary(file.page.file.content_string)
+
             # 存储信息
-            files_meta.append((mtime, rel_path, title, url))
+            files_meta.append((mtime, rel_path, title, url, cover, summary))
             # existing_map[rel_path] = mtime
 
         # 构建最近更新列表
@@ -208,3 +227,195 @@ 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
+
+
+# ===== Extract Summary =====
+# 
+# -------- block skip --------
+# Fence
+FENCE_RE = re.compile(r"^\s*([`~]{3,})")
+
+# HTML comment
+HTML_COMMENT_START = re.compile(r'<!--', re.I)
+HTML_COMMENT_END   = re.compile(r'-->', re.I)
+
+# HTML
+HTML_TAG_OPEN = re.compile(r'<\s*([a-zA-Z][\w\-]*)\b', re.I)
+HTML_TAG_CLOSE_TEMPLATE = r"</\s*{}\s*>"
+HTML_VOID_TAGS = {
+    "area", "base", "br", "col", "embed", "hr",
+    "img", "input", "link", "meta", "param",
+    "source", "track", "wbr"
+}
+HTML_VOID_CLOSE_RE = re.compile(r">", re.I)
+
+# -------- inline skip --------
+H1_TITLE = re.compile(r'^\s*# .+$', re.MULTILINE)
+SINGLE_LINE_HTML_NOISE = re.compile(r'^</?[a-z][\w-]*[^>]*>$', re.I)
+TABLE_ROW_RE = re.compile(r"^\s*\|.*\|\s*$")
+INLINE_SKIP_RE = re.compile(
+    r"""
+    ^\s*> |                 # quote
+    ^\s*(?:!!!|\?\?\?) |    # admonition
+    ^\s*=== |               # tab
+    ^\s*\[.+?\]:            # reference link, including footnote
+    """,
+    re.X,
+)
+
+# -------- inline replace --------
+IMAGE_RE = re.compile(r'!\[[^\]]*\]\([^)]+\)')
+LINK_RE = re.compile(r'\[([^\]]+)\]\([^)]+\)')
+BRACE_RE = re.compile(r"\{[^}]*\}")
+MD_SYNTAX_RE = re.compile(r'[`*_>#]+')
+
+def clean_markdown(md: str) -> list:
+
+    lines = md.splitlines()
+    result = []
+
+    state = "NORMAL"
+    fence = ""
+    html_close_re = None
+    frontmatter_parsed = False
+    h1_parsed = False
+    math_delim = ""
+
+    for line in lines:
+        stripped = line.strip()
+        if not stripped:
+            continue
+
+        # ==================================================
+        # 1. Frontmatter
+        # ==================================================
+        if not frontmatter_parsed:
+            if state == "FRONTMATTER":
+                if stripped in ("---", "+++"):
+                    state = "NORMAL"
+                    frontmatter_parsed = True
+                continue
+            
+            if state == "NORMAL" and stripped in ("---", "+++"):
+                state = "FRONTMATTER"
+                continue
+
+        # ==================================================
+        # 2. Fence Block
+        # ==================================================
+        if state == "FENCE":
+            if stripped.startswith(fence):
+                state = "NORMAL"
+            continue
+ 
+        if state == "NORMAL":
+            m = FENCE_RE.match(stripped)
+            if m:
+                fence = m.group(1)
+                state = "FENCE"
+                continue
+
+        # ==================================================
+        # 3. HTML Comment
+        # ==================================================
+        if state == "COMMENT":
+            if HTML_COMMENT_END.search(stripped):
+                state = "NORMAL"
+            continue
+
+        if state == "NORMAL" and HTML_COMMENT_START.search(stripped):
+            state = "COMMENT"
+            if HTML_COMMENT_END.search(stripped):
+                state = "NORMAL"
+            continue
+
+        # ==================================================
+        # 4. HTML Block
+        # ==================================================
+        if state == "HTML_BLOCK":
+            if html_close_re and html_close_re.search(stripped):
+                state = "NORMAL"
+                html_close_re = None
+            continue
+
+        if state == "NORMAL":
+            m = HTML_TAG_OPEN.match(stripped)
+            if m:
+                tag = m.group(1).lower()
+                is_void = tag in HTML_VOID_TAGS
+
+                # void tag：单行且以 > 结尾，视为直接结束，忽略该行
+                if stripped.endswith('>') and is_void:
+                    continue
+
+                # 非 void tag：进入 HTML_BLOCK
+                state = "HTML_BLOCK"
+                if is_void:
+                    html_close_re = HTML_VOID_CLOSE_RE
+                else:
+                    html_close_re = re.compile(HTML_TAG_CLOSE_TEMPLATE.format(re.escape(tag)), re.I)
+
+                # same-line close: <div>...</div>
+                if html_close_re.search(stripped):
+                    state = "NORMAL"
+                    html_close_re = None
+
+                continue
+
+        # ==================================================
+        # 5. Math Block
+        # ==================================================
+        if state == "MATH":
+            if stripped == math_delim:
+                state = "NORMAL"
+            continue
+
+        if state == "NORMAL" and stripped in ("$$", "\\["):
+            math_delim = "$$" if stripped == "$$" else "\\]"
+            state = "MATH"
+            continue
+
+        # ==================================================
+        # 6. Inline Skip
+        # ==================================================
+        if state == "NORMAL":
+            if TABLE_ROW_RE.match(stripped):
+                continue
+            if INLINE_SKIP_RE.match(stripped):
+                continue
+            # 单行 HTML 噪音兜底
+            if SINGLE_LINE_HTML_NOISE.match(stripped):
+                continue
+            if not h1_parsed:
+                if H1_TITLE.match(stripped):
+                    h1_parsed = True
+                    continue
+            if stripped.startswith(('---', '***')):
+                continue
+
+        # ==================================================
+        # 7. Inline Replace
+        # ==================================================
+        text = stripped
+        text = IMAGE_RE.sub("", text)
+        text = LINK_RE.sub(r"\1", text)
+        text = BRACE_RE.sub("", text)
+
+        text = text.strip()
+        if text:
+            result.append(text)
+
+            # 提前熔断
+            if len(result) >= 10:
+                break
+
+        # 锁定 Frontmatter 状态，防止后续 --- 干扰
+        frontmatter_parsed = True
+
+    return result
+    # return "\n".join(result)
+
+def extract_summary(markdown_text: str) -> str:
+    md_list = clean_markdown(markdown_text)
+    text = "  ".join(md_list)
+    return MD_SYNTAX_RE.sub('', text).strip()

{mkdocs_document_dates-3.5.2 → 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.5.2
+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,6 +95,12 @@ 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
 
+![recently-updated](recently-updated-en.gif)
+
+## Other Projects
+
+- [**MaterialX**](https://github.com/jaywhj/mkdocs-materialx), the next generation of mkdocs-material, is based on `mkdocs-material-9.7.0` and is named `X`. I'll be maintaining this branch continuously (since mkdocs-material will stop being maintained). 
+Updates have been released that refactor and add a lot of new features, see https://github.com/jaywhj/mkdocs-materialx/releases/
 
 <br />
 

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

@@ -26,7 +26,10 @@ mkdocs_document_dates/static/core/timeago.min.js
 mkdocs_document_dates/static/core/utils.js
 mkdocs_document_dates/static/fonts/material-icons.css
 mkdocs_document_dates/static/fonts/materialicons.woff2
-mkdocs_document_dates/static/templates/recently_updated.html
+mkdocs_document_dates/static/templates/recently_updated_detail.html
+mkdocs_document_dates/static/templates/recently_updated_grid.html
+mkdocs_document_dates/static/templates/recently_updated_group.html
+mkdocs_document_dates/static/templates/recently_updated_list.html
 mkdocs_document_dates/static/tippy/backdrop.css
 mkdocs_document_dates/static/tippy/light.css
 mkdocs_document_dates/static/tippy/material.css

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

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

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

@@ -143,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);