Содержание
Шаблон «Roundbox»
Совместим с «Докувики»
2009-02-14, Lemming, Anteater
Блоки (поля) с закругленными углами, которые делят страницу на заголовок, боковую колонку и область основного содержания.
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
(Автор оригинала: 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) или написать комментарий на странице оригинала шаблона.
О новом можно узнать здесь!
Загрузка
2011-01-02 | zip | http://download.lynsoft.co.uk/template_roundbox_20110102.zip |
2011-01-02 | tgz | http://download.lynsoft.co.uk/template_roundbox_20110102.tgz |
2009-06-21 | zip | http://download.lynsoft.co.uk/template_roundbox_20090621.zip |
2009-06-21 | tgz | http://download.lynsoft.co.uk/template_roundbox_20090621.tgz |
2009-01-26 | zip | http://download.lynsoft.co.uk/template_roundbox_20090126.zip |
2009-01-26 | tgz | http://download.lynsoft.co.uk/template_roundbox_20090126.tgz |
2005 0.4.1b | zip | http://chrisarndt.de/en/software/dokuwiki/roundbox-template-0.4.1b.zip |
Установка
- Загрузите архив шаблона.
- Распакуйте в
<dokuwiki>/lib/tpl
. Это создаст папку, названнуюroundbox
. - Войдите в «Управление», а затем в «Настройки вики» для выбора шаблона.
- Дополнительно: сконфигурируйте некоторые параметры шаблона (см. Конфигурация).
- Дополнительно: выберите тему (см. Темы).
Темы (цветовая тема)
С версии шаблона от 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://trolug.de/ Troisdorfer Linux User Group
Не стесняйтесь добавить свой собственный сайт здесь, если вы используете этот шаблон!
Конфигурация
Некоторые аспекты вида этого шаблона и его поведения могут быть сконфигурированы изменением значений параметров в файле <dokuwiki>/lib/tpl/roundbox/conf/default.php
. Большинство из них могут быть изменены через «Настройки вики» в разделе «Параметры шаблонов». Доступны следующие настройки:
rb_theme
Определяет тему, которая будет использоваться.
- Тип: строковый
- Значения: <текущий список тем>
- По умолчанию:
evening
rb_sidebar_orientation
Определяет, с какой стороны от основного блока страницы будет находиться боковая панель.
- Тип: строковый
- Значения:
left|right
- По умолчанию:
left
rb_sitenav
Влючает отображение навигации сайта в боковой панели. См. раздел «Боковая панель» для подробностей.
- Тип: логический
- По умолчанию:
true
rb_uselinks
Использует ссылки вместо кнопок в поле команд боковой панели.
- Тип: логический
- По умолчанию:
true
rb_tagline
Вводит текст для подзаголовка вашей вики в поле ниже заголовка вики.
- Тип: строковый
- По умолчанию: <пустая строка>
rb_roundcorners
Включает опцию закругления углов для основных полей страницы. Работает в большинстве браузеров (кроме Internet Explorer’а, вплоть до 8-й версии).
- Тип: логический
- По умолчанию:
true
rb_youarehere
Заменяет маршрут посещений иерархической цепочкой навигации.
- Тип: логический
- По умолчанию:
true
rb_crumbsep
Устанавливает текст, который разделяет каждую ссылку в навигационной цепочке. Работает, только если параметр rb_youarehere
имеет значение true
.
- Тип: строковый
- По умолчанию:
" → "
rb_index
Определяет имя страницы по умолчанию (index page) пространства имен. Это имеет смысл, только если параметр rb_youarehere
принимает значение true
.
- Тип: строковый
- По умолчанию:
"start"
rb_removeunderscore
Удаляет подчеркивание ссылок навигационной цепочки. Работает, только если параметр rb_youarehere имеет значение true
.
- Тип: логический
- По умолчанию:
true
rb_showeditbtn
Отображает кнопки редактирования на боковой панели.
- Тип: логический
- По умолчанию:
false
rb_private
«Это — частная вики». Когда параметр принимает значение true
, к вики доступ могут получить только зарегистрированные пользователи. Если пользователь незарегистрирован, то единственной страницей, которую он увидит, это страница входа.
- Тип: логический
- По умолчанию:
false
rb_main_sidebar
Показывает/скрывает главную боковую панель. Когда этот параметр установлен, боковая панель по умолчанию будет всегда видна. Если текущая страница находится в пространстве имен, у которого также есть файл боковой панели, её боковая панель будет располагаться ниже главной боковой панели. Если этот параметр не установлен, используется боковая панель, соответствующая показываемой странице.
- Тип: логический
- По умолчанию:
false
rb_actions
Какие действия должны быть доступными в блоке команд боковой панели? Доступные действия:
Действие | Пояснение |
---|---|
edit | Править страницу / Показать исходный текст / Показать страницу |
revert | Возврат |
history | История страницы |
subscribe | Подписаться (все правки) |
backlink | Ссылки сюда |
index | Все страницы |
recent | Недавние изменения |
admin | Управление |
profile | Профиль |
login | Войти |
- | Вставляет небольшой пробел по вертикали |
Расположение действий в массиве определяет расположение кнопок (ссылок) в поле команд боковой панели (сверху вниз).
- Тип: массив
- По умолчанию:
array( 'edit', 'revert', 'history', 'subscribe', 'backlink', '-', 'index', 'recent', '-', 'admin', '-', 'profile', 'login')
rb_act_min_access / rb_act_users
Следующие настройки определяют, какие действия (для доступа к которым и нужны кнопки/ссылки) доступны пользователям:
Для каждого из действий, упомянутых выше может быть ключ в обоих из ассоциативных множеств этих двух опций rb_act_min_access
и rb_act_users
.
Первый определяет, какой уровень доступа текущий пользователь должен иметьв минимуме, чтобы видеть эту кнопку. Последний позволяет определять список пользователей и/или групп, которые будут видеть эту кнопку, независимо от их уровня доступа. Названия группы должны быть снабжены префиксом '@'. Специальная группа '@ALL' относится к пользователям, которые входили в систему или нет.
Дополнительно следующие ключи в массивах будут проверены, чтобы определить отображение форм «Поиск» и «Перейти»:
Действие | Пояснение |
---|---|
goto | Перейти |
search | Поиск |
Примечание. Эти опции только определяют отображение кнопок/связей для данных функций. Функции могут все еще быть вызваны введением подходящих параметров URL вручную! Вы предупреждены.
См. файл conf/default.php
в каталоге шаблона для примера.
- Тип: массив
- По умолчанию: см. файл «conf/default.php»
Списки могут быть изменены только в «conf/default.php». Они недоступны через «Настройки вики».
I18n (локализация)
Шаблон «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.