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
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
|
Автор: Назаров А.А., 2012-2024, Оренбург
Сайт: https://htmlbuilder.onhalt.site
E-mail: programmist.nazarov@gmail.com
Пользовательские поля
Можно добавлять/удалять колонки для контента
на вкладке общие настройки. Будет создана
колонка с именем custom_name
Чтобы ее вывести в шаблоне нужно указать {custom_name}
Поддержка меню
{menu=ID_MENU} работает в глобальных блоках,
доступны для пункта меню
{itemUrl} - ссылка на страницу
{ext} - расширение
{itemTitle} - название пункта
В шаблоне самого меню используется код {items}
Вставить содержимое из удаленного источника
{remote_url="https://something.com/source.txt"}
- Поддержка шаблонов
- Страницы сохраняются под именем /{id}.htm
- В секции шаблона HEAD код {title} соответствует заголовку страницы
- В секции шаблона BODY доступны коды
{title} - заголовок страницы
{body} - html разметка контента
{dt} - дата материала
{tags} - теги материала
- Глобальные блоки разметки
{id глобального блока} замещается разметкой этого блока
в шаблонах,
в контенте страниц
- Шаблон списка категории
{sectionUrl} - часть адреса ссылки на категорию
{sectionTitle} - название раздела
{sectionNote} - аннотация рубрики
{sectionFullText} - полное описание рубрики
{items} - список элементов категории
{sort_order} - навигация по сортировке
{pager} - переключатель страниц в рубрике
- Шаблон элемента списка категории
{itemUrl} - часть адреса ссылки на страницу
{itemTitle} - название страницы
{itemDt} - дата материала
{itemTags} - теги материала
{fX},{vX}, где X от 1 до 7 - название и значение доп. поля
{custom_name} - значение пользов. колонки
{ext} - предпочитаемое расширение файлов
- Быстрые ссылки
Для того, чтобы проставить быстро ссылку на страницу с известным id,
достаточно в тексте записать [id]
Чтобы поставить ссылку в тексте на раздел по его id,
достаточно в разметке напечатать <<id>>
((image_id)) - вывод иллюстрации
||attachment_id|| - вывод прикрепленного документа
- Пользовательские поля
Материал каждой страницы можно дополнить 7 текстовыми полями
для включения в публикацию дополнительной информации
(ключевых слов, ссылок, изображений и т.п.)
Подпись к полю включается в шаблон с помощью кода {fX},
значение дополнительного поля с помощью кода {vX}, где
X - номер поля от 1 до 7. Отредактировать подписи полей
можно на вкладке Общие настройки.
- Поддержка модулей
Модуль - это консольная программа, которая расширяет возможности генератора.
Модули могут быть написаны на любом языке программирования,
позволяющем сохранять на диск обычные текстовые файлы.
Единственное требование: модуль с именем modulename
обязан создавать файл modulename.tmp.
Этот файл забирает генератор и удаляет временный файл.
Например, модуль youtube вставляет HTML разметку для
проигрывателя по ID ролика. Для вызова модуля необходимо
обрамить знаком % его имя и параметры вызова:
%youtube ID%
Модули также могут быть использованы для обработки HTML фрагментов,
для этого текст необходимо обрамить специальными тегами
~модуль~
HTML-фрагмент
~/модуль~
Фрагмент передается генератором во временный файл модуль.inp,
модуль должен предоставить генератору выходной файл модуль.out.
Входной и выходной файл будут удалены генератором автоматически.
Например, чтобы автоматически преобразовать разметку в формате markdown в HTML,
достаточно вызвать код
~markdown~
Разметка
~/markdown~
Путь к модулю должен быть указан в переменной PATH, либо модуль
должен быть установлен в каталог с HtmlBuilder
- Архиватор
Программа использует утилиту 7z архиватора 7-Zip.
Утилита 7z должна быть установлена в каталог C:\Program Files\7-Zip
Получить архиватор можно на сайте http://www.7-zip.org/
ПОРЯДОК ГЕНЕРАЦИИ СТРАНИЦ САЙТА
1. Страница оборачивается в шаблон
2. Заполняются глобальные блоки {block}
3. Проставляются ссылки на страницы [pageID]
4. Включаются ссылки на категории раздела <<sectionID>>
5. Выполняются обработчики %module%
6. Запускаются обработчики ~module~ .... ~/module~
По разделам
Страницы сортируются в выдаче по
- умолчанию (задается в общих настройках)
- по заголовку (возрастание, убывание)
- по дате (возрастание, убывание).
Для сортировок по умолчанию рубрика записывается в корень сайта
/section_SECTION_ID.html
Для других сортировок создаются навигационные папки вида
/o/FIELD-[ASC-DESC]/section_SECTION_ID.html
ПРИМЕР ИСПОЛЬЗОВАНИЯ
1. Создайте каталог C:\MySite
2. Добавьте 2-3 страницы
3. Нажмите кнопку "Создать сайт"
4. Нажмите кнопку "Архивировать".
Каталог с архивом откроется в новом окне проводника.
5. В браузере перейдите на страницу http://staticloud.com/
6. Перетащите на страницу архив site.zip
7. Сайт опубликован!
|