mkdocs-document-dates 2.3.3__tar.gz → 2.4.0__tar.gz

{mkdocs_document_dates-2.3.3 → mkdocs_document_dates-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocs-document-dates
-Version: 2.3.3
+Version: 2.4.0
 Summary: A MkDocs plugin for displaying accurate document creation and last modification dates.
 Home-page: https://github.com/jaywhj/mkdocs-document-dates
 Author: Aaron Wang
@@ -31,13 +31,12 @@ A MkDocs plugin for displaying <mark>accurate</mark> document creation and last
 
 ## Features
 
-- Automatically displays document creation and last modification times
 - **No Git dependency**, uses filesystem timestamps directly
 - Supports manual date specification in `Front Matter`
 - Cross-platform support (Windows, macOS, Linux)
 - Support for multiple time formats (date, datetime, timeago)
 - Flexible display position (top or bottom)
-- Support for document exclusion
+- Support for document exclusion mode
 - Material Design icons, Elegant styling
 - Lightweight with no extra dependencies
 - Multi-language support
@@ -107,7 +106,7 @@ modified: 2025-02-23
 - **exclude** : File exclusion list (default: [] )
   - Supports glob patterns, e.g., ["private/\*", "temp.md", "drafts/\*.md"]
 
-## Notes
+## Tips
 
 - It still works when using CI/CD build systems (e.g. Github Actions), used a cache file `.dates_cache.json` to solve this problem:
     1. First, you can configure the workflow like this (penultimate line) in your .github/workflows/ci.yml:

{mkdocs_document_dates-2.3.3 → mkdocs_document_dates-2.4.0}/README.md

@@ -8,13 +8,12 @@ A MkDocs plugin for displaying <mark>accurate</mark> document creation and last
 
 ## Features
 
-- Automatically displays document creation and last modification times
 - **No Git dependency**, uses filesystem timestamps directly
 - Supports manual date specification in `Front Matter`
 - Cross-platform support (Windows, macOS, Linux)
 - Support for multiple time formats (date, datetime, timeago)
 - Flexible display position (top or bottom)
-- Support for document exclusion
+- Support for document exclusion mode
 - Material Design icons, Elegant styling
 - Lightweight with no extra dependencies
 - Multi-language support
@@ -84,7 +83,7 @@ modified: 2025-02-23
 - **exclude** : File exclusion list (default: [] )
   - Supports glob patterns, e.g., ["private/\*", "temp.md", "drafts/\*.md"]
 
-## Notes
+## Tips
 
 - It still works when using CI/CD build systems (e.g. Github Actions), used a cache file `.dates_cache.json` to solve this problem:
     1. First, you can configure the workflow like this (penultimate line) in your .github/workflows/ci.yml:

{mkdocs_document_dates-2.3.3 → mkdocs_document_dates-2.4.0}/mkdocs_document_dates/__init__.py

@@ -1,7 +1,5 @@
 """MkDocs Document Dates Plugin."""
 
-__version__ = '2.3.3'
-
 from .hooks_installer import install
 
 # 在包被导入时自动执行 hooks 安装

{mkdocs_document_dates-2.3.3 → mkdocs_document_dates-2.4.0}/mkdocs_document_dates/plugin.py

@@ -36,12 +36,12 @@ class DocumentDatesPlugin(BasePlugin):
         if material_icons_url not in config['extra_css']:
             config['extra_css'].append(material_icons_url)
         
-        # 添加自定义 CSS
+        # 添加默认 CSS
         css_file = Path(config['docs_dir']) / 'assets' / 'document_dates.css'
         css_file.parent.mkdir(parents=True, exist_ok=True)
         css_file.write_text(self._get_css_content())
         config['extra_css'].append('assets/document_dates.css')
-        
+
         return config
 
     def _get_date_info(self, created, modified):
@@ -50,8 +50,10 @@ class DocumentDatesPlugin(BasePlugin):
             locale = 'en'
         t = self.translations[locale]
         
+        position_class = 'document-dates-top' if self.config['position'] == 'top' else 'document-dates-bottom'
+        
         return (
-            f"<div class='document-dates-plugin-wrapper'>"
+            f"<div class='document-dates-plugin-wrapper {position_class}'>"
             f"<div class='document-dates-plugin'>"
             f"<span title='{t['created_time']}: {created.strftime(self.config['date_format'])}'><span class='material-icons'>add_circle</span>"
             f"{self._get_formatted_date(created)}</span>"

mkdocs_document_dates-2.4.0/mkdocs_document_dates/styles.py

@@ -0,0 +1,42 @@
+
+DOCUMENT_DATES_CSS = """
+.document-dates-plugin {
+    color: #8e8e8e;
+    font-size: 0.75rem;
+    padding: 0.2rem 0;
+    opacity: 0.7;
+    display: flex;
+    gap: 1.5rem;
+    align-items: center;
+    margin-bottom: 0.3rem;
+}
+.document-dates-plugin span {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.3rem;
+}
+.document-dates-plugin .material-icons {
+    font-size: 0.9rem;
+    opacity: 0.7;
+}
+
+
+/* top position style */
+.document-dates-plugin-wrapper.document-dates-top {
+    margin-top: -1.2rem;
+    padding-bottom: 0.3rem;
+    border-bottom: 1px solid rgba(0, 0, 0, 0.07);
+}
+/* bottom position style */
+.document-dates-plugin-wrapper.document-dates-bottom {
+    margin: 1rem 0;
+    padding-bottom: 0.3rem;
+    border-bottom: 1px solid rgba(0, 0, 0, 0.07);
+}
+
+
+/* Hide the footnote divider immediately following the date information with the CSS adjacent sibling selector */
+.document-dates-plugin-wrapper + .footnote hr {
+    display: none;
+}
+"""

{mkdocs_document_dates-2.3.3 → mkdocs_document_dates-2.4.0}/mkdocs_document_dates.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocs-document-dates
-Version: 2.3.3
+Version: 2.4.0
 Summary: A MkDocs plugin for displaying accurate document creation and last modification dates.
 Home-page: https://github.com/jaywhj/mkdocs-document-dates
 Author: Aaron Wang
@@ -31,13 +31,12 @@ A MkDocs plugin for displaying <mark>accurate</mark> document creation and last
 
 ## Features
 
-- Automatically displays document creation and last modification times
 - **No Git dependency**, uses filesystem timestamps directly
 - Supports manual date specification in `Front Matter`
 - Cross-platform support (Windows, macOS, Linux)
 - Support for multiple time formats (date, datetime, timeago)
 - Flexible display position (top or bottom)
-- Support for document exclusion
+- Support for document exclusion mode
 - Material Design icons, Elegant styling
 - Lightweight with no extra dependencies
 - Multi-language support
@@ -107,7 +106,7 @@ modified: 2025-02-23
 - **exclude** : File exclusion list (default: [] )
   - Supports glob patterns, e.g., ["private/\*", "temp.md", "drafts/\*.md"]
 
-## Notes
+## Tips
 
 - It still works when using CI/CD build systems (e.g. Github Actions), used a cache file `.dates_cache.json` to solve this problem:
     1. First, you can configure the workflow like this (penultimate line) in your .github/workflows/ci.yml:

{mkdocs_document_dates-2.3.3 → mkdocs_document_dates-2.4.0}/setup.py

@@ -7,7 +7,7 @@ try:
 except FileNotFoundError:
     long_description = "A MkDocs plugin for displaying accurate document creation and last modification dates."
 
-VERSION = '2.3.3'
+VERSION = '2.4.0'
 
 setup(
     name="mkdocs-document-dates",

mkdocs_document_dates-2.3.3/mkdocs_document_dates/styles.py

@@ -1,27 +0,0 @@
-
-DOCUMENT_DATES_CSS = """
-.document-dates-plugin {
-    color: #8e8e8e;
-    font-size: 0.75rem;
-    padding: 0.2rem 0;
-    opacity: 0.8;
-    display: flex;
-    gap: 1.5rem;
-    align-items: center;
-    margin-bottom: 0.3rem;
-}
-.document-dates-plugin span {
-    display: inline-flex;
-    align-items: center;
-    gap: 0.3rem;
-}
-.document-dates-plugin .material-icons {
-    font-size: 0.9rem;
-    opacity: 0.7;
-}
-.document-dates-plugin-wrapper {
-    margin: 0.3rem 0 1rem 0;
-    border-bottom: 1px solid rgba(0, 0, 0, 0.07);
-    padding-bottom: 0.5rem;
-}
-"""