Comments 48
Ура! Молодцы как раз сейчас сижу разбираюсь с Backbone.JS. Вы очень вовремя :)
UFO landed and left these words here
UFO landed and left these words here
UFO landed and left these words here
UFO landed and left these words here
Никто не говорит, что перевод идеален. Знаете, как выразиться лучше — милости просим.

Если честно, там и оригинал не блестящий, и подыскивать вразумительные русские эквиваленты не всегда было легко.
UFO landed and left these words here
А бывает, что написано на хорошем английском, но автор решил вы#%ся и написать еще красивее. Оцените фразу (это буквальный перевод): «Уникальные URL-адреса основаны на прецедентах, установленных ранее в Apache и в HTTP серверах».
Сидишь, ломаешь голову, чем заменить эти «прецеденты».
Вы можете помочь проекту и внести свой вклад, если хотите. Никто не препятствует.
Я сейчас делаю перевод документации по Flask for Python. И я столкнулся с этой дилеммой. Либо переводить такие слова как «редирект», либо не переводить. С одной стороны новичкам, которые вчера узнали о компьютере, слово «редирект» абсолютно незнакомо. И для них, конечно, стоит переводить. Но для профессионалов слово «перенаправление» может показаться немного не понятным. Когда им говоришь «редирект» они сразу понимают о чем речь, у них большой опыт связан со словом «редирект».
А так как за Flask лучше браться людям с опытом, то я решил не переводить подобные слова.
Ну мы тоже, в общем. исходили из предпосылки, что человек, вчера начавший изучать JS, не полезет в Backbone.
Думаю. в таком случае необходимо либо давать ссылку на википедию, либо создавать в пределах проекта словарь терминов.
У меня только один вопрос:

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

Не проще ли было использовать Markdown, и затем конвертировать через Jekyll + Redcarpet, например?
Они в исходнике библиотеки. Собирается документация так: github.com/documentcloud/backbone/blob/e4c7a79dc3a861b29f979fbecb21819cf3328ba1/Rakefile#L23

Резюме: было бы лучше перевести комментарии в backbone.js и из него генерить русскую документацию. А с HTML вы очень быстро устанете мержить изменения в оригинале.
UFO landed and left these words here
UFO landed and left these words here
Да, я смотрю они ССЗБ. Держать две версии параллельно не самое удачное для них решение.
Две версии доки. По факту там HTML с документацией и них очень сильно повторяет комменты в коде. Но не идентичен.
UFO landed and left these words here
У меня такое ощущение, что мерджить изменения из backbone.js будет еще геморройнее.
Эта мысль мне пришла в голову около года назад, начал с jQuery. Как раз сейчас занимаюсь документацией Backbone и нативных методов JavaScript.
Проект для генерации документации запустил меньше недели назад, все допиливал то тут, то там.
Но раз «такие пироги» — выкладываю на общее рассмотрение, писать отдельный пост не придется).
http://xdoc.sectorit.net
Важно: «из коробки» правильно работает в Eclipse PDT + Spket 1.6.22. Другие IDE (PHPStorm, NetBeans) в процессе, так что возможно нужно будет поправить инициализацию объектов. Рад фидбекам и конструктивной критике.
Спасибо, но может все таки шрифт стоит поменять на нечто более стандартное?
Piccy.info - Free Image Hosting
UFO landed and left these words here
Предположительно, это FF под *nix. Там стандартный 'sans-serif'-шрифт вот какой-то такой.
У меня XP и такой шрифт в опере и в хроме. Да, так стало читабельней, но только вот шрифтпоменялся до: backbonejs.ru/#Sync =) Дальше так же как и было.
UFO landed and left these words here
UFO landed and left these words here
UFO landed and left these words here
UFO landed and left these words here
Перевод:
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» — это «биндинг по ключу»?

Господа, я вас умоляю: пишите перевод так, как будто читать его будет склонный к насилию психопат, который знает, где вы живёте.
UFO landed and left these words here
>Создание и уничтожение моделей теперь оптимистично.

Сходу не придумаю вариант получше, но дословный перевод выглядит коряво.
Only those users with full accounts are able to leave comments. Log in, please.