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

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

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

Сводка

Подробности

Свойства страницы
Название
... ... @@ -1,1 +1,1 @@
1 -Оглавление
1 +Создание разделов по шаблону
Содержимое
... ... @@ -1,263 +1,212 @@
1 -|(% rowspan="3" %)[[image:Инструкция пользователя Xwiki_134b59443222e23b.png||height="29" width="180"]]|(% colspan="2" %)**Инструкция**
2 -|(% colspan="2" %)**X-Wiki: Инструкция пользователя**
3 -|**Автор**|//**Семенихин А.А.**//
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
4 4  
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}}
5 5  
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
6 6  
98 + {{html}}
99 + <div class="no-attachments-message">
100 + Нет доступных вложений для отображения.
101 + </div>
102 + {{/html}}
103 +
104 +#end
7 7  
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}}
8 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 —
212 +{{/velocity}}