Как собрать md файл без кода но с переменными?
Правильно поставленный вопрос содержит половину ответа. Прошу не посылать в гугл без конкретных запросов, ибо я уже туда так ходил. (автоматическая генерация догументации/markdown, переменные в markdown и прочее) А вот за конкретные запросы, а ещё лучше ссылки буду безмерно благодарен.
Предыстория.
Производим очистные сооружения. Состав блоков, их размер, наполненность оборудованием трубами и электрикой постоянно меняются. Иногда "на ходу". Нужно достаточно быстро выдавать схемы документацию и паспорта. Сейчас всё пишется руками. Усилиями одного-двух человек кто "в теме". Пока это *.doc файл паспорта + *.dwg схема. Нерационально.
Входные данные:
Список оборудования с неочевидной, на первый взгляд, нумерацией.
Список труб с названием, номером и диаметром.
На выходе нужно получить:
Распечатанную стопку бумаги с которой дядя Вася зайдет в модуль и быстро во всём разберется, а Антонина Михайловна подпишет всю документацию.
Специфика: Обычно никто из конечных пользователей не разбирается ни в чем, сложенне "микрософт офис".
Текущий этап.
перенос документации на гитхаб и уменьшение доли ручного труда.
Пока что всё в процессе сборки в *.md файл вот пример
| | 1. КОМПЛЕКТ ПОСТАВКИ | | | |
|:----|:-------------------------|:--------|:----|:-------|
| 1 | Составной блок емкостей: | | | СБ.1 |
| 5 | · приемный резервуар | секция | 1 | ПР.1.2 |
| 4 | · фильтр вторичный | секция | 1 | Ф.6.2 |
| 5 | · погружной насос | шт. | 2 | П.1.3 |
| 6 | Разделительная камера | шт. | 1 | РК.2.4 |
| 7 | Узел дозирования: | компл. | 1 | У.12.1 |
| 8 | - насос-дозатор | шт. | 1 | |
| 9 | - лопастная мешалка; | шт. | 1 | |
| 10 | - расходный бак 100 л. | шт. | 1 | |
| 34 | Мостки кровельные | шт. | 1 | |
| 35 | Лестница уличная | шт. | 1 | |
| 35 | сэндвич панели | шт. | 50 | |
псв20 (Ду65) - Коллектор напорный.
псв21 (Ду65) - Подача сточных вод на очистку
мос24 (Ду50) - Механически очищенные сточные воды.
оп27 (Ду50) - Отвод песка
4.2. ОПИСАНИЕ ТЕХНОЛОГИЧЕСКОГО ПРОЦЕССА
Далее вода поступает в приемный резервуар (**ПрмРр.1.2**), откуда погружными насосами
**пн.1.3** **пн.1.4** через трубы _псв21, псв22_ подается в разделительную камеру (**РзКм2**).
Пожалуйста, прошу не надо обсуждать трубы и фильтры! Они всё равно выдуманные.
Сейчас номера и обозначения даны "как-то". План: сделать "сквозную" нумерацию блоков и труб, примерно следующую той последовательности? в которой вода проходит очистку.
Проблема в том, что может быть несколько одинаковых модулей. Или несколько труб могут сходиться в одну, при этом из разных систем и даже сред. Например воздух подмешивается в воду.
Поэтому номера и обозначения всегда будут "скакать" и их всё равно придется править ручками.
Исходником всегда будет являться схема в dwg. Потому что дешево и универсально. Пока я не нашел быстрых, легких в "железе" и в освоении, бесплатных/дешевых инструменов для создания схем. А
dgw уже все давно научились юзать.
Если посмотреть на таблицу, то быстро обраружатся проблемы связанные с правками. Например нужно вставить в систему какой-то фильтр. И погружная камера становится не номером 2.4, а номером 3.4, и пошло поехало все перебиваться ручками. Радикальне изменения возникают не часто, а вот мелкие правки - часто. И было бы здорово сказать молодому студенту (или молодой маме): "вот образец, вот файлы, сделай красиво, на тебе денег", при необходимости повторить.
Условие: никаких API, никаких фреймворков, желательно без скриптов, если скрипты, то Python. Их попросту некому будет поддерживать или чинить. В идеале хотелось бы обойтись таблицами(csv, потому что в них гугл экспортирует), Toml и md.
пока что самое очевидное для меня решение файлик(и) томл с описанием оборудования и труб. и md со ссылками на toml. Редактируется и рефакторится всё в PyCharm. но как прикрутить переменные к md я не нашел.