From b94089182382553c5a411e9e4a38c79d54ff188d Mon Sep 17 00:00:00 2001 From: Vasily Polovnyov Date: Mon, 11 Feb 2013 16:48:06 +0400 Subject: [PATCH] typos in README.ru.md --- README.ru.md | 57 ++++++++++++++++++++++++++-------------------------- 1 file changed, 28 insertions(+), 29 deletions(-) diff --git a/README.ru.md b/README.ru.md index ee91cd65..8180381d 100644 --- a/README.ru.md +++ b/README.ru.md @@ -36,7 +36,7 @@ thin`. Thin — это более производительный и функц ## Маршруты -В Sinatra маршрут — это пара: и <шаблон URL>. Каждый маршрут +В Sinatra маршрут — это пара: <HTTP метод> и <шаблон URL>. Каждый маршрут связан с блоком кода: ```ruby @@ -68,7 +68,7 @@ end Маршруты сверяются с запросом в порядке очередности их записи в файле приложения. Первый же совпавший с запросом маршрут и будет вызван. -Шаблоны маршрутов могут включать в себя именованные параметры доступные в xэше +Шаблоны маршрутов могут включать в себя именованные параметры, доступные в xэше `params`: ```ruby @@ -88,7 +88,7 @@ end ```` Шаблоны маршрутов также могут включать в себя splat (или '*' маску, -обозначающую любой символ) параметры доступные в массиве `params[:splat]`: +обозначающую любой символ) параметры, доступные в массиве `params[:splat]`: ```ruby get '/say/*/to/*' do @@ -207,8 +207,8 @@ end Возвращаемое значение блока маршрута ограничивается телом ответа, которое будет передано HTTP клиенту, или следующей "прослойкой" (middleware) в Rack -стеке. Чаще всего это строка, как в примерах выше. Но и другие значения также -приемлемы. +стеке. Чаще всего это строка, как в примерах выше. Но также приемлемы и +другие значения. Вы можете вернуть любой объект, который будет либо корректным Rack ответом, объектом Rack body, либо кодом состояния HTTP: @@ -268,7 +268,7 @@ get all_but("/index") do end ``` -Заметьте, что предыдущий пример возможно чересчур усложнен, потому что он +Заметьте, что предыдущий пример, возможно, чересчур усложнен, потому что он может быть реализован так: ```ruby @@ -373,7 +373,7 @@ end
views
- Директория с шаблонами. По умолчанию: `settings.views`. + Директория с шаблонами. По умолчанию: settings.views.
layout
@@ -851,7 +851,7 @@ erb :overview, :locals => { :text => creole(:introduction) } Содержимое шаблона интерпретируется как код на Ruby, а результирующая -переменная json затем конвертируется с помощью #to_json. +переменная json затем конвертируется с помощью `#to_json`. ```ruby json = { :foo => 'bar' } @@ -1037,7 +1037,7 @@ end маршрута, то тело ответа не будет доступно в `after`-фильтрах, так как оно будет сгенерировано позднее. -Фильтры могут использовать шаблоны URL и будут интерпретированы только если +Фильтры могут использовать шаблоны URL и будут интерпретированы, только если путь запроса совпадет с этим шаблоном: ```ruby @@ -1297,7 +1297,7 @@ end Заметьте, что возможности стриминга, особенно количество одновременно обслуживаемых запросов, очень сильно зависят от используемого веб-сервера. -Некоторые сервера, например, WEBRick, могут и вовсе не поддерживать стриминг. +Некоторые серверы, например, WEBRick, могут и вовсе не поддерживать стриминг. Если сервер не поддерживает стриминг, то все данные будут отправлены за один раз сразу после того, как блок, переданный в `stream`, завершится. Стриминг вообще не работает при использовании Shotgun. @@ -1305,7 +1305,7 @@ end Если метод используется с параметром `keep_open`, то он не будет вызывать `close` у объекта потока, что позволит вам закрыть его позже в любом другом месте. Это работает только с событийными серверами, например, с Thin и -Rainbows. Другие же сервера все равно будут закрывать поток: +Rainbows. Другие же серверы все равно будут закрывать поток: ```ruby # long polling @@ -1394,7 +1394,7 @@ end ### Генерирование URL -Чтобы сформировать URL вам следует использовать метод `url`, например, в Haml: +Чтобы сформировать URL, вам следует использовать метод `url`, например, в Haml: ```ruby %a{:href => url('/foo')} foo @@ -1423,7 +1423,7 @@ redirect to('/bar'), 303 redirect 'http://google.com', 'wrong place, buddy' ``` -Вы также можете перенаправить пользователя обратно, на страницу с которой он +Вы также можете перенаправить пользователя обратно, на страницу, с которой он пришел, с помощью `redirect back`: ```ruby @@ -1511,7 +1511,7 @@ etag @article.sha1, :weak ``` Эти методы-помощники не станут ничего кэшировать для вас, но они дадут -необходимую информацию для вашего кэша. Если вы ищите легкое решение для +необходимую информацию для вашего кэша. Если вы ищете легкое решение для кэширования, попробуйте [rack-cache](https://github.com/rtomayko/rack-cache): ```ruby @@ -1594,7 +1594,7 @@ send_file 'foo.png', :type => :jpg Этот метод будет использовать возможности Rack сервера для отправки файлов, -если они доступны, а в противном случае, будет напрямую отдавать файл из Ruby +если они доступны, в противном случае будет напрямую отдавать файл из Ruby процесса. Метод `send_file` также обеспечивает автоматическую обработку частичных (range) запросов с помощью Sinatra. @@ -1636,7 +1636,7 @@ get '/foo' do end ``` -Некоторые опции, такие как `script_name` или `path_info` доступны для +Некоторые опции, такие как `script_name` или `path_info`, доступны для изменения: ```ruby @@ -1760,8 +1760,8 @@ end а вызывает заданный блок для всех возможных путей. Дело тут не в производительности, дело в том, что `render` вызовет `break`, как только файл не будет найден. Содержимое и местонахождение шаблонов будет закэшировано, -если приложение запущено не в режиме разработки (set :environment, -:development). Вы должны помнить об этих нюансах, если пишите по-настоящему +если приложение запущено не в режиме разработки (`set :environment, +:development`). Вы должны помнить об этих нюансах, если пишите по-настоящему "сумасшедший" метод. ## Конфигурация @@ -1905,9 +1905,8 @@ set :protection, :except => [:path_traversal, :session_hijacking]
method_override
- использовать "магический" параметр _method, чтобы позволить - использование PUT/DELETE форм в браузерах, которые не поддерживают эти - методы. + использовать "магический" параметр _method, для поддержки + PUT/DELETE форм в браузерах, которые не поддерживают эти методы.
port
@@ -1932,7 +1931,7 @@ set :protection, :except => [:path_traversal, :session_hijacking]
public_folder
путь к директории, откуда будут раздаваться статические файлы. - Используется только, если включена раздача статических файлов + Используется, только если включена раздача статических файлов (см. опцию static ниже).
@@ -1963,7 +1962,7 @@ set :protection, :except => [:path_traversal, :session_hijacking]
server
сервер или список серверов, которые следует использовать в качестве - встроенного сервера. По умолчанию: ['thin', 'mongrel', 'webrick'], порядок + встроенного сервера. По умолчанию: ['thin', 'mongrel', 'webrick'], порядок задает приоритет.
sessions
@@ -1993,7 +1992,7 @@ set :protection, :except => [:path_traversal, :session_hijacking]
когда Sinatra отдает статические файлы, используйте эту опцию, чтобы добавить им заголовок Cache-Control. Для этого используется - метод-помощник cache_control. По умолчанию отключено. + метод-помощник cache_control. По умолчанию отключено.
Используйте массив, когда надо задать несколько значений: @@ -2014,12 +2013,12 @@ set :protection, :except => [:path_traversal, :session_hijacking] Есть 3 предопределенных режима, окружения: `"development"`, `"production"` и `"test"`. Режим может быть задан через переменную окружения `RACK_ENV`. -Значение по умолчанию — `"development"`. В этом режиме работы, все шаблоны +Значение по умолчанию — `"development"`. В этом режиме работы все шаблоны перезагружаются между запросами. А также задаются специальные обработчики `not_found` и `error`, чтобы вы могли увидеть стек вызовов. В окружениях `"production"` и `"test"` шаблоны по умолчанию кэшируются. -Для запуска приложения в определенном окружении, используйте ключ `-e` +Для запуска приложения в определенном окружении используйте ключ `-e` ``` ruby my_app.rb -e [ENVIRONMENT] @@ -2262,7 +2261,7 @@ class MyApp < Sinatra::Base end ``` -И запускаем с помощью: +Затем: ``` ruby my_app.rb @@ -2525,7 +2524,7 @@ ruby myapp.rb [-h] [-x] [-e ENVIRONMENT] [-p PORT] [-o HOST] [-s HANDLER]
1.8.7 полностью поддерживается, тем не менее, если вас ничто не держит на этой версии, рекомендуем обновиться до 1.9.2 или перейти на JRuby или Rubinius. Поддержка 1.8.7 не будет прекращена до выхода Sinatra 2.0 и Ruby - 2.0, разве что в случае релиза 1.8.8 (что мало вероятно). Но даже тогда, + 2.0, разве что в случае релиза 1.8.8 (что маловероятно). Но даже тогда, возможно, поддержка не будет прекращена. Ruby 1.8.6 больше не поддерживается. Если вы хотите использовать 1.8.6, откатитесь до Sinatra 1.2, которая будет получать все исправления ошибок до тех пор, пока не @@ -2550,7 +2549,7 @@ ruby myapp.rb [-h] [-x] [-e ENVIRONMENT] [-p PORT] [-o HOST] [-s HANDLER]
JRuby
JRuby официально поддерживается (JRuby >= 1.6.5). Нет никаких проблем с использованием альтернативных шаблонов. Тем не менее, если вы выбираете - JRuby, то, пожалуйста, посмотрите на JRuby Rack-сервера, так как Thin не + JRuby, то, пожалуйста, посмотрите на JRuby Rack-серверы, так как Thin не поддерживается полностью на JRuby. Поддержка расширений на C в JRuby все еще экспериментальная, что на данный момент затрагивает только RDiscount, Redcarpet и RedCloth.