Пересборка документации

.github/workflows/os/docs_main.os

@@ -19,7 +19,7 @@
 Перем СчетчикБиблиотеки;
 Перем СоответствиеЗаголовков;
 Перем СоответствиеТестов;
-Перем ПутьКСоответствиюТестов;
+Перем ТекущийЯзык;
 Перем ТекущаяБиблиотека;
 
 Процедура ПриСозданииОбъекта()  
@@ -28,8 +28,14 @@
 	Языки.Добавить("ru");
 	Языки.Добавить("en");
 
+	ЧтениеJSON = Новый ЧтениеJSON();
+	ЧтениеJSON.ОткрытьФайл("./service/dictionaries/en.json");
+	Словарь = ПрочитатьJSON(ЧтениеJSON, Истина);
+	ЧтениеJSON.Закрыть();
+
 	Для Каждого Язык Из Языки Цикл
 
+		ТекущийЯзык         = Язык;
 		Расположение        = "./src/" + Язык + "/OInt";
 		СПодкаталогами      = Истина;
 		КаталогДокументации = "./docs/" + Язык + "/md";
@@ -38,7 +44,6 @@
 		КаталогПримеров     = "./docs/" + Язык + "/examples/";
 		КаталогЗначений     = "./docs/" + Язык + "/data/";
 		КаталогCLI          = "./docs/" + Язык + "/cli/";
-		ПутьКСловарю        = "./service/dictionaries/en.json";
 		СписокОбластей      = Новый СписокЗначений();
 		ТекущаяОбласть      = "";
 		СчетчикОбласти      = 0;
@@ -53,11 +58,6 @@
 
 	КонецЦикла;
 
-	ЧтениеJSON = Новый ЧтениеJSON();
-	ЧтениеJSON.ОткрытьФайл(ПутьКСловарю);
-	Словарь = ПрочитатьJSON(ЧтениеJSON, Истина);
-	ЧтениеJSON.Закрыть();
-
 	//ПеревестиДокументацию();
 
 КонецПроцедуры
@@ -145,7 +145,7 @@
 	Запись.Закрыть();
 	
 	Макет = Новый ТекстовыйДокумент();
-	Макет.Прочитать("./.github/workflows/os/template.md", "UTF-8");
+	Макет.Прочитать("./service/templates/doc_" + ТекущийЯзык + ".md", "UTF-8");
 
 	Макет = Макет.ПолучитьТекст();
 
@@ -352,7 +352,6 @@
 	СтруктураДанных.Вставить("Параметры" , МассивОписанийПараметров);
 
 	СоздатьСтраницуДокументации(СтруктураДанных);
-	СоответствиеТестов.Вставить(ТекущаяБиблиотека + "_" + ИмяМетода, Ложь);
 
 КонецПроцедуры
 
@@ -412,17 +411,20 @@
             ОписаниеМетода = СокрЛП(ОписаниеМетода) + " " + СокрЛП(СтрокаКомментария);
         КонецЕсли;
 
-        Если СтрНайти(СтрокаКомментария, "Параметры:") > 0 Тогда
+        Если СтрНайти(СтрокаКомментария, "Параметры:") > 0
+			Или СтрНайти(СтрокаКомментария, "Parameters:") > 0 Тогда
             ЗаписыватьПараметры  = Истина;
             ЗаписыватьОписание   = Ложь;
 			ЗаписыватьПримечание = Ложь;
 
-		ИначеЕсли СтрНайти(СтрокаКомментария, "Примечание:") > 0 Тогда
+		ИначеЕсли СтрНайти(СтрокаКомментария, "Примечание:") > 0
+			Или СтрНайти(СтрокаКомментария, "Note") > 0 Тогда
 			ЗаписыватьПараметры  = Ложь;
 			ЗаписыватьОписание   = Ложь;
 			ЗаписыватьПримечание = Истина;
 
-        ИначеЕсли СтрНайти(СтрокаКомментария, "Возвращаемое значение:") > 0 Тогда
+        ИначеЕсли СтрНайти(СтрокаКомментария, "Возвращаемое значение:") > 0
+			Или СтрНайти(СтрокаКомментария, "Returns:") > 0 Тогда
 			СтруктураДанных.Вставить("ВозвращаемоеЗначение", МассивКомментария[Счетчик]);
             Прервать;
 
@@ -570,18 +572,6 @@
 
 	Результат = СокрП(Результат);
 
-	Если ЗначениеЗаполнено(Результат) Тогда
-
-		Результат = "```bsl title=""Пример кода""" 
-			+ Символы.ПС
-			+ Результат 
-			+ Символы.ПС
-			+ "```"
-			+ Символы.ПС;
-
-	КонецЕсли;
-
-
 	Возврат Результат;
 
 КонецФункции
@@ -636,7 +626,7 @@
 
 Функция ТранслитироватьСтроку(Знач Значение)
 
-	Значение     = нРег(Значение);
+	Значение = нРег(Значение);
 
 	Для Каждого ЗаменяемыйСимвол Из Транслитация Цикл
 		Значение = СтрЗаменить(Значение, ЗаменяемыйСимвол.Ключ, ЗаменяемыйСимвол.Значение);
@@ -651,13 +641,18 @@
 
 	ПереведенноеИмя = Словарь[Значение];
 
-	Если Не ЗначениеЗаполнено(ПереведенноеИмя) Тогда
-		ПереведенноеИмя = ТранслитироватьСтроку(Значение);
-		ПереведенноеИмя = СтрЗаменить(ПереведенноеИмя, "(", "");
-		ПереведенноеИмя = СтрЗаменить(ПереведенноеИмя, ")", "");
-		ПереведенноеИмя = СтрЗаменить(ПереведенноеИмя, "-", " ");
+	Если Не ЗначениеЗаполнено(ПереведенноеИмя)  Тогда
+		Если ТекущийЯзык = "ru" Тогда
+			ПереведенноеИмя = ТранслитироватьСтроку(Значение);
+		Иначе 
+			ПереведенноеИмя = Значение;
+		КонецЕсли;
 	КонецЕсли;
 
+	ПереведенноеИмя = СтрЗаменить(ПереведенноеИмя, "(", "");
+	ПереведенноеИмя = СтрЗаменить(ПереведенноеИмя, ")", "");
+	ПереведенноеИмя = СтрЗаменить(ПереведенноеИмя, "-", " ");
+
 	Возврат ПереведенноеИмя;
 
 КонецФункции
@@ -726,16 +721,6 @@
 
 	Результат = СокрЛП(Результат);
 	
-	Если ЗначениеЗаполнено(Результат) Тогда
-
-		Результат = "```json title=""Результат"""
-			+ Символы.ПС
-			+ Результат
-			+ Символы.ПС
-			+ "```";
-		
-	КонецЕсли;
-
 	Возврат Результат;
 
 КонецФункции
@@ -896,7 +881,7 @@
 				ТекстДокумента = СтрЗаменить(ТекстДокумента, Слово.Ключ, Слово.Значение);
 			КонецЦикла;
 
-			ТекущийДокумент.УстановитьТекст(НовыйТекст);
+			ТекущийДокумент.УстановитьТекст(ТекстДокумента);
 			ТекущийДокумент.Записать(Файл.ПолноеИмя);
 
 		КонецЕсли;

.github/workflows/os/template.md

@@ -1,32 +0,0 @@
----
-sidebar_position: @Счетчик
----
-
-# @Заголовок
-@Описание
-
-
-
-`@Объявление`
-
-  | Параметр | CLI опция | Тип | Назначение |
-  |-|-|-|-|
-@ТаблицаПараметров
-  
-  Возвращаемое значение: @ВозвращаемоеЗначение
-
-<br/>
-
-@Примечание
-
-
-@Вызов1С	
-
-
-```sh title="Пример команды CLI"
-    
-@ВызовCLI
-
-```
-
-@Результат