force UTF-8 as external encoding in guides generation [ci skip]
See the rationale in the comment found in the patch.
This commit is contained in:
parent
c741b49340
commit
37770bc8d1
@ -2,15 +2,28 @@ namespace :guides do
|
||||
desc 'Generate guides (for authors), use ONLY=foo to process just "foo.md"'
|
||||
task generate: "generate:html"
|
||||
|
||||
# Guides are written in UTF-8, but the environment may be configured for some
|
||||
# other locale, these tasks are responsible for ensuring the default external
|
||||
# encoding is UTF-8.
|
||||
#
|
||||
# Real use cases: Generation was reported to fail on a machine configured with
|
||||
# GBK (Chinese). The docs server once got misconfigured somehow and had "C",
|
||||
# which broke generation too.
|
||||
task :encoding do
|
||||
%w(LANG LANGUAGE LC_ALL).each do |env_var|
|
||||
ENV[env_var] = "en_US.UTF-8"
|
||||
end
|
||||
end
|
||||
|
||||
namespace :generate do
|
||||
desc "Generate HTML guides"
|
||||
task :html do
|
||||
task :html => :encoding do
|
||||
ENV["WARNINGS"] = "1" # authors can't disable this
|
||||
ruby "rails_guides.rb"
|
||||
end
|
||||
|
||||
desc "Generate .mobi file. The kindlegen executable must be in your PATH. You can get it for free from http://www.amazon.com/gp/feature.html?docId=1000765211"
|
||||
task :kindle do
|
||||
task :kindle => :encoding do
|
||||
require "kindlerb"
|
||||
unless Kindlerb.kindlegen_available?
|
||||
abort "Please run `setupkindlerb` to install kindlegen"
|
||||
@ -25,7 +38,7 @@ namespace :guides do
|
||||
|
||||
# Validate guides -------------------------------------------------------------------------
|
||||
desc 'Validate guides, use ONLY=foo to process just "foo.html"'
|
||||
task :validate do
|
||||
task :validate => :encoding do
|
||||
ruby "w3c_validator.rb"
|
||||
end
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user