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

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


wiki:template:starter

Это старая версия документа!


Starter шаблон

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

  • 2024-02-06 "Kaos" да
  • 2023-04-04 "Jack Jackrum" да
  • 2022-07-31 "Igor" неизвестно
  • 2020-07-29 "Hogfather" да

template Шаблон, с которого можно начать

Последнее обновление:
2024-01-21
Репозиторий
исходный код

Это расширение не находится в пространстве имен 'plugin' или 'template' и поэтому игнорируется.

Похож на benjamin, twigstarter

Теги: sidebar, simple, start

Шаблон Starter Template разработан как отправная точка для вашего пользовательского шаблона. Он содержит множество встроенных комментариев в коде, которые должны объяснять многие вещи. Он меньше фокусируется на дизайне, но больше на удобстве обслуживания.

Это сделано таким образом, что позволяет вам меньше беспокоиться о базовых стилях DokuWiki. Вместо этого вам нужно заботиться только о пяти основных стилях:

  • basic.css: Вероятно, вам следует прикоснуться к этому параметру только в том случае, если вы хотите изменить общие размеры шрифтов и стеки шрифтов.
  • structure.css: Вероятно, вам стоит прикоснуться к этому, только если вы хотите изменить общую структуру сайта (сделать ее трехколоночной, или разной ширины, или сделать все гибким, или переместить боковую панель вправо и т. д.).
  • design.css: Здесь вы можете задать стиль всем частям, окружающим содержимое страницы.
  • content.css: Здесь вы можете задать стиль всего содержимого страницы.
  • mobile.css: Здесь вы можете настроить все изменения для мобильных устройств и небольших экранов.

Дополнительные советы по созданию легко поддерживаемого шаблона DokuWiki можно найти в статье Андреаса Хертера (основанной на более ранней записи в блоге Михаэля Клиера).

Общую информацию см. в документации по разработке шаблонов.

Загрузите и установите

  • Для версии DokuWiki 2014-05-05 (Ponder Stibbons) и более поздних версий: используйте менеджер расширений для установки этого шаблона.
  • Для Binky или Weatherwax: Вы можете загрузить более старую версию.
  • Если вас интересует более урезанная версия шаблона, вы можете использовать ветку "minimal". Эта версия почти не использует CSS и не включает никаких дополнительных функций.

Информацию о том, как устанавливать и использовать шаблоны в DokuWiki, см . в разделе Шаблоны.

Configuration

These are in [theme root]/starter/conf/default.php. It can be changed from the Configuration panel.

config option description default value
hideTools hide editing and other tools when not logged in 0
sidebarIsNav use a nav element around the sidebar if it's mainly used for navigation, otherwise use an aside element (new since version 2021-01-25) 1

Config options in previous versions (removed in version 2021-01-25):

  • discussionPage: Discussion page functionality was removed and can be replaced by using the Talkpage Plugin; just change the talkns option from 'talk' to 'discussion' to use the same namespace as before
  • userPage: User page functionality was removed and can be replaced by using the Userpage Plugin

More Info

Credits

  • Thanks to Andreas Gohr for general advice.
  • Thanks to Clarence Lee for his design advice, especially concerning typography.

Changes

If you are a template author using this template as a base for your own, you might want to check out the list of detailed changes.

Demo

Templates based on Starter

Comments

  • clear and useful! great!
  • thank you, this template is very clean and useful for most cases! love this :)
  • Very nice stuff.

How to translate this theme?

There are three files to translate:

  • lang/en/lang.php is for everything you see on the frontend (although the «accessibility headlines» are hidden for most users) plus descriptions for style.ini placeholders which the Styling plugin in the admin section uses. This file is the most important to translate.
  • lang/en/settings.php is for the configuration admin. This file is not as important as the other, as it will only be seen by the admin(s).
  • lang/en/style.txt is for extra information about configuration of the template displayed under the form of the Styling plugin in the admin section.

You can either send me language files to update by email or post them here or in the bugtracker. Please have a look at the available translations first.

How to insert a logo image instead of text?

Open the template's main.php and search for «logo». It's explained in there.

CSS bug w/ zoom plugin

An image included with the zoom plugin will scroll over the footer and hide it

I cannot reproduce this. Do you have any more specific information? (Browser, other installed plugins, etc?) — Anika Henke 2011/05/02 16:45

Tools hidden - can't login

In the template config, I selected «hide editing and other tools when not logged in» and then I logged out. But now I can't log in as there is no «Login» button/link showing.

Am I missing something? — Nactus 2011-11-10

You probably need to save/remember the login URL (you can get it just by adding ?do=login to any DokuWiki URL). In fact I use the following bookmarklet:
javascript:window.location=window.location+"?do=login"

(I'm assuming the use of webserver rewriting) —Antonio Bueno 2011/11/11 21:40

That sounds like a good idea! Thanks — Nactus 2011-11-13

in line 31 of tpl_functions

tpl_pagelink($backID, $backTitle); 

returns

discussion:home

for the page ID when the link is built. The issue is not with the _tpl_discussion function as replacing $backID with 'home' produces the same problem.

A fix is:

tpl_pagelink(':'.$backID, $backTitle);
Thanks. That's fixed since today's release. — Anika Henke 2014-05-19 03:24
Только авторизованные участники могут оставлять комментарии.
wiki/template/starter.1739014373.txt.gz · Последнее изменение: vladpolskiy