9 апреля 2012 в 14:05

Перевод официальной документации по Backbone.JS

Веб-разработка*, Open source*, JavaScript*

Доброго времени суток!

В полку Open Source прибыло! Мы (kulakowka, k12th, dhomich и я) рады представить вашему вниманию перевод официальной документации по Backbone.JS — каркасу для создания RIA приложений на JavaScript, автором которого является Jeremy Askenas — создатель CoffeeScript.

Хочется отметить всех участников проекта и выразить им огромную благодарность за проделанную работу. А именно:

kulakowka (Кулакову Антону) — автора идеи и идейного вдохновителя из ТМ;
k12th (Константина Китманова) — за активное участие в проекте, а также
dhomich (Дениса Хомича) — за любезно предоставленный домен по адресу backbonejs.ru, а также за участие в проекте.

Если вы заметите какие-либо ошибки или неточности и захотите внести поправку — пожалуйста, вы можете отправить pull-request в данную ветвь.

+119

431

krovatti –8,0

комментарии (48)

smileonl, 9 апреля 2012 в 14:18 #

Ура! Молодцы как раз сейчас сижу разбираюсь с Backbone.JS. Вы очень вовремя :)

hookenful, 9 апреля 2012 в 14:24 #

Парни, спасибо за работу. Добавил в избранное! Долго переводили?

k12th, 9 апреля 2012 в 14:42 #

↵

↑

Меньше недели по вечерам.

kulakowka, 9 апреля 2012 в 14:24 #

От себя хотелось бы добавить — это мой первый опыт подобной работы с Хабрасообществом. И опыт определенно позитивный. Проект реализован в кратчайшие сроки. Всего около недели. Я очень рад, что нашел единомышленников среди пользователей Хабра.

Так же, нужно упомянуть о проекте: http://underscorejs.ru/ который так же «попал под раздачу» :)

Спасибо коллеги. Надеюсь будем продолжать в том же духе и забабахаем чего ни будь вкусненького…

krovatti, 9 апреля 2012 в 14:30 #

↵

↑

Разумеется, будем. И на этот раз я к вам присоединюсь. =)

spmbt, 10 апреля 2012 в 18:22 #

↵

↑

Ещё неплохо knockoutJS разделать.

krovatti, 10 апреля 2012 в 23:46 #

↵

↑

Висит такой таск в ToDo. Если будет время, начну на выходных.

Alexeyco, 9 апреля 2012 в 14:34 #

Какое же вам спасибо… Лучи благодарности вам.

krovatti, 9 апреля 2012 в 14:39 #

↵

↑

И вам. Как благодарному читателю.

andybel, 9 апреля 2012 в 14:38 #

Я бы мог спросить, что это такое, но я не буду спрашивать:
1. «биндингами по ключу»
2. «богатым набором методов с перечислимыми сущностями»
3. «декларативной обработкой событий»
ну и так далее. Конечно, перевод сделали быстро.

Правда, кое что я всё таки понял: «REST-овым JSON API.»

kulakowka, 9 апреля 2012 в 14:44 #

↵

↑

Помогите нам сделать ее лучше :)

k12th, 9 апреля 2012 в 14:44 #

↵

↑

Никто не говорит, что перевод идеален. Знаете, как выразиться лучше — милости просим.

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

kulakowka, 9 апреля 2012 в 14:45 #

↵

↑

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

Rome, 9 апреля 2012 в 23:25 #

↵

↑

А бывает, что написано на хорошем английском, но автор решил вы#%ся и написать еще красивее. Оцените фразу (это буквальный перевод): «Уникальные URL-адреса основаны на прецедентах, установленных ранее в Apache и в HTTP серверах».
Сидишь, ломаешь голову, чем заменить эти «прецеденты».

k12th, 10 апреля 2012 в 02:10 #

↵

↑

Да, бывает такое:)

krovatti, 9 апреля 2012 в 14:45 #

↵

↑

Вы можете помочь проекту и внести свой вклад, если хотите. Никто не препятствует.

Rome, 9 апреля 2012 в 23:16 #

↵

↑

Я сейчас делаю перевод документации по Flask for Python. И я столкнулся с этой дилеммой. Либо переводить такие слова как «редирект», либо не переводить. С одной стороны новичкам, которые вчера узнали о компьютере, слово «редирект» абсолютно незнакомо. И для них, конечно, стоит переводить. Но для профессионалов слово «перенаправление» может показаться немного не понятным. Когда им говоришь «редирект» они сразу понимают о чем речь, у них большой опыт связан со словом «редирект».
А так как за Flask лучше браться людям с опытом, то я решил не переводить подобные слова.

k12th, 10 апреля 2012 в 02:11 #

↵

↑

Ну мы тоже, в общем. исходили из предпосылки, что человек, вчера начавший изучать JS, не полезет в Backbone.

vmuha, 10 апреля 2012 в 12:25 #

↵

↑

Думаю. в таком случае необходимо либо давать ссылку на википедию, либо создавать в пределах проекта словарь терминов.

ComodoHacker, 10 апреля 2012 в 01:30 #

↵

↑

> «биндингами по ключу»

«автопробегом по разгильдяйству»

akzhan, 9 апреля 2012 в 14:51 #

У меня только один вопрос:

Я не вижу исходных текстов документации. Неужели вы верстаете все в HTML?

Не проще ли было использовать Markdown, и затем конвертировать через Jekyll + Redcarpet, например?

k12th, 9 апреля 2012 в 15:08 #

↵

↑

В оригинальном репо не было никаких исходников.

Sannis, 9 апреля 2012 в 15:38 #

↵

↑

Они в исходнике библиотеки. Собирается документация так: github.com/documentcloud/backbone/blob/e4c7a79dc3a861b29f979fbecb21819cf3328ba1/Rakefile#L23

Резюме: было бы лучше перевести комментарии в backbone.js и из него генерить русскую документацию. А с HTML вы очень быстро устанете мержить изменения в оригинале.

andybel, 9 апреля 2012 в 15:43 #

↵

↑

Так как раз, в том числе для этого и разработан backbone.js с «REST-овым JSON API», что бы решать такие задачи.

kulakowka, 9 апреля 2012 в 15:44 #

↵

↑

Ну одно дело комментарии к исходному коду backbone.js, и другое дело страница с примерами и документацией.
Мы не планируем останавливаться на достигнутом. Поэтому рады любым советам. Спасибо за ваш отзыв. Подумаем как автоматизировать это дело :)

Sannis, 9 апреля 2012 в 15:56 #

↵

↑

Да, я смотрю они ССЗБ. Держать две версии параллельно не самое удачное для них решение.

Sannis, 9 апреля 2012 в 15:57 #

↵

↑

Две версии доки. По факту там HTML с документацией и них очень сильно повторяет комменты в коде. Но не идентичен.

kulakowka, 9 апреля 2012 в 16:04 #

↵

↑

Да. К тому же там примеров куча.

k12th, 9 апреля 2012 в 15:44 #

↵

↑

У меня такое ощущение, что мерджить изменения из backbone.js будет еще геморройнее.

Sorbing, 10 апреля 2012 в 00:03 #

↵

↑

Эта мысль мне пришла в голову около года назад, начал с jQuery. Как раз сейчас занимаюсь документацией Backbone и нативных методов JavaScript.
Проект для генерации документации запустил меньше недели назад, все допиливал то тут, то там.
Но раз «такие пироги» — выкладываю на общее рассмотрение, писать отдельный пост не придется).
http://xdoc.sectorit.net
Важно: «из коробки» правильно работает в Eclipse PDT + Spket 1.6.22. Другие IDE (PHPStorm, NetBeans) в процессе, так что возможно нужно будет поправить инициализацию объектов. Рад фидбекам и конструктивной критике.

krovatti, 10 апреля 2012 в 08:48 #

↵

↑

Ок, посмотрю на досуге.

Sannis, 9 апреля 2012 в 15:34 #

↵

↑

Дока по node.js v0.2 тоже была в HTML :)

kuzemchik, 9 апреля 2012 в 17:26 #

Молодцы! Хотя мне привычнее на оригинал, но все равно молодцы!)

taliban, 9 апреля 2012 в 17:58 #

Спасибо, но может все таки шрифт стоит поменять на нечто более стандартное?

kulakowka, 9 апреля 2012 в 18:05 #

↵

↑

а что это за ОС у вас? и браузер какой?

k12th, 9 апреля 2012 в 18:11 #

↵

↑

Предположительно, это FF под *nix. Там стандартный 'sans-serif'-шрифт вот какой-то такой.

taliban, 9 апреля 2012 в 18:17 #

↵

↑

У меня XP и такой шрифт в опере и в хроме. Да, так стало читабельней, но только вот шрифтпоменялся до: backbonejs.ru/#Sync =) Дальше так же как и было.

kulakowka, 9 апреля 2012 в 18:22 #

↵

↑

Кто то написал <tt/> вместе . Бывает. я поправил. Спасибо большое.

kulakowka, 9 апреля 2012 в 18:23 #

↵

↑

Блин… парсер схавал мой коммент.
В общем было

 <tt/>

а надо было

 </tt>

Видимо кто то ошибся, когда переводил текст.

kulakowka, 9 апреля 2012 в 18:07 #

↵

↑

поправил слегка. Заменил на Arial, sans-serif. Он думаю попривычней будет в большинстве ОС.

akzhan, 9 апреля 2012 в 19:15 #

↵

↑

Поставьте впереди Verdana, это более читабельно.

mgrach, 10 апреля 2012 в 12:37 #

↵

↑

Как-то наткнулся на статью безопасные шрифтовые стеки для рунета, но воспользоваться все забываю (: Может вам пригодиться

kulakowka, 10 апреля 2012 в 12:41 #

↵

↑

спасибо, пригодится.

Astralian, 10 апреля 2012 в 14:06 #

Пацаны вообще backbone!

–2

Mithgol, 10 апреля 2012 в 14:51 #

Перевод:

Backbone.js придаёт структуру веб-приложениям с помощью моделей с биндингами по ключу и пользовательскими событиями, коллекций с богатым набором методов с перечислимыми сущностями, представлений с декларативной обработкой событий; и соединяет это всё с вашим существующим REST-овым JSON API.

Первоисточник:

Backbone.js gives structure to web applications by providing models with key-value binding and custom events, collections with a rich API of enumerable functions, views with declarative event handling, and connects it all to your existing API over a RESTful JSON interface.

Стало быть, «existing API over a RESTful JSON interface» — это «существующий REST-овый JSON API», однако же «a rich API of enumerable functions» — это «богатый набор методов с перечислимыми сущностями»?

Значит, «key-value binding» — это «биндинг по ключу»?

Господа, я вас умоляю: пишите перевод так, как будто читать его будет склонный к насилию психопат, который знает, где вы живёте.

krovatti, 10 апреля 2012 в 17:06 #

↵

↑

Уважаемый. Вместо того, чтобы острить, вы могли бы помочь.

kulakowka, 10 апреля 2012 в 17:07 #

↵

↑

Мы будем рады, ежели вы соблаговолите принять участие в этом богоугодном начинании. Исходный код размещен на: github.

cabeza, 12 мая 2012 в 14:50 #

>Создание и уничтожение моделей теперь оптимистично.

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

Только зарегистрированные пользователи могут оставлять комментарии. Войдите, пожалуйста.