Автоматизация создания документации

.github/workflows/os/oint_docs.os

@@ -7,6 +7,8 @@
 Перем СПодкаталогами;
 Перем КаталогДокументации;
 Перем СписокОбластей;
+Перем ТекущаяОбласть;
+Перем СчетчикОбласти;
 
 Процедура ПриСозданииОбъекта()  
 
@@ -14,6 +16,8 @@
 	СПодкаталогами      = Истина;
 	КаталогДокументации = ".\docs";
 	СписокОбластей      = Новый СписокЗначений();
+	ТекущаяОбласть      = "";
+	СчетчикОбласти      = 0;
 
 	ПроверитьСоздатьКаталог(КаталогДокументации);
     СоздатьФайлыДокументации();
@@ -43,10 +47,17 @@
 
 КонецПроцедуры
 
-Процедура СоздатьСтраницуДокументации(СтруктураМетода)
+Процедура СоздатьСтраницуДокументации(СтруктураМетода, Счетчик = 1)
+
+	Область = СтруктураМетода["Область"];
+
+	Если ТекущаяОбласть <> Область Тогда
+		ТекущаяОбласть = Область;
+		СчетчикОбласти = 1;
+	КонецЕсли;
 
 	ТранслитированноеИмя     = ТранслитироватьСтроку(СтруктураМетода["Заголовок"]);
-	СинонимОбласти           = Синонимайзер(СтруктураМетода["Область"]);
+	СинонимОбласти           = Синонимайзер(Область);
 	ТранслитированнаяОбласть = ТранслитироватьСтроку(СинонимОбласти);
 
 	КаталогБиблиотеки = КаталогДокументации + "\" + СтруктураМетода["Каталог"];
@@ -59,6 +70,7 @@
 
 	Макет = Макет.ПолучитьТекст();
 
+	Макет = СтрЗаменить(Макет, "@Счетчик"             , Строка(СчетчикОбласти));
 	Макет = СтрЗаменить(Макет, "@Заголовок"           , СтруктураМетода["Заголовок"]);
 	Макет = СтрЗаменить(Макет, "@Описание"            , СтруктураМетода["Описание"]);
 	Макет = СтрЗаменить(Макет, "@Объявление"          , СтруктураМетода["Объявление"]);
@@ -95,6 +107,8 @@
 	НовыйДокумент.УстановитьТекст(Макет);
 	НовыйДокумент.Записать(КаталогОбласти + "\" + ТранслитированноеИмя + ".md");
 
+	СчетчикОбласти = СчетчикОбласти + 1;
+	
 КонецПроцедуры
 
 #КонецОбласти
@@ -295,12 +309,13 @@
 			МассивЭлементовПараметра[Н] = СокрЛП(МассивЭлементовПараметра[Н]);
 		КонецЦикла;
 	
-		Если КоличествоЭлементов < 4 Тогда
-			Возврат;
-		КонецЕсли;
-	
         Имя1С     = МассивЭлементовПараметра[0];
-		Имя       = "--" + МассивЭлементовПараметра[3];
+
+		Если КоличествоЭлементов >= 4 Тогда
+			Имя  = "--" + МассивЭлементовПараметра[3];
+		Иначе 
+			Имя = "";
+		Конецесли;
 		Типы      = МассивЭлементовПараметра[1];
 		Описание  = ?(КоличествоЭлементов >= 5, МассивЭлементовПараметра[4], МассивЭлементовПараметра[2]);
         

.github/workflows/os/template.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 
+sidebar_position: @Счетчик
 ---
 
 # @Заголовок

OPI/src/CommonModules/OPI_Slack/Module.bsl

@@ -170,11 +170,11 @@
 // Изменяет состав существующего сообщения
 // 
 // Параметры:
-//  Токен        - Строка - Токен бота                  - token
-//  Канал        - Строка - Идентификатор канала        - channel
-//  Отметка      - Строка - Временная отметка сообщения - stamp
-//  Текст        - Строка - Новый текст сообщения       - text
-//  МассивБлоков - Массив Из Структура - Массив описаний блоков     - blocks - JSON массива описаний блоков
+//  Токен        - Строка - Токен бота                          - token
+//  Канал        - Строка - Идентификатор канала                - channel
+//  Отметка      - Строка - Временная отметка сообщения         - stamp
+//  Текст        - Строка - Новый текст сообщения               - text
+//  МассивБлоков - Массив Из Структура - Массив описаний блоков - blocks - JSON массива описаний блоков
 // 
 // Возвращаемое значение:
 //  Соответствие Из КлючИЗначение - сериализованный JSON ответа от Slack
@@ -635,8 +635,8 @@
 // Закрывает существующий диалог
 // 
 // Параметры:
-//  Токен  - Строка - Токен бота
-//  Диалог - Строка - ID диалога
+//  Токен  - Строка - Токен бота - token
+//  Диалог - Строка - ID диалога - conv
 // 
 // Возвращаемое значение:
 //  Соответствие Из КлючИЗначение - сериализованный JSON ответа от Slack
@@ -656,8 +656,8 @@
 // Формирует блок с картинкой для добавления в массив блоков сообщения
 // 
 // Параметры:
-//  URL                 - Строка - URL картинки
-//  АльтернативныйТекст - Строка - Альтернативный текст картинки
+//  URL                 - Строка - URL картинки                   - picture
+//  АльтернативныйТекст - Строка - Альтернативный текст картинки  - alt
 // 
 // Возвращаемое значение:
 //  Соответствие Из КлючИЗначение -  Блок картинки