Руководство разработчика

Прислано: axel

ср, 10/11/2004 - 13:47

Другие статьи по теме:

Здесь собирается различная техническая информация полезная для разработки расширений к Drupal, ведению переводов и т.п.

Комментарии


Настройки просмотра комментариев

Выберите нужный метод показа комментариев и нажмите "Применить"
Опубликовано Smart в ср, 24/11/2004 - 21:21.

Я всё пытаюсь поставить в заголовок сайта флеш! Но где бы я её не прописывал Drupal всё равное не хочет видеть её!
Что можно сделать?


Опубликовано Easter в пн, 20/12/2004 - 08:40.

Steven - October 20, 2004 - 12:17
Замечание: эта страница описывает систему тем с точки зрения создателя тем. Если вы писатель модулей, ищущий информацию о том, как сделать ваш модуль подчиненным темам, вам нужно прочесть эту страницу.
Как и в версии 4.5, система тем Drupal очень гибкая. Новая структура позволяет легко соединять компоненты вместе для создания вашей темы: движки для создания шаблонов тем, шаблоны, стилевые страницы и PHP.
Вот как устроены некоторые из существующих тем:
Теперь тема – это абстрактная вещь, которая может быть сформирована несколькими путями:
• Файл PHP .theme содержащий перекрытия для theme_functions: такой как Chameleon
• Файл шаблона (.xtmpl, .tpl.php) для шаблонирующего движка (XTemplate, PHPTemplate, ...): такой как. Pushbutton, Bluebeach
• Стилевые страницы для существующего шаблона или темы, такие как Marvin, Box Cleanslate
Структура директории для примера, данного выше, выглядит следующим образом:
themes/engines/xtemplate/xtemplate.engine
themes/engines/phptemplate/phptemplate.engine
themes/pushbutton/xtemplate.tmpl
themes/pushbutton/style.css
themes/box_grey/page.tpl.php
themes/box_grey/style.css
themes/box_grey/box_cleanslate/style.css
themes/bluebeach/page.tpl.php
themes/bluebeach/style.css
themes/chameleon/chameleon.theme
themes/chameleon/style.css
themes/chameleon/marvin/style.css
Темы и шаблоны размещены в их собственной поддиректории в директории themes. Движки тем просканируют каждую поддиректорию на присутствие файлов шаблонов (.xtmpl, .tpl.php, ...). Если присутствует файл style.css он также будет использован.
Вы можете делать темы основанные только на CSS создав поддиректорию в директории любой темы и поместив в ней новый файл style.css. Drupal объединит новую стилевую таблицу с шаблоном к которому она привязана и сделает его доступным как новую тему. Так работают темы Marvin и Box Cleanslate.
Наконец, если в директории темы есть файл screenshot.png, Drupal отобразит его в экране администрирования темы.
Создание индивидуальных тем
Если вы хотите создать индивидуальную тему, вы можете модифицировать существующую тему или начать с нуля.
Чтобы модифицировать существующую тему, просто скопируйте ее в новую директорию в themes. Затем измените настолько насколько нужно. В зависимости от того, чем является тема шаблоном или основанной на файле .theme, вы можете использовать PHP или XHTML/CSS для его изменения. Как объяснялось выше, если вы хотите всего лишь поменять CSS темы, тогда просто поместите новый файл style.css в поддиректорию темы: он появится как новая тема в Drupal.
Если вы хотите начать с нуля, есть несколько способов. Если вы не программист, тогда наиболее простое решение движки шаблонирования. По умолчанию, Drupal поставляется с движком шаблонов XTemplate, которому нужно, чтобы вы создали основу со специальными метками. Смотри документацию XTemplate для дополнительной информации. Есть другие движки шаблонирования доступные в репозитории пожертвованных разработок (таких как PHPTemplate).
Темы Drupal обычно кодированы прямо в PHP. Этот метод все еще доступен, но сложнее в использовании и применении тем основанных на шаблонах.
Движок шаблонирования XTemplate
TDobes - March 15, 2004 - 15:45
Система шаблонирования XTemplate использует шаблоны для верстки и стилизации веб-страниц. Она разделяет логическое (PHP), структурное (XHTML/HTML) и стилистическое (CSS) изготовление, для дизайнеров проще создавать и модифицировать шаблоны, работая на XHTML/HTML и CSS без забот о кодировании чего-либо в PHP.
Шаблоны XTemplate это директории которые содержат все XHTML/HTML, CSS, изображения и файлы JavaScript которые использует шаблон. Шаблоны размещены в директории тем установки Drupal:
/themes/
Как шаблон появляется в директории тем, XTemplate автоматически определяет его и делает его доступным для выбора администраторов:
администрирование -> темы
Drupal распространяется с включенными шаблонами XTemplate - Bluemarine и Pushbutton.
Создание нового шаблона
TDobes - March 15, 2004 - 17:14
Чтобы создать новый шаблон XTemplate, создайте новую директорию в установки Drupal по адресу:
/themes/
Как вы назовете новую директорию, так и будет назваться ваш новый шаблон, например:
/themes/rembrant
Как только вы создадите шаблон в этой директории, он сразу появится на странице выбора шаблона под именем "rembrant".
Наиболее просто способ создать новый шаблон – это сделать копию существующего шаблона, такого как Default или Pushbutton, и начать делать изменения в файлах.
Единственный файл, который нужен в директории - это xtemplate.xtmpl, который является обычным файлом HTML или XHTML содержащим некоторые тэги XTemplate которые Drupal заменяет содержимым когда страница обслуживается. Файл xtemplate.xtmpl можно редактировать в DreamWeaver, GoLive, BBEdit или любом другом приложении, которое вы используете для работы над HTML/XHTML.
Все остальные файлы в шаблоне являются выборочными, и присоединяются из файла xtemplate.xtmpl. Он может содержать CSS, изображение или файлы JavaScript и должны быть включены в директорию шаблона, чтобы сделать администрирование и обслуживание, и перемещение между установками Drupal проще.
Заметьте, если вы дадите таблице стилей имя style.css, она будет автоматически подключена Drupal и вам не нужно явно добавлять для этого @import или . Если вы делаете поддиректорию внутри шаблона, содержащего другой файл style.css, тогда поддиректория станет новой темой, использующей XHTML из первой темы, но с другой стилевой таблицей stylesheet.
Основы создания шаблона
Robert Castelo - March 20, 2004 - 16:03
xTemplate создает веб-страницы замещая теги заполнители в шаблоне, файла xtemplate.xtmpl, содержимым из базы данных.
Есть два типа тэгов заполнителей в шаблоне, теги раздела и теги элемента.
Тэги раздела
Тэги раздела имеют дело со структурой веб-страницы, области страницы создают следующие тэги комментарии XHTML/HTML:

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

Тэги секции могут вкладываться, так, что один наборы тэгов секции может быть внутри другого:

Тэги элемента
Тэги элемента являются заполнителями для элементов содержания, таких как заглавие страницы, кто эту страницу написал или главное содержимое страницы. Тэги элемента выглядят следующим образом:
{title}
{submitted}
{content}
Тэги элемента ассоциируются с тэгами раздела, который окружают его, например:

{title}

Тэг выше {title} является главным названием страницы, тогда как тэг {title} ниже это название комментариев на странице.

{title}


Опубликовано Гость (гостевой логин) в пн, 03/01/2005 - 23:55.

подскажите - а где найти инструкцию по разработке модулей?


Опубликовано kiev1 в ср, 12/01/2005 - 19:32.

можно-ли как-то в теме на XTemplate делать условия и где найти перечень всех тегов друпала, которые можно применять в теме


Опубликовано axel в чт, 13/01/2005 - 00:05.

Инфа по XTemplate в handbook: http://drupal.org/node/6493 + исходники xtemplate смотреть.

--
Axel


Опубликовано axel в чт, 13/01/2005 - 00:07.

На http://drupaldocs.org есть примеры простых модулей. Плюс полное описание API.

--
Axel


Опубликовано kiev1 в пт, 14/01/2005 - 20:41.

в handbook про ветвления и написание собственных учловий при выводе темы - нет, иначе не спрашивал-бы, прийдется исходники самому смотреть.


Опубликовано Dmitriy Sergeevich в вс, 04/09/2005 - 07:19.

Народ, ай хэв грэйт проблем!!!
Графика на сайте не отображается вообще ( что характерно на localhoste все было ОК! ). Кто подскажет в чём трабл?
Что интересно, браузер полностью видит пути к графике и даже показывает их вес :-(
пример можно посмотреть здесь - http://RUS25.NixUP.COM

Help!!!

P.S.:
Тестированно на IE7, Opera, NS Navigator.


Опубликовано Nick в пн, 05/09/2005 - 22:40.

Ну и при чем здесь "Руководства разработчика" ??!?
Новую то тему создать не судьба совсем? Или там где увидили формочку для написания чего-нибудь, так туда и написали...

Вообщем, если бы вы внимательно читали комментарии к кофиг файлам, то заметили бы в /sites/default/setings.php:

Цитата:

# Base URL:
#
# The URL of your website's main page. It is not allowed to have
# a trailing slash; Drupal will add it for you.

Если еще что-то не понятно, то создавайте новую тему. На ваши оффтопики я больше ни байта не отвечу, более того оффтоп удалю.


Опубликовано Natalie в пн, 04/09/2006 - 20:27.

Это, собственно, к чему было?
---
---
All content management systems suck, Drupal just happens to suck less. -- Boris Mann at DrupalCON Amsterdam, August 2005.


Опубликовано dyp@drupal.org в пн, 04/09/2006 - 20:28.

Обычно в таких случаях пишут просто "up!".


Новое на сайте

Ссылки партнёров