Использование тегов в DocFX markmat frontmatter / YAML header - PullRequest
Новая
       59

Использование тегов в DocFX markmat frontmatter / YAML header

1 голос
/ 02 мая 2020

У меня есть сайт DocFX с несколькими страницами. Я хотел бы добавить теги вверху каждой страницы с помощью пользовательского шаблона, и я бы хотел, чтобы авторы могли добавлять теги во фронтматер YAML, например: 

---
title: My Page Title
tags: tag1;tag2;tag3
---

. иметь возможность обращаться к этим тегам как к какому-то массиву и обрабатывать их при генерации вывода HTML.

Я прочитал документы здесь , что говорит о том, что я могу добавить schema.json файл где-нибудь, и это автоматически обнаружит элементы в схеме. Что я не могу понять, так это как получить доступ к фронт-матерсу YAML в моем шаблоне при генерации вывода.

Если мне нужно написать собственный плагин. NET, чтобы сделать это, тогда это не проблема. , но я полагаю, что я должен каким-то образом получить доступ к этим свойствам в шаблоне.

Любое руководство будет очень с благодарностью получено!

1 Ответ

1 голос
/ 02 мая 2020

Мне удалось со временем разобраться.

В моем собственном шаблоне у меня есть файл conceptual.html.primary.tmpl, который обеспечивает доступ к frontmatter: 

<div id="tags">
  {{#tags}}{{tags}}{{/tags}}
</div>

Очевидно, теперь мне нужно обработать теги, но теперь я получаю HTML, как и ожидалось, из моих .md файлов: 

<div id="tags">
    tag1;tag2;tag3
</div>
...