О бедной XWiki замолвите слово
Однажды… когда в очередной раз, выполняя рутинную работу, Ты будешь, теряя время, вспоминать: в каком из вариантов проекта и по какой причине были внесены изменения в расчеты, оформление или текст… о Пользователь — знай, что для тебя настало время борьбы со Страстями за Структурирование! Структурирование, или стратегия организации разрозненной информации, упирается в возможности и способности конкретного человека, продуктивность которого всецело зависит от тех инструментов которыми он пользуется для этих целей, будь то блокнот или АСУ.
На сегодняшний день существует огромное количество таких инструментов прямо и косвенных решающих эту задачу, с разной степенью эффективности, но на мой взгляд будущее за продуктами интегрирующие в себя не только инструменты ввода, сортировки, представления и оформления данных, но так же содержащие инструменты аналитики, программирования и поиска. XWiki, как представителю такого направления и будет посвящена сея статья, которая будет включать в себя обзор, установку и настройку Вики-движка, которая будет интересная как новичкам, так и продвинутым пользователям.
Добро пожаловать под Cut (осторожно — трафик, картинки)
Экспозиция
О Вики-движке XWiki в русскоязычном сегменте Интернета почти ничего нет, кроме общей информации и парочки руководств, что на мой взгляд категорически неверно, ибо это замечательный инструмент и помощник, со своими плюсами и минусами, конечно. XWiki — это Вики-движок второго поколения, который характеризуются возможностью структуризации информации и программного доступа к базе вики. Написан на языке Java, лицензия распространения LGPL, функциональность включает в себя блог, инструменты API, комментарии, аутентификацию по LDAP, экспорт страниц в PDF. Используется многими компаниями по всему миру. 25 языков интерфейса, включая русский. Так же более подробно желающие могут сравнить на wikimatrix с наиболее распространенными в Рунете Вики-движками: DokuWiki и MediaWiki.
Скачать последнюю, на момент написания статьи, версию XWiki 7.1.2 можно по следующей ссылке: http://enterprise.xwiki.org/xwiki/bin/view/Main/Download
Варианты установки поддерживают: Windows, Debian, веб-контейнер (веб-сервер) — *.war, мультисистемный формат — *.jar и портативную версию вики на базе связки Jetty+HSQLDB, которая, ИМХО, наиболее удобна для настройки/эксплуатации Пользователем как в Windows, так и в Linux. О ней и пойдет речь.
Для того чтобы установить Xwiki, необходимо чтобы в системе была установлена Java, а так же распаковать файлы из архива ZIP в корень диска (также рекомендуется переименовать папку до более короткого пути, например так: «D:\xwiki-7.1.2«). Запуск осуществляется файлом start_xwiki.bat, в котором уже прописаны все необходимые настройки.

Теперь нам необходимо открыть окно web-браузера (окно консоли при этом закрывать категорически не рекомендуется), и ввести указанный URL из консоли, в нашем случае это: panther.itme.info:8080/xwiki/bin/view/Main/
Здесь так же стоит добавить, что порт по умолчанию, с которого стартует XWiki — 8080, если по тем или иным причинам он у вас занят, то его можно изменить, отредактировав через Блокнот start_xwiki.bat.
После загрузки в браузере откроется следующее окно:

Из интересного здесь ссылка на гайд на английском — Documentation, но нас будет интересовать совершенно другое, а именно кликаем в правом верхнем углу на Log-in и вводим для входа в админку:
Login: Admin
Password: admin
Здесь стоит отметить, что в этом месте регистр имеет значение!

Здесь хочу остановиться на следующем:
1. Боковые панели приобрела дополнительный функционал, который настраивается Пользователем.
2. Функционал в XWiki позволяет на страницах редактировать не только текст, с помощью обычного или WYSIWYG редактора, выводя его в колонки с помощью редактирования Inline form, но и вставлять гаджеты на страницу. Под гаджетом в XWiki понимается выводимый в некоторой области Макрос, т.е. вызов одной или последовательности команд, в частности это может быть ссылка на другую страницу или даже ленту блога, облако тэгов, формы для отправки сообщений и т.д. и т.п.
Макросы в XWiki по сути являются основой данного движка, именно благодаря им Пользователь может настроить практически все, будь то: свое мини-приложение, внешний вид страниц и панелей или интеграция собственного расширения (плагина).
Здесь нужно немного отвлечься и рассказать об организационной структуре XWiki, а именно о жизненном цикле вики-страниц. Здесь есть одна тонкость, а именно: Пользователь может создавать Page и Space, и если с Page‘ами все более или менее понятно, то при создании Space создается Заголовок области, внутри которого будет создано автоматом Page с именем WebHome, но при этом выводится будет всюду Заголовок области, а адресация будет на WebHome, что может создать некоторые трудности при ссылке на страницу. При этом нет ограничений по уровню вложения, которые можно делать как к Space, так и к Page.
Для начала необходимо выбрать страницу для редактирования и войти в редактор.


Затем необходимо набрать либо в текстовом режиме сам макрос, вместе с параметрами, либо, воспользовавшись графическим интерфейсом выбрать необходимый макрос из списка.

и заполнить необходимые поля:

Но это все была лирика, давайте перейдем к практике и начнем мы с настройки интерфейса. Для этого необходимо кликнуть на левой панели на пиктограмму Panels и в открывшейся странице запустить Panel Wizard. Перед нами предстанет интерфейс настроек администратора, открытый во вкладке Panel Wizard. альтернативный и основной способ перейти к настройкам XWiki — это клик по стрелочке в верхнем выпадающем списке рядом с Home и выбор пункта Administer Wiki.

Вкладка на странице настроек панели Page Layout позволяет настроить расположение, число и ширину колонок нашей вики. Соседствующая рядом вкладка Panel List включает в себя приложения (макросы), которое может быть расположено на наших полях, при этом они включают в себя окошко предпросмотра, а так же управляющие элементы включения/исключения и редактирования содержимого и функций. Предпросмотр для соответствующих приложений, находящихся в виде кнопок и функционала на полях, выключен. Для того что бы настроить функционал приложения — необходимо кликнуть на Edit, что бы удалить макрос — кликнуть на Delete, что бы убрать/поместить на панель приложение/функционал — перетащить используя метод Drag and Drop.
Теперь мы сделаем правую панель навигационной, для этого убираем с правой панели Quick Links и My Recent Modifications и добавляем Tag Cloud, Navigation и Create Page, кликаем на Save the new Layout при этом заходим в правку Navigation и вставляем следующий код, который сделает наш серфинг более удобным:
Что нам это дает? Это дает отображение древовидную структуру для навигации между вложениями, Pages и Spaces, без вывода дополнительной отвлекающей информации. Теперь настало самое внести вдохнуть краски в наш новый сайт и уйти от плоского интерфейса. Для этого выбираем в меню LOOK & FEEL пункт Presentation. Здесь мы меняем Icon Theme на Silk и Color Theme на Garden.

Теперь пора подумать и о медиа инструментах, а именно — какой же блог без галереи и графики? К сожалению встроенной галереи XWiki не имеет, а потому придется потрудиться что бы установить и настроить дополнение (Extensions), для этого заходим в меню EXTENSION MANAGER пункт Add Extensions. Здесь можно из веб репозитория установить необходимые дополнения, в данном случае нас будет интересовать плагин Lightbox Macro, с помощью которого удобно организовывать слайд шоу, а так же объединять по группам картинки. Для установки вводим в строку поиска слово lightbox и в полученном результате поиска кликаем install.


Теперь переходим на главную страницу нашей XWiki и здесь в панели Navigation мы обнаружим 2 новых Space Lightbox и LightboxMacro. Значит наступило самое время применить макрос в дело, для этого создаем тестовый Space под именем Test page и во вкладке Attachments загружаем картинки для тестирования галереи, в нашем случае это будут фотографии со дня празднования 9го мая 2014 года снятые на ничем не примечательный китайфон на Андроиде Jiayu G3.
Текст кода интерпретируется следующим образом: в массив $myArray закладывается список вложений на странице, затем производится сортировка по имени (для тех случаев если загруженные файлы с камеры были загружены в разнобой, но в то же время хранят в имени файла дату и время съемки, или хотя бы нумерации очередности снимков). После чего для каждого вложения, если оно есть изображение, выводится миниатюра высотой 20% от оригинала. Здесь так же нужно сказать, что параметры макроса включают в себя следующие пункты:
The Advanced Open Source Enterprise Wiki
Learn about XWiki’s concept and why it’s an alternative to Confluence and MediaWiki
Features
- a very robust WYSIWYG editor
- a powerful wiki syntax
- strong rights management
Why use XWiki?
Developed for more than 10 years, XWiki is being used by many high profile companies as:
- Knowledge base
- Collaborative intranet
- Public website
- Business applications
… or other use cases .
XWiki Projects
XWiki offers a generic platform for developing projects and collaborative applications using the wiki paradigm.
- PlatformXWiki Platform is the generic wiki platform offering runtime services for applications built on top of it.
- FlavorsXWiki Standard is a fully-featured flavor on top of XWiki. It’s also a second generation wiki offering the ability to install and develop small applications inside wiki pages.
- ExtensionsXWiki Extensions allows you to customise your wiki by providing a vast collection of applications that can be installed on top of the default distribution.
- All projects All XWiki software is developed in Java and under the LGPL open source license . Top Level Projects are actively developed by the XWiki Development Team. In order to see all our projects please visit the forge .
All XWiki software is developed in Java and under the LGPL open source license . In order to see all our projects please visit the forge .
XWiki Extensions
Over 600 extensions : applications, macros, skins, plugins, themes, etc.
- Extension Manager
- AppWithin Minutes
- Dashboard
- Color Themes
- Blog
- more
XWiki is a light and powerful development platform that allows you to customize the wiki to your specific needs. Using structured data and in-page-scripting you can create macros and applications that allow you to extend the capabilities of your wiki.







Latest Blog Posts
XWiki 14.4.1 Released
The XWiki development team is proud to announce the availability of XWiki 14.4.1. This is a bugfix release that covers important issues that we have discovered since 14.4 has been released. .
XWiki 13.10.6 Released
The XWiki development team is proud to announce the availability of XWiki 13.10.6. This is a bugfix release that covers important issues that we have discovered since 13.10.5 has been released. .
XWiki 14.4 Released
This release brings extra usability in 2 areas: images can now be searched for inside the WYSIWYG editor (when adding an image), and macros available in extension repositories but not installed are also visible directly from the WYSIWYG editor’s Insert Macro feature (and can be installed in one click by admins). As usual, there are also bug & security fixes. .
XWiki 14.4 Release Candidate 1 Released
This release brings extra usability in 2 areas: images can now be searched for inside the WYSIWYG editor (when adding an image), and macros available in extension repositories but not installed are also visible directly from the WYSIWYG editor’s Insert Macro feature (and can be installed in one click by admins). As usual, there are also bug & security fixes. .
XWiki 14.3.1 Released
The XWiki development team is not overly proud to announce the availability of XWiki 14.3.1. This is a bugfix release that covers important issues that we have discovered since 14.3 has been released. .
XWiki 14.3 Released
This release introduces a new (experimental) image dialog for the WYSIWYG editor and a new administration section to define image styles, with the goal to simplify the insertion and editing of images. On the same topic, the image popover now provides an image permalink and the image lightbox added the ability to copy the image identifier to clipboard to be used as link anchor or to be referenced by wiki macros. Finally, the images (or any files) uploaded through the WYSIWYG editor are not saved right away anymore but, instead, they create temporary attachments that are saved only when the edited content is saved. All these image related improvements, along with a lot of bug fixes, make this release worth trying. .
XWiki 14.3 Release Candidate 1 Released
This release introduces a new (experimental) image dialog for the WYSIWYG editor and a new administration section to define image styles, with the goal to simplify the insertion and editing of images. On the same topic, the image popover now provides an image permalink and the image lightbox added the ability to copy the image identifier to clipboard to be used as link anchor or to be referenced by wiki macros. Finally, the images (or any files) uploaded through the WYSIWYG editor are not saved right away anymore but, instead, they create temporary attachments that are saved only when the edited content is saved. All these image related improvements, along with a lot of bug fixes, make this release worth trying. .
XWiki 13.10.5 Released
The XWiki development team is proud to announce the availability of XWiki 13.10.5. This is a bugfix release that covers important issues that we have discovered since 13.10.4 has been released. Further, it adds a small improvement to the link syntax. .
XWiki 14.2.1 Released
This is a bugfix release that covers very important issues that we have discovered right after 14.2 has been released. .
XWiki 13.10.4 Released
The XWiki development team is proud to announce the availability of XWiki 13.10.4. This is a bugfix release that covers important issues that we have discovered since 13.10.3 has been released. .
Аналоги XWiki
XWiki — это мощная платформа для совместной работы с открытым исходным кодом, позволяющая компаниям любого размера экономить время и деньги, расширяя возможности сотрудничества как на уровне команд разработчиков, так и на уровне организаций. Ориентируясь на эффективность обмена знаниями и более выгодное сотрудничество, XWiki выводит на новый уровень ценность бизнес-данных, предоставляя любому пользователю простой и быстрый доступ к важной информации, упрощая этим сложную систему работы крупных компаний.
Забитость архива электронной почты и потеря важных данных, при увольнении ключевых сотрудников, давно забыты организациями, использующими XWiki, поскольку жизненно важная информация теперь легко доступна, затраты на обучение и содержание сотрудников сокращаются, а выполнение регулярного резервного копирования исключает утрату важных данных.