О бедной XWiki замолвите слово — 2

В первой части статьи я рассказывал о том как сделать стандартный интерфейс более комфортным, однако с тех пор утекло достаточно воды, что бы вышли как новые версии xWiki-движка, так и поменялся интерфейс в сторону улучшения юзабилити. По этому в новой статье я предлагаю обсудить тюнинг и более тонкую настройку xWiki для портативного клиента (на базе связки Jetty и HSQLDB). Оговорюсь сразу, я не считаю это лучшей реализацией из возможных, но учитывая удобство развертывания портативной версии (скопировал в нужную папку и запустил), считаю что для индивидуальной работы или работы небольшого коллектива в спартанских условиях — это лучший вариант.

Добро пожаловать под Cut Экспозиция Сперва несколько замечаний:

1. Для того что бы xWiki запустилась необходимо что бы на ПК используемого в качестве хоста была установлена Java 2. Портативная версия, о настройке которой пойдет речь, запускается как на ПК под управлением Windows, так и Linux, однако в паре моментов, о которых будет оговорено отдельно, тюнинг будет отличаться. 3. На взгляд автора, исходя из его эмпирического опыта, для комфортной работы отдельно выделенному хосту желательно иметь отдельно выделенный двух-ядерный процессор семейства Intel/AMD и оперативной памяти не менее 3-4Гб, или аналогично настроенную виртуальную машину). В случае если хост это ПК/ноутбук для офисной работы, то рекомендую оперативную память проапгрейдить минимум до 4Гб, а так же поставить процессор i3 (или его аналог) или выше. 4. Для корректного внесения изменения в файлы конфигураций wiki-движка использовать Notepad++ или аналогичный. 5. После каждого изменения рекомендую делать промежуточный бэкап версий, на всякий случай. 6. Программа настраивалась под себя, для удобства структурирования результатов работы инженером ПТО/сметчиком.

Завязка Скачать последнюю, на момент написания статьи, версию XWiki можно по следующей ссылке: enterprise.xwiki.org/xwiki/bin/view/Main/Download

Варианты установки поддерживают: Windows, Debian, веб-контейнер (веб-сервер) — *.war, мультисистемный формат — *.jar и портативную версию вики на базе связки Jetty+HSQLDB, которая, ИМХО, наиболее удобна для настройки/эксплуатации Пользователем как в Windows, так и в Linux.

Для начала работ по настройке и тюнингу необходимо распаковать файлы из архива ZIP в корень диска (также рекомендуется переименовать папку до более короткого пути, например так: «D:\xwiki»).

Запуск осуществляется файлом start_xwiki.bat для Windows (start_xwiki.sh для Linux через терминал), в котором уже прописаны все необходимые настройки. Окно консоли при этом рекомендуется свернуть. Теперь нам необходимо открыть окно web-браузера (окно консоли при этом закрывать категорически не рекомендуется), и ввести указанный URL из консоли (терминала), вида: http://localhost:8080/xwiki/bin/view/Main/

Теперь можно работать

Логин и пароль администратора по умолчанию: Login: Admin Password: admin

Для хранения данных портативная версия основанная на Jetti использует базу HSQLDB со всеми ее плюсами и минусами, в частности стоит программное ограничение на вложения превышающие 32Мб (которое можно увеличить при желании, но не с этой БД). Возможно в конкретно Вашем случае этого будет более чем достаточно, но если забить HSQLDB мелкими файлами (фото 1..30Мб) до более чем 4Гб, то система начинает работать медленнее, а в какой-то момент попросту отказывается принимать новые вложения. Для того что бы разделить текст и вложения, а так же лучше всего подойдет следующий метод, а именно: xWiki поддерживает хранение файлов в папках на жестком диске.

Первым делом мы меняем расположение хранение вложенных файлов с БД на файловую систему, для этого необходимо внести изменения в xwiki.cfg (..\webapps\xwiki\WEB-INF\) (Последовательность символов #-# и # в файлах конфигурации означает комментарий)

Первая переменная здесь означает что вложения будут писаться на жесткий диск. Вторая означает, что версии вложений так же будут хранится на жестком диске, третья означает что корзина с удаленными файлами так же будет хранится на жестком диске. Минус данного решения состоит в нагрузке на путь к файлам, которые ложатся на файловую систему

Так же в документации на сайте следует замечание, что руками в этой структуре файлов ковыряться не надо, иначе произойдет рассогласование между данными и ссылками, а так же можно получить ошибку.

There is a bug in XWiki, that prevents restoring attachments from the recycle bin via UI: you will find empty LiveTable. Attachment delete action brings new version to the document, so, the correct way to restore the attachment is to rollback to the necessary version. If you delete the document with the attachment and then click delete again to permanently expunge the document from history, the attachment will be removed from your system together One of the options to avoid mess with attachments in the filesystem until this bug would be fixed, just turn off recycle bin for attachments at all.

примерный перевод Существует ошибка в XWiki, которая мешает восстановить удаленные вложения из корзины через пользовательский интерфейс: вы найдете пустой LiveTable. Действие по удалению вложения сбивает счетчик версии документа, поэтому, правильный путь, чтобы восстановить вложение — это откат до нужной версии. Если удалить документ с приложением, а затем нажмите кнопку еще раз, чтобы удалить навсегда удалялись документ из истории, вложенный файл будет удален из системы вместе. Один из вариантов, чтобы избежать путаницы с вложениями в файловой системе, пока эта ошибка не будет исправлена, просто отключить корзины для всех удаленных вложений

Для того что бы действие вступило в силу — перезапустить XWiki

Теперь изменяем ограничение в 32Мб на размер вложений, т.к. оно более не актуально, для этого необходимо: 1. Перейти по адресу: http://«yourwiki»/xwiki/bin/edit/XWiki/XWikiPreferences?editor=object 2. Раскрыть список «XWikiPreferences 0» 3. Проскроллировать вниз до пункта «Maximum Upload Size» и изменить его на любое другое значение (в байтах. ) 4. Проскроллировать вниз до кнопки «Save»

Для того что бы действие вступило в силу — принудительно обновить страницу.

Общий перечень расширений доступен следующей ссылке: extensions.xwiki.org/xwiki/bin/view/Main Установка всех расширений осуществляется из админки. Всего есть 2 способа установит расширение: 1. Зайти в «Administer Wiki» -> «Extension Manager» -> «Add Extensions». Далее вводится в строку для поиска название или часть названия/функционала на латинице и нажимается «Enter», в выведенных результатах, база расширений как и сами расширения находится на сайте XWiki, кликаем «Install», «Continue» 2. Загружаем с сайта файл(ы) с расширением *.xar, заходим в «Administer Wiki» -> «Content» -> «Import», выбираем и загружаем файл, кликаем по нему в окне и следом соглашаемся импортировать.

By default, the export is made from the **current database** and from **all spaces**.

import com.xpn.xwiki.*; import com.xpn.xwiki.api.*; import com.xpn.xwiki.doc.*;

import java.io.File; import java.net.URL;

class ExportedAttachments

// Export attachments def void exportAttachments(XWikiContext context) >

println ""; println "(((Export done.)))"; println "**" + ExportedAttachments.attachmentsNo + "** attachments exported."; >

// Export attachments for the given document def void exportDocAttachments(XWikiDocument doc, File dir, XWikiContext context) 0) > > >

// Handle request if(request.confirm && request.dirpath) Галерея для вложений - Lightbox Macro

Самый что ни наесть менеджер задач. Плюсы в том что бесплатен и, относительно, гибок, минусы упираются в ограничения длины пути для вложенных файлов, из-за чего рекомендуется, если запускать под Windows, имена файлам вложений давать покороче, как и сами названия задач и Project'ов. Так же рекомендуется избегать символа «кавычки», т.к. при редактировании редактор все норовит обрезать имя задачи на конец фразы после первой «кавычки».

Внешнее отображение колонок можно менять, на взгляд автора там несколько больше ненужной для личного пользования информации, а вот важный пункт — "% выполнения" в стандартном отображении отсутствует. Таким образом заходим на страницу Task Manager'а, выбираем Правку страницы обычным редактором, не WYSIWYG и копируем следующий текст: