Написание мануалов, справок и документаций с помощью Drupal

Приветствую сообщество!

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

По мере сдачи готового сайта заказчику мне часто приходится писать мини-инструкции, бывает что необходимые настройки далеко не интуитивно понятны даже для продвинутого заказчика, приходится садиться, скриншотить и писать. Думаю в этом я не один такой.

Естественно процесс написания подобных инструкций всегда хотелось как-то упростить и ускорить, чтобы не задумываться об инструментах с помощью которых эти инструкции создавались. А инструменты были разные, начиная с MS World'а и заканчивая разного рода специализированным ПО. Один раз дошло до того что я сверстал себе небольшую шаблонную страничку в HTML и писал инструкции в ней, кодом. Ну не люблю я WYSIWYG'и. =) Способ этот конечно же неудобный, долгий и никак не удовлетворял. Меня не оставляла мысль найти подходящий инструмент, который бы позволял писать инструкции быстро и с удобством. И вот буквально на днях выстрелила в голову бредовая мысль, использовать для этих целей Drupal.

Документация по темизации drupal 7

Не подскажете, где бы подробнее почитать про изменения в Drupal 7 по-русски? Может кто-то знает обширные статьи(кроме этой)? Может кто знает, где лежат книги в сети по Drupal7 на русском? Что-то совсем все перелопатили, простейшие задачи решаются часами. :-(

документация

Вечер добрый,пока меня не выкинул сайт с одноразовым паролём,решил спросить-где на сайте можно прочитать по установке и настройке drupal 7,fao начинается с переработки модулей,а хотелось бы с установки денвера и желательно на русском языке.

Документация TS Alphorne

В составе пакета Alphorn имеется три pdf-файла документации, которая может быть полезна как специалисту, работающему с данной темой, так и неофиту, пытающемуся разобраться в Drupal'e (особенно, в вопросах темизации).

Для себя начал перевод. Самый короткий файл оформил так (см. прикрепленные файлы). Имеет смысл переводить и надлежащим образом оформлять оставшиеся? Может, такие переводы уже существуют? Или в них вообще нет практической пользы?

Список файлов:
1. alphorn_readme.pdf (см. вложение)
2. Business_Druplal_Knowledge_Base.pdf
3. SymphonyThemes_Documents.pdf

А давайте попереводим

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

Сейчас есть желание сделать еще переводов важных статей про Друпал. Более актуальных - про семерку. Соответственно, вопрос: кто хочет поучаствовать?

Перевести можно, например, вот эту серьезную документацию: http://drupal.org/developing/api/database. Также будет здорово, если желающие увидеть перевод тех или иных статей про Друпал (желательно, 7) накидают в этот топик ссылок.

Всх, кто хочет принять участие, прошу отмечаться. Участникам предыдущего перевода, а также тем, кто специально просил, немного погодя вышлю персональные приглашения.

Пока отозвались:
Softovick
heap.ster
q2_faith
Ch
iHappy
Shift-Web
G.A. Vinogradov
LeopART
ingumsky@drupal.org
ZanaDLucTyc
P.Selfin@drupal.org
Clarion
kyky
Dock@drupal.org
mak-vardugin
NovoKain
likin
alexart79

Предложено к переводу:
http://drupal.org/node/360052 - Standards, security and best practices
http://drupal.org/developing/api/database - Drupal 7 Database API
http://drupal.org/theme-guide/6-7 - Theming Guide

gmaps ( Google Maps Tools ) ищю любую документацию

Всем привет!

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

Возникла необходимость в этом модуле, gmap не подходит, так как там вроде нет возможности прокладывать маршрут, читал redme ничего там интересного нету, гугл я тоже юзал и поиск по сайту ничего конкретного нету, может я не так запросы пишу подскажите как правильно написать чтоб выдало

или может кто знает как к ноде добавить поле выбора из списка городов а потом отображения на карте или хотя бы просто указать на карте 2 точки и рассчитать расстояние между ними по маршруту

буду благодарен за любую подсказку

Литература по Drupal

Здравствуйте, камнями прошу не кидаться, я новичок. Посоветуйте полезную литературу по Drupal 6, желательно на русском.

Также буду рад советам, так как довольно слабо представляю с чего надо начинать (курить форум и документацию?). Знаком с HTML, CSS, с PHP дела обстоят не очень, но я учусь. Заранее спасибо.

Кусочек информации по GalleryAPI

Документация о модуле http://www.drupal.ru/node/36063, http://drupal.org/project/galleryapi

Создание галерей с помощью galleryAPI и подключаемых к ней плагинов.
Модуль зависим от CCK, Views, Imagecache

Input метод - код который позволяет подготовить то или иной набор данных для обработки АПИ галереи. Данные на выходе Input метода структурированы определнным образом. Данные из Input метода никаким образом изначально не связаны с методами последующего отображения информации.

Output метод - код который обеспечивает вывод информации в определенном виде с этом же коде происходит оборачивание данных в определенный html для корректного отображения. В код Output метода по определению попадают значения структурированные определенным образом.

АПИ галереи - для связи и синхронизации Input и Output методов.

1. Распаковываем модуль в папку с модулями sites/all/modules
2. Включаем на странице управления модулями admin/build/modules/list сам galleryAPI и те плагины и методы которые хотите использовать.
2а. Плагины получения информации для АПИ: ССК - подразумевается использование CCK imagefield в режиме multiple, либо информация для галереи
получаемая с помощью модуля views. (о работе с данными плагинами чуть ниже).
2б. Плагины отображения информации: Djembe Gallery Output Method и Slideshow Output Method

ВАЖНО!!! при включении плагинов выбирать следует как Input, так и Output метод.

После включения соответствующих плагинов:
admin/settings/galleryapi

Невидно новые модули в разделе Modules

Добрый день!
Подскажите пожалуйста новичку... В чем может быть проблема...
Я установил модуль setlinks6.x-0.995, как-то он у меня встал коряво и я решил его снести (удалил из папки modules). Теперь при добавление новых модулей в modules их не видно в админской части "Модули" (не могу их включить). Посмотрел в БД setlinks никаких своих таблиц не установил. В чем может быть проблема? Я так понимаю секрета сильного в удаление модулей не должно быть или ошибаюсь?

Предложение по api.drupal.ru

Во-первых, хотелось бы поблагодарить всех создателей сайта, действительно сделали очень круто, красиво и функуционально.

Пока осваиваюсь с сайтом, перевёл примеры из «Как создавать форматы ввода» и «Как создавать страницы». Это мои первые переводы, если что не так, сильно не бейте ;)

Собственно во время переводо возникло несколько мыслей:

1. Надо сделать возможность перевода комментариев в коде. Этот пример очень наглядный.
2. Могли бы выложить статистику из Google Analytics, какие страницы наиболее популярны, чтобы их переводить в первую очередь. Всё-таки «Топ использования функций» это немного не то.
3. Сделать возможность добавлять страницы, тех же примеров можно было бы побольше сделать.
4. В качестве кода нужно давать не исходный код функции, а примеры использования.

P.S. Пока переводил, очередной раз задумался, как же сложно написана документация у Драпала. Совсем не user-friendly. Приходиться несколько раз перечитывать, чтобы понять. Надо равняться на PHP, лучшая документация, которую встречал.

Несколько ламерских вопросов по верстке дизайна :) [Решено]

#1 Как расположить текст, картинку и флэш над картинкой, например в шапке сайта например как кнопки, много чего пробовал, что пишут в гугле, но так и не смог прийти к оптимальному варианту, если кто знает, то как это обычно делают или чаще всего?
#2 Есть ли для Drupal какой нибудь модуль или плагин, с помощью которого можно визуально редактировать дизайн сайта?
#3 Есть ли документация верстки дизайна с нуля или же натяжки шаблона?
#4 И еще хотел спросить, какие модули можно сразу ставить на Drupal? (хотя наверно не в ту тему)

drupalpoisk.ru - поиск по русскоязычным Drupal ресурсам

Идея

Есть много сайтов с полезной информацией о Drupal. Лично я каждый раз добавляю "drupal"...
Поэтому мне удобнее настроить гугловский поиск и указать нужные сайты - это ускоряет работу.

Альтернативы

Можно использовать тулбар, который делал Вадим Барсуков для ФФ, но я в основном работаю в Опере, к тому же на этом тулбаре я почти ничего не использовал, кроме поиска...

Список сайтов, которые участвуют в поиске

• drupal.ru/* (Помощь, Документация)
• ibm.com/developerworks/ru/library/i-osource*/ (Документация)
• drupal.by/* (SEO)
• drupaler.ru/* (Перевод)
• drupalcookbook.ru/* (Рецепты, Помощь)
• setegnom.com/* (Сниппеты, Помощь)
• youweb.ru/* (Рецепты, Сниппеты)

Редактировать HANDBOOК может каждый

По состоянию на сегодня, 16 октября 2008 года, каждый пользователь, имеющий учетную запись на Drupal.org имеет возможность редактировать большую часть страниц руководства (подробности приводятся ниже). Уже сейчас все пользователи могут создавать новые страницы в справочниках; так что это расширяет возможность редактирования страниц, кроме тех, который вы создали. В прошлом это было разрешено только членам команды документации или команде поддержки сайта.

Данное нововведение установлено на испытательный срок в один месяц. В конце этого периода, 15 ноября 2008 года, документацию и сайт команды сопровождения можно будет оценить оцените, если оценка принесёт положительный результат то будет принято решение о внедрении этой возможности. В случае большого количества спама или фактов вандализма в справочнике, мы будем вынуждены отменить свободное редактирование. Если мы не будем уверены что можем принять решение о продлении испытательного срока через один месяц мы продлим этот срок, пока не сможем уверенно принять то или иное решение.

Аддисон Бэрри - новый лидер команды документирования Drupal

Сделал перевод статьи Dries Buytaert: Addison Berry new Drupal documentation team lead.
Перевод доступен по адресу: Бэрри Аддисон - новый лидер команды документирования Drupal

В течении нескольких последних лет Команду Документирования Друпал возглавлял Стивен Пек (Steven Peck) (sepeck). Стивен был лучшим, кто подходил на эту роль, и он сделал огромную работу. Не только потому, что он увеличил команду документирования, включив в нее множество талантливых и много работающих писателей-добровольцев, он контролировал реструктуризацию и реорганизацию Руководства в документации на Drupal.org, великолепно улучшив их структуру и доступность. Спасибо тебе, Стивен за большую работу!

Коллекция ресурсов для разработчиков под Drupal (Drupal Developer’s Toolbox)

В любимом мною вэб-журнале для вебмастеров появилась публикация Drupal Developer’s Toolbox.

Как сказано в предисловии, после опубликования WordPress Developer’s Toolbox появилось много запросов от разработчиков под Drupal с просьбой о предоставлении такой же подборки для этой все более популярной CMS/CMF.

Ознакомится можете сами http://www.smashingmagazine.com/2008/09/24/drupal-developers-toolbox/.

Для продвинутых - нового практически ничего нет, для начинающих и желающих углубиться - удобное подспорье.

Также вебмастерам рекомендую само издание. Постоянно нахожу там новое и интересное.