Metadata-Version: 2.1
Name: mkdocs-git-revision-date-localized-plugin
Version: 0.5.1
Summary: Mkdocs plugin that enables displaying the localized date of the last git modification of a markdown file.
Home-page: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin
Author: Tim Vink
Author-email: vinktim@gmail.com
License: MIT
Description: [![Actions Status](https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/workflows/pytest/badge.svg)](https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/actions)
        ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mkdocs-git-revision-date-localized-plugin)
        ![PyPI](https://img.shields.io/pypi/v/mkdocs-git-revision-date-localized-plugin)
        ![PyPI - Downloads](https://img.shields.io/pypi/dm/mkdocs-git-revision-date-localized-plugin)
        [![codecov](https://codecov.io/gh/timvink/mkdocs-git-revision-date-localized-plugin/branch/master/graph/badge.svg)](https://codecov.io/gh/timvink/mkdocs-git-revision-date-localized-plugin)
        ![GitHub contributors](https://img.shields.io/github/contributors/timvink/mkdocs-git-revision-date-localized-plugin)
        ![PyPI - License](https://img.shields.io/pypi/l/mkdocs-git-revision-date-localized-plugin)
        
        # mkdocs-git-revision-date-localized-plugin
        
        [MkDocs](https://www.mkdocs.org/) plugin that enables displaying the date of the last git modification of a page. The plugin uses [babel](https://github.com/python-babel/babel/tree/master/babel) and [timeago.js](https://github.com/hustcc/timeago.js) to provide different localized date formats. Initial fork from [mkdocs-git-revision-date-plugin](https://github.com/zhaoterryy/mkdocs-git-revision-date-plugin).
        
        ![example](https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/raw/master/example.png)
        
        (*Example when used together with [mkdocs-material](https://github.com/squidfunk/mkdocs-material) theme*)
        
        ## Setup
        
        Install the plugin using `pip` with the following command:
        
        ```bash
        pip install mkdocs-git-revision-date-localized-plugin
        ```
        
        Next, add the following lines to your `mkdocs.yml`:
        
        ```yaml
        plugins:
          - search
          - git-revision-date-localized
        ```
        
        > If you have no `plugins` entry in your config file yet, you'll likely also want to add the `search` plugin. MkDocs enables it by default if there is no `plugins` entry set.
        
        ### When using CI runners
        
        The plugin needs access to the last commit that touched a file to be able to retrieve the date. If you build your docs using CI then you might need to change the default settings:
        
        - github actions: set `fetch_depth` to `0` ([docs](https://github.com/actions/checkout))
        - gitlab runners: set `GIT_DEPTH` to `1000` ([docs](https://docs.gitlab.com/ee/user/project/pipelines/settings.html#git-shallow-clone))
        
        ----
        
        ## Usage
        
        ### In supported themes
        
        - [mkdocs-material](https://squidfunk.github.io/mkdocs-material/) offers support for this plugin, see [setup instructions](https://squidfunk.github.io/mkdocs-material/plugins/revision-date/)
        
        ### In theme templates
        
        In templates you can use `page.meta.git_revision_date_localized`:
        
        ```django hljs
        {% if page.meta.git_revision_date_localized %}
          Last update: {{ page.meta.git_revision_date_localized }}
        {% endif %}
        ```
        
        ### In markdown pages
        
        In your markdown files you can use `{{ git_revision_date_localized }}`:
        
        ```django hljs
        Last update: {{ git_revision_date_localized }}
        ```
        
        ## Options
        
        ### `type`
        
        To change the date format, set the `type` parameter to one of `date`, `datetime`, `iso_date`, `iso_datetime` or `timeago`. Default is `date`. Example outputs:
        
        ```bash
        28 November, 2019           # type: date
        28 November, 2019 13:57:28  # type: datetime
        2019-11-28                  # type: iso_date
        2019-11-28 13:57:26         # type: iso_datetime
        20 hours ago                # type: timeago
        ```
        
        ### `locale`
        
        Specify a two letter [ISO639](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language code to display dates in your preferred language.
        
        - When used in combination with `type: date` or `type: datetime`, translation is done using [babel](https://github.com/python-babel/babel) which supports [these locales](http://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html)
        - When used in combination with `type: timeago` then [timeago.js](https://github.com/hustcc/timeago.js) is added to your website, which supports [these locales](https://github.com/hustcc/timeago.js/tree/master/src/lang). If you specify a locale not supported by timeago.js, the fallback is English (`en`)
        - When not set, this plugin will look for `locale` or `language` options set in your theme. If also not set, the fallback is English (`en`)
        
        ### `fallback_to_build_date`
        
        If set to `true` (default is `false`) the plugin will use the time when running `mkdocs build` instead of the git revision date. This means the revision date will be inaccurate, but this can be useful if your build environment has no access to GIT and you want to ignore the Git exceptions during `git log`.
        
        ----
        
        ### Example
        
        Example with all options:
        
        ```yaml
        # mkdocs.yml
        plugins:
          - git-revision-date-localized:
            locale: en
            type: timeago
            fallback_to_build_date: true
        ```
        
        Result:
        
        ```txt
        20 hours ago
        ```
        
Keywords: mkdocs git date timeago babel plugin
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.5
Description-Content-Type: text/markdown
