Генератор статических блогов с несколькими каталогами изображений

Хьюго может это сделать. cd в пустую папку по вашему выбору, затем создайте каркас:

hugo new site .

После этого вы можете поместить свое содержание в content, например:

content
  post
    alpha
      index.md
      1.jpg
      2.jpg
    bravo
      index.md
      1.jpg
      2.jpg

Сайт сборки:

hugo

Результат создается в папке public:

public
  post
    alpha
      index.html
      1.jpg
      2.jpg
    bravo
      index.html
      1.jpg
      2.jpg

Jekyll явно не применяет правила о том, где размещать ваши ресурсы, например изображения, за исключением того, что Jekyll не будет копировать файлы непосредственно в папку, начинающуюся с символа подчеркивания. Хотя обычно все изображения помещаются в каталог \assets\, вы можете поместить его в любое другое место, кроме каталога _posts\, что вам и нужно.

Это поведение по умолчанию, но есть способы обойти это:

1. Размещайте свои сообщения вне _posts каталога

Поместите все свои сообщения за пределы папки по умолчанию _posts вместе с изображениями (это скопирует все файлы без какого-либо внешнего вида YAML и предварительно обработает все файлы с помощью внешнего интерфейса YAML). Однако любая другая функция, которую вы можете выполнять с сообщениями автоматически в Jekyll, больше не будет работать. Это может быть проблемой, а может и не быть.

2. Плагины

   • Вот плагин (ссылка на вопрос SO), написанный специально для заставить Jekyll копировать файлы в почтовый каталог. Если вы все же используете это, вы определенно можете просто написать следующий Markdown, и он будет ссылаться на сообщение, как и должно. :

     • ![Image title](my_image_filename.png)

   • Плагин пути к активу Jekyll - еще один надежный плагин, который делает нечто подобное, но не храните ваши изображения в одном каталоге, однако он все же связывает изображения относительно заголовка вашего сообщения.

   • Jekyll asset pipeline - еще один плагин, который обрабатывает CSS и JS, что может быть вам хотите иметь вместе с плагином 1.

Однако обратите внимание, что использование сторонних плагинов не поддерживается при создании сайта GitHub Pages, то есть вам придется сгенерировать их в другой ветке или локально, а затем отправить статические HTML-файлы в мастер. Это может быть проблемой для вас, если вы планируете размещать на GitHub Pages, иначе на вашем собственном экземпляре сервера вам хорошо.

Я также хочу, чтобы мои сообщения были «самодостаточными», а текстовое содержимое и изображения находились в одной папке. Я использую Джекилла.

Я сделал это возможным с помощью запроса на слияние в замечательном плагине jekyll-picture.

Затем я могу использовать простой синтаксис {% picture my-image.png %}, чтобы показать изображение в моем сообщении, которое находится в той же папке.

Вот пример: https://github.com/nhoizey/nicolas-hoizey.com/tree/master/_posts/2015/06/19-mon-jeu-esviji-integre-a-framagames

Спустя год после моего предыдущего ответа я разработал плагин Jekyll, который помогает хранить ресурсы сообщений вместе с файлом Markdown, он может удовлетворить ваши потребности: https://nhoizey.github.io/jekyll_post_files/