mirror of https://github.com/rails/rails
Always recommend config.asset_host in examples
This commit is contained in:
parent
761fea3822
commit
76e432341c
|
@ -32,7 +32,7 @@ Rails.application.configure do
|
|||
# `config.assets.precompile` and `config.assets.version` have moved to config/initializers/assets.rb
|
||||
|
||||
# Enable serving of images, stylesheets, and JavaScripts from an asset server.
|
||||
# config.action_controller.asset_host = 'http://assets.example.com'
|
||||
# config.asset_host = 'http://assets.example.com'
|
||||
|
||||
# Specifies the header that your server uses for sending files.
|
||||
# config.action_dispatch.x_sendfile_header = 'X-Sendfile' # for Apache
|
||||
|
|
|
@ -34,7 +34,7 @@ Rails.application.configure do
|
|||
# `config.assets.precompile` and `config.assets.version` have moved to config/initializers/assets.rb
|
||||
|
||||
# Enable serving of images, stylesheets, and JavaScripts from an asset server.
|
||||
# config.action_controller.asset_host = 'http://assets.example.com'
|
||||
# config.asset_host = 'http://assets.example.com'
|
||||
|
||||
# Specifies the header that your server uses for sending files.
|
||||
# config.action_dispatch.x_sendfile_header = 'X-Sendfile' # for Apache
|
||||
|
|
|
@ -34,7 +34,7 @@ Rails.application.configure do
|
|||
# `config.assets.precompile` and `config.assets.version` have moved to config/initializers/assets.rb
|
||||
|
||||
# Enable serving of images, stylesheets, and JavaScripts from an asset server.
|
||||
# config.action_controller.asset_host = 'http://assets.example.com'
|
||||
# config.asset_host = 'http://assets.example.com'
|
||||
|
||||
# Specifies the header that your server uses for sending files.
|
||||
# config.action_dispatch.x_sendfile_header = 'X-Sendfile' # for Apache
|
||||
|
|
|
@ -621,7 +621,7 @@ As the `:asset_host` usually is consistent across the application you can
|
|||
configure it globally in `config/application.rb`:
|
||||
|
||||
```ruby
|
||||
config.action_mailer.asset_host = 'http://example.com'
|
||||
config.asset_host = 'http://example.com'
|
||||
```
|
||||
|
||||
Now you can display an image inside your email.
|
||||
|
|
|
@ -23,11 +23,11 @@ The following is only a brief overview summary of the helpers available in Actio
|
|||
|
||||
This module provides methods for generating HTML that links views to assets such as images, JavaScript files, stylesheets, and feeds.
|
||||
|
||||
By default, Rails links to these assets on the current host in the public folder, but you can direct Rails to link to assets from a dedicated assets server by setting `config.action_controller.asset_host` in the application configuration, typically in `config/environments/production.rb`. For example, let's say your asset host is `assets.example.com`:
|
||||
By default, Rails links to these assets on the current host in the public folder, but you can direct Rails to link to assets from a dedicated assets server by setting `config.asset_host` in the application configuration, typically in `config/environments/production.rb`. For example, let's say your asset host is `assets.example.com`:
|
||||
|
||||
```ruby
|
||||
config.action_controller.asset_host = "assets.example.com"
|
||||
image_tag("rails.png")
|
||||
config.asset_host = "assets.example.com"
|
||||
image_tag("rails.png")
|
||||
# => <img src="http://assets.example.com/images/rails.png" />
|
||||
```
|
||||
|
||||
|
@ -36,7 +36,7 @@ image_tag("rails.png")
|
|||
Returns a link tag that browsers and feed readers can use to auto-detect an RSS, Atom, or JSON feed.
|
||||
|
||||
```ruby
|
||||
auto_discovery_link_tag(:rss, "http://www.example.com/feed.rss", { title: "RSS Feed" })
|
||||
auto_discovery_link_tag(:rss, "http://www.example.com/feed.rss", { title: "RSS Feed" })
|
||||
# => <link rel="alternate" type="application/rss+xml" title="RSS Feed" href="http://www.example.com/feed.rss" />
|
||||
```
|
||||
|
||||
|
@ -51,7 +51,7 @@ image_path("edit.png") # => /assets/edit.png
|
|||
Fingerprint will be added to the filename if config.assets.digest is set to true.
|
||||
|
||||
```ruby
|
||||
image_path("edit.png")
|
||||
image_path("edit.png")
|
||||
# => /assets/edit-2d1a2db63fc738690021fedb5a65b68e.png
|
||||
```
|
||||
|
||||
|
@ -76,7 +76,7 @@ image_tag("icon.png") # => <img src="/assets/icon.png" />
|
|||
Returns an HTML script tag for each of the sources provided. You can pass in the filename (`.js` extension is optional) of JavaScript files that exist in your `app/assets/javascripts` directory for inclusion into the current page or you can pass the full path relative to your document root.
|
||||
|
||||
```ruby
|
||||
javascript_include_tag "common"
|
||||
javascript_include_tag "common"
|
||||
# => <script src="/assets/common.js"></script>
|
||||
```
|
||||
|
||||
|
@ -93,7 +93,7 @@ javascript_path "common" # => /assets/common.js
|
|||
Computes the URL to a JavaScript asset in the `app/assets/javascripts` directory. This will call `javascript_path` internally and merge with your current host or your asset host.
|
||||
|
||||
```ruby
|
||||
javascript_url "common"
|
||||
javascript_url "common"
|
||||
# => http://www.example.com/assets/common.js
|
||||
```
|
||||
|
||||
|
@ -102,7 +102,7 @@ javascript_url "common"
|
|||
Returns a stylesheet link tag for the sources specified as arguments. If you don't specify an extension, `.css` will be appended automatically.
|
||||
|
||||
```ruby
|
||||
stylesheet_link_tag "application"
|
||||
stylesheet_link_tag "application"
|
||||
# => <link href="/assets/application.css" media="screen" rel="stylesheet" />
|
||||
```
|
||||
|
||||
|
@ -119,7 +119,7 @@ stylesheet_path "application" # => /assets/application.css
|
|||
Computes the URL to a stylesheet asset in the `app/assets/stylesheets` directory. This will call `stylesheet_path` internally and merge with your current host or your asset host.
|
||||
|
||||
```ruby
|
||||
stylesheet_url "application"
|
||||
stylesheet_url "application"
|
||||
# => http://www.example.com/assets/application.css
|
||||
```
|
||||
|
||||
|
@ -256,9 +256,9 @@ For example, let's say we have a standard application layout, but also a special
|
|||
Reports the approximate distance in time between two Time or Date objects or integers as seconds. Set `include_seconds` to true if you want more detailed approximations.
|
||||
|
||||
```ruby
|
||||
distance_of_time_in_words(Time.now, Time.now + 15.seconds)
|
||||
distance_of_time_in_words(Time.now, Time.now + 15.seconds)
|
||||
# => less than a minute
|
||||
distance_of_time_in_words(Time.now, Time.now + 15.seconds, include_seconds: true)
|
||||
distance_of_time_in_words(Time.now, Time.now + 15.seconds, include_seconds: true)
|
||||
# => less than 20 seconds
|
||||
```
|
||||
|
||||
|
|
|
@ -882,11 +882,11 @@ valid CDN provider at the time of this writing). Now that you have configured
|
|||
your CDN server, you need to tell browsers to use your CDN to grab assets
|
||||
instead of your Rails server directly. You can do this by configuring Rails to
|
||||
set your CDN as the asset host instead of using a relative path. To set your
|
||||
asset host in Rails, you need to set `config.action_controller.asset_host` in
|
||||
asset host in Rails, you need to set `config.asset_host` in
|
||||
`config/environments/production.rb`:
|
||||
|
||||
```ruby
|
||||
config.action_controller.asset_host = 'mycdnsubdomain.fictional-cdn.com'
|
||||
config.asset_host = 'mycdnsubdomain.fictional-cdn.com'
|
||||
```
|
||||
|
||||
NOTE: You only need to provide the "host", this is the subdomain and root
|
||||
|
@ -899,7 +899,7 @@ variable](https://en.wikipedia.org/wiki/Environment_variable) to make running a
|
|||
staging copy of your site easier:
|
||||
|
||||
```ruby
|
||||
config.action_controller.asset_host = ENV['CDN_HOST']
|
||||
config.asset_host = ENV['CDN_HOST']
|
||||
```
|
||||
|
||||
|
||||
|
|
|
@ -501,7 +501,7 @@ The schema dumper adds two additional configuration options:
|
|||
|
||||
`config.action_controller` includes a number of configuration settings:
|
||||
|
||||
* `config.action_controller.asset_host` sets the host for the assets. Useful when CDNs are used for hosting assets rather than the application server itself.
|
||||
* `config.action_controller.asset_host` sets the host for the assets. Useful when CDNs are used for hosting assets rather than the application server itself. You should only use this if you have a different configuration for Action Mailer, otherwise use `config.asset_host`.
|
||||
|
||||
* `config.action_controller.perform_caching` configures whether the application should perform the caching features provided by the Action Controller component or not. Set to `false` in the development environment, `true` in production. If it's not specified, the default will be `true`.
|
||||
|
||||
|
@ -734,6 +734,8 @@ Defaults to `'signed cookie'`.
|
|||
|
||||
There are a number of settings available on `config.action_mailer`:
|
||||
|
||||
* `config.action_mailer.asset_host` sets the host for the assets. Useful when CDNs are used for hosting assets rather than the application server itself. You should only use this if you have a different configuration for Action Controller, otherwise use `config.asset_host`.
|
||||
|
||||
* `config.action_mailer.logger` accepts a logger conforming to the interface of Log4r or the default Ruby Logger class, which is then used to log information from Action Mailer. Set to `nil` to disable logging.
|
||||
|
||||
* `config.action_mailer.smtp_settings` allows detailed configuration for the `:smtp` delivery method. It accepts a hash of options, which can include any of these options:
|
||||
|
|
|
@ -111,11 +111,11 @@ module Rails
|
|||
# file in <tt>config/environments</tt>.
|
||||
#
|
||||
# environment do
|
||||
# "config.action_controller.asset_host = 'cdn.provider.com'"
|
||||
# "config.asset_host = 'cdn.provider.com'"
|
||||
# end
|
||||
#
|
||||
# environment(nil, env: "development") do
|
||||
# "config.action_controller.asset_host = 'localhost:3000'"
|
||||
# "config.asset_host = 'localhost:3000'"
|
||||
# end
|
||||
def environment(data = nil, options = {})
|
||||
sentinel = "class Application < Rails::Application\n"
|
||||
|
|
|
@ -35,7 +35,7 @@ Rails.application.configure do
|
|||
|
||||
<%- end -%>
|
||||
# Enable serving of images, stylesheets, and JavaScripts from an asset server.
|
||||
# config.action_controller.asset_host = 'http://assets.example.com'
|
||||
# config.asset_host = 'http://assets.example.com'
|
||||
|
||||
# Specifies the header that your server uses for sending files.
|
||||
# config.action_dispatch.x_sendfile_header = 'X-Sendfile' # for Apache
|
||||
|
|
Loading…
Reference in New Issue