1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
# Last Modified At Plugin
A liquid tag for Jekyll to indicate the last time a file was modified.
This plugin determines a page's last modified date by checking the last Git commit date of source files. In the event Git is not available, the file's `mtime` is used.
## Setting up
Open your Gemfile in your Jekyll root folder and add the following:
``` ruby
group :jekyll_plugins do
gem "jekyll-last-modified-at"
end
```
Add the following to your site's `_config.yml` file
```yml
plugins:
- jekyll-last-modified-at
# Optional. The default date format, used if none is specified in the tag.
last-modified-at:
date-format: '%d-%b-%y'
```
## Usage
There are a few ways to use this gem.
You can place the following tag somewhere within your layout:
``` liquid
{% last_modified_at %}
```
By default, this creates a time format matching `"%d-%b-%y"` (like "04-Jan-14").
You can also choose to pass along your own time format. For example:
```liquid
{% last_modified_at %Y:%B:%A:%d:%S:%R %}
```
That produces "2014:January:Saturday:04."
You can also call the method directly on a Jekyll "object," like so:
``` liquid
{{ page.last_modified_at }}
```
To format such a time, you'll need to rely on Liquid's `date` filter:
``` liquid
{{ page.last_modified_at | date: '%Y:%B:%A:%d:%S:%R' }}
```
(It's generally [more performant to use the `page.last_modified_at` version](https://github.com/gjtorikian/jekyll-last-modified-at/issues/24#issuecomment-55431108) of this plugin.)
|
