Pelican plug-in for adding Persian dates (from Jalali calendar) into articles
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Pelican Persian date plugin

This is a Pelican (Static Site Generator) plugin.

This plugin converts article.locale_date attribute from Gregorian calendar into Solar Hijri calendar (AKA Jalali calendar, Persian calendar, Iranian calendar) which is the official calendar of Iran and Afghanistan.


  • Output HTML result with Pelican's notmyidea theme

Persian date screenshot

Persian date screenshot


  1. Get the plugin in any way which is convenient for you. for example:
    • Clone the repository into plugins directory
    git clone
    • Or add the repository as a submodule in plugins directory
    git submodule add -b master plugins/pelican_persian_date
  2. Activate the plugin in your setting file (more information on using pelican plugins + +)
# Plugins
PLUGIN_PATHS = ['path/to/plugins']
PLUGINS = ["pelican_persian_date"]
  1. Define date format in (more information on format codes)
    'fa': '%A %d %B %Y'

Requirement & testing environment

I'm using this plugin on Windows with Python v3.4.3 & Pelican v3.6.0 installed. Perhaps it will work on other platforms & versions.