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

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


wiki:template:starter

Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слеваПредыдущая версия
Следующая версия
Предыдущая версия
wiki:template:starter [2025/02/08 14:22] – удалено - внешнее изменение (Дата неизвестна) 127.0.0.1wiki:template:starter [2025/02/08 14:52] (текущий) – [Backlink for Discussion Has Wrong Page ID] vladpolskiy
Строка 1: Строка 1:
 +====== Starter шаблон ======
 +
 +---- template ----
 +description   : Шаблон, с которого можно начать
 +author        : Anika Henke
 +email         : anika@selfthinker.org
 +lastupdate    : 2024-01-21
 +compatible    : Frusterick Manners, Elenor of Tsort, Detritus, "Ponder Stibbons", Hrun, Greebo, Hogfather, 2023-04-04, Kaos
 +depends       : 
 +conflicts     : 
 +similar       : benjamin , twigstarter
 +screenshot_img: :wiki:template:starter_template.png
 +tags          : start, simple, sidebar
 +
 +downloadurl   : https://github.com/selfthinker/dokuwiki_template_starter/zipball/master
 +bugtracker    : https://github.com/selfthinker/dokuwiki_template_starter/issues
 +sourcerepo    : https://github.com/selfthinker/dokuwiki_template_starter
 +donationurl   : https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=11071728
 +---- 
 +
 +Шаблон **Starter Template** разработан как отправная точка для вашего пользовательского шаблона. Он содержит множество встроенных комментариев в коде, которые должны объяснять многие вещи. Он меньше фокусируется на дизайне, но больше на удобстве обслуживания.
 +
 +Это сделано таким образом, что позволяет вам меньше беспокоиться о базовых стилях DokuWiki. Вместо этого вам нужно заботиться только о пяти основных стилях:
 +  * ''basic.css'': Вероятно, вам следует прикоснуться к этому параметру только в том случае, если вы хотите изменить общие размеры шрифтов и стеки шрифтов.
 +  * ''structure.css'': Вероятно, вам стоит прикоснуться к этому, только если вы хотите изменить общую структуру сайта (сделать ее трехколоночной, или разной ширины, или сделать все гибким, или переместить боковую панель вправо и т. д.).
 +  * **''design.css''**: Здесь вы можете задать стиль всем частям, окружающим содержимое страницы.
 +  * **''content.css''**: Здесь вы можете задать стиль всего содержимого страницы.
 +  * **''mobile.css''**: Здесь вы можете настроить все изменения для мобильных устройств и небольших экранов.
 +
 +[[http://blog.andreas-haerter.com/2011/03/16/how-to-create-a-maintainable-dokuwiki-template|Дополнительные советы по созданию легко поддерживаемого шаблона DokuWiki]] можно найти в статье Андреаса Хертера (основанной на более ранней записи в блоге Михаэля Клиера).
 +
 +Общую информацию см. в [[wiki:devel:template|документации по разработке шаблонов]]. 
 +
 +===== Загрузите и установите ======
 +
 +  * Для версии DokuWiki 2014-05-05 (Ponder Stibbons) и более поздних версий: используйте менеджер расширений для установки этого шаблона.
 +  * Для Binky или Weatherwax: Вы можете {{wiki:template:dokuwiki_template_starter.zip|загрузить более старую версию}}.
 +  * Если вас интересует более урезанная версия шаблона, вы можете использовать [[https://github.com/selfthinker/dokuwiki_template_starter/tree/minimal|ветку "minimal"]]. Эта версия почти не использует CSS и не включает никаких дополнительных функций.
 +
 +Информацию о том, как устанавливать и использовать шаблоны в DokuWiki, см . в разделе [[wiki:template|Шаблоны]].
 +
 +===== Конфигурация======
 +
 +Они находятся в //[корень темы]/starter/conf/default.php//. Их можно изменить на панели конфигурации.
 +
 +^опция конфигурации         ^описание                                                         ^значение по умолчанию   ^
 +^ ''hideTools''        | скрыть редактирование и другие инструменты, если вы не вошли в систему                   | ''0''          |
 +^ ''sidebarIsNav''     | используйте ''nav'' элемент вокруг боковой панели, если она в основном используется для навигации, в противном случае используйте asideэлемент (новое с версии 2021-01-25) | ''1''          |
 +
 +Параметры конфигурации в предыдущих версиях (удалены в версии 2021-01-25):
 +
 +  * ''discussionPage'': Функциональность страницы обсуждения удалена и может быть заменена с помощью [[wiki:plugin:talkpage|Talkpage плагина]]; просто измените ''talkns'' параметр с «talk» на «discussion», чтобы использовать то же пространство имен, что и раньше.
 +  * ''userPage'': Функциональность страницы пользователя удалена и может быть заменена с помощью [[wiki:plugin:userpage|плагина Userpage]]
 +
 +
 +===== More Info ======
 +
 +==== Дополнительная информация =====
 +
 +  * Спасибо [[world>https://forum.dokuwiki.org/u/andi|Andreas Gohr]] за общие советы.
 +  * Спасибо [[mail>clarencedglee@gmail.com|Clarence Lee]] за его советы по дизайну, особенно в отношении типографики.
 +
 +==== Изменения =====
 +
 +Если вы являетесь автором шаблона и используете этот шаблон в качестве основы для своего собственного, вам, возможно, будет интересно ознакомиться со [[wiki:template:starter:changes|списком подробных изменений]].
 +
 +{{rss>https://github.com/selfthinker/dokuwiki_template_starter/commits/master.atom date}}
 +
 +==== Демо====
 +
 +  * http://demo.selfthinker.org/
 +
 +===== Templates based on Starter =====
 +
 +  * [[template:dokuwiki|the new default template since Adora Belle]]
 +  * [[ACH]]
 +  * [[monobook]] (the DokuWiki CSS parts)
 +  * [[vector]] (the DokuWiki CSS parts)
 +  * [[Taratasy]]
 +  * [[Apricot]]
 +  * [[Scanlines]]
 +  * [[writers|Writer's]]
 +  * [[zenlike|Zenlike]]
 +  * [[benjamin|Benjamin]]
 +  * [[template:stm|STM]]
 +
 +===== Комментарии=====
 +
 +  * ясно и полезно! отлично!
 +  * спасибо, этот шаблон очень чистый и полезен для большинства случаев! обожаю его :)
 +  * Очень классная вещь.
 +
 +==== How to translate this theme? ====
 +
 +There are three files to translate:
 +  * [[https://github.com/selfthinker/dokuwiki_template_starter/blob/master/lang/en/lang.php|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 [[plugin:Styling]] plugin in the admin section uses. This file is the most important to translate.
 +  * [[https://github.com/selfthinker/dokuwiki_template_starter/blob/master/lang/en/settings.php|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).
 +  * [[https://github.com/selfthinker/dokuwiki_template_starter/blob/master/lang/en/style.txt|lang/en/style.txt]] is for extra information about configuration of the template displayed under the form of the [[plugin:Styling]] plugin in the admin section.
 +
 +You can either send me language files to update by email or post them here or in the [[https://github.com/selfthinker/dokuwiki_template_starter/issues|bugtracker]]. Please have a look at the [[https://github.com/selfthinker/dokuwiki_template_starter/tree/master/lang|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?) --- [[user>ach|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 [[wp>bookmarklet]]:
 +><code javascript>javascript:window.location=window.location+"?do=login"</code> (I'm assuming the use of [[doku>Rewrite|webserver rewriting]]) ---[[user>atnbueno|Antonio Bueno]] //2011/11/11 21:40//
 +>>That sounds like a good idea! Thanks --- //Nactus 2011-11-13//
 +
 +==== Обратная ссылка для обсуждения имеет неверный идентификатор страницы ====
 +в строке 31 tpl_functions
 +  tpl_pagelink($backID, $backTitle); 
 +возвращается
 +  discussion:home
 +для идентификатора страницы при построении ссылки. Проблема не в функции _tpl_discussion, так как замена //$backID// на //'home'// приводит к той же проблеме.
 +
 +Исправление: 
 +  tpl_pagelink(':'.$backID, $backTitle);
 +
 +> Спасибо. Это исправлено с сегодняшнего релиза --- [[mail>anika@selfthinker.org|Anika Henke]] //2014-05-19 03:24//
 +=====Дополнения и Файлы=====
 +  * {{:wiki:template:selfthinker-dokuwiki_template_starter-v2021-02-25-3-g57b339e.zip|Шаблон Starter}}
 +  * {{ :wiki:template:dokuwiki_template_starter.zip |Шаблон Starter для Binky или Weatherwax}}
 +  * {{ :wiki:template:dokuwiki_template_starter-minimal.zip |Шаблон Starter minimal}}
 +[[https://www.dokuwiki.org/template:starter|Ссылка на оригинальную статью]]