Создание страницы категории в страницах github с таргетингом на jekyll

Question

Я пытаюсь сгенерировать страницы категорий для моего блога github pages с помощью jekyll. Когда я запускаю локально, используя jekyll serve, это работает, потому что он может использовать мой плагин.

Используя этот пример из документов не работает, потому что github не будет генерировать пользовательские плагины:

module Jekyll
  class CategoryPage < Page
    def initialize(site, base, dir, category)
      @site = site
      @base = base
      @dir = dir
      @name = 'index.html'

      self.process(@name)
      self.read_yaml(File.join(base, '_layouts'), 'category_index.html')
      self.data['category'] = category

      category_title_prefix = site.config['category_title_prefix'] || 'Category: '
      self.data['title'] = "#{category_title_prefix}#{category}"
    end
  end

  class CategoryPageGenerator < Generator
    safe true

    def generate(site)
      if site.layouts.key? 'category_index'
        dir = site.config['category_dir'] || 'categories'
        site.categories.each_key do |category|
          site.pages << CategoryPage.new(site, site.source, File.join(dir, category), category)
        end
      end
    end
  end
end

Однако, это сработало бы, если бы я мог генерировать свои собственные страницы, которых нет в каталоге _site. Затем я бы отмечал их как «обычные» страницы, даже если они генерируются системой.

Можно ли с помощью jekyll генерировать страницы категорий вне каталога _site?

Answer 1

A) Вы можете написать собственные сценарии (shell или Ruby или что-либо еще) для генерации файлов в любом месте, используя операции ввода-вывода файла . В приведенном выше примеревместо добавления новых страниц на сайт, вы можете записывать файлы с фронтальной информацией в каталог вашего проекта.Например (Ruby):

open('somepath/#{category}/index.html', 'w') { |f|
  f << "---\n"
  f << "key: #{variable}\n"
  f << "---\n"
}

И, конечно, вам нужно запустить его локально, прежде чем отправить проект в GitHub.

---

B) Или вы можете визуализировать свой сайт Jekyll локально и отправить только содержимое _site в GitHub.Затем вы можете использовать любой плагин , который вам нужен.Вам нужно создать файл .nojekyll в корневом каталоге проекта, чтобы обойти обработку Jekyll на GitHub, и добавить его также во включения Jekyll (в _config.yml):

include: - .nojekyll

Затем вы можете отобразить сайт (jekyll build) и отправить содержимое каталога _site в GitHub.Вы можете автоматизировать этот шаг с помощью небольшого сценария оболочки.