Совместим с «Докувики»

2009-02-14, Lemming, Anteater

Блоки (поля) с закругленными углами, которые делят страницу на заголовок, боковую колонку и область основного содержания.

Последнее обновление:

2011-01-02

The missing download url means that this extension cannot be installed via the Extension Manager. Please see Publishing a Plugin on dokuwiki.org. Recommended are public repository hosts like GitHub, GitLab or Bitbucket.

Это расширение не обновлялось более двух лет. Возможно, оно больше не разрабатывается или не поддерживается; возможны проблемы совместимости.

This extension is not in the 'plugin' or 'template' namespace and is therefore ignored.

Похож на sxs

Теги: cms, roundbox, sidebar, tagline, themes

- Don Bowman

• minima

(Автор оригинала: Christopher Arndt)

Первоначально создан Кристофером Арндтом (Christopher Arndt) и основан на дизайне его домашней страницы. Представляет собой поля, которые делят страницу на заголовок, боковую панель и область основного содержания. В большинстве браузеров (кроме Internet Explorer’а, вплоть до 8-й версии) у полей могут быть закруглённые углы.

Автор: Don Bowman (был ChristopherArndt)
Дата: 02-01-2011

Roundbox — это шаблон для DokuWiki, который первоначально был создан Кристофером Арндтом (Christopher Arndt) в соответствии с его домашней страницей, которая в свою очередь базируется на дизайне «Open Source Web Designs». Это чёткий табличный дизайн, основанный на полях, которые делят страницу на три основных раздела: заголовок, боковую панель и область основного содержания. Шаблон подходит для сайтов, предоставляющих только право чтения незарегистрированным пользователям, так как все кнопки могут переключаться в положение «Вкл./Выкл.» в зависимости от уровней прав доступа и групп участников. Кроме того, можно разрешить доступ только зарегистрированным пользователям.

Щёлкните по изображению слева, чтобы увидеть скриншот большего размера!

Последний релиз roundbox совместим с версией DokuWiki 2010-11-07 «Anteater» (в переводе «Муравьед»). Он включает изменения, обсужденные ниже, а также некоторые дополнительные обновления для более простого использования.

Не стесняйтесь отправлять свои наработки с этим шаблоном по электронной почте автору (Don Bowman) или написать комментарий на странице оригинала шаблона.

О новом можно узнать здесь!

1. Загрузите архив шаблона.
2. Распакуйте в <dokuwiki>/lib/tpl. Это создаст папку, названную roundbox.
3. Войдите в «Управление», а затем в «Настройки вики» для выбора шаблона.
4. Дополнительно: сконфигурируйте некоторые параметры шаблона (см. Конфигурация).
5. Дополнительно: выберите тему (см. Темы).

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

С версии от 26.01.2009 можно изменить тему, модифицируя файл style.ini. Некоторые предложенные темы находятся в папке themes. Чтобы использовать их, просто скопируйте и переименуйте одну из них с заменой существующего style.ini.

Этот шаблон использует следующие идеи и код:

• шаблон по умолчанию ориентирован на DokuWiki с версии 2010-11-07 «Anteater»;
• шаблон «Боковая панель»;
• шаблон «Лучшая навигация»;
• It also includes some CSS styles taken from different plugins which I use at my site. These all went into the file plugins.css. Не используется plugins.css в версии 26.01.2009. Это может быть восстановлено позже.

• http://www.phppatterns.com/
• http://www.asif.dreamhosters.com/
• http://coldstonelabs.org/
• http://www.spamer.me.uk/wiki/
• http://www.scoutlink.it/it/
• http://trolug.de/ Troisdorfer Linux User Group
• http://lynplex.org/
• http://lynsoft.co.uk/
• http://tollerporcorum.org.uk/
• http://www.paddlingabc.com

Не стесняйтесь добавить свой собственный сайт здесь, если вы используете этот шаблон!

Некоторые аспекты вида этого шаблона и его поведения могут быть сконфигурированы изменением значений параметров в файле <dokuwiki>/lib/tpl/roundbox/conf/default.php. Большинство из них могут быть изменены через «Настройки вики» в разделе «Параметры шаблонов». Доступны следующие настройки:

Определяет тему, которая будет использоваться.

• Тип: строковый
• Значения: <текущий список тем>
• По умолчанию: evening

Определяет, с какой стороны от основного блока страницы будет находиться боковая панель.

• Тип: строковый
• Значения: left|right
• По умолчанию: left

Влючает отображение навигации сайта в боковой панели. См. раздел «Боковая панель» для подробностей.

• Тип: логический
• По умолчанию: true

Использует ссылки вместо кнопок в поле команд боковой панели.

• Тип: логический
• По умолчанию: true

Вводит текст для подзаголовка вашей вики в поле ниже заголовка вики.

• Тип: строковый
• По умолчанию: <пустая строка>

Включает опцию закругления углов для основных полей страницы. Работает в большинстве браузеров (кроме Internet Explorer’а, вплоть до 8-й версии).

• Тип: логический
• По умолчанию: true

Заменяет маршрут посещений иерархической цепочкой навигации.

• Тип: логический
• По умолчанию: true

Устанавливает текст, который разделяет каждую ссылку в навигационной цепочке. Работает, только если параметр rb_youarehere имеет значение true.

• Тип: строковый
• По умолчанию: " → "

Определяет имя страницы по умолчанию (index page) пространства имен. Это имеет смысл, только если параметр rb_youarehere принимает значение true.

• Тип: строковый
• По умолчанию: "start"

Удаляет подчеркивание ссылок навигационной цепочки. Работает, только если параметр rb_youarehere имеет значение true.

• Тип: логический
• По умолчанию: true

Отображает кнопки редактирования на боковой панели.

• Тип: логический
• По умолчанию: false

«Это — частная вики». Когда параметр принимает значение true, к вики доступ могут получить только зарегистрированные пользователи. Если пользователь незарегистрирован, то единственной страницей, которую он увидит, это страница входа.

• Тип: логический
• По умолчанию: false

Показывает/скрывает главную боковую панель. Когда этот параметр установлен, боковая панель по умолчанию будет всегда видна. Если текущая страница находится в пространстве имен, у которого также есть файл боковой панели, её боковая панель будет располагаться ниже главной боковой панели. Если этот параметр не установлен, используется боковая панель, соответствующая показываемой странице.

• Тип: логический
• По умолчанию: false

Какие действия должны быть доступными в блоке команд боковой панели? Доступные действия:

Расположение действий в массиве определяет расположение кнопок (ссылок) в поле команд боковой панели (сверху вниз).

• Тип: массив
• По умолчанию: array( 'edit', 'revert', 'history', 'subscribe', 'backlink', '-', 'index', 'recent', '-', 'admin', '-', 'profile', 'login')

Следующие настройки определяют, какие действия (для доступа к которым и нужны кнопки/ссылки) доступны пользователям:

Для каждого из действий, упомянутых выше может быть ключ в обоих из ассоциативных множеств этих двух опций rb_act_min_access и rb_act_users.

Первый определяет, какой уровень доступа текущий пользователь должен иметьв минимуме, чтобы видеть эту кнопку. Последний позволяет определять список пользователей и/или групп, которые будут видеть эту кнопку, независимо от их уровня доступа. Названия группы должны быть снабжены префиксом '@'. Специальная группа '@ALL' относится к пользователям, которые входили в систему или нет.

Дополнительно следующие ключи в массивах будут проверены, чтобы определить отображение форм «Поиск» и «Перейти»:

Примечание. Эти опции только определяют отображение кнопок/связей для данных функций. Функции могут все еще быть вызваны введением подходящих параметров URL вручную! Вы предупреждены.

См. файл conf/default.php в каталоге шаблона для примера.

• Тип: массив
• По умолчанию: см. файл «conf/default.php»

Списки могут быть изменены только в «conf/default.php». Они недоступны через «Настройки вики».

Шаблон «Roundbox» использует строки (например, для заголовков полей и подсказок кнопок), которые вам желательно перевести на свой язык. Чтобы преобразовать их в свой язык, создайте каталог в виде двухбуквенного кода своего языка (ru для русского) в папке <dokuwiki>/lib/tpl/roundbox/lang/, скопируйте файл <dokuwiki>/lib/tpl/roundbox/lang/en/lang.php в этот каталог, и переведите необходимые строки в этом файле.

Языковые файлы для английского, финского, немецкого, французского и итальянского языков уже включены. Если имеются поправки для них или вы перевели их на свой язык, пожалуйста, отправьте файл lang.php автору для включения в дистрибутив шаблона.

Есть ещё один файл языка, settings.php, который используется для описания параметров через «Настройки вики». Только английские и финские версии этого файла имеются в настоящее время.

В шаблон «Roundbox» интегрирован код шаблона «Боковая панель» для обеспечения возможности навигации по сайту с помощью боковой панели. Содержание этой панели — обычная вики-страница. То, какая страница вики загружена в поле навигации сайта, зависит от текущего пространства имен. См. оригинал шаблона для пояснений.

Для быстрого начала работы достаточно создать страницу с именем sidebar (боковая панель) в пространстве имён по умолчанию. Независимо от того, что вы разместите на этой странице, оно будет показано в поле навигации сайта. Вы можете создать отдельные файлы для каждого пространства имён. Если параметр rb_main_sidebar будет включен, то и боковая панель по умолчанию и боковая панель пространства имён будут показаны.

Боковую панель можно показать слева или справа от основного поля страницы в зависимости от значения, выбранного для параметра rb_sidebar_orientation. Значение по умолчанию — слева (left).

Версия: 2011-01-02 Don Bowman

Совместимость:
 - CSS изменены для выполнения в среде DokuWiki 2009-12-25c “Lemming”;
 - использована новая функция dformat вместо strftime (DokuWiki 2009-12-25c "Lemming");
 - кнопка «Возврат» добавлена в список команд.
Отображение:
 - последовательность заголовков разделов в блоке «Настройки вики» изменилась для удобства чтения;
 - опция закругления углов полей сайта теперь работает во всех браузерах (кроме Internet Explorer, вплоть до IE8);
 - у кнопок теперь есть подсветка/затенение и цвета, соответствующие теме оформления.
Боковая панель:
 - новый параметр конфигурации «rb_showeditbtn» для отображения кнопки редактирования на боковой панели;
 - новый параметр конфигурации «rb_main_sidebar», чтобы всегда показывать основную боковую панель.
Управление доступом:
 - новый параметр конфигурации «rb_private» для ограничения доступа входа в систему пользователей.
Исправленные ошибки:
 - в Firefox’е менеджер медиафайлов теперь корректно отображает список файлов;
 - боковая панель для пространст имён теперь отображается корректно;
 - боковая панель, обрабатывая пустые записи, теперь отбрасывает их полностью (необходимо для Internet Explorer, вплоть до IE8).

Шаблон установил и выбрал первую тему. Но выдается сообщение «Could not set correct style.ini file for your chosen theme.» на первой странице сайта. В коде roundbox.php есть строка if @file_exists($file2)) && (@unlink($file)) && (@copy($file2, $file Подозреваю не работает @unlink($file). Почему? Права на $file (style.ini) и $file2 (style.ini в themes) дал 777.