Permalink
Browse files

Merge commit 'zukunftsalick/master'

  • Loading branch information...
2 parents f42c385 + 9144e7b commit fb933679be8fa181117423a54523b942309584aa @tapajos tapajos committed Jun 9, 2008
View
Binary file not shown.
@@ -1,3 +1,3 @@
#ActionView
-O ActionView é a camada responsável pela geração da interface visível ao usuário através da conversão dos templates ERB.
+ActionView is the layer responsible by the generation of the viewable interface visible to users through conversion of ERB templates.
@@ -1,18 +1,18 @@
## ActionView::Helpers::FormHelper
-### fields\_for form\_for com a opção index.
+### fields\_for form\_for with index option.
-Os métodos **#fields\_for** e **form\_for** receberam a opção **:index**, removendo a necessidade de usar o **:index => nil** em cada objeto do formulário. Veja os exemplos:
+The **#fields\_for** and **form\_for** methods received the **:index** option, removing the need of using **:index => nil** on each form object. Look the examples:
-O código ficava assim:
+This is the way code used to be:
<% fields_for "project[task_attributes][]", task do |f| %>
<%= f.text_field :name, :index => nil %>
<%= f.hidden_field :id, :index => nil %>
<%= f.hidden_field :should_destroy, :index => nil %>
<% end %>
-Agora fica assim:
+Now it looks like this:
<% fields_for "project[task_attributes][]", task,
:index => nil do |f| %>
@@ -1,9 +1,9 @@
## ActionView::Helpers::DateHelper
-Agora todos os métodos desse módulo que tratam datas (**date\_select**, **time\_select**, **select\_datetime**, etc.) aceitam HTML options. Veja um exemplo usando o **date\_select**
+Now, all these module methods dealing with dates (**date\_select**, **time\_select**, **select\_datetime**, etc.) are accepting **HTML** options. Look an example using **date\_select**
<%= date_select 'item','happening', :order => [:day], :class => 'foobar'%>
### date\_helper
-O método date\_helper foi alterado para usar o **Date.current** para determinar o seu valor padrão.
+The **date\_helper** method was updated to use **Date.current** in order to define its default value.
@@ -2,33 +2,33 @@
### register\_javascript\_expansion
-Este método registra um ou mais arquivos javascript para serem incluídos quando um símbolo, determinado por você, for passado como parâmetro para o método **javascript\_include\_tag**. A idéia é que este método seja chamado no arquivo **init.rb** do seu plugin para registrar os arquivos javascript que seu plugin instalou na pasta **public/javascripts**. Veja como funciona:
+This method registers one or more javascript files to be included when a symbol, defined by the programmer, is given as a parameter to the **javascript\_include\_tag** method. The idea is to call this method inside the **init.rb** of your plugin, in order to register the javascript files which your plugin places in the folder **public/javascripts**. Let's see how it works:
- # No arquivo init.rb
+ # In the init.rb file
ActionView::Helpers::AssetTagHelper.register_javascript_expansion
:monkey => ["head", "body", "tail"]
- # Depois, fazendo assim:
+ # In our view:
javascript_include_tag :monkey
- # Teremos isto:
+ # We are going to have:
<script type="text/javascript" src="/javascripts/head.js"></script>
<script type="text/javascript" src="/javascripts/body.js"></script>
<script type="text/javascript" src="/javascripts/tail.js"></script>
### register\_stylesheet\_expansion
-Este método faz exatamente a mesma coisa que o método **ActionView::Helpers::AssetTagHelper#register\_javascript\_expansion**, mas criando um símbolo para ser usado nas chamadas ao método **stylesheet\_link\_tag**. Veja um exemplo:
+This method does exactly the same as the **ActionView::Helpers::AssetTagHelper#register\_javascript\_expansion** method, but it creates a symbol to be used later when making calls to **stylesheet\_link\_tag** method. Look an example:
- # No arquivo init.rb
+ # In the init.rb file
ActionView::Helpers::AssetTagHelper.register_stylesheet_expansion
:monkey => ["head", "body", "tail"]
- # Depois, fazendo assim:
+ # In our view:
stylesheet_link_tag :monkey
- # Teremos isto:
+ # We are going to have:
<link href="/stylesheets/head.css" media="screen" rel="stylesheet"
type="text/css" />
<link href="/stylesheets/body.css" media="screen" rel="stylesheet"
@@ -2,6 +2,6 @@
### submit\_tag
-Foi adicionada a opção **:confirm** nos parametros do método **#submit\_tag**. Essa opção funciona exatamente como no método **link\_to**. Veja um exemplo:
+It was added the **:confirm** option in the parameters of **#submit\_tag** method. This option works the same way like the method **link\_to**. Look an example:
submit_tag('Save changes', :confirm => "Are you sure?")
@@ -2,22 +2,23 @@
### number\_to\_currency
-O método **number\_to\_currency** passou a aceitar a opção **:format** como parâmetro, permitindo a formatação do valor retornado pelo método. Nas versões anteriores, na hora de formatarmos valores em reais precisamos incluir um espaço na frente da opção **:unit** para que o formato ficasse correto. Veja os exemplos:
-
+The **number\_to\_currency** method now accepts the **:format** option as a parameter,letting us to format the method's returning value. In earlier versions, when we had to format values for our local currency, we needed to include a space in front of **:unit** option to make the output format correct. See the examples:
+
+ # R$ is the symbol for Brazilian currency
number_to_currency(9.99, :separator => ",", :delimiter => ".", :unit => "R$")
# => "R$9,99″
number_to_currency(9.99, :format => "%u %n", :separator => ",",
:delimiter => ".", :unit => "R$")
# => "R$ 9,99″
-Além disto, podemos personalizar de outras formas, por exemplo:
+Besides that, we can customize in other forms, for example:
- number_to_currency(9.99, :format => "%n em reais", :separator => ",",
+ number_to_currency(9.99, :format => "%n in Brazilian reais", :separator => ",",
:delimiter => ".", :unit => "R$")
# => "9,99 em reais"
-Ao montar sua própria string de formatação, você pode usar os seguintes parâmetros:
+When creating your own formatting string, you can use the following parameters:
- %u Para a unidade monetária
- %n Para o número
+ %u For the currency
+ %n For the number
@@ -2,23 +2,23 @@
### excerpt
-O método **excerpt** é um helper para localizar uma palavra dentro de uma frase e retornar uma abreviação desta frase com o número de caracteres passado como parâmetro antes e depois da palavra, acrescentando, quando necessário, "…". Veja este exemplo:
+The **excerpt** method is a helper to find a word inside a phrase and return an abreviation of that phrase with the number of given characters as parameters before and after the word, adding, when necessary the "…". Look an example:
excerpt('This is an example', 'an', 5)
# => "…s is an examp…"
-O problema é que existia um BUG. Se você contar verá que depois a palavra ele trouxe na verdade seis caracteres e não cinco. Esse bug foi corrigido. Veja o exemplo do funcionamento correto desse método:
+But the problem it was bugged. If you count, you'll see the method returned 6 chars and not 5. This bug was fixed. Look the example of the correct output for this method:
excerpt('This is an example', 'an', 5)
# => "…s is an exam…"
###simple\_format
-O método **simple\_format** basicamente recebe como parâmetro um texto qualquer e o formata de uma forma simples em HTML. O que ele faz é pegar o texto e substituir uma quebra de linha (\n) pela tag "< br />". E quando temos duas quebras de linha seguidas (\n\n) ele separa o texto entre parágrafos, usando a tag "< p>".
+The **simple\_format** method basically receives as a parameter any text and formats it in a simple way to **HTML**. It takes the takes the text and replaces line breaks (\n) by **HTML** tag "< br />". And when we have two line breaks one after other (\n\n) it separates the text in paragraphs using "< p>"tag.
-No Rails 2.1 este método recebe um novo parâmetro opcional. Além do texto poderemos também informar quais atributos HTML gostaríamos que a tag "< p>" tivesse. Vamos aos exemplos:
+In Rails 2.1 this method received an additional parameter. Besides text, we are going to be able to inform which **HTML** attributes we would like "< p>" tag had.Look the examples:
- simple_format("Oi mãe!", :class => 'description')
- # => "<p class=’description’>Oi mãe!</p>"
+ simple_format("Hello Mom!", :class => 'description')
+ # => "<p class=’description’>Hello Mom!</p>"
-Os atributos HTML informados serão acrescentados em todas as tags "< p>" criadas pelo método.
+The **HTML** attributes will be added in all "< p>" tags created by the method.
@@ -1,6 +1,6 @@
## config.gem
-Agora é possível configurar todas as gems necessárias para o funcionamento correto de um projeto através do novo recurso **config.gem**. No arquivo **environment.rb** você pode adicionar quais gems seu projeto depende, como nesse exxemplo:
+Now it's possible to configure all necessary gems to get a project running by using a new feature called **config.gem**. In **environment.rb** file you can specify which gems your project depends for run. Look the example:
config.gem "bj"
@@ -9,35 +9,35 @@ Agora é possível configurar todas as gems necessárias para o funcionamento co
config.gem "aws-s3", :lib => "aws/s3"
-Pode instalar todas as dependências de uma só vez basta usar o comando:
+To install all dependencies at once, we just use a Rake task:
- # Instala todos os gems listados
+ # Installs all specified gems
rake gems:install
-Também é possível listar quais gems estão sendo usados no projeto executando:
+It's also possible to list which gems are being used in the running project by using:
- # Lista todos os gems dependentes
+ # Listing all gem dependencies
rake gems
-E se algum dos gems tiver um arquivo **rails/init.rb** e você quiser levar o gem junto com sua aplicação, rode:
+If one of the gems have a **rails/init.rb** file and you want to take the gem with your application, you can use:
- # Copia o gem especifícado para vendor/gems/nome_do_gem-x.x.x
- rake gems:unpack GEM=nome_do_gem
+ # Copy the specified gem to vendor/gems/nome_do_gem-x.x.x
+ rake gems:unpack GEM=gem_name
-E o gem será copiado para o diretório **vendor/gems/gem\_name-x.x.x**. Caso você não especifique o nome do gem o Rails irá copiar todos os gems para o diretório **vendor/gem**
+Then, the gem will be copied to the directory **vendor/gems/gem\_name-x.x.x**. In case you don't specify gem name, Rails will copy all gems to the directory **vendor/gem**
-## config.gem em plugins
+## config.gem in plugins
-O recurso do **config.gem** também está disponível para uso com plugins.
+The **config.gem** feature is also available for use with plugins.
-Até a versão 2.0 o arquivo **init.rb** de um plugin se parecia com isto:
+Untill Rails 2.0 the **init.rb** file of a plugin used to look like this:
- # init.rb do plugin open_id_authentication
+ # init.rb of plugin open_id_authentication
require 'yadis'
require 'openid'
ActionController::Base.send :include, OpenIdAuthentication
-Mas no Rails 2.1 o arquivo **init.rb** seria:
+But in Rails 2.1 the **init.rb** file would be:
config.gem "ruby-openid", :lib => "openid", :version => "1.1.4"
config.gem "ruby-yadis", :lib => "yadis", :version => "0.3.4"
@@ -46,4 +46,4 @@ Mas no Rails 2.1 o arquivo **init.rb** seria:
ActionController::Base.send :include, OpenIdAuthentication
end
-Assim, quando você rodar a tarefa para instalar todos os gems necessários, estes gems estarão entre eles.
+So, when you run the task to install all necessary gems, these gems will be among them.
@@ -1,6 +1,6 @@
## gems:build
-A task **gems:build** compila todas as extensões nativas do gems que foram instaladas através do gems:unpack. A sintaxe é:
+The **gems:build** task compiles all native extensions of gems which were installed through **gems:unpack**. The syntax is the following:
- rake gems:build # Para todas as gems
- rake gems:build GEM=mygem # Estou informando a gem
+ rake gems:build # For all gems
+ rake gems:build GEM=mygem # I'm specifing the gem
@@ -1,5 +1,5 @@
-## Nova mensagem ao iniciar o servidor
+## New message when starting server
-Ouve uma pequena alteração na mensagem de inicio do Rails, agora ela mostra também qual é a versão do Rails que está sendo carregada:
+There was a little improvement when starting Rails server, now it shows which Rails version is being loaded:
Rails 2.1 application starting on http://0.0.0.0:3000
@@ -1,5 +1,5 @@
## Rails.public\_path
-Foi incluído no Rails o atalho **Rails.public\_path** para recuperar o caminho do diretório **"public"** do projeto.
+It was added the **Rails.public\_path** shortcut to recover the path of the project's **"public"** directory.
Rails.public_path
@@ -1,6 +1,6 @@
-## Rails.logger, Rails.root, Rails.env e Rails.cache
+## Rails.logger, Rails.root, Rails.env and Rails.cache
-No Rails 2.1 ao invés de usarmos as constantes: **RAILS\_DEFAULT\_LOGGER**, **RAILS\_ROOT**, **RAILS\_ENV** e **RAILS\_CACHE**. Usaremos os atalhos:
+In Rails 2.1 instead of using the constants: **RAILS\_DEFAULT\_LOGGER**, **RAILS\_ROOT**, **RAILS\_ENV** and **RAILS\_CACHE**. We will use:
# RAILS_DEFAULT_LOGGER
Rails.logger
@@ -1,10 +1,10 @@
## Rails.version
-Nas versões anteriores para descobrir, durante a execução do seu código, qual é a versão do Rails em uso, bastava usar:
+In earlier versions to discover, during running time, what's the Rails version in use, we used:
Rails::VERSION::STRING
-No Rails 2.1 isso mudou para:
+In Rails 2.1 changed to:
Rails.version
@@ -1,18 +1,18 @@
-##Obtendo informações sobre um plugin
+##Getting information about a plugin
-Aí está uma das novas funcionalidades do Rails 2.1 que provavelmente você nunca usará. Digo “talvez”, porque pode ser que em algum caso muito especifico seja interessante obter o número da versão do plugin, por exemplo.
+This is one of the new Rails 2.0 features which you probably never use it. I say "probably", because in some very specific case it can be useful, for example, to know plugin version.
-Para testar isto, precisamos criar um novo arquivo chamado *about.yml* no diretório do plugin, algo mais ou menos assim:
+To test it, we need to create a new file called *about.yml* in the plugin directory, something like this:
author: Carlos Brando
version: 1.2.0
- description: Uma descrição qualquer sobre o plugin
+ description: A description about the plugin
url: http://www.nomedojogo.com
-Depois podemos recuperar estas informações via código, assim:
+We can get this information later this way:
- plugin = Rails::Plugin.new(diretorio_do_meu_plugin)
+ plugin = Rails::Plugin.new(plugin_directory)
plugin.about["author"] # => “Carlos Brando”
plugin.about["url"] # => “http://www.nomedojogo.com”
-Se alguém encontrar algum uso para isto e quiser compartilhar comigo, talvez eu mude de idéia quanto à sua real necessidade.
+If you find some good use for this feature and want to share with me, maybe i can change my mind about its real need.

0 comments on commit fb93367

Please sign in to comment.