Возможно, уже кто-то заморачивался автоматической подготовкой документации из исходников 1С.
Т.е., допустим, у меня есть модуль, в нем есть экспортные функции/процедуры (API т.е.), и я написал к ним описания согласно стандарту.
Нет ли уже готового инструмента для формирования текстового файлика (a la синтакс-помощник) с описанием API из таких сырцов?
Автоматическое формирование документации из исходников
Он на такое отвечал, что забросили эту идею, т. к. нет целевой аудитории. Не понятно для кого будут генерироваться эти доки и зачем. Я теперь тоже согласен с этим мнением
У меня работает несколько лет, но публиковать не вижу смысла. Все слишком индивидуально.
Если кратко: самописный парсер + либа конфлюенс + Женька + гитлаб
Могу завтра скрин скинуть, если интересно.
А почему не опубликовать! Мне вот тоже надо автодокументатор для АПИ!
На партнерке выкладывали обработку, которая генерит описание БСП для ИТС
Хм. На мой взгляд всё довольно просто. Есть вроде бы стандартный механизм 1С, который тебе при обращении к функции/процедуре с адекватным описанием даст соответствующую подсказку в пофигураторе. Но он подразумевает, что ты знаешь о её существовании. Наличие же актуального описания API продукта в общей базе знаний (Confluence, wiki, etc) дает возможность найти нужную функцию/процедуру разработчику без изобретения своего лисапеда.
Дайдайдай)
Если не жалко. Ибо назрело))
Кажется обработка с партнёрки вот Генерация описания программного интерфейса Но может я перепутал, и это что-то с инфостарта.
Если не открывается или наоборот, даёт доступ ко всему моему дропбоксу маякните.
Круто ж!! А движок какой - wiki?
Очень похоже на Confluense
Да, хелп в confluence, для отображения 1с кода используется соответствующий плагин.
Поэтому я и говорил, что постить смысла нет - слишком много звезд долно сойтись для того, чтобы все получилось красиво.
Да и пусть некрасиво. Хотя бы идею почерпнуть.