Документирование 1С через комментарии
Разработка - Инструментарий разработчика
Файлы
ВНИМАНИЕ: Файлы из Базы знаний - это исходный код разработки. Это примеры решения задач, шаблоны, заготовки, "строительные материалы" для учетной системы. Файлы ориентированы на специалистов 1С, которые могут разобраться в коде и оптимизировать программу для запуска в базе данных. Гарантии работоспособности нет. Возврата нет. Технической поддержки нет.
Подписка PRO — скачивайте любые файлы со скидкой до 85% из Базы знаний
Оформите подписку на компанию для решения рабочих задач
Оформить подписку и скачать решение со скидкойВы можете заказать платную доработку или адаптацию этой разработки под вашу конфигурацию на «Бирже заказов».
- 0% комиссии — оплата напрямую исполнителю;
- Исполнители любого масштаба — от отдельных специалистов до команд под проект;
- Прямой обмен контактами между заказчиком и исполнителем;
- Безопасная сделка — при необходимости;
- Рейтинги, кейсы и прозрачная система откликов.
Можно. Для этого потребуется:
- Установить ант
- Настроить ант
- Запустить ант
- Написать комментарии в коде
1. Что же такое ант?
Apache Ant (англ.ant — муравей и акроним — «Another Neat Tool») — утилита для автоматизации процесса сборки программного продукта. Является платформонезависимым аналогом утилиты make (в качестве «Makefile» применяется «build.xml»).
(с) Википедия
Скачать эту замечательную утилиту можно по адресу: http://ant.apache.org/bindownload.cgi.
К данной замечательной утилите потребуется два плагина. Первый это плагин http://ant-doxygen.blogspot.ru/, а второй - это плагин к анту, написаный мной и прекрепленный к данной статье.
Второй плагин ни делает ничего, кроме выгрузки модулей 1С и преобразования их в код на подобии java.
2. Как настроить ант?
К этой статье приложен файл: "build.xml", в нем надо заменить пути к файлам и значения, на ваши. Скачать и подправить файл настройки doxigen (так же приложен к данной статье).
3. Как запустить ант?
Запустить cmd.exe или PowerShell и перейти в каталог с файлом build.xml и запустить ant all.
4. Комментарии
Комментарии нужно оформить в стиле javadoc или doxigen, но есть маленькая специфика. Что бы ваша документация ложилаь по простанствам имен(пакетам) я добавил от себя следующие правила:
Если модуль начинается с комментария:
// $subsystem=[имя]
// [Какое-то описание]
// $
То это этот модуль попадет в [имя].ОбщийМодуль.ИмяОбщегоМодуля.
Если же такого комментария не будет, то он попадет в ОбщийМодуль.ИмяОбщегоМодуля.
5. Итог
Вуаля документация у вас готова.
P.S. Прошу прощенья, если описание не внятно. Но описание я пишу почти через год после написания программы. Может чего и забыл.
Вступайте в нашу телеграмм-группу Инфостарт