عرض مصدر Rails/generators

<noinclude>{{DISPLAYTITLE:إنشاء وتخصيص مولدات وقوالب ريلز}}</noinclude>
مولدات ريلز هي أداة أساسية إذا كنت تخطط لتحسين سير عملك. مع هذا الدليل سوف تتعلم كيفية إنشاء المولدات وتخصيص المولدات الموجودة.

بعد قراءة هذا الدليل، ستتعلم:
* كيفية معرفة أي المولدات المتوفرة في التطبيق الخاص بك.
* كيفية إنشاء مولد باستخدام القوالب.
* كيفية بحث ريلز عن المولدات قبل استدعائها.
* كيفية إنشاء ريلز داخليًا شيفرة من القوالب.
* كيفية تخصيص المولد scaffold عن طريق إنشاء مولدات جديدة.
* كيفية تخصيص المولد scaffold عن طريق تغيير قوالب المولدات.
* كيفية استخدام التراجعات (fallbacks) لتجنب استبدال مجموعة ضخمة من المولدات.
* كيفية إنشاء قالب التطبيق.

== الاتصال الأول ==
عندما تنشئ تطبيقًا باستخدام الأمر <code>rails</code>، فأنت في الحقيقة تستخدم مولد ريلز. بعد ذلك، يمكنك الحصول على قائمة بجميع المولدات المتاحة عن طريق استدعاء <code>rails generate</code> فقط:
<syntaxhighlight lang="shell">
$ rails new myapp
$ cd myapp
$ bin/rails generate
</syntaxhighlight>

سوف تحصل على قائمة بجميع المولدات التي تأتي مع ريلز. إذا كنت بحاجة إلى وصف تفصيلي لمولد المساعد، على سبيل المثال، يمكنك ببساطة القيام بما يلي:<syntaxhighlight lang="shell">
$ bin/rails generate helper --help
</syntaxhighlight>

== إنشاء المولد الأول الخاص بك ==
منذ الإصدار 3.0 من ريلز، تنشأ المولدات أعلى [https://github.com/erikhuda/thor Thor]. يوفر [https://github.com/erikhuda/thor Thor] خيارات قوية للتحليل، وواجهة برمجة تطبيقات رائعة لمعالجة الملفات. على سبيل المثال، لإنشاء مولد ينشئ ملف مُهيئ يسمى initializer.rb داخل config/initializers.

الخطوة الأولى هي إنشاء ملف في lib/generators/initializer_generator.rb بالمحتوى التالي:
<syntaxhighlight lang="rails">
class InitializerGenerator < Rails::Generators::Base
  def create_initializer_file
    create_file "config/initializers/initializer.rb", "# Add initialization content here"
  end
end
</syntaxhighlight>

'''ملاحظة''': <code>create_file</code> هو تابع مقدم من <code>Thor::Actions</code>. يمكن العثور على توثيق للتابع <code>create_file</code> وتوابع Thor الأخرى في [http://rdoc.info/github/erikhuda/thor/master/Thor/Actions.html توثيق Thor].

مولدنا الجديد بسيط للغاية: فهو يرث من <code>Rails::Generators::Base</code> وله تعريف واحد للتابع. عندما يُستدعَى المولد، يُنفذ كل تابع عام في المولد بالترتيب التسلسلي الذي عُرِّف به. وأخيرًا، نستدعي التابع <code>create_file</code> الذي سينشئ ملفًا في الوجهة المحددة بالمحتوى المحدد. إذا كنت معتادًا على  قوالب الواجهة البرمجية (API) لتطبيق ريلز، فستشعر بشيء من الألفة عند استخدام واجهة برمجة التطبيقات للمولدات الجديدة.

لاستدعاء المولد الجديد، نحتاج فقط إلى القيام بما يلي:
<syntaxhighlight lang="shell">
$ bin/rails generate initializer
</syntaxhighlight>

قبل أن نبدأ، لنرى وصف علامة المولد الجديد:
<syntaxhighlight lang="shell">
$ bin/rails generate initializer --help
</syntaxhighlight>

ريلز عادةً ما تكون قادرة على توليد أوصاف جيدة إذا كان المولّد هو مجال اسم، مثل

<code>ActiveRecord::Generators::ModelGenerator</code>، ولكن ليس في هذه الحالة بالذات. يمكننا حل هذه المشكلة بطريقتين. الحل الأول هو استدعاء <code>desc</code> داخل مولدنا:
<syntaxhighlight lang="rails">
class InitializerGenerator < Rails::Generators::Base
  desc "This generator creates an initializer file at config/initializers"
  def create_initializer_file
    create_file "config/initializers/initializer.rb", "# Add initialization content here"
  end
end
</syntaxhighlight>

الآن يمكننا رؤية الوصف الجديد من خلال استدعاء ‎<code>--help</code> على المولد الجديد. الطريقة الثانية لإضافة وصف هي عن طريق إنشاء ملف يسمى USAGE في نفس المجلد الموجود فيه مولدنا. سنقوم بذلك في الخطوة التالية.

== إنشاء مولدات مع المولدات ==
المولدات نفسها لديها مولد:
<syntaxhighlight lang="shell">
$ bin/rails generate generator initializer
      create  lib/generators/initializer
      create  lib/generators/initializer/initializer_generator.rb
      create  lib/generators/initializer/USAGE
      create  lib/generators/initializer/templates
      invoke  test_unit
      create    test/lib/generators/initializer_generator_test.rb
</syntaxhighlight>

هذا هو المولد الذي أُنشأ للتو:
<syntaxhighlight lang="shell">
class InitializerGenerator < Rails::Generators::NamedBase
  source_root File.expand_path('templates', __dir__)
end
</syntaxhighlight>

أولًا، لاحظ أننا نرث من <code>Rails::Generators::NamedBase</code> بدلًا من <code>Rails::Generators::Base</code>. هذا يعني أن مولدنا يتوقع وسيطًا واحدًا على الأقل، والذي سيكون اسم المُهيئ، وسيكون متاحًا في الشيفرة الخاص بنا في المتغير <code>name</code>.

يمكننا أن نرى ذلك من خلال استدعاء وصف هذا المولد الجديد (لا تنس حذف ملف المولد القديم):
<syntaxhighlight lang="shell">
$ bin/rails generate initializer --help
Usage:
  rails generate initializer NAME [options]
</syntaxhighlight>

يمكننا أيضًا رؤية أن المولد الجديد لديه تابع صنف يُسمى <code>source_root</code>. يشير هذا التابع إلى مكان وضع قوالب المولد الخاصة بنا، إن وجدت، وبشكل افتراضي يشير إلى المجلد lib/generators/initializer/templates الذي أُُنشِئ.

لفهم معنى قالب المولد، نُنشئ الملف lib/generators/initializer/templates/initializer.rb بالمحتوى التالي:
<syntaxhighlight lang="rails">
# Add initialization content here
</syntaxhighlight>

والآن دعنا نغير المولد لنسخ هذا القالب عند الاستدعاء:
<syntaxhighlight lang="rails">
class InitializerGenerator < Rails::Generators::NamedBase
  source_root File.expand_path('templates', __dir__)
 
  def copy_initializer_file
    copy_file "initializer.rb", "config/initializers/#{file_name}.rb"
  end
end
</syntaxhighlight>

دعنا ننفذه على المولد الخاص بنا:
<syntaxhighlight lang="shell">
$ bin/rails generate initializer core_extensions
</syntaxhighlight>

يمكننا أن نرى أنه أُنشئ مُهيئ باسم <code>core_extensions</code> في config/initializers/core_extensions.rb بمحتويات القالب الخاص بنا. وهذا يعني أن <code>copy_file</code> نسخ الملف في المصدر الأصل الخاص بنا إلى مسار الوجهة الذي قدمناه. يُنشَأ التابع <code>file_name</code> تلقائيًا عندما نرث من <code>Rails::Generators::NamedBase</code>.

سنشير إلى التوابع المتوفرة للمولدات في [[Rails/generators#.D8.AA.D9.88.D8.A7.D8.A8.D8.B9 .D8.A7.D9.84.D9.85.D9.88.D9.84.D8.AF|القسم الأخير]] من هذا الدليل.

== البحث عن مولدات ==
عند تشغيل <code>rails generate initializer core_extensions</code> تتطلب ريلز هذه الملفات بدورها حتى تعثر على أحدها:
<syntaxhighlight lang="text">
rails/generators/initializer/initializer_generator.rb
generators/initializer/initializer_generator.rb
rails/generators/initializer_generator.rb
generators/initializer_generator.rb
</syntaxhighlight>

إذا لم يعثر على أي شيء، فستُعرَض رسالة خطأ.

'''ملاحظة''': تضع الأمثلة أعلاه الملفات تحت تطبيق <code>lib</code> لأن المجلد المذكور ينتمي إلى ‎<code>$LOAD_PATH</code>.

== تخصيص سير العمل الخاص بك ==
المولدات الخاصة بريلز مرنة بما يكفي لتسمح لك بتخصيص السقالات (scaffolding). يمكن ضبطها في config/application.rb، هذه بعض الافتراضات:
<syntaxhighlight lang="rails">
config.generators do |g|
  g.orm             :active_record
  g.template_engine :erb
  g.test_framework  :test_unit, fixture: true
end
</syntaxhighlight>

قبل تخصيص سير العمل الخاص بنا، لنرى أولًا الشكل الذي تبدو عليه سقالاتنا (scaffold):
<syntaxhighlight lang="shell">
$ bin/rails generate scaffold User name:string
      invoke  active_record
      create    db/migrate/20130924151154_create_users.rb
      create    app/models/user.rb
      invoke    test_unit
      create      test/models/user_test.rb
      create      test/fixtures/users.yml
      invoke  resource_route
       route    resources :users
      invoke  scaffold_controller
      create    app/controllers/users_controller.rb
      invoke    erb
      create      app/views/users
      create      app/views/users/index.html.erb
      create      app/views/users/edit.html.erb
      create      app/views/users/show.html.erb
      create      app/views/users/new.html.erb
      create      app/views/users/_form.html.erb
      invoke    test_unit
      create      test/controllers/users_controller_test.rb
      invoke    helper
      create      app/helpers/users_helper.rb
      invoke    jbuilder
      create      app/views/users/index.json.jbuilder
      create      app/views/users/show.json.jbuilder
      invoke  test_unit
      create    test/application_system_test_case.rb
      create    test/system/users_test.rb
      invoke  assets
      invoke    coffee
      create      app/assets/javascripts/users.coffee
      invoke    scss
      create      app/assets/stylesheets/users.scss
      invoke  scss
      create    app/assets/stylesheets/scaffolds.scss
</syntaxhighlight>

بالنظر إلى هذا الناتج، من السهل فهم كيفية عمل المولدات في الإصدار 3.0 وما بعد من ريلز. مولد السقالة scaffold لا يولد أي شيء في الواقع، إنه يستدعي الآخرين فقط للقيام بالعمل. هذا يسمح لنا بإضافة أو استبدال أو إزالة أي من تلك الإستدعاءات. على سبيل المثال، يستدعي المولد scaffold المولد scaffold_controller، الذي يستدعي المولدات erb و test_unit و helper. نظرًا لأن كل مولد لديه مسؤولية واحدة، فإنه من السهل إعادة استخدامه، مع تجنب تكرار الشيفرة.

إذا كنا نريد تجنب التوليد الافتراضي للملف app/assets/stylesheets/scaffolds.scss عند توليد مورد جديد عبر المولد scaffold، يمكننا تعطيل <code>scaffold_stylesheet</code>:
<syntaxhighlight lang="rails">
config.generators do |g|
  g.scaffold_stylesheet false
end
</syntaxhighlight>

سيكون التخصيص التالي على سير العمل هو التوقف عن توليد [[CSS|ورقة الأنماط]] و<nowiki/>[[JavaScript|جافاسكريبت]] و<nowiki/>[[Rails/testing#.D8.AD.D9.82.D9.8A.D9.82.D8.A9 .D8.AA.D8.AD.D8.B6.D9.8A.D8.B1.D8.A7.D8.AA .D8.A7.D9.84.D8.A7.D8.AE.D8.AA.D8.A8.D8.A7.D8.B1 .28Fixtures.29|ملفات تحضيرات الاختبار]] للسقالات بالكامل. نُحقق ذلك عن طريق تغيير إعدادات الضبط لدينا إلى ما يلي:
<syntaxhighlight lang="rails">
config.generators do |g|
  g.orm             :active_record
  g.template_engine :erb
  g.test_framework  :test_unit, fixture: false
  g.stylesheets     false
  g.javascripts     false
end
</syntaxhighlight>

إذا قمنا بإنشاء مورد آخر عبر المولد scaffold، يمكننا ملاحظة أنه لن ينشئ أوراق الأنماط وشيفرة جافاسكريبت وملفات تحضيرات الاختبار بعد الآن. إذا كنت ترغب في تخصيصها بشكل أكبر، على سبيل المثال لاستخدام DataMapper و RSpec بدلًا من [[Rails/active record|Active Record]] و TestUnit، فإن الأمر يتعلق فقط بإضافة الجواهر الخاصة بهم إلى التطبيق الخاص بك وضبط المولدات الخاصة بك.

لإثبات ذلك، سننشئ مولدًا مساعدًا جديدًا يضيف ببساطة بعض متغيرات النسخة. أولًا، نُنشئ مولدًا داخل مجال الاسم <code>rails</code>، حيث أن هذا هو المكان الذي تبحث فيه ريلز عن المولدات المستخدمة كخطافات:
<syntaxhighlight lang="rails">
$ bin/rails generate generator rails/my_helper
      create  lib/generators/rails/my_helper
      create  lib/generators/rails/my_helper/my_helper_generator.rb
      create  lib/generators/rails/my_helper/USAGE
      create  lib/generators/rails/my_helper/templates
      invoke  test_unit
      create    test/lib/generators/rails/my_helper_generator_test.rb

</syntaxhighlight>

بعد ذلك، يمكننا حذف كلٍّ من المجلد templates وتابع الصنف <code>class_root</code> الذي يستدعى من المولد الجديد، لأننا لن نحتاج إليهما. أضف التابع أدناه، لذلك يبدو مولدنا كما يلي:
<syntaxhighlight lang="rails">
# lib/generators/rails/my_helper/my_helper_generator.rb
class Rails::MyHelperGenerator < Rails::Generators::NamedBase
  def create_helper_file
    create_file "app/helpers/#{file_name}_helper.rb", <<-FILE
module #{class_name}Helper
  attr_reader :#{plural_name}, :#{plural_name.singularize}
end
    FILE
  end
end
</syntaxhighlight>

يمكننا تجربة مولدنا الجديد عن طريق إنشاء مساعد للمنتجات:
<syntaxhighlight lang="shell">
$ bin/rails generate my_helper products
      create  app/helpers/products_helper.rb
</syntaxhighlight>

وسوف تولد الملف المساعد التالي في app/helpers:
<syntaxhighlight lang="rails">
module ProductsHelper

 attr_reader :products, :product

End
</syntaxhighlight>

وهو ما كنا نتوقعه. يمكننا الآن أن نخبر المولد scaffold أن يستخدم المولد المساعد الجديد الخاص بنا عن طريق تعديل الملف config/application.rb مرة أخرى بالشكل التالي:
<syntaxhighlight lang="rails">
config.generators do |g|
  g.orm             :active_record
  g.template_engine :erb
  g.test_framework  :test_unit, fixture: false
  g.stylesheets     false
  g.javascripts     false
  g.helper          :my_helper
end
</syntaxhighlight>

ونرى ذلك في العمل عند استدعاء المولد:
<syntaxhighlight lang="shell">
$ bin/rails generate scaffold Article body:text
      [...]
      invoke    my_helper
      create      app/helpers/articles_helper.rb
</syntaxhighlight>

من المخرجات التي حصلنا عليها، يمكننا ملاحظة أن مساعدنا الجديد استُدعِي بدلًا من مولد ريلز الافتراضي. ومع ذلك، هناك شيء واحد مفقود، وهو الاختبارات لمولدنا الجديد؛ ولتصحيح ذلك، سنعيد استخدام مولدات الاختبار القديمة.

منذ الإصدار 3.0 من ريلز، هذا من السهل القيام به بسبب مفهوم الخطافات. لا يحتاج المساعد الجديد الخاص بنا إلى التركيز في إطار اختبار واحد محدد، بل يمكن ببساطة توفير خطاف وإطار اختبار يحتاج فقط إلى تنفيذ هذا الخطاف من أجل التوافق.

للقيام بذلك، يمكننا تغيير المولد بهذه الطريقة:
<syntaxhighlight lang="rails">
# lib/generators/rails/my_helper/my_helper_generator.rb
class Rails::MyHelperGenerator < Rails::Generators::NamedBase
  def create_helper_file
    create_file "app/helpers/#{file_name}_helper.rb", <<-FILE
module #{class_name}Helper
  attr_reader :#{plural_name}, :#{plural_name.singularize}
end
    FILE
  end
 
  hook_for :test_framework
end
</syntaxhighlight>

الآن، عندما يُستدعَى المولد المساعد وتُكون TestUnit كإطار اختبار، سيحاول استدعاء <code>Rails::TestUnitGenerator</code> و <code>TestUnit::MyHelperGenerator</code> كلاهما. نظرًا لأنه لم يُعرَّف أي منها، يمكننا أن نطلب من المولد الخاص بنا استدعاء <code>TestUnit::Generators::HelperGenerator</code> بدلًا من ذلك، إذ هو مُعرَّف لأنه مولد ريلز. للقيام بذلك، نحن بحاجة فقط إلى إضافة:
<syntaxhighlight lang="rails">
# :my_helper بدلًا من :helper ابحث عن
hook_for :test_framework, as: :helper
</syntaxhighlight>

والآن يمكنك إعادة تشغيل المولد scaffold لمورد آخر للتأكد من توليده للاختبارات أيضًا!

== تخصيص سير العمل الخاص بك عن طريق تغيير قوالب المولدات ==
في الخطوة أعلاه، أردنا ببساطة إضافة سطر إلى المساعد الذي اُنشأ، دون إضافة أي وظائف إضافية. هناك طريقة أبسط للقيام بذلك، ومن خلال استبدال قوالب المولدات الموجودة بالفعل، في تلك الحالة <code>Rails::Generators::HelperGenerator</code>.

في الإصدار 3.0 وما بعده من ريلز، لا تبحث المولدات فقط في المصدر الأصل عن القوالب، بل تبحث أيضًا عن القوالب في مسارات أخرى. واحد منهم هو lib/templates. بما أننا نريد تخصيص <code>Rails::Generators::HelperGenerator</code>، يمكننا القيام بذلك ببساطة عن طريق إنشاء نسخة القالب داخل lib/templates/rails/helper بالاسم helper.rb. لذلك دعنا ننشئ هذا الملف مع المحتوى التالي:
<syntaxhighlight lang="rails">
module <%= class_name %>Helper
  attr_reader :<%= plural_name %>, :<%= plural_name.singularize %>
end
</syntaxhighlight>

والرجوع إلى آخر تغيير في config/application.rb:
<syntaxhighlight lang="rails">
config.generators do |g|
  g.orm             :active_record
  g.template_engine :erb
  g.test_framework  :test_unit, fixture: false
  g.stylesheets     false
  g.javascripts     false
end
</syntaxhighlight>

إذا قمت بإنشاء مورد آخر، يمكنك أن ترى أننا نحصل على نفس النتيجة بالضبط! وهذا مفيد إذا كنت تريد تخصيص قوالب المولد scaffold و/أو تخطيطك من خلال إنشاء edit.html.erb و index.html.erb وما إلى ذلك داخل lib/templates/erb/scaffold.

تستخدم قوالب المولد scaffold في ريلز وسوم ERB بشكل متكرر؛ هذه الوسوم تحتاج إلى أن تُهرَّب بحيث يكون الناتج الذي أنشأه وسم ERB صالح.

على سبيل المثال، سيكون الوسم ERB المهرَّب التالي مطلوبًا في القالب (لاحظ الإشارة % الزائدة) ...
<syntaxhighlight lang="rails">
<%%= stylesheet_include_tag :application %>
</syntaxhighlight>

... لتوليد الناتج التالي:
<syntaxhighlight lang="rails">
<%= stylesheet_include_tag :application %>
</syntaxhighlight>

== إضافة تراجعات للمولدات ==
ميزة واحدة أخيرة حول المولدات التي هي مفيدة جدًا لمولدات المكوّنات الإضافيّة. على سبيل المثال، تخيل أنك تريد إضافة ميزة أعلى TestUnit مثل [https://github.com/thoughtbot/shoulda shoulda]. بما أن TestUnit ينفذ بالفعل جميع المولدات المطلوبة من قبل ريلز و shoulda يريد فقط استبدال جزء منه، فلا توجد حاجة إلى إعادة تشغيل بعض المولدات مرة أخرى، يمكن ببساطة أن تخبر ريلز باستخدام مولد TestUnit إذا لم يعثر على أي منها تحت مجال الاسم Shoulda.

يمكننا بسهولة محاكاة هذا السلوك عن طريق تغيير config/application.rb الخاص بنا مرة أخرى:
<syntaxhighlight lang="rails">
config.generators do |g|
  g.orm             :active_record
  g.template_engine :erb
  g.test_framework  :shoulda, fixture: false
  g.stylesheets     false
  g.javascripts     false
 
  # إضافة تراجع
  g.fallbacks[:shoulda] = :test_unit
end
</syntaxhighlight>

الآن، إذا أنشئت <code>Comment</code> عبر المولد scaffold، سترى أنه تُستدعَى المولدات shoulda، ثم يرجع إلى المولدات TestUnit في النهاية:
<syntaxhighlight lang="shell">

$ bin/rails generate scaffold Comment body:text
      invoke  active_record
      create    db/migrate/20130924143118_create_comments.rb
      create    app/models/comment.rb
      invoke    shoulda
      create      test/models/comment_test.rb
      create      test/fixtures/comments.yml
      invoke  resource_route
       route    resources :comments
      invoke  scaffold_controller
      create    app/controllers/comments_controller.rb
      invoke    erb
      create      app/views/comments
      create      app/views/comments/index.html.erb
      create      app/views/comments/edit.html.erb
      create      app/views/comments/show.html.erb
      create      app/views/comments/new.html.erb
      create      app/views/comments/_form.html.erb
      invoke    shoulda
      create      test/controllers/comments_controller_test.rb
      invoke    my_helper
      create      app/helpers/comments_helper.rb
      invoke    jbuilder
      create      app/views/comments/index.json.jbuilder
      create      app/views/comments/show.json.jbuilder
      invoke  test_unit
      create    test/application_system_test_case.rb
      create    test/system/comments_test.rb
      invoke  assets
      invoke    coffee
      create      app/assets/javascripts/comments.coffee
      invoke    scss

</syntaxhighlight>

تسمح التراجعات للمولدات الخاصة بك بتحمل مسؤولية واحدة، مما يزيد من إعادة استخدام الشيفرات ويقلل من مقدار التكرار.

== قوالب التطبيق ==
الآن بعد أن رأيت كيف يمكن استخدام المولدات داخل أحد التطبيقات، هل تعلم أيضًا أنه يمكن استخدامها أيضًا لإنشاء التطبيقات؟ يشار إلى هذا النوع من المولد باسم "قالب" (template). هذه نظرة عامة موجزة عن الواجهة Templates البرمجية. للحصول على التوثيق التفصيلي، انظر دليل [[Rails/rails application templates|قوالب تطبيقات ريلز]].
<syntaxhighlight lang="rails">
gem "rspec-rails", group: "test"
gem "cucumber-rails", group: "test"
 
if yes?("Would you like to install Devise?")
  gem "devise"
  generate "devise:install"
  model_name = ask("What would you like the user model to be called? [user]")
  model_name = "user" if model_name.blank?
  generate "devise", model_name
end
</syntaxhighlight>

في النموذج أعلاه، نحدد أن التطبيق يعتمد على الجوهرة rspec-rails والجوهرة cucumber-rails لذلك يُضافان إلى المجموعة test في الملف Gemfile.

ثم نطرح سؤالًا على المستخدم حول ما إذا كان يرغب في تثبيت Devise أم لا. إذا رد المستخدم "y" أو "yes" على هذا السؤال، سيضيف القالب Devise إلى الملف Gemfile خارج أي مجموعة، ثم يُشغل المولد <code>devise: install</code>.

ثم يأخذ هذا القالب مدخلات المستخدمين ويُشغل المولد devise، مع إجابة المستخدم من السؤال الأخير الذي مُرر إلى هذا المولد.

تخيل أن هذا القالب كان في ملف يسمى template.rb. يمكننا استخدامه لتعديل نتائج الأمر <code>rails new</code> باستخدام الخيار ‎<code>-m</code> وتمريره في اسم الملف:<syntaxhighlight lang="shell">
$ rails new thud -m template.rb
</syntaxhighlight>سيولد هذا الأمر التطبيق Thud، ثم يطبق القالب إلى الناتج المولد.

لا يجب تخزين القوالب على النظام المحلي، كما يدعم الخيار ‎<code>-m</code> أيضًا النماذج عبر الإنترنت:
<syntaxhighlight lang="shell">
$ rails new thud -m https://gist.github.com/radar/722911/raw/
</syntaxhighlight>

في حين أن القسم الأخير من هذا الدليل لا يغطي كيفية إنشاء أكثر النماذج روعة بالنسبة للإنسان، فإنه يأخذك عبر الطرق المتاحة تحت تصرفك حتى تتمكن من تطويرها بنفسك. هذه الأساليب نفسها متاحة للمولدات.

== إضافة وسائط سطر الأوامر ==
يمكن تعديل مولدات ريلز بسهولة لقبول وسائط سطر الأوامر المخصصة. هذه الوظيفة تأتي من Thor:
<syntaxhighlight lang="rails">
class_option :scope, type: :string, default: 'read_products'
</syntaxhighlight>

الآن يمكن استدعاء المولد الخاص بنا على النحو التالي:
<syntaxhighlight lang="shell">
rails generate initializer --scope write_products
</syntaxhighlight>

يمكن الوصول إلى وسائط سطر الأوامر من خلال التابع <code>options</code> داخل صنف المولد مثل:
<syntaxhighlight lang="rails">
@scope = options['scope']
</syntaxhighlight>

== توابع المولد ==
فيما يلي التوابع المتوفرة لكل من المولدات والقوالب الخاصة بريلز.

'''ملاحظة''': لا يُغطي هذا الدليل التوابع التي يقدمها Thor ويمكن العثور عليها في [http://rdoc.info/github/erikhuda/thor/master/Thor/Actions.html توثيق Thor].

=== <code>gem</code> ===
يحدد تبعية الجوهرة للتطبيق.
<syntaxhighlight lang="rails">
gem "rspec", group: "test", version: "2.1.0"
gem "devise", "1.1.5"
</syntaxhighlight>

الخيارات المتاحة هي:
* <code>group:‎</code> - المجموعة في الملف Gemfile حيث يجب أن تذهب هذه الجوهرة.
* <code>version:‎</code> - سلسلة إصدار الجوهرة التي تريد استخدامها. يمكن أيضًا تحديده كوسيطٍ ثانٍ للتابع.
* <code>git:‎</code> - عنوان URL لمستودع git لهذه الجوهرة.
تُوضع أي خيارات إضافية مُررت إلى هذا التابع في نهاية السطر:
<syntaxhighlight lang="rails">
gem "devise", git: "https://github.com/plataformatec/devise.git", branch: "master"
</syntaxhighlight>

ستضع الشيفرة السابقة السطر التالي في الملف Gemfile:
<syntaxhighlight lang="rails">
gem "devise", git: "https://github.com/plataformatec/devise.git", branch: "master"
</syntaxhighlight>

=== <code>gem_group</code> ===
يغلف مدخلات الجوهرة داخل المجموعة:
<syntaxhighlight lang="rails">
gem_group :development, :test do
  gem "rspec-rails"
end
</syntaxhighlight>

=== <code>add_source</code> ===
يضيف مصدرًا محددًا إلى الملف Gemfile:
<syntaxhighlight lang="rails">
add_source "http://gems.github.com"

</syntaxhighlight>

هذا التابع يأخذ أيضا كتلة:
<syntaxhighlight lang="rails">
add_source "http://gems.github.com" do
  gem "rspec-rails"
end
</syntaxhighlight>

=== <code>inject_into_file</code> ===
يحقن كتلة من التعليمات البرمجية في موضع محدد في ملفك.
<syntaxhighlight lang="rails">
inject_into_file 'name_of_file.rb', after: "#The code goes below this line. Don't forget the Line break at the end\n" do <<-'RUBY'
  puts "Hello World"
RUBY
end
</syntaxhighlight>
===<code>gsub_file</code>===
يستبدل نصًّا داخل الملف.<syntaxhighlight lang="rails">
gsub_file 'name_of_file.rb', 'method.to_be_replaced', 'method.the_replacing_code'
</syntaxhighlight>يمكن استخدام [[Ruby/Regexp|التعبيرات النمطية]] لجعل هذا التابع أكثر دقة. يمكنك أيضًا استخدام <code>append_file</code> و <code>prepend_file</code> بالطريقة نفسها لوضع الشفرة في بداية ونهاية الملف على التوالي.

=== <code>application</code> ===
يضيف سطرًا إلى config/application.rb مباشرةً بعد تعريف صنف التطبيق.
<syntaxhighlight lang="rails">
application "config.asset_host = 'http://example.com'"
</syntaxhighlight>

يمكن أن يأخذ هذا التابع أيضًا كتلة:
<syntaxhighlight lang="rails">
application do
  "config.asset_host = 'http://example.com'"
end
</syntaxhighlight>

الخيارات المتاحة هي:
* <code>env:‎</code> - حدد بيئة لخيار التوصيف هذا. إذا كنت ترغب في استخدام هذا الخيار مع صياغة الكتلة، تكون الصياغة الموصى بها كما يلي:
<syntaxhighlight lang="rails">
application(nil, env: "development") do
  "config.asset_host = 'http://localhost:3000'"
end
</syntaxhighlight>

=== <code>git</code> ===
يشغل الأمر <code>git</code> المحدد:
<syntaxhighlight lang="rails">
git :init
git add: "."
git commit: "-m First commit!"
git add: "onefile.rb", rm: "badfile.cxx"
</syntaxhighlight>

تكون قيم [[Ruby/Hash|الجدول Hash]] هنا هي الوسائط أو الخيارات التي مُررت إلى الأمر <code>git</code> المحدد. وفقًا للمثال النهائي الموضح هنا، يمكن تحديد عدة أوامر <code>git</code> في وقت واحد، ولكن لا يُضمن ترتيب تشغيلها بنفس الترتيب المحدد.

=== <code>vendor</code> ===
يضع ملفًا في vendor الذي يحتوي على الشيفرة المحددة.
<syntaxhighlight lang="rails">
vendor "sekrit.rb", '#top secret stuff'
</syntaxhighlight>

هذا التابع يأخذ أيضا كتلة:
<syntaxhighlight lang="rails">
vendor "seeds.rb" do
  "puts 'in your app, seeding your database'"
end
</syntaxhighlight>

=== <code>lib</code> ===
يضع ملفًا في lib يحتوي على الشيفرة المحددة.
<syntaxhighlight lang="rails">
lib "special.rb", "p Rails.root"
</syntaxhighlight>

هذا التابع يأخذ أيضا كتلة:
<syntaxhighlight lang="rails">
lib "super_special.rb" do
  "puts 'Super special!'"
end
</syntaxhighlight>

=== <code>rakefile</code> ===
ينشئ ملف Rake في دليل lib/tasks الخاص بالتطبيق.
<syntaxhighlight lang="rails">
rakefile "test.rake", 'task(:hello) { puts "Hello, there" }'
</syntaxhighlight>

هذا التابع يأخذ أيضا كتلة:
<syntaxhighlight lang="rails">
rakefile "test.rake" do
  %Q{
    task rock: :environment do
      puts "Rockin'"
    end
  }
end
</syntaxhighlight>

=== <code>initializer</code> ===
ينشئ مُهيئ في المجلد config/initializers للتطبيق:
<syntaxhighlight lang="rails">
initializer "begin.rb", "puts 'this is the beginning'"
</syntaxhighlight>

يأخذ هذا التابع أيضًا كتلة، ويتوقع أن يعيد سلسلة نصية:
<syntaxhighlight lang="rails">
initializer "begin.rb" do
  "puts 'this is the beginning'"
end
</syntaxhighlight>

=== <code>generate</code> ===
يشغِّل المولد المحدد حيث يكون الوسيط الأولى هو اسم المولد وتمرر الوسائط المتبقية مباشرة إلى المولد.
<syntaxhighlight lang="rails">
generate "scaffold", "forums title:string description:text"
</syntaxhighlight>

=== <code>rake</code> ===
يشغل مهمة Rake محددة.
<syntaxhighlight lang="rails">
rake "db:migrate"
</syntaxhighlight>

الخيارات المتاحة هي:
* <code>env:</code>‎  -  يحدد البيئة التي ستشغل مهمة rake.
* <code>sudo:‎</code> - يحدد تشغيل هذه المهمة باستخدام sudo أم لا. القيمة الافتراضية هي: <code>false</code>.

=== <code>route</code> ===
يضيف نصًا إلى الملف config/routes.rb:
<syntaxhighlight lang="rails">
route "resources :people"
</syntaxhighlight>

=== <code>readme</code> ===
يطبع محتويات الملف في <code>source_path</code> للقالب، عادة ما يكون README.
<syntaxhighlight lang="rails">
readme "README"
</syntaxhighlight>

== مصادر ==
* [https://guides.rubyonrails.org/generators.html صفحة Creating and Customizing Rails Generators & Templates في توثيق Ruby On Rails الرسمي.]
[[تصنيف:Rails]]
[[تصنيف:Rails Extending]]