Предыдущая версия справа и слеваПредыдущая версияСледующая версия | Предыдущая версия |
wiki:template:starter [2025/02/08 14:22] – удалено - внешнее изменение (Дата неизвестна) 127.0.0.1 | wiki:template:starter [2025/02/08 14:52] (текущий) – [Backlink for Discussion Has Wrong Page ID] vladpolskiy |
---|
| ====== 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|Ссылка на оригинальную статью]] |
| |