forked from bia-tech/autodocgen
-
Notifications
You must be signed in to change notification settings - Fork 8
/
ШаблонГенераторДокументации.os-template
123 lines (91 loc) · 5.92 KB
/
ШаблонГенераторДокументации.os-template
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
///////////////////////////////////////////////////////////////////
//
// Служебный класс генерации документации в формате <имя формата>
//
///////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////
//
// Служебный класс генерации документации в формате <Формат>
//
///////////////////////////////////////////////////////////////////////////////
Перем КаталогПубликацииДокументации;
Перем АнализироватьТолькоПотомковПодсистемы Экспорт;
///////////////////////////////////////////////////////////////////
// СТАНДАРТНЫЙ ИНТЕРФЕЙС
///////////////////////////////////////////////////////////////////
#Область ГенерацияДанных
// ДокументацияПоМодулю
//
// Параметры:
// ДанныеМодуля - Структура - Описание модуля, структура содержащая массив описаний методов, см. ГенераторДокументации.ОписаниеМетода
// Ошибки - Массив - Коллекция ошибок генерации документации, сюда помещаем информацию о возникших ошибках
//
// Возвращаемое значение:
// Строка - Текст документации по модулю, если пустая строка, публикация не выполняется
//
Функция ДокументацияПоМодулю(ДанныеМодуля, Ошибки) Экспорт
ВызватьИсключение "Не реализованно";
// Возврат ТекстДокументации;
КонецФункции
// ДокументацияКонстанты
//
// Параметры:
// МассивКонстант - Массив - Массив структур описаний констант
// Имя - Имя константы
// Тип - Тип значения константы
// Описание - Описание константы
// Подсистема - Описание подсистем, которой принадлежит константа. см ГенераторДокументации.ПолучитьСтруктуруПодсистем
// Ошибки - Массив - Коллекция ошибок генерации документации, сюда помещаем информацию о возникших ошибках
//
// Возвращаемое значение:
// Строка - Текст документации по модулю, если пустая строка, публикация не выполняется
//
Функция ДокументацияКонстанты(МассивКонстант, Ошибки) Экспорт
ВызватьИсключение "Не реализованно";
// Возврат ТекстДокументации;
КонецФункции
#КонецОбласти
#Область Публикация
// ОпубликоватьРаздел
//
// Параметры:
// Раздел - СтрокаТаблицыЗначений - Описание публикуемого раздела
// * Имя - Имя страницы/раздела
// * Родитель - Родитель страницы, ссылку на строку этой же таблицы
// * Содержимое - Содержимое страницы
// * Идентификатор - Служебное поле, можно использовать при публикации
// ОбъектыРаздела - СтрокаТаблицыЗначений - Массив описаний объектов раздела
// * Имя - Имя объекта
// * Родитель - Родитель страницы, ссылку на строку этой же таблицы
// * Содержимое - Содержимое страницы
// * Идентификатор - Служебное поле, можно использовать при публикации
// ОшибкиПубликации - Массив - Коллекция ошибок публикации документации, сюда помещаем информацию о возникших ошибках
//
// Возвращаемое значение:
// Булево - Признак успешности
//
Функция ОпубликоватьРаздел(Раздел, ОбъектыРаздела, ОшибкиПубликации) Экспорт
ВызватьИсключение "Не реализованно";
// Возврат Успешно;
КонецФункции
Функция ПрефиксИмени(ТипСтраницы) Экспорт
Если ТипСтраницы = "Модуль" Тогда
Возврат "Программный интерфейс: ";
Иначе
Возврат "";
КонецЕсли;
КонецФункции
#КонецОбласти
#Область Настройки
// Производит чтение настроек из конфигурационного файла и сохраняет их в свойствах объекта
//
// Параметры:
// НастройкиСтенда - Объект.НастройкиСтенда - Объект, содержащий информацию конфигурационного файла
//
// Возвращаемое значение:
// Строка - описание возникших ошибок
Функция ПрочитатьНастройки(НастройкиСтенда) Экспорт
ВызватьИсключение "Не реализованно";
// Возврат ТекстОшибки;
КонецФункции
#КонецОбласти