krovatti Apr 9 2012 at 14:05

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

1 min

9.9K

Website development*Open source*JavaScript*

+119

Comments 48

smileonl Apr 9 2012 at 14:18

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

hookenful Apr 9 2012 at 14:24

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

k12th Apr 9 2012 at 14:42

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

UFO just landed and posted this here

krovatti Apr 9 2012 at 14:30

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

spmbt Apr 10 2012 at 18:22

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

krovatti Apr 10 2012 at 23:46

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

UFO just landed and posted this here

krovatti Apr 9 2012 at 14:39

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

UFO just landed and posted this here

k12th Apr 9 2012 at 14:44

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

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

UFO just landed and posted this here

Rome Apr 9 2012 at 23:25

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

k12th Apr 10 2012 at 02:10

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

krovatti Apr 9 2012 at 14:45

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

Rome Apr 9 2012 at 23:16

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

k12th Apr 10 2012 at 02:11

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

vmuha Apr 10 2012 at 12:25

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

ComodoHacker Apr 10 2012 at 01:30

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

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

akzhan Apr 9 2012 at 14:51

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

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

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

k12th Apr 9 2012 at 15:08

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

Sannis Apr 9 2012 at 15:38

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

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

UFO just landed and posted this here

Sannis Apr 9 2012 at 15:56

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

Sannis Apr 9 2012 at 15:57

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

UFO just landed and posted this here

k12th Apr 9 2012 at 15:44

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

Sorbing Apr 10 2012 at 00:03

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

krovatti Apr 10 2012 at 08:48

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

Sannis Apr 9 2012 at 15:34

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

kuzemchik Apr 9 2012 at 17:26

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

taliban Apr 9 2012 at 17:58

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

UFO just landed and posted this here

k12th Apr 9 2012 at 18:11

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

taliban Apr 9 2012 at 18:17

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

UFO just landed and posted this here

akzhan Apr 9 2012 at 19:15

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

maxvipon Apr 10 2012 at 12:37

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

UFO just landed and posted this here

Astralian Apr 10 2012 at 14:06

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

Mithgol Apr 10 2012 at 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» — это «биндинг по ключу»?

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

-2

krovatti Apr 10 2012 at 17:06

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

UFO just landed and posted this here

cabeza May 12 2012 at 14:50

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

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

Show the best of all time