https://github.com/patrickcate/jekyll-ordinal

Jekyll liquid filter to output a date ordinal such as "st", "nd", "rd", or "th".
https://github.com/patrickcate/jekyll-ordinal

jekyll jekyll-ordinal liquid liquid-filters

Last synced: 24 days ago
JSON representation

Jekyll liquid filter to output a date ordinal such as "st", "nd", "rd", or "th".

• Host: GitHub
• URL: https://github.com/patrickcate/jekyll-ordinal
• Owner: patrickcate
• License: unlicense
• Created: 2014-02-15T05:46:16.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2016-03-30T23:56:22.000Z (over 8 years ago)
• Last Synced: 2024-10-17T18:12:14.155Z (about 1 month ago)
• Topics: jekyll, jekyll-ordinal, liquid, liquid-filters
• Language: Ruby
• Homepage:
• Size: 2.93 KB
• Stars: 11
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Jekyll-Ordinal

==============

Jekyll liquid filter to output a date ordinal such as "st", "nd", "rd", or "th".

## Installation

To use this with your [Jekyll](http://jekyllrb.com/) site, copy `ordinal.rb` to your `_plugins` folder.

__NOTE:__ Because [GitHub Pages](http://pages.github.com/) disables the use of any Jekyll plugins with the `--safe` option if you want to deploy your Jekyll site to GitHub you’ll need to convert the site locally and push the generated static files to your GitHub repository instead of the Jekyll source files.

## Usage

To use the filter, simply pass a date string such as `page.date` or `post.date` and the filter will return the ordinal for that day.

```ruby

{{ page.date | ordinal }}

```

Note that only the ordinal will be returned. This is by design to make the formatting of the ordinal easier such as wrapping it in `` html tags.

````html

{{ page.date | ordinal }}

````

## Other Resources

- [Jekyll (and GitHub Pages) Liquid Date Formatting Examples](http://alanwsmith.com/jekyll-liquid-date-formatting-examples): An excellent resource showing numerious Jekyll and Liquid date formatting options with examples.

- [jekyll-humanize](https://github.com/23maverick23/jekyll-humanize): A port of the Django app `humanize` which adds a several liquid filters, including one for date ordinals.

## License

This plugin is hereby released into the public domain. To the extent possible, the author places no restrictions upon its use, modification, or redistribution.