В любом случае, есть ли шаблон Markdown?
У меня есть контент знаний, который мне нужно сохранить в репозитории GitHub. Содержимое составляет около 40 файлов (сейчас в 40 документах). Все они представляют собой одностраничный файл. Они имеют общую структуру:
Проблема
Немного аннотации
Параметры
какая-то реклама
Рекомендация
Немного аннотации
Если я запишу 40 файлов md (скопирую/вставлю структуру и заполню аннотации), я рискую позже столкнуться с проблемой структуры, требующей небольшого изменения - например, переименования «Рекомендации» в «Решение» или некоторых других деталей форматирования. Мне пришлось бы перебрать 40 файлов только для форматирования.
Должен быть лучший способ.
Например, есть ли способ определить шаблон файла md в одном месте, а затем создать 40 файлов md, которые содержат содержимое, но не обязательно в формате. Тогда есть что-то, что визуализирует эти файлы с использованием шаблона?
Спасибо за мысль, но иногда содержание будет большим. Кроме того, работа с таблицами уценок — это кошмар, если честно, с большим контентом (вы знаете, каналы и все такое). Таблица HTML — еще один вариант, но я пытаюсь использовать маршрутизатор, чтобы иметь мини-удобоваримые файлы md для каждой записи.
Возможно, я слишком много думаю и переусердствую. Чем больше я об этом думаю, тем больше понимаю, что то, о чем я прошу, вероятно, не стоит делать. Если со временем структура изменится, какое бы решение ни существовало, оно все равно придется изменить во многих местах. ИИ предложил мне иметь шаблон файла md с заполнителями и сценарий Python для чтения содержимого структуры из json, и этот сценарий генерирует файлы md. Я просто думаю, что это, вероятно, того не стоит, поскольку 40-страничный контент придется хранить в файлах json.
Кажется слишком сложным, да, жаль, что в Markdown нет шаблонов.
Ответы 1
Я рискую позже столкнуться с проблемой структуры, требующей небольшого изменения - например, переименования «Рекомендации» в «Решение» или некоторых других деталей форматирования. Мне пришлось бы перебрать 40 файлов только для форматирования.
Вам всегда нужно будет выбрать определенную структуру для ваших данных.
Идея шаблонизации состоит в том, чтобы отделить представление от данных. Любое шаблонное решение должно будет считывать свои данные из некоторого формата данных (например, JSON), и там вам также придется определить свои ключевые имена. Есть ли у вас:
- поле JSON
"recommendation":, - заголовок уценки
## Recommendationили - HTML-заголовок
<h2>Recommendation</h2>
Это не имеет значения. Во всех трех форматах вам необходимо выбрать имя поля (в данном случае рекомендуется) и определить структуру (даже если вы не применяете ее с помощью схемы или валидатора, структура все равно существует, чтобы данные были полезны). И во всех трёх случаях позже можно написать скрипт для автоматического изменения названия поля или заголовка.
Таким образом, я бы сказал, что вы действительно ничего не получите, выйдя за рамки уже имеющегося у вас файла уценки.
Можно ли вместо этого использовать сетку уценки или содержимое будет слишком большим для ячеек?