Новый сайт API и конкурс переводчиков

Аватар пользователя neochief neochief 18 июня 2009 в 16:23

Итак, рад представить обновленную версию сайта api.drupal.ru. В этой версии были внесены кардинальные изменения к лучшему в процесс использования и перевода материалов:

  • Полностью изменен дизайн сайта, сделан упор на минимализм и улучшения типографики.
  • Появилась возможность оставлять комментарии к материалам.
  • Появился полнотекстовый поиск в дополнению к поиску по индексу.
  • Появилась возможность быстро просматривать оригинал.
  • Появился индекс вызовов функций темизации (былостало) и хуков (былостало). Это дает возможность понять где именно они вызываются, так как вызовы этих функций и хуков непрямые.
  • Перевод теперь осуществляется посредством интерфейса редактирования ноды, что облегчает и делает гибче сам перевод.
  • Появились ревизии и модерация переводов.
  • Появился рейтинг и топ переводчиков.
  • Переведенные материалы теперь подсвечиваются в списках. Это позволяет проще ориентироваться пользователям, а переводчикам доставляет магическое удовольствие от озеленения сайта.
  • Здесь, на drupal.ru, обворачивание кода тегом <code> теперь подсвечивает функции и делает ссылки на сайт русского API, например:
    function theme() {
      static $hooks = NULL;
      if (!isset($hooks)) {
        init_theme();
        $hooks = theme_get_registry();
      }
    }

Летний конкурс для переводчиков

Прежде всего, я бы хотел сказать пару слов о мотивации. Вопрос звучит так — «Зачем мне что-нибудь переводить?». На этот вопрос у меня есть парочка ответов:

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

Начиная с сегодняшнего дня (18 июня 2009) и до 1 августа проводится конкурс на перевод пяти самых восстребованных разделов документации:

Пять самых результативных переводчиков получат каждый по новенькой и блестящей Pro Drupal Development (или другой, если эта у него уже есть).

С чего начать?

Лучше всего начать с помощи по сайту. Там подробно описано как пользоваться сайтом, как делать переводы и т.д. Не забудьте также посетить раздел Трудности перевода.

Вот моя личная стратегия, которая позволяет, с одной стороны — переводить, с другой — не тратить для этого слишком много времени:

  • Если я помогаю кому-то на форуме, и тыкаю его в апи, я это апи и перевожу, если требуется. Таким образом, переводится сперва только нужное.
  • Сначала я перевожу документацию для шестерки. В принципе, этого достаточно, но в большинстве случаев, я перевожу еще и версию для пятерки, так как различий между версиями не так много и выходит если не тупой копи-паст, то еще что-то удалить, так как в пятерке функционала, параметров и т.д. заведомо меньше. Такой простой финт повышает мой рейтинг в два раза.
  • Если я прихожу на сайт по работе, я перевожу все, что мне понадобилось, так как это понадобится в будущем не только мне.
  • Есть довольно важных вещей, которые не входят в категории. Такие важные вещи можно найти в топе использования функций.

И напоследок...

...будут очень кстати ваши пожертвования. Сайт является плодом моей личной инициативы, и если api.drupal.ru помог вам или вашей компании в вашем профессиональном росте, вы в полном праве пожертвовать несколько (5, 10, 20, 100) WMZ в фонд конкурса и инициативы, который находится в кошельке Z739117869357 (или R126614819988).

0 Thanks

Комментарии

Аватар пользователя EllECTRONC EllECTRONC 18 июня 2009 в 17:30
"neochief" wrote:

Полностью изменен дизайн сайта, сделан упор на минимализм и улучшения типографики.

дизайн хороший, «упор» удался.
Блок входа в систему это модуль или просто AJAX подгружали?

Аватар пользователя neochief neochief 18 июня 2009 в 20:53
"RxB" wrote:

Только WMZ принимаются?

Лучше только их, или другие WM*. Все остальное, несколько не в почете у нас здесь. Ели ну ооочень хочется, можно воспользоваться обменником Smile

Аватар пользователя neochief neochief 18 июня 2009 в 21:05
"EllECTRONC" wrote:

Блок входа в систему это модуль или просто AJAX подгружали?

Quick-and-dirty:

function bonus_form_alter(&$form, $form_state, $form_id) {
  if ($form_id == 'user_login_block') {
    $form['#suffix'] = "<script type=\"text/javascript\">$('#user-login-form').parents('.blockinner').children('h2').wrapInner('<a class=\"ajax\" href=\"#\"></a>').click(function(){
      $(this).siblings('.content').slideToggle();
      return false;
    });
    if (!$('#user-login-form input.error').length) {
      $('#user-login-form').parents('.blockinner').children('.content').css('display', 'none');
    }</script>"
;
  }
}

Почему в хуке сразу же под формой, а не на лоад? Чтобы не мелькало.

Аватар пользователя neochief neochief 18 июня 2009 в 21:53
"RxB" wrote:

Да я собственно насчёт WMR кошелька интересовался

R126614819988 (добавил в материал)

Аватар пользователя wanders.32 wanders.32 19 июня 2009 в 15:54

хорошо, и приятненький дизайн, и информация доступнее отображается, имхо, в этом варианте.
было - стало - разница ну очень заметна в сторону api.drupal.ru Smile

Аватар пользователя cosmos cosmos 19 июня 2009 в 21:26

честно говоря неудобно стало, особенно поле поиска
постаьте его выше вкладок
* Drupal 5 * Drupal 6

будет намного удобнее

Аватар пользователя PVasili PVasili 21 июня 2009 в 13:04

IMHO было бы полезно фильтр по функциям выложить в паблик. Многие в своих блогах бы использовали.

Аватар пользователя Virr Virr 23 июня 2009 в 7:04

Отличнейший сайт. Достойная помощь в изучении API. Огромное спасибо.

Аватар пользователя xenos xenos 26 июня 2009 в 10:38

Хороший сайт...
Очень понравился поиск..
набираешь hook_ и аяксом все хуки показываются...

Аватар пользователя neochief neochief 30 июня 2009 в 3:21
"Demimurych" wrote:

В одном месте одни отступы в другом другие.

Вся конкретная критика учитывается.

Аватар пользователя Demimurych Demimurych 30 июня 2009 в 12:59
"neochief" wrote:

Вся конкретная критика учитывается.

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

Аватар пользователя Grey Teardrop Grey Teardrop 30 июня 2009 в 19:17

Хочу сказать спасибо за сайт. Читать в самом деле намного приятнее, чем оригинал Smile

Есть пара небольших замечаний:

  1. На заглавной странице ссылки под заголовком «Примеры модулей» ведут на версии для 5-го Друпала.
  2. Не знаю, возможно это так и нужно: на этой же странице в разделе «Отдельные обсуждения» нет ссылок на “Forms API Quickstart Guide”, “JavaScript Startup Guide” и “Drupal Programming from an Object-Oriented Perspective”, как в оригинале.
  3. Это наверняка субъективно: иногда интервал между абзацами кажется слишком большим.
Аватар пользователя neochief neochief 30 июня 2009 в 19:51
"Grey Teardrop" wrote:

На заглавной странице ссылки под заголовком «Примеры модулей» ведут на версии для 5-го Друпала.

Поправил

"Grey Teardrop" wrote:

Не знаю, возможно это так и нужно: на этой же странице в разделе «Отдельные обсуждения» нет ссылок на “Forms API Quickstart Guide”, “JavaScript Startup Guide” и “Drupal Programming from an Object-Oriented Perspective”, как в оригинале.

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

Grey Teardrop
Да, и спасибо за переводы вам лично. Вы один из тех немногих, кто не боится переводить объемные разделы доков.

Аватар пользователя EllECTRONC EllECTRONC 30 июня 2009 в 21:38
"neochief" wrote:

Здесь, на drupal.ru, обворачивание кода тегом <code> теперь подсвечивает функции и делает ссылки на сайт русского API

угу, дак вот почему <code> стал подсвечиват текст...
для подсветки синтаксиса друпала есть <code lang="drupal5"> и <code lang="drupal6">, а теперь у нас везде все раскрашивается Sad

Аватар пользователя neochief neochief 30 июня 2009 в 22:54

Повальное большинство не использовало подсветку по назначению, потому как не видели этого выбора или просто было лень протянуть мышку на 50 пикселей вниз в списке, поэтому и было выставлено подсвечивать по-умолчанию. Чтобы не иметь подсветку вообще, сделайте lang="abc" в аттрибуте и все будет ок (согласен, это стоит поместить в буэдитор).

Аватар пользователя direqtor direqtor 2 июля 2009 в 5:07

Я бы еще добавил просьбу писать на API комменты с примерами кода для функций из топика. Тут даже переводчиком быть не надо. Иногда три строчки кода намного понятнее, чем любое словесное описание. Мне такой стиль всегда очень на php.net нравился. Если что-то не доезжаешь из доков – внизу всё расписано.

Аватар пользователя EllECTRONC EllECTRONC 2 июля 2009 в 19:40
"neochief" wrote:

Чтобы не иметь подсветку вообще, сделайте lang="abc" в аттрибуте и все будет ок (согласен, это стоит поместить в буэдитор).

надо, значит надо. не вопрос добавляйте, если есть доступ.

"direqtor" wrote:

Я бы еще добавил просьбу писать на API комменты с примерами кода для функций из топика.

+1000, тоже такая мысль приходила, это было бы [color=#FF0000]о[/color][color=#FF9900]о[/color][color=#FFFF00]о[/color][color=#33CC00]о[/color][color=#33CCFF]о[/color][color=#3333FF]о[/color][color=#6666CC]о[/color]чень (пародия на «goooogle») кстати Smile

Аватар пользователя Sky Cat Sky Cat 25 августа 2009 в 18:31

А можно немного не в тему спросить?
Подскажите пожалуйста, какой модуль используется на api.drupal.ru для вывода сниппетов с подсказками?
Там примерно такой текст выводится:
Требуется твоя помощь с переводом материалов сайта. Всем переводчикам — респект и уважуха.