2017-08-13 13:02:48 +00:00
# frozen_string_literal: true
2012-05-26 19:29:47 +00:00
namespace :guides do
2012-09-07 04:09:56 +00:00
desc 'Generate guides (for authors), use ONLY=foo to process just "foo.md"'
2016-08-06 17:39:28 +00:00
task generate : " generate:html "
2012-05-26 19:29:47 +00:00
namespace :generate do
desc " Generate HTML guides "
2018-02-04 13:49:22 +00:00
task :html do
2018-02-04 13:37:17 +00:00
ruby " -Eutf-8:utf-8 " , " rails_guides.rb "
2012-05-26 19:29:47 +00:00
end
2022-07-06 06:59:06 +00:00
desc " Generate .mobi file "
2018-02-04 13:49:22 +00:00
task :kindle do
2022-07-06 06:59:06 +00:00
require " active_support/deprecation "
ActiveSupport :: Deprecation . warn ( " The guides:generate:kindle rake task is deprecated and will be removed in 7.2. Run rake guides:generate:epub instead " )
Rake :: Task [ " guides:generate:epub " ] . invoke
end
desc " Generate .epub file "
task :epub do
ENV [ " EPUB " ] = " 1 "
2016-08-06 17:21:59 +00:00
Rake :: Task [ " guides:generate:html " ] . invoke
2012-05-26 19:29:47 +00:00
end
end
# Validate guides -------------------------------------------------------------------------
desc 'Validate guides, use ONLY=foo to process just "foo.html"'
2021-11-10 09:27:45 +00:00
task :validate do
2012-05-26 19:29:47 +00:00
ruby " w3c_validator.rb "
end
2012-03-17 15:32:49 +00:00
2012-05-26 20:05:52 +00:00
desc " Show help "
task :help do
2017-02-12 09:21:20 +00:00
puts <<HELP
2012-05-26 20:05:52 +00:00
2014-11-26 00:54:30 +00:00
Guides are taken from the source directory , and the result goes into the
2012-05-26 20:05:52 +00:00
output directory . Assets are stored under files , and copied to output / files as
part of the generation process .
2014-11-26 00:54:30 +00:00
You can generate HTML , Kindle or both formats using the ` guides:generate ` task .
2014-12-05 15:32:50 +00:00
All of these processes are handled via rake tasks , here ' s a full list of them :
2012-05-28 21:17:00 +00:00
#{%x[rake -T]}
2012-05-26 20:05:52 +00:00
Some arguments may be passed via environment variables :
2017-02-12 09:21:20 +00:00
RAILS_VERSION = tag
If guides are being generated for a specific Rails version set the Git tag
here , otherwise the current SHA1 is going to be used to generate edge guides .
2012-05-26 20:05:52 +00:00
ALL = 1
Force generation of all guides .
ONLY = name
Useful if you want to generate only one or a set of guides .
2012-08-31 16:01:06 +00:00
2012-05-26 20:05:52 +00:00
Generate only association_basics . html :
ONLY = assoc
Separate many using commas :
ONLY = assoc , migrations
GUIDES_LANGUAGE
Use it when you want to generate translated guides in
source / < GUIDES_LANGUAGE > folder ( such as source / es )
Examples :
2017-02-12 09:21:20 +00:00
$ rake guides : generate ALL = 1 RAILS_VERSION = v5 . 1 . 0
$ rake guides : generate ONLY = migrations
2022-07-06 06:59:06 +00:00
$ rake guides : generate : epub
2012-05-26 20:05:52 +00:00
$ rake guides : generate GUIDES_LANGUAGE = es
2017-02-12 09:21:20 +00:00
HELP
2012-05-26 20:05:52 +00:00
end
2012-03-17 15:32:49 +00:00
end
2012-05-26 20:05:52 +00:00
2019-02-05 14:50:06 +00:00
task :test do
2022-01-06 21:56:06 +00:00
templates = Dir . glob ( " bug_report_templates/*.rb " )
2019-02-05 14:50:06 +00:00
counter = templates . count do | file |
puts " --- Running #{ file } "
2021-05-31 23:29:00 +00:00
Bundler . unbundled_system ( Gem . ruby , " -w " , file ) ||
2019-02-05 14:50:06 +00:00
puts ( " +++ 💥 FAILED (exit #{ $? . exitstatus } ) " )
end
puts " +++ #{ counter } / #{ templates . size } templates executed successfully "
exit 1 if counter < templates . size
end
2016-08-06 17:39:28 +00:00
task default : " guides:help "