Изменения документа Создание разделов по шаблону

Редактировал(а) Alexey Semenihin 24.06.2025

От версии 7.2
отредактировано Alexey Semenihin
на 23.04.2025
Изменить комментарий: Changed document title to [Оглавление].
К версии 6.1
отредактировано Alexey Semenihin
на 23.04.2025
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

Свойства страницы
Название
... ... @@ -1,1 +1,1 @@
1 -Оглавление
1 +Создание разделов по шаблону
Содержимое
... ... @@ -1,263 +1,90 @@
1 -|(% rowspan="3" %)[[image:Инструкция пользователя Xwiki_134b59443222e23b.png||height="29" width="180"]]|(% colspan="2" %)**Инструкция**
2 -|(% colspan="2" %)**X-Wiki: Инструкция пользователя**
3 -|**Автор**|//**Семенихин А.А.**//
1 +{{velocity}}
4 4  
3 +## Подключаем необходимые JS/CSS для работы вкладок
4 +$xwiki.jsfx.use('uicomponents/widgets/tabView.js', {'forceSkinAction': true, 'language': 'xwiki/2.1'})
5 +$xwiki.ssfx.use('uicomponents/widgets/tabView.css', true)
6 +{{html}}
7 +<script>
8 +// Ждём загрузки DOM
9 +document.observe("dom:loaded", function() {
10 + // Находим ссылку на вкладку "Вложения" (по ID или тексту)
11 + var attachmentsTab = $('Attachmentslink');
12 +
13 + // Если вкладка найдена, имитируем клик
14 + if (attachmentsTab) {
15 + attachmentsTab.click();
16 + }
17 + // Альтернативный вариант (если не сработал ID):
18 + else {
19 + var tabs = $$('.tab-menu a').find(function(tab) {
20 + return tab.textContent.trim().includes('Вложения');
21 + });
22 + if (tabs && tabs.length > 0) tabs[0].click();
23 + }
24 +});
25 +</script>
26 +{{/html}}
27 +{{/velocity}}
5 5  
29 +{{velocity}}
30 +#set($attachments = $doc.getAttachmentList())
31 +#foreach($attachment in $attachments)
32 + #set($filename = $attachment.filename)
33 + #set($fileurl = $doc.getAttachmentURL($filename))
34 + #set($fileExt = $filename.substring($filename.lastIndexOf('.') + 1).toLowerCase())
35 +
36 + ## Определяем тип файла
37 + #set($isPdf = $fileExt == 'pdf')
38 + #set($isImage = $fileExt == 'png' || $fileExt == 'jpg' || $fileExt == 'jpeg' || $fileExt == 'gif' || $fileExt == 'bmp' || $fileExt == 'svg')
39 + #set($isOffice = $fileExt == 'doc' || $fileExt == 'docx' || $fileExt == 'xls' || $fileExt == 'xlsx' || $fileExt == 'ppt' || $fileExt == 'pptx' || $fileExt == 'odt' || $fileExt == 'ods' || $fileExt == 'odp')
40 +
41 + ## Обрабатываем только поддерживаемые форматы
42 + #if($isPdf || $isImage || $isOffice)
43 +
44 + ===Документ: ${attachment.filename}===
45 +
46 + #if($isPdf)
47 + {{html}}
48 + <div class="pdf-viewer-container">
49 + <iframe
50 + src="/resources/pdfjs/web/viewer.html?file=${fileurl}"
51 + width="100%"
52 + height="600px">
53 + </iframe>
54 + </div>
55 + {{/html}}
56 +
57 + #elseif($isImage)
58 + [[image:${attachment.filename}]]
59 +
60 + #elseif($isOffice)
61 + {{office attachment="${attachment.filename}" filterStyles="false"/}}
62 +
63 + #end
64 + #end
65 +#end
6 6  
7 -
8 -
9 -
10 -
11 -
12 -
13 -
14 -
15 -
16 -
17 -
18 -
19 -**X-Wiki: Инструкция пользователя**
20 -
21 -= Оглавление =
22 -
23 -[[1 Введение 3>>path:#_Toc196217831]]
24 -
25 -[[2 Шаблоны 4>>path:#_Toc196217832]]
26 -
27 -[[2.1 Шаблон «PDF/Office» 5>>path:#_Toc196217833]]
28 -
29 -[[2.2 Шаблон «PDF/Office with head» 6>>path:#_Toc196217834]]
30 -
31 -[[2.3 Шаблон «Просмотр вложений переключением» 7>>path:#_Toc196217835]]
32 -
33 -[[2.4 Шаблон Список вложенных страниц 8>>path:#_Toc196217836]]
34 -
35 -[[2.5 Шаблон Не отображать вложения 9>>path:#_Toc196217837]]
36 -
37 -[[2.6 Шаблон Создать новый тендер 10>>path:#_Toc196217838]]
38 -
39 -[[2.7 Шаблон Создать новый проект 11>>path:#_Toc196217839]]
40 -
41 -[[3 Редактирование страницы 12>>path:#_Toc196217840]]
42 -
43 -[[3.1 Добавление ссылок 13>>path:#_Toc196217841]]
44 -
45 -[[3.1.1 Ссылка на страницу Xwiki 13>>path:#_Toc196217842]]
46 -
47 -[[3.1.2 Ссылка на вложение 14>>path:#_Toc196217843]]
48 -
49 -[[3.1.3 Ссылка на внешние ресурсы, почту 16>>path:#_Toc196217844]]
50 -
51 -[[3.2 Форматирование текста 17>>path:#_Toc196217845]]
52 -
53 -1. (((
54 -= {{id name="_Toc414990670"/}}{{id name="_Toc412045053"/}}{{id name="_Toc196217831"/}}{{id name="_Toc154492115"/}}Введение =
55 -)))
56 -
57 -В документе представлено руководство пользователя для работы с шаблонами страниц в XWiki. Данная функциональность включает возможность создания, настройки и применения шаблонов документов, а также управления их структурой и содержимым.
58 -
59 -Шаблоны страниц позволяют:
60 -
61 -* Единообразно оформлять документы в рамках проекта или организации
62 -
63 -* Автоматизировать создание типовых страниц
64 -
65 -* Использовать предопределенные блоки и элементы оформления
66 -
67 -Доступ к шаблонам осуществляется через меню «Создать», при создании пользователем новой страницы. Шаблоны могут быть привязаны к конкретным пространствам имен или доступны глобально для всей системы, в зависимости от настроек.
68 -
69 -
70 -[[image:Инструкция пользователя Xwiki_af21663ad02b392f.png||height="291" width="643"]]
71 -
72 -1. (((
73 -= {{id name="_Toc196217832"/}}Шаблоны =
74 -)))
75 -
76 -Выбор шаблона происходит в специальном окне, во время создания страницы.
77 -
78 -[[image:Инструкция пользователя Xwiki_71ad7b74b40527d7.png||height="329" width="643"]]
79 -
80 -Для выбора доступны 14 шаблонов, наибольший интерес представляют следующие:
81 -
82 -1. PDF/Office
83 -1. PDF/Office with head
84 -1. Просмотр вложений переключением
85 -1. Список вложенных страниц
86 -1. Не отображать вложения
87 -1. Создать новый тендер
88 -1. Создать новый проект
89 -
90 -Шаблоны 1-5 создают пустую страницу, к которой в последующем можно прикрепить вложения, для полноценной работы шаблона.
91 -
92 -Шаблоны 6-7 создают структуру страниц. (Шаблон 6 доступен только из раздела «Пресейл», а шаблон 7 из раздела «Проекты»).
93 -
94 -1.
95 -11. (((
96 -== {{id name="_Toc196217833"/}}Шаблон «PDF/Office» ==
97 -)))
98 -
99 -{{id name="_Hlk196149430"/}}[[image:Инструкция пользователя Xwiki_79eca5e8b72f4458.png||height="154" width="308"]] Д[[image:Инструкция пользователя Xwiki_d7d00097a4f738a7.png||height="77" width="277"]] анный шаблон создает страницу, на которой будут отображены прикрепленные вложения. Изначально страница пустая. Для работы макроса необходимо прикрепить документ. Это можно сделать нажатием соответствующей кнопки и выбором файлов.
100 -
101 -[[image:Инструкция пользователя Xwiki_9ecfd8c55afdf69a.png||height="63" width="425"]] После того как файл загружен вы увидите следующее.
102 -
103 -[[image:Инструкция пользователя Xwiki_189931d242f28507.png||height="391" width="600"]] После загрузки всех файлов необходимо обновить страницу. Результатом выполнения макроса будет форматированная страница. Из документа Office будут вытащены изображения и текст, файлы формата PDF будут находиться в отдельном окне.
104 -
105 -
106 -
107 -1.
108 -11. (((
109 -== {{id name="_Toc196217834"/}}Шаблон «PDF/Office with head» ==
110 -)))
111 -
112 -Д[[image:Инструкция пользователя Xwiki_65cfc30b707d863c.png||height="102" width="274"]] анный шаблон создает страницу, на которой будут отображены прикрепленные вложения, а также ссылки на другие дочерние страницы. Изначально страница пустая. Для работы макроса необходимо прикрепить документ или создать внутри данной страницы дочернюю страницы. Это можно сделать нажатием соответствующей кнопки и выбором файлов (Прикрепление файлов и их отображение соответствует шаблону из п.2.1) или созданием страницы аналогично п.2., выбор формата не повлияет на работу текущего шаблона. Ключевым отличием от п.2.1. является отображение ссылок на дочерние страницы.
113 -
114 -[[image:Инструкция пользователя Xwiki_5a05b57df3ffb613.png||height="157" width="313"]]
115 -
116 -[[image:Инструкция пользователя Xwiki_bd6388e984e6bf6b.png||height="253" width="643"]]
117 -
118 -1.
119 -11. (((
120 -== {{id name="_Toc196217835"/}}Шаблон «Просмотр вложений переключением» ==
121 -)))
122 -
123 -[[image:Инструкция пользователя Xwiki_6864e4ed32655c83.png||height="167" width="506"]] Д[[image:Инструкция пользователя Xwiki_1cf18ed9f0a91d0b.png||height="98" width="264"]] анный шаблон позволяет просматривать вложения в виде — 1 файл на страницу, с возможностью переключения между ними. Шаблон также, как и предыдущие, создает пустую страницу, к которой необходимо прикрепить документы для работы макроса.
124 -
125 -П[[image:Инструкция пользователя Xwiki_1ee5742420f03e73.png||height="318" width="486"]]
126 -осле того как документы будут во вложениях, страница примет следующий вид:
127 -
128 -М[[image:Инструкция пользователя Xwiki_f8f341ed0117429f.png||height="73" width="285"]]
129 -[[image:Инструкция пользователя Xwiki_37d9296dcb49c628.png||height="70" width="273"]]
130 -ежду файлами можно переключаться нажатием кнопок «Назад»/«Вперед» или выбором файла из выпадающего списка.
131 -
132 -1.
133 -11. (((
134 -== {{id name="_Toc196217836"/}}Шаблон Список вложенных страниц ==
135 -)))
136 -
137 -Д[[image:Инструкция пользователя Xwiki_3014929c2f8f6541.png||height="66" width="278"]] [[image:Инструкция пользователя Xwiki_e4e5929271d23f66.png||height="243" width="643"]]
138 -анный шаблон автоматически создает на странице ссылки на дочерние элементы. При его использовании создается пустая страница. Для отображения ссылок достаточно создать дочернюю страницу любого формата, после чего обновить страницу.
139 -
140 -
141 -1.
142 -11. (((
143 -== {{id name="_Toc196217837"/}}Шаблон Не отображать вложениявложения без предпросмотра ==
144 -)))
145 -
146 -Д[[image:Инструкция пользователя Xwiki_f37965d0b4e0bee0.png||height="75" width="283"]] анный шаблон представляет собой пустую страницу без предпросмотра файлов на веб-странице, на которой не отображаются никакие файлы из вложенийфайлы отображаются только в разделе Вложения.
147 -
148 -[[image:Инструкция пользователя Xwiki_2ba3a1eb853e8971.png||height="278" width="643"]]
149 -
150 -1.
151 -11. (((
152 -== {{id name="_Toc196217838"/}}Шаблон Создать новый тендер ==
153 -)))
154 -
155 -Д[[image:Инструкция пользователя Xwiki_bfbd9a6f4dfff938.png||height="62" width="279"]] анный шаблон создает не только страницу нового тендера, но и всю вложенную структуру документа.
156 -
157 -[[image:Инструкция пользователя Xwiki_c4de55b01beb1b63.png||height="210" width="643"]]
158 -\\\\
159 -
160 -[[image:Инструкция пользователя Xwiki_bb5ea30a507b9983.png||height="484" width="266"]]
161 -
162 -1.
163 -11. (((
164 -== {{id name="_Toc196217839"/}}Шаблон Создать новый проект ==
165 -)))
166 -
167 -Д[[image:Инструкция пользователя Xwiki_1bd4becd3dd18e16.png||height="64" width="281"]] анный шаблон по аналогии с предыдущим создает структуру для нового проекта.
168 -
169 -[[image:Инструкция пользователя Xwiki_50e0c83e5f898901.png||height="201" width="643"]]
170 -
171 -[[image:Инструкция пользователя Xwiki_3c1bfb9a4bd8eba.png||height="295" width="243"]]
172 -
173 -1. (((
174 -= {{id name="_Toc196217840"/}}Редактирование страницы =
175 -)))
176 -
177 -В[[image:Инструкция пользователя Xwiki_c5c38095c954b54f.png||height="271" width="643"]]
178 -xwiki можно отредактировать любую страницу под свои потребности. Для этого необходимо нажать кнопку «Редактировать» на странице.
179 -
180 -О[[image:Инструкция пользователя Xwiki_a9f2ff64f022259a.png||height="143" width="643"]]
181 -ткроется такая страница, для активации интерфейса редактирования необходимо нажать мышью в выделенной области:
182 -
183 -О[[image:Инструкция пользователя Xwiki_52e63fbfd7d52043.png||height="134" width="643"]]
184 -тобразится поле, в котором можно писать текст, все изменения вносить строго после «макрос:velocity» с новой строки:
185 -
186 -
187 -1.
188 -11. (((
189 -== {{id name="_Toc196217841"/}}Добавление ссылок ==
190 -
191 -1. (((
192 -=== {{id name="_Toc196217842"/}}Ссылка на страницу Xwiki ===
193 -)))
194 -)))
195 -
196 -Иногда может потребоваться добавить ссылку на какую-нибудь страницу xwiki. Для этого необходимо проделать несколько шагов:
197 -
198 -* Скопировать ссылку на целевую страницу
199 -
200 -Д[[image:Инструкция пользователя Xwiki_3e2886444f6723f0.png||height="55" width="469"]]
201 -[[image:Инструкция пользователя Xwiki_f5c312b4191169ee.png||height="262" width="169"]]
202 -ля этого необходимо перейти на страницу, которая будет целевой и через кнопку «Информация» перейти на страницу, содержащую сведения о текущей. Внизу будет строка «Ссылка на страницу», ее нужно скопировать.
203 -
204 -* [[image:Инструкция пользователя Xwiki_3ad5d9cc4ac96bf7.png||height="131" width="471"]] На вкладке редактирование прописать текст, по нажатию которого будем переходить на страницу, выделить его, а после чего нажать на кнопку
205 -* [[image:Инструкция пользователя Xwiki_27968828a5e9f43c.png||height="177" width="285"]] Откроется окно, в поле «Страница» нужно вставить ссылку, которую мы копировали ранее, или же по нажатию кнопки найти эту страницу.
206 -
207 -1.
208 -11.
209 -111. (((
210 -=== {{id name="_Toc196217843"/}}Ссылка на вложение ===
211 -)))
212 -
213 -В[[image:Инструкция пользователя Xwiki_a5356626ec72bab1.png||height="35" width="496"]]
214 -тексте страницы можно встроить ссылки на вложение, для этого через меню редактирования перейти на вкладку «Источник»
215 -
216 -Н[[image:Инструкция пользователя Xwiki_c548b306631ae8f4.png||height="380" width="439"]]
217 -а вкладке будет виден полный код страницы
218 -
219 -Для добавления ссылки на вложение необходимо прописать следующее:
220 -
221 -~[~[attach~:имя_вложения.расширение]]
222 -
223 -Ниже представлен пример ссылки.
224 -
225 -[[image:Инструкция пользователя Xwiki_1ba63a8e33064957.png||height="461" width="442"]]
226 -\\
227 -
228 -[[image:Инструкция пользователя Xwiki_7c9e898399416f67.png||height="171" width="476"]] В результате на странице отобразится ссылка на просмотр вложения.
229 -
230 -1.
231 -11.
232 -111. (((
233 -=== {{id name="_Toc196217844"/}}Ссылка на внешние ресурсы, почту ===
234 -)))
235 -
236 -Перечисленный ниже код необходимо вставлять только в области редактирования «Источник».
237 -
238 -Для вставки ссылки на почту:
239 -
240 -[[image:Инструкция пользователя Xwiki_1e200f6cac057f55.png||height="21" width="357"]]
241 -
242 -[[image:Инструкция пользователя Xwiki_588288bb08962ea1.png||height="27" width="220"]]
243 -
244 -Д[[image:Инструкция пользователя Xwiki_53a833615780b76f.png||height="25" width="269"]]
245 -ля вставки ссылки на внешний источник:
246 -
247 -[[image:Инструкция пользователя Xwiki_cf5fec35745a04fd.png||height="27" width="445"]]
248 -\\\\
249 -
250 -1.
251 -11. (((
252 -== {{id name="_Toc196217845"/}}Форматирование текста ==
253 -)))
254 -
255 -Перечисленный ниже код необходимо вставлять только в области редактирования «Источник». [[image:Инструкция пользователя Xwiki_134085313c8d460d.png||height="385" width="643"]]
256 -
257 -[[image:Инструкция пользователя Xwiki_d24e06b9d9efda03.png||height="277" width="591"]]
258 -
259 -Еще больше информации о форматировании страницы можно найти по __[[ссылке>>url:https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/XWikiSyntax/]]__.
260 -
261 -|**Предупреждение о конфиденциальности:**|Данный документ содержит конфиденциальную информацию, которая не может быть раскрыта, распространена и (или) воспроизведена без предварительного письменного разрешения.
262 -
263 -— 1 —
67 +{{html}}
68 +<style>
69 + .pdf-viewer-container {
70 + margin: 20px 0;
71 + border: 1px solid #eee;
72 + padding: 10px;
73 + background: #f9f9f9;
74 + }
75 +
76 + /* Стили для изображений */
77 + .image-wrapper {
78 + max-width: 100%;
79 + margin: 10px 0;
80 + }
81 +
82 + /* Стили для офисных документов */
83 + .office-document {
84 + border: 1px solid #ddd;
85 + margin: 15px 0;
86 + min-height: 500px;
87 + }
88 +</style>
89 +{{/html}}
90 +{{/velocity}}