Инструменты пользователя

Инструменты сайта


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

Этот перевод старее, чем оригинальная страница, и может быть неактуальным. Смотрите, что было изменено.
Перевод этой страницы?:

О «Докувики»

Дополнительные возможности

Corporate Use

Наше сообщество


Следуйте за нами на Фейсбуке, в Твиттере и других социальных сетях.

Конфиденциальность (англ.)

ru:template:roundbox

Шаблон «Roundbox»

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

2009-02-14, Lemming, Anteater

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

Последнее обновление:
2011-01-02

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

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

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

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

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

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

 Скриншот шаблона Roundbox 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>/lib/tpl/roundbox/conf/default.php. Большинство из них могут быть изменены через «Настройки вики» в разделе «Параметры шаблонов». Доступны следующие настройки:

rb_theme

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

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

rb_sidebar_orientation

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

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

rb_sitenav

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

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

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

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

rb_tagline

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

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

rb_roundcorners

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

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

rb_youarehere

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

  • Тип: логический
  • По умолчанию: 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

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

ДействиеПояснение
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.

ru/template/roundbox.txt · Последние изменения: 2017-05-03 20:02 — Klap-in