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