DokuWiki

Отредактируйте страницу и нажмите «Сохранить». Прочтите справочную страницу для ознакомления с синтаксисом вики. Пожалуйста, редактируйте только в том случае, если планируете улучшить содержимое. Если вы просто хотите потестировать что-либо, воспользуйтесь специальной страницей: playground.

====== Шаблон «Roundbox» ======

---- template ----
author:         Don Bowman
email:          don@lynsoft.co.uk
Description:    Блоки (поля) с закругленными углами, которые делят страницу на заголовок, боковую колонку и область основного содержания. 
lastUpdate:     2011-01-02
Compatible:     2009-02-14, Lemming, Anteater
tags:           roundbox, sidebar, themes, cms, tagline
Screenshot_img: http://download.lynsoft.co.uk/Roundbox1.png
----

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

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

===== Исходная информация =====

**Автор:** [[don@lynsoft.co.uk|Don Bowman]] (был [[chris@chrisarndt.de|ChristopherArndt]])\\
**Дата:** ''02-01-2011''

{{http://download.lynsoft.co.uk/Roundbox1.png?200 | Скриншот шаблона Roundbox}} Roundbox --- это [[ru:template|шаблон]] для DokuWiki, который первоначально был создан Кристофером Арндтом (Christopher Arndt) в соответствии с его [[http://chrisarndt.de/|домашней страницей]], которая в свою очередь базируется на дизайне «[[http://www.oswd.org/|Open Source Web Designs]]». Это чёткий табличный дизайн, основанный на полях, которые делят страницу на три основных раздела: заголовок, боковую панель и область основного содержания. Шаблон подходит для сайтов, предоставляющих только право чтения незарегистрированным пользователям, так как все кнопки могут переключаться в положение «Вкл./Выкл.» в зависимости от уровней [[ru:acl|прав доступа]] и групп участников. Кроме того, можно разрешить доступ только зарегистрированным пользователям.

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

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

Не стесняйтесь отправлять свои наработки с этим шаблоном по электронной почте автору ([[don@lynsoft.co.uk|Don Bowman]]) или написать комментарий на странице [[:template:roundbox#comments_suggestions|оригинала шаблона]].

О новом можно узнать [[#Изменения|здесь]]!

===== Загрузка =====

| 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»;
  * [[http://wiki.jalakai.co.uk/dokuwiki/doku.php/start|шаблон «Боковая панель»]];
  * [[http://www.jandecaluwe.com/testwiki/doku.php/navigation:intro|шаблон «Лучшая навигация»]];
  * <del>It also includes some CSS styles taken from different [[:plugins]] which I use at my site. These all went into the file ''plugins.css''.</del> Не используется ''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''. Большинство из них могут быть изменены через «Настройки вики» в разделе «Параметры шаблонов». Доступны следующие настройки:

==== 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 ====

Заменяет [[ru:breadcrumbs|маршрут посещений]] иерархической цепочкой навигации.

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

==== rb_crumbsep ====

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

* Тип: строковый
  * По умолчанию: ''%%" &rarr; "%%''

==== 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 ====

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

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

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

==== rb_act_min_access / rb_act_users ====

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

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

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

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

:!: **Примечание.** Эти опции только определяют //отображение// кнопок/связей для данных функций. Функции могут все еще быть вызваны введением подходящих параметров 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'' [[don@lynsoft.co.uk|автору]] для включения в дистрибутив шаблона.

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

===== Боковая панель =====

В шаблон «Roundbox» интегрирован код [[http://wiki.jalakai.co.uk/dokuwiki/doku.php/start|шаблона «Боковая панель»]] для обеспечения возможности навигации по сайту с помощью боковой панели. Содержание этой панели --- обычная вики-страница. То, какая страница вики загружена в поле навигации сайта, зависит от текущего [[ru:namespaces|пространства имен]]. См. [[http://wiki.jalakai.co.uk/dokuwiki/doku.php|оригинал шаблона]] для пояснений.

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

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

===== Изменения =====

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

<code>
Совместимость:
 - 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).
</code>

===== Проблемы при установке шаблона =====
Шаблон установил и выбрал первую тему. Но выдается сообщение "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.

Пожалуйста, введите код подтверждения, чтобы доказать, что вы человек: S H W B E Пожалуйста, оставьте это поле пустым:

Сводка изменений

Примечание: редактируя эту страницу, вы соглашаетесь на использование своего вклада на условиях следующей лицензии: CC Attribution-Share Alike 4.0 International