Перейти к содержимому

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

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

Сводка

Подробности

Свойства страницы
Название
... ... @@ -1,1 +1,1 @@
1 -Создание разделов по шаблону
1 +Оглавление
Содержимое
... ... @@ -1,90 +1,263 @@
1 -{{velocity}}
1 +|(% rowspan="3" %)[[image:Инструкция пользователя Xwiki_134b59443222e23b.png||height="29" width="180"]]|(% colspan="2" %)**Инструкция**
2 +|(% colspan="2" %)**X-Wiki: Инструкция пользователя**
3 +|**Автор**|//**Семенихин А.А.**//
2 2  
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}}
28 28  
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
66 66  
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}}
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 —