From abf2c659ab7db471eadc6ce9bf685ab0a121fcfa Mon Sep 17 00:00:00 2001 From: Iain Barnett Date: Mon, 4 Mar 2013 16:25:59 +0000 Subject: [PATCH 2/4] First convert. --- README.jp.rdoc | 1242 +++++++++++++++++++++++++----------------------- 1 file changed, 644 insertions(+), 598 deletions(-) diff --git a/README.jp.rdoc b/README.jp.rdoc index 1c407096..536db80e 100644 --- a/README.jp.rdoc +++ b/README.jp.rdoc @@ -1,131 +1,132 @@ -= Sinatra -注） 本文書は英語から翻訳したものであり、その内容が最新でない場合もあります。最新の情報はオリジナルの英語版を参照して下さい。 +# Sinatra -SinatraはRubyで下記のような最小労力で手早くウェブアプリケーションを作成するための{DSL}[http://ja.wikipedia.org/wiki/ドメイン固有言語]です。 +*注） +本文書は英語から翻訳したものであり、その内容が最新でない場合もあります。最新の情報はオリジナルの英語版を参照して下さい。* - # myapp.rb - require 'sinatra' - get '/' do - 'Hello world!' - end +[DSL](http://ja.wikipedia.org/wiki/ドメイン固有言語)です。 + + # myapp.rb + require 'sinatra' + get '/' do + 'Hello world!' + end gemをインストールして動かしてみる。 - gem install sinatra - ruby myapp.rb + gem install sinatra + ruby myapp.rb -http://localhost:4567 を見る。 +[localhost:4567](http://localhost:4567) を見る。 -== ルート +## ルート Sinatraでは、ルートはHTTPメソッドとURLマッチングパターンがペアになっています。 ルートはブロックに結び付けられています。 - get '/' do - .. 何か見せる .. - end + get '/' do + .. 何か見せる .. + end - post '/' do - .. 何か生成する .. - end + post '/' do + .. 何か生成する .. + end - put '/' do - .. 何か更新する .. - end + put '/' do + .. 何か更新する .. + end - delete '/' do - .. 何か削除する .. - end + delete '/' do + .. 何か削除する .. + end -ルートは定義された順番にマッチします。 リクエストに最初にマッチしたルートが呼び出されます。 +ルートは定義された順番にマッチします。 +リクエストに最初にマッチしたルートが呼び出されます。 ルートのパターンは名前付きパラメータを含むことができ、 -paramsハッシュで取得できます。 +`params`ハッシュで取得できます。 - get '/hello/:name' do - # matches "GET /hello/foo" and "GET /hello/bar" - # params[:name] is 'foo' or 'bar' - "Hello #{params[:name]}!" - end + get '/hello/:name' do + # matches "GET /hello/foo" and "GET /hello/bar" + # params[:name] is 'foo' or 'bar' + "Hello #{params[:name]}!" + end また、ブロックパラメータで名前付きパラメータにアクセスすることもできます。 - get '/hello/:name' do |n| - "Hello #{n}!" - end + get '/hello/:name' do |n| + "Hello #{n}!" + end ルートパターンはsplat(またはワイルドカード)を含むこともでき、 -params[:splat] で取得できます。 +`params[:splat]` で取得できます。 - get '/say/*/to/*' do - # matches /say/hello/to/world - params[:splat] # => ["hello", "world"] - end + get '/say/*/to/*' do + # matches /say/hello/to/world + params[:splat] # => ["hello", "world"] + end - get '/download/*.*' do - # matches /download/path/to/file.xml - params[:splat] # => ["path/to/file", "xml"] - end + get '/download/*.*' do + # matches /download/path/to/file.xml + params[:splat] # => ["path/to/file", "xml"] + end ブロックパラーメータを使用した場合: - get '/download/*.*' do |path, ext| - [path, ext] # => ["path/to/file", "xml"] - end + get '/download/*.*' do |path, ext| + [path, ext] # => ["path/to/file", "xml"] + end 正規表現を使ったルート: - get %r{/hello/([\w]+)} do - "Hello, #{params[:captures].first}!" - end + get %r{/hello/([\w]+)} do + "Hello, #{params[:captures].first}!" + end ブロックパラーメータを使用した場合: - get %r{/hello/([\w]+)} do |c| - "Hello, #{c}!" - end + get %r{/hello/([\w]+)} do |c| + "Hello, #{c}!" + end - -=== 条件 +### 条件 ルートにはユーザエージェントのようなさまざまな条件を含めることができます。 - get '/foo', :agent => /Songbird (\d\.\d)[\d\/]*?/ do - "You're using Songbird version #{params[:agent][0]}" - end + get '/foo', :agent => /Songbird (\d\.\d)[\d\/]*?/ do + "You're using Songbird version #{params[:agent][0]}" + end - get '/foo' do - # Matches non-songbird browsers - end + get '/foo' do + # Matches non-songbird browsers + end -ほかに+host_name+と+provides+条件が利用可能です: +ほかに`host_name`と`provides`条件が利用可能です: - get '/', :host_name => /^admin\./ do - "Admin Area, Access denied!" - end + get '/', :host_name => /^admin\./ do + "Admin Area, Access denied!" + end - get '/', :provides => 'html' do - haml :index - end - - get '/', :provides => ['rss', 'atom', 'xml'] do - builder :feed - end + get '/', :provides => 'html' do + haml :index + end + + get '/', :provides => ['rss', 'atom', 'xml'] do + builder :feed + end 独自の条件を定義することも簡単にできます: - set(:probability) { |value| condition { rand <= value } } - - get '/win_a_car', :probability => 0.1 do - "You won!" - end - - get '/win_a_car' do - "Sorry, you lost." - end + set(:probability) { |value| condition { rand <= value } } + get '/win_a_car', :probability => 0.1 do + "You won!" + end -=== 戻り値 + get '/win_a_car' do + "Sorry, you lost." + end + +### 戻り値 ルートブロックの戻り値は、HTTPクライアントまたはRackスタックでの次のミドルウェアに渡されるレスポンスボディを決定します。 @@ -134,10 +135,15 @@ Sinatraでは、ルートはHTTPメソッドとURLマッチングパターンが Rackレスポンス、Rackボディオブジェクト、HTTPステータスコードのいずれかとして 妥当なオブジェクトであればどのようなオブジェクトでも返すことができます: -* 3要素の配列: [ステータス(Fixnum), ヘッダ(Hash), レスポンスボディ(#eachに応答する)] -* 2要素の配列: [ステータス(Fixnum), レスポンスボディ(#eachに応答する)] -* #eachに応答し、与えられたブロックに文字列を渡すオブジェクト -* ステータスコードを表現するFixnum +- 3要素の配列: + `[ステータス(Fixnum), ヘッダ(Hash), レスポンスボディ(#eachに応答する)]` + +- 2要素の配列: + `[ステータス(Fixnum), レスポンスボディ(#eachに応答する)]` + +- `#each`に応答し、与えられたブロックに文字列を渡すオブジェクト + +- ステータスコードを表現するFixnum そのように、例えばストリーミングの例を簡単に実装することができます: @@ -149,698 +155,706 @@ Rackレスポンス、Rackボディオブジェクト、HTTPステータスコ get('/') { Stream.new } +## 静的ファイル -== 静的ファイル +静的ファイルは`./public`ディレクトリから配信されます。 +`:public_folder`オプションを指定することで別の場所を指定することができます。 -静的ファイルは./publicディレクトリから配信されます。 -:public_folderオプションを指定することで別の場所を指定することができます。 - - set :public_folder, File.dirname(__FILE__) + '/static' + set :public_folder, File.dirname(__FILE__) + '/static' 注意: この静的ファイル用のディレクトリ名はURL中に含まれません。 -例えば、./public/css/style.cssはhttp://example.com/css/style.cssでアクセスできます。 +例えば、`./public/css/style.css`は`http://example.com/css/style.css`でアクセスできます。 -== ビュー / テンプレート +## ビュー / テンプレート -テンプレートは./viewsディレクトリ下に配置されています。 +テンプレートは`./views`ディレクトリ下に配置されています。 他のディレクトリを使用する場合の例: - set :views, File.dirname(__FILE__) + '/templates' + set :views, File.dirname(__FILE__) + '/templates' テンプレートはシンボルを使用して参照させることを覚えておいて下さい。 -サブデレクトリでもこの場合は:'subdir/template'のようにします。 +サブデレクトリでもこの場合は`:'subdir/template'`のようにします。 レンダリングメソッドは文字列が渡されると、そのまま文字列を出力します。 -=== Haml テンプレート +### Haml テンプレート hamlを使うにはhamlライブラリが必要です: - # hamlを読み込みます - require 'haml' + # hamlを読み込みます + require 'haml' - get '/' do - haml :index - end + get '/' do + haml :index + end -./views/index.hamlを表示します。 +`./views/index.haml`を表示します。 -{Haml's options}[http://haml.info/docs/yardoc/file.HAML_REFERENCE.html#options] -はSinatraの設定でグローバルに設定することができます。 -{Options and Configurations}[http://www.sinatrarb.com/configuration.html], +[Haml’s +options](http://haml.info/docs/yardoc/file.HAML_REFERENCE.html#options) +はSinatraの設定でグローバルに設定することができます。 [Options and +Configurations](http://www.sinatrarb.com/configuration.html), を参照してそれぞれ設定を上書きして下さい。 - set :haml, {:format => :html5 } # デフォルトのフォーマットは:xhtml + set :haml, {:format => :html5 } # デフォルトのフォーマットは:xhtml - get '/' do - haml :index, :haml_options => {:format => :html4 } # 上書き - end + get '/' do + haml :index, :haml_options => {:format => :html4 } # 上書き + end +### Erb テンプレート -=== Erb テンプレート + # erbを読み込みます + require 'erb' - # erbを読み込みます - require 'erb' + get '/' do + erb :index + end - get '/' do - erb :index - end +`./views/index.erb`を表示します。 -./views/index.erbを表示します。 - -=== Erubis +### Erubis erubisテンプレートを表示するには、erubisライブラリが必要です: - # erubisを読み込みます - require 'erubis' + # erubisを読み込みます + require 'erubis' - get '/' do - erubis :index - end + get '/' do + erubis :index + end -./views/index.erubisを表示します。 +`./views/index.erubis`を表示します。 -=== Builder テンプレート +### Builder テンプレート builderを使うにはbuilderライブラリが必要です: - # builderを読み込みます - require 'builder' + # builderを読み込みます + require 'builder' - get '/' do - builder :index - end + get '/' do + builder :index + end -./views/index.builderを表示します。 +`./views/index.builder`を表示します。 -=== 鋸 テンプレート +### 鋸 テンプレート 鋸を使うには鋸ライブラリが必要です: - # 鋸を読み込みます - require 'nokogiri' + # 鋸を読み込みます + require 'nokogiri' - get '/' do - nokogiri :index - end + get '/' do + nokogiri :index + end -./views/index.nokogiriを表示します。 +`./views/index.nokogiri`を表示します。 -=== Sass テンプレート +### Sass テンプレート Sassテンプレートを使うにはsassライブラリが必要です: - # hamlかsassを読み込みます - require 'sass' + # hamlかsassを読み込みます + require 'sass' - get '/stylesheet.css' do - sass :stylesheet - end + get '/stylesheet.css' do + sass :stylesheet + end -./views/stylesheet.sassを表示します。 +`./views/stylesheet.sass`を表示します。 -{Sass' options}[http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#options] -はSinatraの設定でグローバルに設定することができます。 -see {Options and Configurations}[http://www.sinatrarb.com/configuration.html], +[Sass’ +options](http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#options) +はSinatraの設定でグローバルに設定することができます。 see [Options and +Configurations](http://www.sinatrarb.com/configuration.html), を参照してそれぞれ設定を上書きして下さい。 - set :sass, {:style => :compact } # デフォルトのSass styleは :nested + set :sass, {:style => :compact } # デフォルトのSass styleは :nested - get '/stylesheet.css' do - sass :stylesheet, :sass_options => {:style => :expanded } # 上書き - end + get '/stylesheet.css' do + sass :stylesheet, :sass_options => {:style => :expanded } # 上書き + end -=== Scss テンプレート +### Scss テンプレート Scssテンプレートを使うにはsassライブラリが必要です: - # hamlかsassを読み込みます - require 'sass' + # hamlかsassを読み込みます + require 'sass' - get '/stylesheet.css' do - scss :stylesheet - end + get '/stylesheet.css' do + scss :stylesheet + end -./views/stylesheet.scssを表示します。 +`./views/stylesheet.scss`を表示します。 -{Sass' options}[http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#options] -はSinatraの設定でグローバルに設定することができます。 -see {Options and Configurations}[http://www.sinatrarb.com/configuration.html], +[Sass’ +options](http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#options) +はSinatraの設定でグローバルに設定することができます。 see [Options and +Configurations](http://www.sinatrarb.com/configuration.html), を参照してそれぞれ設定を上書きして下さい。 - set :scss, :style => :compact # デフォルトのScss styleは:nested + set :scss, :style => :compact # デフォルトのScss styleは:nested - get '/stylesheet.css' do - scss :stylesheet, :style => :expanded # 上書き - end + get '/stylesheet.css' do + scss :stylesheet, :style => :expanded # 上書き + end -=== Less テンプレート +### Less テンプレート Lessテンプレートを使うにはlessライブラリが必要です: - # lessを読み込みます - require 'less' + # lessを読み込みます + require 'less' - get '/stylesheet.css' do - less :stylesheet - end + get '/stylesheet.css' do + less :stylesheet + end -./views/stylesheet.lessを表示します。 +`./views/stylesheet.less`を表示します。 -=== Liquid テンプレート +### Liquid テンプレート Liquidテンプレートを使うにはliquidライブラリが必要です: - # liquidを読み込みます - require 'liquid' + # liquidを読み込みます + require 'liquid' - get '/' do - liquid :index - end + get '/' do + liquid :index + end -./views/index.liquidを表示します。 +`./views/index.liquid`を表示します。 -LiquidテンプレートからRubyのメソッド(+yield+を除く)を呼び出すことができないため、 +LiquidテンプレートからRubyのメソッド(`yield`を除く)を呼び出すことができないため、 ほぼ全ての場合にlocalsを指定する必要があるでしょう: - liquid :index, :locals => { :key => 'value' } + liquid :index, :locals => { :key => 'value' } -=== Markdown テンプレート +### Markdown テンプレート Markdownテンプレートを使うにはrdiscountライブラリが必要です: - # rdiscountを読み込みます - require "rdiscount" - - get '/' do - markdown :index - end + # rdiscountを読み込みます + require "rdiscount" -./views/index.markdownを表示します。(+md+と+mkd+も妥当な拡張子です) + get '/' do + markdown :index + end + +`./views/index.markdown`を表示します。(`md`と`mkd`も妥当な拡張子です) markdownからメソッドを呼び出すことも、localsに変数を渡すこともできません。 それゆえ、他のレンダリングエンジンとの組み合わせで使うのが普通です: - erb :overview, :locals => { :text => markdown(:introduction) } + erb :overview, :locals => { :text => markdown(:introduction) } 他のテンプレートからmarkdownメソッドを呼び出してもよいことに注意してください: - %h1 Hello From Haml! - %p= markdown(:greetings) + %h1 Hello From Haml! + %p= markdown(:greetings) -=== Textile テンプレート +### Textile テンプレート Textileテンプレートを使うにはRedClothライブラリが必要です: - # redclothを読み込みます - require "redcloth" + # redclothを読み込みます + require "redcloth" - get '/' do - textile :index - end + get '/' do + textile :index + end -./views/index.textileを表示します。 +`./views/index.textile`を表示します。 textileからメソッドを呼び出すことも、localsに変数を渡すこともできません。 それゆえ、他のレンダリングエンジンとの組み合わせで使うのが普通です: - erb :overview, :locals => { :text => textile(:introduction) } + erb :overview, :locals => { :text => textile(:introduction) } 他のテンプレートからtextileメソッドを呼び出してもよいことに注意してください: - %h1 Hello From Haml! - %p= textile(:greetings) + %h1 Hello From Haml! + %p= textile(:greetings) -=== RDoc テンプレート +### RDoc テンプレート RDocテンプレートを使うにはRDocライブラリが必要です: - # rdoc/markup/to_htmlを読み込みます - require "rdoc" - require "rdoc/markup/to_html" + # rdoc/markup/to_htmlを読み込みます + require "rdoc" + require "rdoc/markup/to_html" - get '/' do - rdoc :index - end + get '/' do + rdoc :index + end -./views/index.rdocを表示します。 +`./views/index.rdoc`を表示します。 rdocからメソッドを呼び出すことも、localsに変数を渡すこともできません。 それゆえ、他のレンダリングエンジンとの組み合わせで使うのが普通です: - erb :overview, :locals => { :text => rdoc(:introduction) } + erb :overview, :locals => { :text => rdoc(:introduction) } 他のテンプレートからrdocメソッドを呼び出してもよいことに注意してください: - %h1 Hello From Haml! - %p= rdoc(:greetings) + %h1 Hello From Haml! + %p= rdoc(:greetings) -=== Radius テンプレート +### Radius テンプレート Radiusテンプレートを使うにはradiusライブラリが必要です: - # radiusを読み込みます - require 'radius' + # radiusを読み込みます + require 'radius' - get '/' do - radius :index - end + get '/' do + radius :index + end -./views/index.radiusを表示します。 +`./views/index.radius`を表示します。 -RadiusテンプレートからRubyのメソッド(+yield+を除く)を呼び出すことができないため、 +RadiusテンプレートからRubyのメソッド(`yield`を除く)を呼び出すことができないため、 ほぼ全ての場合にlocalsを指定する必要があるでしょう: - radius :index, :locals => { :key => 'value' } + radius :index, :locals => { :key => 'value' } -=== Markaby テンプレート +### Markaby テンプレート Markabyテンプレートを使うにはmarkabyライブラリが必要です: - # markabyを読み込みます - require 'markaby' + # markabyを読み込みます + require 'markaby' - get '/' do - markaby :index - end + get '/' do + markaby :index + end -./views/index.mabを表示します。 +`./views/index.mab`を表示します。 -=== RABL テンプレート +### RABL テンプレート RABLテンプレートを使うにはrablライブラリが必要です: - # rablを読み込みます - require 'rabl' + # rablを読み込みます + require 'rabl' - get '/' do - rabl :index - end + get '/' do + rabl :index + end -./views/index.rablを表示します。 +`./views/index.rabl`を表示します。 -=== Slim テンプレート +### Slim テンプレート Slimテンプレートを使うにはslimライブラリが必要です: - # slimを読み込みます - require 'slim' + # slimを読み込みます + require 'slim' - get '/' do - slim :index - end + get '/' do + slim :index + end -./views/index.slimを表示します。 +`./views/index.slim`を表示します。 -=== Creole テンプレート +### Creole テンプレート Creoleテンプレートを使うにはcreoleライブラリが必要です: - # creoleを読み込みます - require 'creole' + # creoleを読み込みます + require 'creole' - get '/' do - creole :index - end + get '/' do + creole :index + end -./views/index.creoleを表示します。 +`./views/index.creole`を表示します。 -=== CoffeeScript テンプレート +### CoffeeScript テンプレート -CoffeeScriptテンプレートを表示するにはcoffee-scriptライブラリと`coffee`バイナリが必要です: +CoffeeScriptテンプレートを表示するにはcoffee-scriptライブラリと\`coffee\`バイナリが必要です: - # coffee-scriptを読み込みます - require 'coffee-script' + # coffee-scriptを読み込みます + require 'coffee-script' - get '/application.js' do - coffee :application - end + get '/application.js' do + coffee :application + end -./views/application.coffeeを表示します。 +`./views/application.coffee`を表示します。 -=== インラインテンプレート +### インラインテンプレート - get '/' do - haml '%div.title Hello World' - end + get '/' do + haml '%div.title Hello World' + end 文字列をテンプレートとして表示します。 -=== テンプレート内で変数にアクセスする +### テンプレート内で変数にアクセスする -テンプレートはルートハンドラと同じコンテキストの中で評価されます。. ルートハンドラでセットされたインスタンス変数は +テンプレートはルートハンドラと同じコンテキストの中で評価されます。. +ルートハンドラでセットされたインスタンス変数は テンプレート内で直接使うことができます。 - get '/:id' do - @foo = Foo.find(params[:id]) - haml '%h1= @foo.name' - end + get '/:id' do + @foo = Foo.find(params[:id]) + haml '%h1= @foo.name' + end ローカル変数を明示的に定義することもできます。 - get '/:id' do - foo = Foo.find(params[:id]) - haml '%h1= foo.name', :locals => { :foo => foo } - end + get '/:id' do + foo = Foo.find(params[:id]) + haml '%h1= foo.name', :locals => { :foo => foo } + end このやり方は他のテンプレート内で部分テンプレートとして表示する時に典型的に使用されます。 -=== ファイル内テンプレート +### ファイル内テンプレート テンプレートはソースファイルの最後で定義することもできます。 - require 'rubygems' - require 'sinatra' + require 'rubygems' + require 'sinatra' - get '/' do - haml :index - end + get '/' do + haml :index + end - __END__ + __END__ - @@ layout - %html - = yield + @@ layout + %html + = yield - @@ index - %div.title Hello world!!!!! + @@ index + %div.title Hello world!!!!! -注意: sinatraをrequireするファイル内で定義されたファイル内テンプレートは自動的に読み込まれます。 -他のファイルで定義されているテンプレートを使うには enable :inline_templatesを明示的に呼んでください。 +注意: +sinatraをrequireするファイル内で定義されたファイル内テンプレートは自動的に読み込まれます。 +他のファイルで定義されているテンプレートを使うには +`enable :inline_templates`を明示的に呼んでください。 -=== 名前付きテンプレート +### 名前付きテンプレート -テンプレートはトップレベルのtemplateメソッドで定義することができます。 +テンプレートはトップレベルの`template`メソッドで定義することができます。 - template :layout do - "%html\n =yield\n" - end + template :layout do + "%html\n =yield\n" + end - template :index do - '%div.title Hello World!' - end + template :index do + '%div.title Hello World!' + end - get '/' do - haml :index - end + get '/' do + haml :index + end 「layout」というテンプレートが存在する場合、そのテンプレートファイルは他のテンプレートが -表示される度に使用されます。:layout => falseすることでlayoutsを無効にできます。 +表示される度に使用されます。`:layout => false`することでlayoutsを無効にできます。 - get '/' do - haml :index, :layout => !request.xhr? - end + get '/' do + haml :index, :layout => !request.xhr? + end -== ヘルパー +## ヘルパー -トップレベルのhelpersを使用してルートハンドラやテンプレートで使うヘルパメソッドを +トップレベルの`helpers`を使用してルートハンドラやテンプレートで使うヘルパメソッドを 定義できます。 - helpers do - def bar(name) - "#{name}bar" + helpers do + def bar(name) + "#{name}bar" + end end - end - get '/:name' do - bar(params[:name]) - end + get '/:name' do + bar(params[:name]) + end -== フィルタ +## フィルタ beforeフィルタはリクエストされたコンテキストを実行する前に評価され、 リクエストとレスポンスを変更することができます。フィルタ内でセットされた インスタンス変数はルーティングとテンプレートで使用できます。 - before do - @note = 'Hi!' - request.path_info = '/foo/bar/baz' - end + before do + @note = 'Hi!' + request.path_info = '/foo/bar/baz' + end - get '/foo/*' do - @note #=> 'Hi!' - params[:splat] #=> 'bar/baz' - end + get '/foo/*' do + @note #=> 'Hi!' + params[:splat] #=> 'bar/baz' + end afterフィルタは同じコンテキストにあるリクエストの後に評価され、 同じくリクエストとレスポンスを変更することができます。 beforeフィルタとルートで設定されたインスタンス変数は、 afterフィルタからアクセスすることができます: - after do - puts response.status - end + after do + puts response.status + end フィルタにはオプションとしてパターンを渡すことができ、 この場合はリクエストのパスがパターンにマッチした場合のみフィルタが評価されます: - before '/protected/*' do - authenticate! - end + before '/protected/*' do + authenticate! + end - after '/create/:slug' do |slug| - session[:last_slug] = slug - end + after '/create/:slug' do |slug| + session[:last_slug] = slug + end -== 強制終了 +## 強制終了 ルートかbeforeフィルタ内で直ちに実行を終了する方法: - halt + halt ステータスを指定することができます: - halt 410 + halt 410 -body部を指定することもできます ... +body部を指定することもできます … - halt 'ここにbodyを書く' + halt 'ここにbodyを書く' -ステータスとbody部を指定する ... +ステータスとbody部を指定する … - halt 401, '立ち去れ!' + halt 401, '立ち去れ!' ヘッダを指定: - halt 402, {'Content-Type' => 'text/plain'}, 'リベンジ' + halt 402, {'Content-Type' => 'text/plain'}, 'リベンジ' -== パッシング(Passing) +## パッシング(Passing) -ルートはpassを使って次のルートに飛ばすことができます: +ルートは`pass`を使って次のルートに飛ばすことができます: - get '/guess/:who' do - pass unless params[:who] == 'Frank' - "見つかっちゃった!" - end + get '/guess/:who' do + pass unless params[:who] == 'Frank' + "見つかっちゃった!" + end - get '/guess/*' do - "はずれです!" - end + get '/guess/*' do + "はずれです!" + end ルートブロックからすぐに抜け出し、次にマッチするルートを実行します。 マッチするルートが見当たらない場合は404が返されます。 -== リクエストオブジェクトへのアクセス +## リクエストオブジェクトへのアクセス -受信するリクエストオブジェクトは、`request`メソッドを通じてリクエストレベル(フィルタ、ルート、エラーハンドラ)からアクセスすることができます: +受信するリクエストオブジェクトは、\`request\`メソッドを通じてリクエストレベル(フィルタ、ルート、エラーハンドラ)からアクセスすることができます: - # アプリケーションが http://example.com/example で動作している場合 - get '/foo' do - request.body # クライアントによって送信されたリクエストボディ(下記参照) - request.scheme # "http" - request.script_name # "/example" - request.path_info # "/foo" - request.port # 80 - request.request_method # "GET" - request.query_string # "" - request.content_length # request.bodyの長さ - request.media_type # request.bodyのメディアタイプ - request.host # "example.com" - request.get? # true (他の動詞についても同様のメソッドあり) - request.form_data? # false - request["SOME_HEADER"] # SOME_HEADERヘッダの値 - request.referer # クライアントのリファラまたは'/' - request.user_agent # ユーザエージェント (:agent 条件によって使用される) - request.cookies # ブラウザクッキーのハッシュ - request.xhr? # Ajaxリクエストかどうか - request.url # "http://example.com/example/foo" - request.path # "/example/foo" - request.ip # クライアントのIPアドレス - request.secure? # false - request.env # Rackによって渡された生のenvハッシュ - end + # アプリケーションが http://example.com/example で動作している場合 + get '/foo' do + request.body # クライアントによって送信されたリクエストボディ(下記参照) + request.scheme # "http" + request.script_name # "/example" + request.path_info # "/foo" + request.port # 80 + request.request_method # "GET" + request.query_string # "" + request.content_length # request.bodyの長さ + request.media_type # request.bodyのメディアタイプ + request.host # "example.com" + request.get? # true (他の動詞についても同様のメソッドあり) + request.form_data? # false + request["SOME_HEADER"] # SOME_HEADERヘッダの値 + request.referer # クライアントのリファラまたは'/' + request.user_agent # ユーザエージェント (:agent 条件によって使用される) + request.cookies # ブラウザクッキーのハッシュ + request.xhr? # Ajaxリクエストかどうか + request.url # "http://example.com/example/foo" + request.path # "/example/foo" + request.ip # クライアントのIPアドレス + request.secure? # false + request.env # Rackによって渡された生のenvハッシュ + end -script_nameやpath_infoなどのオプションは次のように利用することもできます: +`script_name`や`path_info`などのオプションは次のように利用することもできます: - before { request.path_info = "/" } - - get "/" do - "全てのリクエストはここに来る" - end + before { request.path_info = "/" } -request.bodyはIOまたはStringIOのオブジェクトです: + get "/" do + "全てのリクエストはここに来る" + end - post "/api" do - request.body.rewind # 既に読まれているときのため - data = JSON.parse request.body.read - "Hello #{data['name']}!" - end +`request.body`はIOまたはStringIOのオブジェクトです: + post "/api" do + request.body.rewind # 既に読まれているときのため + data = JSON.parse request.body.read + "Hello #{data['name']}!" + end -== 設定 +## 設定 どの環境でも起動時に１回だけ実行されます。 - configure do - ... - end + configure do + ... + end -環境(RACK_ENV環境変数)が:productionに設定されている時だけ実行する方法: +環境(RACK\_ENV環境変数)が`:production`に設定されている時だけ実行する方法: - configure :production do - ... - end + configure :production do + ... + end -環境が:productionか:testの場合に設定する方法: +環境が`:production`か`:test`の場合に設定する方法: - configure :production, :test do - ... - end + configure :production, :test do + ... + end -== エラーハンドリング +## エラーハンドリング エラーハンドラーはルートコンテキストとbeforeフィルタ内で実行します。 -haml、erb、haltなどを使うこともできます。 +`haml`、`erb`、`halt`などを使うこともできます。 -=== Not Found +### Not Found -Sinatra::NotFoundが起きた時か レスポンスのステータスコードが -404の時にnot_foundハンドラーが発動します。 +`Sinatra::NotFound`が起きた時か レスポンスのステータスコードが +404の時に`not_found`ハンドラーが発動します。 - not_found do - 'ファイルが存在しません' - end + not_found do + 'ファイルが存在しません' + end -=== エラー +### エラー -+error+ ハンドラーはルートブロックかbeforeフィルタ内で例外が発生した時はいつでも発動します。 -例外オブジェクトはRack変数sinatra.errorから取得できます。 +`error` +ハンドラーはルートブロックかbeforeフィルタ内で例外が発生した時はいつでも発動します。 +例外オブジェクトはRack変数`sinatra.error`から取得できます。 - error do - 'エラーが発生しました。 - ' + env['sinatra.error'].name - end + error do + 'エラーが発生しました。 - ' + env['sinatra.error'].name + end エラーをカスタマイズする場合は、 - error MyCustomError do - 'エラーメッセージ...' + env['sinatra.error'].message - end + error MyCustomError do + 'エラーメッセージ...' + env['sinatra.error'].message + end と書いておいて,下記のように呼び出します。 - get '/' do - raise MyCustomError, '何かがまずかったようです' - end + get '/' do + raise MyCustomError, '何かがまずかったようです' + end そうするとこうなります: - エラーメッセージ... 何かがまずかったようです + エラーメッセージ... 何かがまずかったようです あるいは、ステータスコードに対応するエラーハンドラを設定することもできます: - error 403 do - 'Access forbidden' - end + error 403 do + 'Access forbidden' + end - get '/secret' do - 403 - end + get '/secret' do + 403 + end 範囲指定もできます: - error 400..510 do - 'Boom' - end + error 400..510 do + 'Boom' + end - -開発環境として実行している場合、Sinatraは特別なnot_foundとerrorハンドラーを +開発環境として実行している場合、Sinatraは特別な`not_found`と`error`ハンドラーを インストールしています。 -== MIMEタイプ +## MIMEタイプ -send_fileか静的ファイルを使う時、Sinatraが理解でいないMIMEタイプがある場合があります。 -その時は +mime_type+ を使ってファイル拡張子毎に登録して下さい。 +`send_file`か静的ファイルを使う時、Sinatraが理解でいないMIMEタイプがある場合があります。 +その時は `mime_type` を使ってファイル拡張子毎に登録して下さい。 - mime_type :foo, 'text/foo' + mime_type :foo, 'text/foo' -これはcontent_typeヘルパで利用することができます: +これはcontent\_typeヘルパで利用することができます: - content_type :foo + content_type :foo -== Rackミドルウェア +## Rackミドルウェア -SinatraはRack[http://rack.rubyforge.org/]というRubyのWEBフレームワーク用の -最小限の標準インターフェース 上で動作しています。Rack中でもアプリケーションデベロッパー +[SinatraはRack](http://rack.rubyforge.org/)フレームワーク用の +最小限の標準インターフェース +上で動作しています。Rack中でもアプリケーションデベロッパー 向けに一番興味深い機能はミドルウェア(サーバとアプリケーション間に介在し、モニタリング、HTTPリクエストとレスポンス の手動操作ができるなど、一般的な機能のいろいろなことを提供するもの)をサポートすることです。 -Sinatraではトップレベルの+use+ メソッドを使ってRackにパイプラインを構築します。 +Sinatraではトップレベルの`use` +メソッドを使ってRackにパイプラインを構築します。 - require 'sinatra' - require 'my_custom_middleware' + require 'sinatra' + require 'my_custom_middleware' - use Rack::Lint - use MyCustomMiddleware + use Rack::Lint + use MyCustomMiddleware - get '/hello' do - 'Hello World' - end + get '/hello' do + 'Hello World' + end -use の意味は{Rack::Builder}[http://rack.rubyforge.org/doc/classes/Rack/Builder.html] DSLで定義されていることと全て一致します。 -例えば +use+ メソッドはブロック構文のように複数の引数を受け取ることができます。 +`use` +[Rack::Builder](http://rack.rubyforge.org/doc/classes/Rack/Builder.html) +DSLで定義されていることと全て一致します。 例えば `use` +メソッドはブロック構文のように複数の引数を受け取ることができます。 - use Rack::Auth::Basic do |username, password| - username == 'admin' && password == 'secret' - end + use Rack::Auth::Basic do |username, password| + username == 'admin' && password == 'secret' + end Rackはログ、デバッギング、URLルーティング、認証、セッションなどいろいろな機能を備えた標準的ミドルウェアです。 -Sinatraはその多くのコンポーネントを自動で使うよう基本設定されているため、+use+で明示的に指定する必要はありません。 +Sinatraはその多くのコンポーネントを自動で使うよう基本設定されているため、`use`で明示的に指定する必要はありません。 -== テスト +## テスト SinatraでのテストはRack-basedのテストライブラリかフレームワークを使って書くことができます。 -{Rack::Test}[http://gitrdoc.com/brynary/rack-test] をおすすめします。やり方: +[Rack::Test](http://gitrdoc.com/brynary/rack-test) +をおすすめします。やり方: - require 'my_sinatra_app' - require 'rack/test' + require 'my_sinatra_app' + require 'rack/test' - class MyAppTest < Test::Unit::TestCase - include Rack::Test::Methods + class MyAppTest < Test::Unit::TestCase + include Rack::Test::Methods - def app - Sinatra::Application + def app + Sinatra::Application + end + + def test_my_default + get '/' + assert_equal 'Hello World!', last_response.body + end + + def test_with_params + get '/meet', :name => 'Frank' + assert_equal 'Hello Frank!', last_response.body + end + + def test_with_rack_env + get '/', {}, 'HTTP_USER_AGENT' => 'Songbird' + assert_equal "あなたはSongbirdを使ってますね!", last_response.body + end end - def test_my_default - get '/' - assert_equal 'Hello World!', last_response.body - end - - def test_with_params - get '/meet', :name => 'Frank' - assert_equal 'Hello Frank!', last_response.body - end - - def test_with_rack_env - get '/', {}, 'HTTP_USER_AGENT' => 'Songbird' - assert_equal "あなたはSongbirdを使ってますね!", last_response.body - end - end - 注意: ビルトインのSinatra::TestモジュールとSinatra::TestHarnessクラスは 0.9.2リリース以降、廃止予定になっています。 -== Sinatra::Base - ミドルウェア、ライブラリ、 モジュラーアプリ +## Sinatra::Base - ミドルウェア、ライブラリ、 モジュラーアプリ トップレベル(グローバル領域)上でいろいろ定義していくのは軽量アプリならうまくいきますが、 RackミドルウェアやRails metal、サーバのコンポーネントを含んだシンプルな @@ -848,96 +862,104 @@ RackミドルウェアやRails metal、サーバのコンポーネントを含 トップレベルのDSLがネームスペースを汚染したり、設定を変えてしまうこと(例:./publicや./view)がありえます。 そこでSinatra::Baseの出番です。 - require 'sinatra/base' + require 'sinatra/base' - class MyApp < Sinatra::Base - set :sessions, true - set :foo, 'bar' + class MyApp < Sinatra::Base + set :sessions, true + set :foo, 'bar' - get '/' do - 'Hello world!' + get '/' do + 'Hello world!' + end end - end このMyAppは独立したRackコンポーネントで、RackミドルウェアやRackアプリケーション -Rails metalとして使用することができます。config.ruファイル内で +use+ か、または -+run+ でこのクラスを指定するか、ライブラリとしてサーバコンポーネントをコントロールします。 +Rails metalとして使用することができます。`config.ru`ファイル内で `use` +か、または `run` +でこのクラスを指定するか、ライブラリとしてサーバコンポーネントをコントロールします。 - MyApp.run! :host => 'localhost', :port => 9090 + MyApp.run! :host => 'localhost', :port => 9090 Sinatra::Baseのサブクラスで使えるメソッドはトップレベルのDSLを経由して確実に使うことができます。 ほとんどのトップレベルで記述されたアプリは、以下の２点を修正することでSinatra::Baseコンポーネントに変えることができます。 -* +sinatra+の代わりにsinatra/baseを読み込む -(そうしない場合、SinatraのDSLメソッドの全てがメインネームスペースにインポートされます) -* ルート、エラーハンドラー、フィルター、オプションをSinatra::Baseのサブクラスに書く +- `sinatra`の代わりに`sinatra/base`を読み込む -Sinatra::Base はまっさらです。ビルトインサーバを含む、ほとんどのオプションがデフォルト -で無効になっています。オプション詳細については{Options and Configuration}[http://sinatra.github.com/configuration.html] +(そうしない場合、SinatraのDSLメソッドの全てがメインネームスペースにインポートされます) + +- ルート、エラーハンドラー、フィルター、オプションをSinatra::Baseのサブクラスに書く + +`Sinatra::Base` +はまっさらです。ビルトインサーバを含む、ほとんどのオプションがデフォルト +で無効になっています。オプション詳細については[Options and +Configuration](http://sinatra.github.com/configuration.html) をご覧下さい。 -補足: SinatraのトップレベルDSLはシンプルな委譲(delgation)システムで実装されています。 -Sinatra::Applicationクラス(Sinatra::Baseの特別なサブクラス)は、トップレベルに送られる -:get、 :put、 :post、:delete、 :before、:error、:not_found、 :configure、:set messagesのこれら -全てを受け取ります。 詳細を閲覧されたい方はこちら(英語): -{Sinatra::Delegator mixin}[http://github.com/sinatra/sinatra/blob/master/lib/sinatra/base.rb#L1064] -{included into the main namespace}[http://github.com/sinatra/sinatra/blob/master/lib/sinatra/main.rb#L25]. +補足: +SinatraのトップレベルDSLはシンプルな委譲(delgation)システムで実装されています。 +`Sinatra::Application`クラス(Sinatra::Baseの特別なサブクラス)は、トップレベルに送られる +:get、 :put、 :post、:delete、 :before、:error、:not\_found、 +:configure、:set messagesのこれら 全てを受け取ります。 +詳細を閲覧されたい方はこちら(英語): [Sinatra::Delegator +mixin](http://github.com/sinatra/sinatra/blob/master/lib/sinatra/base.rb#L1064) +[included into the main +namespace](http://github.com/sinatra/sinatra/blob/master/lib/sinatra/main.rb#L25). -=== Sinatraをミドルウェアとして利用する +### Sinatraをミドルウェアとして利用する Sinatraは他のRackミドルウェアを利用することができるだけでなく、 全てのSinatraアプリケーションは、それ自体ミドルウェアとして別のRackエンドポイントの前に追加することが可能です。 -このエンドポイントには、別のSinatraアプリケーションまたは他のRackベースのアプリケーション(Rails/Ramaze/Camping/...)が用いられるでしょう。 +このエンドポイントには、別のSinatraアプリケーションまたは他のRackベースのアプリケーション(Rails/Ramaze/Camping/…)が用いられるでしょう。 - require 'sinatra/base' - - class LoginScreen < Sinatra::Base - enable :sessions - - get('/login') { haml :login } - - post('/login') do - if params[:name] = 'admin' and params[:password] = 'admin' - session['user_name'] = params[:name] - else - redirect '/login' + require 'sinatra/base' + + class LoginScreen < Sinatra::Base + enable :sessions + + get('/login') { haml :login } + + post('/login') do + if params[:name] = 'admin' and params[:password] = 'admin' + session['user_name'] = params[:name] + else + redirect '/login' + end end end - end - - class MyApp < Sinatra::Base - # middleware will run before filters - use LoginScreen - - before do - unless session['user_name'] - halt "Access denied, please login." - end - end - - get('/') { "Hello #{session['user_name']}." } - end -== スコープとバインディング + class MyApp < Sinatra::Base + # middleware will run before filters + use LoginScreen + + before do + unless session['user_name'] + halt "Access denied, please login." + end + end + + get('/') { "Hello #{session['user_name']}." } + end + +## スコープとバインディング 現在のスコープはどのメソッドや変数が利用可能かを決定します。 -=== アプリケーション/クラスのスコープ +### アプリケーション/クラスのスコープ 全てのSinatraアプリケーションはSinatra::Baseのサブクラスに相当します。 -もしトップレベルDSLを利用しているならば(require 'sinatra')このクラスはSinatra::Applicationであり、 +もしトップレベルDSLを利用しているならば(`require 'sinatra'`)このクラスはSinatra::Applicationであり、 そうでなければ、あなたが明示的に作成したサブクラスです。 -クラスレベルでは`get`や`before`のようなメソッドを持っています。 -しかし`request`オブジェクトや`session`には、全てのリクエストのために1つのアプリケーションクラスが存在するためアクセスできません。 +クラスレベルでは\`get\`や\`before\`のようなメソッドを持っています。 +しかし\`request\`オブジェクトや\`session\`には、全てのリクエストのために1つのアプリケーションクラスが存在するためアクセスできません。 -`set`によって作られたオプションはクラスレベルのメソッドです: +\`set\`によって作られたオプションはクラスレベルのメソッドです: class MyApp < Sinatra::Base # Hey, I'm in the application scope! set :foo, 42 foo # => 42 - + get '/foo' do # Hey, I'm no longer in the application scope! end @@ -945,112 +967,136 @@ Sinatraは他のRackミドルウェアを利用することができるだけで 次の場所ではアプリケーションスコープバインディングを持ちます: -* アプリケーションのクラス本体 -* 拡張によって定義されたメソッド -* `helpers`に渡されたブロック -* `set`の値として使われるProcまたはブロック +- アプリケーションのクラス本体 + +- 拡張によって定義されたメソッド + +- \`helpers\`に渡されたブロック + +- \`set\`の値として使われるProcまたはブロック このスコープオブジェクト(クラス)は次のように利用できます: -* configureブロックに渡されたオブジェクト経由(configure { |c| ... }) -* リクエストスコープの中での`settings` +- configureブロックに渡されたオブジェクト経由(`configure { |c| ... }`) -=== リクエスト/インスタンスのスコープ +- リクエストスコープの中での\`settings\` + +### リクエスト/インスタンスのスコープ やってくるリクエストごとに、あなたのアプリケーションクラスの新しいインスタンスが作成され、全てのハンドラブロックがそのスコープで実行されます。 -このスコープの内側からは`request`や`session`オブジェクトにアクセスすることができ、`erb`や`haml`のような表示メソッドを呼び出すことができます。 -リクエストスコープの内側からは、`settings`ヘルパによってアプリケーションスコープにアクセスすることができます。 +このスコープの内側からは\`request\`や\`session\`オブジェクトにアクセスすることができ、\`erb\`や\`haml\`のような表示メソッドを呼び出すことができます。 +リクエストスコープの内側からは、\`settings\`ヘルパによってアプリケーションスコープにアクセスすることができます。 - class MyApp < Sinatra::Base - # Hey, I'm in the application scope! - get '/define_route/:name' do - # Request scope for '/define_route/:name' - @value = 42 - - settings.get("/#{params[:name]}") do - # Request scope for "/#{params[:name]}" - @value # => nil (not the same request) + class MyApp < Sinatra::Base + # Hey, I'm in the application scope! + get '/define_route/:name' do + # Request scope for '/define_route/:name' + @value = 42 + + settings.get("/#{params[:name]}") do + # Request scope for "/#{params[:name]}" + @value # => nil (not the same request) + end + + "Route defined!" end - - "Route defined!" end - end 次の場所ではリクエストスコープバインディングを持ちます: -* get/head/post/put/delete ブロック -* before/after フィルタ -* helper メソッド -* テンプレート/ビュー +- get/head/post/put/delete ブロック -=== デリゲートスコープ +- before/after フィルタ + +- helper メソッド + +- テンプレート/ビュー + +### デリゲートスコープ デリゲートスコープは、単にクラススコープにメソッドを転送します。 しかしながら、クラスのバインディングを持っていないため、クラススコープと全く同じふるまいをするわけではありません: -委譲すると明示的に示されたメソッドのみが利用可能であり、またクラススコープと変数/状態を共有することはできません(注: 異なった`self`を持っています)。 -Sinatra::Delegator.delegate :method_nameを呼び出すことによってデリゲートするメソッドを明示的に追加することができます。 +委譲すると明示的に示されたメソッドのみが利用可能であり、またクラススコープと変数/状態を共有することはできません(注: +異なった\`self\`を持っています)。 +`Sinatra::Delegator.delegate :method_name`を呼び出すことによってデリゲートするメソッドを明示的に追加することができます。 次の場所ではデリゲートスコープを持ちます: -* もしrequire "sinatra"しているならば、トップレベルバインディング -* `Sinatra::Delegator` mixinでextendされたオブジェクト +- もし`require "sinatra"`しているならば、トップレベルバインディング -コードをご覧ください: ここでは -{Sinatra::Delegator mixin}[http://github.com/sinatra/sinatra/blob/ceac46f0bc129a6e994a06100aa854f606fe5992/lib/sinatra/base.rb#L1128] -は{main 名前空間にincludeされています}[http://github.com/sinatra/sinatra/blob/ceac46f0bc129a6e994a06100aa854f606fe5992/lib/sinatra/main.rb#L28]. +- \`Sinatra::Delegator\` mixinでextendされたオブジェクト -== コマンドライン +コードをご覧ください: ここでは [Sinatra::Delegator +mixin](http://github.com/sinatra/sinatra/blob/ceac46f0bc129a6e994a06100aa854f606fe5992/lib/sinatra/base.rb#L1128) +は[main +名前空間にincludeされています](http://github.com/sinatra/sinatra/blob/ceac46f0bc129a6e994a06100aa854f606fe5992/lib/sinatra/main.rb#L28). + +## コマンドライン Sinatraアプリケーションは直接実行できます。 - ruby myapp.rb [-h] [-x] [-e ENVIRONMENT] [-p PORT] [-o HOST] [-s HANDLER] + ruby myapp.rb [-h] [-x] [-e ENVIRONMENT] [-p PORT] [-o HOST] [-s HANDLER] オプション: - -h # ヘルプ - -p # ポート指定(デフォルトは4567) - -o # ホスト指定(デフォルトは0.0.0.0) - -e # 環境を指定 (デフォルトはdevelopment) - -s # rackserver/handlerを指定 (デフォルトはthin) - -x # mutex lockを付ける (デフォルトはoff) + -h # ヘルプ + -p # ポート指定(デフォルトは4567) + -o # ホスト指定(デフォルトは0.0.0.0) + -e # 環境を指定 (デフォルトはdevelopment) + -s # rackserver/handlerを指定 (デフォルトはthin) + -x # mutex lockを付ける (デフォルトはoff) -== 最新開発版について +## 最新開発版について Sinatraの開発版を使いたい場合は、ローカルに開発版を落として、 -LOAD_PATHのsinatra/libディレクトリを指定して実行して下さい。 +`LOAD_PATH`の`sinatra/lib`ディレクトリを指定して実行して下さい。 - cd myapp - git clone git://github.com/sinatra/sinatra.git - ruby -Isinatra/lib myapp.rb + cd myapp + git clone git://github.com/sinatra/sinatra.git + ruby -Isinatra/lib myapp.rb -sinatra/libディレクトリをアプリケーションのLOAD_PATHに追加する方法もあります。 +`sinatra/lib`ディレクトリをアプリケーションの`LOAD_PATH`に追加する方法もあります。 - $LOAD_PATH.unshift File.dirname(__FILE__) + '/sinatra/lib' - require 'rubygems' - require 'sinatra' + $LOAD_PATH.unshift File.dirname(__FILE__) + '/sinatra/lib' + require 'rubygems' + require 'sinatra' - get '/about' do - "今使ってるバージョンは" + Sinatra::VERSION - end + get '/about' do + "今使ってるバージョンは" + Sinatra::VERSION + end Sinatraのソースを更新する方法: - cd myproject/sinatra - git pull + cd myproject/sinatra + git pull -== その他 +## その他 日本語サイト -* {Greenbear Laboratory Rack日本語マニュアル}[http://mono.kmc.gr.jp/~yhara/w/?RackReferenceJa] - Rackの日本語マニュアル +- [Greenbear Laboratory + Rack日本語マニュアル](http://mono.kmc.gr.jp/~yhara/w/?RackReferenceJa) + - Rackの日本語マニュアル 英語サイト -* {プロジェクトサイト}[http://sinatra.github.com/] - ドキュメント、 - ニュース、他のリソースへのリンクがあります。 -* {プロジェクトに参加(貢献)する}[http://sinatra.github.com/contributing.html] - バグレポート - パッチの送信、サポートなど -* {Issue tracker}[http://github.com/sinatra/sinatra/issues] - チケット管理とリリース計画 -* {Twitter}[http://twitter.com/sinatra] -* {メーリングリスト}[http://groups.google.com/group/sinatrarb] -* {IRC: #sinatra}[irc://chat.freenode.net/#sinatra] on http://freenode.net +- [プロジェクトサイト](http://sinatra.github.com/) - ドキュメント、 + ニュース、他のリソースへのリンクがあります。 + +- [プロジェクトに参加(貢献)する](http://sinatra.github.com/contributing.html) + - バグレポート パッチの送信、サポートなど + +- [Issue tracker](http://github.com/sinatra/sinatra/issues) - + チケット管理とリリース計画 + +- [Twitter](http://twitter.com/sinatra) + +- [メーリングリスト](http://groups.google.com/group/sinatrarb) + +- [IRC: \#sinatra](irc://chat.freenode.net/#sinatra) on + [freenode.net](http://freenode.net) + +[[Validate]](http://validator.w3.org/check/referer) + +Generated with the [Darkfish Rdoc +Generator](http://deveiate.org/projects/Darkfish-Rdoc/) 2. From 783c8b7b7be37ca0c1770a96ac849ce69c527408 Mon Sep 17 00:00:00 2001 From: Iain Barnett Date: Mon, 4 Mar 2013 16:27:22 +0000 Subject: [PATCH 3/4] Change extension. --- README.jp.rdoc => README.jp.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename README.jp.rdoc => README.jp.md (100%) diff --git a/README.jp.rdoc b/README.jp.md similarity index 100% rename from README.jp.rdoc rename to README.jp.md From 59246557b5b8e4fb8a5c7a29019c4f3a2c3910b0 Mon Sep 17 00:00:00 2001 From: Iain Barnett Date: Mon, 4 Mar 2013 16:43:12 +0000 Subject: [PATCH 4/4] Removed bit of unneeded RDoc stuff at bottom. --- README.jp.md | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/README.jp.md b/README.jp.md index 536db80e..fca0f762 100644 --- a/README.jp.md +++ b/README.jp.md @@ -1094,9 +1094,4 @@ Sinatraのソースを更新する方法: - [メーリングリスト](http://groups.google.com/group/sinatrarb) - [IRC: \#sinatra](irc://chat.freenode.net/#sinatra) on - [freenode.net](http://freenode.net) - -[[Validate]](http://validator.w3.org/check/referer) - -Generated with the [Darkfish Rdoc -Generator](http://deveiate.org/projects/Darkfish-Rdoc/) 2. + [freenode.net](http://freenode.net) \ No newline at end of file