РецептысозданиясайтовнаDrupal

Формат статей с рецептами

• Выбрать Создать → Страница книги (book)
• Для создания структуры статьи используется специальная разметка, которая вставляется в тело статьи кнопкой редактора "Структура"

Общие правила

• Одно решение проблемы на одну статью.
• Не допускается албанский язык, нецензурная лексика
• Проверять грамматику перед публикацией
• Максимально использовать русские слова вместо английских
• Обязательное и насколько возможно полное заполнение тегов.
• Указать всех авторов, которые предложили решения.

Заголовок

Заголовок должен:

• Иметь минимальную длину и максимально описывать задачу.
• Быть утверждением, а не вопросом.
• Нужно избегать двузначности и игры слов.
• Нужно использовать слова и понятия принятые сообществом Друпал.ру, а не выдумывать свои.

Оформление задачи (анонса)

• Задача задаётся в виде анонса отдельно от текста рецепта. Для этого нужно нажать кнопку "Отделить анонс от основного материала".
• Параметр "Показать анонс при полном просмотре" не должен быть выбран. Иначе все теги будут выведены над текстом статьи, а не после описания задачи.
• Перед текстом задачи вставляется картинка по теме рецепта.
  • Формат картинки может быть любым.
  • Имя картинки совпадает с URL рецепта.
  • А теге alt картинки нужно указать название статьи на русском языке.
  • Картинка должна быть ссылкой на рецепт системный URL рецепта (во время редактирования рецепта можно скопировать текущий адрес и удалить в конце '/edit')
  • В аттрибуте title указывается название статьи на русском языке.
• Текст анонса должен быть очень кратким, но достаточным, чтобы можно было быстро понять проблему/задачу.

Пример анонса:
<a href="http://drupalcookbook.ru/node/276" title="Получить форматированный текст анонса"><img src="http://drupalcookbook.ru/sites/default/files/teaser-summary.gif" alt="Получить форматированный текст анонса" align="left" /></a>Получить форматированный текст анонса (teaser) в шаблоне темы (node.tpl.php)

Подбор картинки для рецепта

• Можно поискать по ключевым словам рецепта в картинках Гугл
• Картика должна быть уменьшена до 200px в высоту
• Картинка должна быть максимально оптимизирована.
  • JPG: степень сжатия 80% и убрать всю не нужную информацию (EXIF, комментарии и прочее)
  • GIF: палитра цветов должна содержать минимум необходимых цветов.
  • PNG: желательно без прозрачности, но это не критично.

Оформление текста решения

Подзаголовки

• Не используемые подзаголовки должны быть удалены.
• Можно создавать свои подзаголовки, соблюдая вложенность.

Иллюстрации к тексту рецепта

• Иллюстрации должны облегчать понимание решения.
• Иллюстрации нужно использовать только если они действительно необходимы.
• Вставляются в тело статьи как inline-элементы (тег IMG)
• В "Прикрепленные файлы" нужно снять галочку "Список" для всех иллюстраций, чтобы они не выводились в виде списка внизу статьи.
• Список приложенных документов не должен выводиться для картинок. Может выводиться для других файлов, но лучше давать ссылку для скачивания в статье.

Прикрепленные файлы

• Лучше давать ссылку на скачивание файла в самой статье, а не выводить в виде списка.

Оглавление подшивки

Выбрать наиболее подходящего родителя или сохранить в самом верхнем уровне.

Проверка рецепта

Перед публикацией нужно проверить:

• грамматику
• орфографию
• валидность HTML-кода новой статьи (см. ссылку "Проверить HTML" в блоке "Меню редактора")

Оформление вариантов решений

Такая реализация согласуется со стандартом xhtml 1.0:
<h3>Варианты</h3>
<ul>
 <li><a href="#packer">Packer</a></li>
 <li><a href="#online_packer">Online Packer</a></li>
 <li>Y<a href="#yui_compressor">UI Compressor</a></li>
 <li><a href="#jsmin">JSMin</a></li>
</ul>

<h3 id="jsmin">JSMin</h3>

Правила публикации статей с описаниями модулей

• Описание одного модуля в одной статье.
• Выбрать Создать → Описание модуля
• Заголовок должен содержать имя модуля, которое указано на сайте drupal.org в адресной строке. Это название может не совпадать с названием модуля на странице. Это нужно для того, чтобы можно было сформировать ссылки на страницы модулей автоматически.
• Теги. Со страницы модуля на drupal.org нужно взять информацию об авторе, дате начала проекта, категориях, в которых должен быть расположен модуль, а также описание и др. Важно заполнить версии Друпал, для которых есть релиз модуля. Это поможет в отборе модулей по версии Друпал.
• Для структурирования и оформления используется специальная разметка (вставляется в тело статьи кнопкой редактора "Описание модуля").
• Подзаголовки. Не используемые подзаголовки должны быть удалены. Можно создавать свои подзаголовки, соблюдая вложенность.

Изображения в статьях

• Вставляются в тело статьи, а не выводятся как приложенные файлы.
• Список приложенных документов не должен выводиться для картинок. Может выводиться для других файлов, но лучше давать ссылку для скачивания в статье.