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

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

Редактировал(а) Alexey Semenihin 24.06.2025
От версии 7.1
отредактировано Alexey Semenihin
на 23.04.2025
Изменить комментарий: Created by office importer.
К версии 3.1
отредактировано Alexey Semenihin
на 23.04.2025
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

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