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

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

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

Сводка

Подробности

Свойства страницы
Название
... ... @@ -1,1 +1,1 @@
1 -Создание разделов по шаблону
1 +Оглавление
Содержимое
... ... @@ -1,212 +1,263 @@
1 -{{velocity}}
2 -=== Прикрепите вложения и используйте кнопки для навигации ===
3 -#set($spaceRef = $doc.documentReference.lastSpaceReference.name)
4 -#set($pageName = $doc.documentReference.name)
5 -#set($docFullName = "${spaceRef}.${pageName}")
6 -#set($attachments = $doc.getAttachmentList())
7 -#set($itemsPerPage = 1)
8 -#set($totalPages = ($attachments.size() + $itemsPerPage - 1) / $itemsPerPage)
9 -#set($currentPage = 1)
10 -#if("$!request.page" != "")
11 - #set($currentPage = $mathtool.toInteger($request.page))
12 -#end
13 -#set($startIndex = ($currentPage - 1) * $itemsPerPage)
14 -#set($endIndex = $startIndex + $itemsPerPage - 1)
15 -#if($endIndex >= $attachments.size())
16 - #set($endIndex = $attachments.size() - 1)
17 -#end
1 +|(% rowspan="3" %)[[image:Инструкция пользователя Xwiki_134b59443222e23b.png||height="29" width="180"]]|(% colspan="2" %)**Инструкция**
2 +|(% colspan="2" %)**X-Wiki: Инструкция пользователя**
3 +|**Автор**|//**Семенихин А.А.**//
18 18  
19 -{{html}}
20 -<div class="navigation-controls">
21 - #if($attachments && !$attachments.isEmpty())
22 - <!-- Выпадающий список для выбора вложения -->
23 - <div class="attachment-selector">
24 - <label for="attachment-select">Выберите вложение:</label>
25 - <select id="attachment-select">
26 - #foreach($attachment in $attachments)
27 - <option value="$attachment.filename" #if($velocityCount == $currentPage)selected#end>
28 - $attachment.filename
29 - </option>
30 - #end
31 - </select>
32 - </div>
33 - <!-- Пагинация -->
34 - <div class="pagination-controls">
35 - #if($currentPage > 1)
36 - #set($prevPage = $currentPage - 1)
37 - <a href="$doc.getURL('view', "page=${prevPage}")" class="btn btn-primary">Назад</a>
38 - #else
39 - <span class="btn btn-disabled">Назад</span>
40 - #end
41 -
42 - <span class="page-info">Страница $currentPage из $totalPages</span>
43 -
44 - #if($currentPage < $totalPages)
45 - #set($nextPage = $currentPage + 1)
46 - <a href="$doc.getURL('view', "page=${nextPage}")" class="btn btn-primary">Далее</a>
47 - #else
48 - <span class="btn btn-disabled">Далее</span>
49 - #end
50 - </div>
51 - #else
52 - <div class="no-attachments-message">
53 - Нет прикрепленных вложений. Пожалуйста, добавьте файлы для просмотра.
54 - </div>
55 - #end
56 -</div>
57 -{{/html}}
58 58  
59 -#if($attachments && !$attachments.isEmpty())
60 - #foreach($i in [$startIndex..$endIndex])
61 - #set($attachment = $attachments.get($i))
62 - #set($filename = $attachment.filename)
63 - #set($fileurl = $doc.getAttachmentURL($filename, "download"))
64 - #set($fileExtension = $filename.substring($filename.lastIndexOf('.') + 1).toLowerCase())
65 -
66 - === Документ: $filename ===
67 -
68 - {{html}}
69 - <div class="document-viewer-container" id="document-viewer">
70 - #if($fileExtension == 'pdf')
71 - <!-- PDF Viewer -->
72 - <iframe
73 - id="document-frame"
74 - src="/resources/pdfjs/web/viewer.html?file=${escapetool.url($fileurl)}"
75 - width="1200px"
76 - height="600px">
77 - </iframe>
78 - #elseif($fileExtension == 'doc' || $fileExtension == 'docx' || $fileExtension == 'ppt' || $fileExtension == 'pptx' || $fileExtension == 'xls' || $fileExtension == 'xlsx')
79 - <!-- Office Viewer -->
80 - #set($officeViewerUrl = "${doc.getURL('view')}?xpage=office&attachment=${escapetool.url($filename)}")
81 - <iframe
82 - id="document-frame"
83 - src="$officeViewerUrl"
84 - width="1200px"
85 - height="600px">
86 - </iframe>
87 - #else
88 - <div class="unsupported-format">
89 - Формат файла (${fileExtension}) не поддерживается для просмотра.
90 - <a href="${fileurl}">Скачать файл</a>
91 - </div>
92 - #end
93 - </div>
94 - {{/html}}
95 - #end
96 -#else
97 97  
98 - {{html}}
99 - <div class="no-attachments-message">
100 - Нет доступных вложений для отображения.
101 - </div>
102 - {{/html}}
103 -
104 -#end
105 105  
106 -{{html}}
107 -<style>
108 - .navigation-controls {
109 - display: flex;
110 - flex-direction: column;
111 - gap: 15px;
112 - margin-bottom: 20px;
113 - }
114 - .attachment-selector {
115 - display: flex;
116 - align-items: center;
117 - gap: 10px;
118 - }
119 - .attachment-selector select {
120 - padding: 8px;
121 - border-radius: 4px;
122 - min-width: 300px;
123 - }
124 - .document-viewer-container {
125 - margin: 20px 0;
126 - border: 1px solid #eee;
127 - padding: 10px;
128 - background: #f9f9f9;
129 - }
130 - .pagination-controls {
131 - margin: 20px 0;
132 - display: flex;
133 - justify-content: center;
134 - align-items: center;
135 - gap: 20px;
136 - }
137 - .btn {
138 - padding: 8px 16px;
139 - border-radius: 4px;
140 - text-decoration: none;
141 - }
142 - .btn-primary {
143 - background-color: #3366cc;
144 - color: white;
145 - }
146 - .btn-disabled {
147 - background-color: #eee;
148 - color: #999;
149 - cursor: not-allowed;
150 - }
151 - .page-info {
152 - font-weight: bold;
153 - }
154 - .unsupported-format {
155 - padding: 20px;
156 - text-align: center;
157 - color: #666;
158 - }
159 - .no-attachments-message {
160 - padding: 20px;
161 - text-align: center;
162 - color: #666;
163 - font-style: italic;
164 - border: 1px dashed #ccc;
165 - background-color: #f5f5f5;
166 - }
167 -</style>
168 -<script>
169 -//<![CDATA[
170 -document.addEventListener('DOMContentLoaded', function() {
171 - const select = document.getElementById('attachment-select');
172 - const viewerContainer = document.getElementById('document-viewer');
173 -
174 - if (select && viewerContainer) {
175 - select.addEventListener('change', function() {
176 - const filename = this.value;
177 - const fileExtension = filename.split('.').pop().toLowerCase();
178 - const fileurl = "${doc.getURL('download')}" + "/" + encodeURIComponent(filename);
179 - const pdfViewerUrl = "/resources/pdfjs/web/viewer.html?file=" + encodeURIComponent(fileurl);
180 - const baseUrl = "${doc.getURL('view')}";
181 -
182 - let viewerHtml = '';
183 -
184 - if (fileExtension === 'pdf') {
185 - viewerHtml = '<iframe id="document-frame" ' +
186 - 'src="' + pdfViewerUrl + '" ' +
187 - 'width="100%" height="600px"></iframe>';
188 - } else if (['doc', 'docx', 'ppt', 'pptx', 'xls', 'xlsx'].indexOf(fileExtension) >= 0) {
189 - viewerHtml = '<iframe id="document-frame" ' +
190 - 'src="' + baseUrl + '?xpage=office&attachment=' + encodeURIComponent(filename) + '" ' +
191 - 'width="100%" height="600px"></iframe>';
192 - } else {
193 - viewerHtml = '<div class="unsupported-format">' +
194 - 'Формат файла (' + fileExtension + ') не поддерживается для просмотра. ' +
195 - '<a href="' + fileurl + '">Скачать файл</a></div>';
196 - }
197 -
198 - viewerContainer.innerHTML = viewerHtml;
199 -
200 - // Обновляем заголовок документа
201 - const titleElement = viewerContainer.previousElementSibling;
202 - if (titleElement && titleElement.tagName === 'H3') {
203 - titleElement.textContent = 'Документ: ' + filename;
204 - }
205 - });
206 - }
207 -});
208 -//]]>
209 -</script>
210 -{{/html}}
211 211  
212 -{{/velocity}}
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 —