Одной из самых нетривильных задач в процессе руссификации блога, построенного с помощью Octopress, является изменение формата даты с английского AUG 1ST, 2011 на более привычный русский, например ПЯТНИЦА, 13 ИЮЛЯ 2012 (о Боже, сегодня же пятница 13-ое!). Задача эта нетривиальна, но вполне себе решаема. Далее описан адаптированный для русского языка способ, который я подглядел у моего коллеги по Octopress из Германии Марка, который, естесственно, описывает его для локализации дат на немецкий язык.

Вводная информация

Для успеха операции нам придется руками залезть в файл date.rb, который после обновления Octopress будет заменен на новый. Поэтому предлагаю сохранить где-то информацию об изменениях, вносимых в этот файл, а затем в случае обновления Octopress руками поправить date.rb еще раз.

Шаг 1

Нам необходимо убедиться, что файл _config.yml содержит верную настройку в строке date_format:

date_format: "ordinal"

Шаг 2

Далее идем в ../octopress/plugins и находим там файл ruby.rb, который приводим к такому виду:

# encoding: utf-8
module Octopress
  module Date
    # Русская локализация:
    MONTHNAMES_RU = [nil,
      "Января", "Февраля", "Марта", "Апреля", "Мая", "Июня",
      "Июля", "Августа", "Сентября", "Октября", "Ноября", "Декабря" ]
    ABBR_MONTHNAMES_RU = [nil,
      "Янв", "Фев", "Мар", "Апр", "Май", "Июн",
      "Июл", "Авг", "Сен", "Окт", "Ноя", "Дек" ]
    DAYNAMES_RU = [
      "Воскресенье", "Понедельник", "Вторник", "Среда",
      "Четверг", "Пятница", "Суббота" ]
    ABBR_DAYNAMES_RU = [
      "Вс", "Пн", "Вт", "Ср",
      "Чт", "Пт", "Сб" ]

    # Returns a datetime if the input is a string
    def datetime(date)
      if date.class == String
        date = Time.parse(date)
      end
      date
    end

    # Returns an ordidinal date eg July 22 2007 -> July 22nd 2007
    # def ordinalize(date)
    # date = datetime(date)
    #  "#{date.strftime('%b')} #{ordinal(date.strftime('%e').to_i)}, #{date.strftime('%Y')}"
    #end

    # В _config.yml должно быть задано: date_format: ordinal 
    def ordinalize(date)
    # Задаем наш формат выдачи даты    
    format_date(date, "%A, %e %B %Y") # ПЯТНИЦА, 13 ИЮЛЯ 2012
    end

    # Returns an ordinal number. 13 -> 13th, 21 -> 21st etc.
    def ordinal(number)
      if (11..13).include?(number.to_i % 100)
        "#{number}<span>th</span>"
      else
        case number.to_i % 10
        when 1; "#{number}<span>st</span>"
        when 2; "#{number}<span>nd</span>"
        when 3; "#{number}<span>rd</span>"
        else    "#{number}<span>th</span>"
        end
      end
    end

    # Formats date either as ordinal or by given date format
    # Adds %o as ordinal representation of the day
    # def format_date(date, format)
    #  date = datetime(date)
    #  if format.nil? || format.empty? || format == "ordinal"
    #    date_formatted = ordinalize(date)
    #  else
    #    date_formatted = date.strftime(format)
    #    date_formatted.gsub!(/%o/, ordinal(date.strftime('%e').to_i))
    #  end
    #  date_formatted
    #end

    # Formats date either as ordinal or by given date format
    # Adds %o as ordinal representation of the day
    def format_date(date, format)
      date = datetime(date)
      if format.nil? || format.empty? || format == "ordinal"
        date_formatted = ordinalize(date)
      else
        format.gsub!(/%a/, ABBR_DAYNAMES_RU[date.wday])
        format.gsub!(/%A/, DAYNAMES_RU[date.wday])
        format.gsub!(/%b/, ABBR_MONTHNAMES_RU[date.mon])
        format.gsub!(/%B/, MONTHNAMES_RU[date.mon])
        date_formatted = date.strftime(format)
        # date_formatted = date.strftime(format)
        # date_formatted.gsub!(/%o/, ordinal(date.strftime('%e').to_i))
      end
      date_formatted
    end

  end
end


module Jekyll

  class Post
    include Octopress::Date

    # Convert this post into a Hash for use in Liquid templates.
    #
    # Returns <Hash>
    def to_liquid
      date_format = self.site.config['date_format']
      self.data.deep_merge({
        "title"             => self.data['title'] || self.slug.split('-').select {|w| w.capitalize! || w }.join(' '),
        "url"               => self.url,
        "date"              => self.date,
        # Monkey patch
        "date_formatted"    => format_date(self.date, date_format),
        "updated_formatted" => self.data.has_key?('updated') ? format_date(self.data['updated'], date_format) : nil,
        "id"                => self.id,
        "categories"        => self.categories,
        "next"              => self.next,
        "previous"          => self.previous,
        "tags"              => self.tags,
        "content"           => self.content })
    end
  end

  class Page
    include Octopress::Date

    # Initialize a new Page.
    #
    # site - The Site object.
    # base - The String path to the source.
    # dir  - The String path between the source and the file.
    # name - The String filename of the file.
    def initialize(site, base, dir, name)
      @site = site
      @base = base
      @dir  = dir
      @name = name

      self.process(name)
      self.read_yaml(File.join(base, dir), name)
      # Monkey patch
      date_format = self.site.config['date_format']
      self.data['date_formatted']    = format_date(self.data['date'], date_format) if self.data.has_key?('date')
      self.data['updated_formatted'] = format_date(self.data['updated'], date_format) if self.data.has_key?('updated')
    end
  end

  module Filters
    include Octopress::Date
    def date_ru(date, format)
      format_date(date, format)
    end
  end

end

Обратите особое внимание на первую строку # encoding: utf-8, без нее Octopress не сможет собрать Ваш блог (как я понял, в Ruby в случае наличия Unicode-символов, например, русских букв, необходимо явно указывать на кодировку файла).

Если кратко, мы добавили в этот файл массивы MONTHNAMES_RU, ABBR_MONTHNAMES_RU, DAYNAMES_RU и ABBR_DAYNAMES_RU с русскими именами дней недели и месяцев, изменили методы ordinalize, format_date в модуле Octopress, а также добавили модуль Filters в модуль Jekyll.

Также настоятельно рекомендую сохранить где-нибудь в отдельной директории исходный файл date.rb на случай, если Вы что-то поломаете. Отдельная директория нужна потому, что при сборке сайта Octopress проходит по всем Ruby-файлам в папке ../octopress/plugins и измененные нами методы могут конфликтовать с исходными методами.

Шаг 3

Внесем изменения в ../octopress/source/_includes/archive_post.html и приведем его к такому виду:

{% capture category %}{{ post.categories | size }}{% endcapture %}
<h1><a href="{{ root_url }}{{ post.url }}">{{post.title}}</a></h1>
<time datetime="{{ post.date | datetime | date_to_xmlschema }}" pubdate>{{ post.date | date_ru: "<span class='day'>%d</span> <span class='month'>%b</span> <span class='year'>%Y</span>"}}</time>
{% if category != '0' %}
<footer>
  <span class="categories">Опубликовано в {{ post.categories | category_links }}</span>
</footer>
{% endif %}

После внесения этих изменений даты в Вашем блоге должны принять вид ПЯТНИЦА, 13 ИЮЛЯ 2012.