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

[smileonl]

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

[hookenful]

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

[k12th]

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

[krovatti]

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

[spmbt]

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

[krovatti]

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

[krovatti]

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

[k12th]

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

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

[Rome]

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

[k12th]

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

[krovatti]

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

[Rome]

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

[k12th]

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

[vmuha]

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

[ComodoHacker]

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

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

[akzhan]

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

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

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

[k12th]

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

[Sannis]

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

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

[Sannis]

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

[Sannis]

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

[k12th]

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

[Sorbing]

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

[krovatti]

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

[Sannis]

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

[kuzemchik]

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

[taliban]

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

[k12th]

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

[taliban]

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

[akzhan]

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

[maxvipon]

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

[Astralian]

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

[Mithgol]

Перевод:

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]

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

[cabeza]

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

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