Почему удаление передней части yaml мешает Jekyll конвертировать md-файл в html? - PullRequest
Новая
       12

Почему удаление передней части yaml мешает Jekyll конвертировать md-файл в html?

0 голосов
/ 13 декабря 2018

Я унаследовал процесс, который преобразует контент уценки в html, используя jekyll.

Если я удаляю фронт yaml между ---, по запросу клиента, чтобы упростить процесс для редакторов, 

---
product: Product Name
capability: testing
infotype: Overview
audience:

---

# Testing file 2

This is another testing file.

Сборка jekyll не конвертирует файл.

# Testing file 2

This is another testing file.

Когда у меня есть начальная тема в файле тестирования 2, я вижу следующее в журнале при запуске build --verbose

Rendering: user-administration/testing-file-2.md
Pre-Render Hooks: user-administration/testing-file-2.md
Rendering Markup: user-administration/testing-file-2.md
Rendering Layout: user-administration/testing-file-2.md

, но без основной информации нет сообщенияв журнале, относящемся к testing-file-2.md

Этот testing-file-2.md является частью набора других файлов, имеющих метаданные.Они выводятся на html-сайт, но не при проверке метаданных, а на testing-file-2.md.

Есть ли у jekyll способ создавать и отображать файлы без всяких предварительных действий?

Ответы [ 2 ]

0 голосов
/ 18 декабря 2018

Джекилл не игнорирует файлы.Скорее, для каждого файла он решает, является ли файл:

  • статическим файлом, который можно скопировать как есть в выходную папку (_site) или
  • файл, который должен быть обработан первым.

Файлы уценки (.md) обрабатываются kramdown и Liquid , если они запускаютсяс frontmatter YAML: 

---
---

в противном случае они обрабатываются как статические файлы и копируются в _site без обработки.

Существует обходной путь, который может работать для вас, используя include_relative;но это может вызвать больше проблем для редакторов вашего клиента, чем оно того стоит, в зависимости от того, как они работают.

Вы можете включить статический файл в файл для обработки.Ваш статический файл может быть plain-text.md: 

# Static text file

This is a file with no YAML frontmatter.

Затем, отдельно, вы создаете файл уценки с frontmatter, который будет включать в себя текстовый файл внутри него.Скажем, processed-text.md: 

---
---
{% include_relative plaintext.md %}

Тогда ваш обычный текст будет обработан и появится на вашем сайте как /processed-text.Думайте о файле processed-text.md как о некоем шаблоне для хранения plain-text.md.

. Вы захотите увидеть документы на include_relative, особенно тот факт, что файл длябыть включенным не может быть выше включаемого файла в файловой системе.

0 голосов
/ 13 декабря 2018

Я прочитал , что требуется иметь как минимум пустое имя, иначе jekyll проигнорирует файл 

---
---
...