Support Rails v6.0 document (#74)

* Create collections

ref. https://jekyllrb.com/docs/step-by-step/09-collections/

* Define collections

* Create mkdir rake task

* Add: switch_rails method

* Define specific_version under version

* Enhance switch_rails

* mkdir && switch_rails

* Update submodule: v6.0.3

* Set frozen_string_literal

* Change collection config format

ref. https://jekyllrb.com/docs/step-by-step/09-collections/

* Use just each

* Float to String

```
jekyll/collection.rb:163:in `sanitize_label': undefined method `gsub' for 6.0:Float (NoMethodError)
```

* Create version directory inside src

* Add: generate_rails_rdoc, generate_src

* Add target_version to generate_src

* Define INDEX_HTML

* mv navigation.html

* collections→rails_versions

* main: Rails v6, sub: Rails v5

* Create build_multi task

* Set scope for Rails 5.2 path

* Change navigation path

* Replace link path

* Replace path

* Add files for Rails v5.2

* Bump bootstrap from 4.5 to 4.6

ref. https://getbootstrap.com/docs/4.6/getting-started/introduction/

* Set navbar-expand to header

* Display version selector

* target_rails_version→default_rails_version

* Add doc-build to CI

* Add require

* Create symbolic link for default version

* Set default page.version

* checkout with submodule

* Use macOS for doc build

* Bump rails: 6.0.3→6.0.3.6

* sed shell script → ruby File read/write

to make it OS-agnostic

* Revert "Use macOS for doc build"

This reverts commit 895c0d2.

* switch_default_rails→build

* Revert "switch_default_rails→build"

This reverts commit 3eb87b8.

* Update ci.yml

* Generate Rails v6.0 doc

Author: toshimaru

.github/workflows/ci.yml

@@ -1,14 +1,28 @@
 name: CI
-on: [push]
+on: [push, pull_request]
 jobs:
-  build:
+  jekyll-build:
     runs-on: ubuntu-latest
     name: Jekyll Build
     steps:
     - uses: actions/checkout@v2
     - uses: ruby/setup-ruby@v1
       with:
         ruby-version: 3.0
-        bundler-cache: true 
+        bundler-cache: true
     - name: Jekyll Build
       run: bundle exec jekyll build
+  doc-build:
+    runs-on: ubuntu-latest
+    name: Rails Doc Build
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        submodules: true
+    - uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 2.7
+        bundler-cache: true
+    - name: Doc Build
+      run: |
+        rake build

Rakefile

@@ -1,31 +1,77 @@
+# frozen_string_literal: true
+
+require 'yaml'
+require 'bundler'
+
+SOURCE_DIR = "src"
+INDEX_HTML = 'files/railties/RDOC_MAIN_rdoc.html'
+
 task :build do
+  generate_rails_rdoc
+  generate_src
+
+  sh 'bundle exec jekyll build'
+end
+
+task :switch_default_rails do
+  switch_rails(config["default_rails_version"])
+end
+
+task :build_multi do
+  config["rails_versions"].each do |version, detail|
+    dir = "#{SOURCE_DIR}/#{version}"
+    mkdir dir unless Dir.exist?(dir)
+
+    bulid_version = detail["specific_version"]
+    switch_rails(bulid_version)
+    generate_rails_rdoc
+    generate_src(target_version: version)
+  end
+end
+
+def config
+  YAML.load_file('./_config.yml')
+end
+
+def switch_rails(version)
+  cd 'rails' do
+    sh "git reset --hard"
+    sh "git switch refs/tags/v#{version} -C v#{version}"
+  end
+end
+
+def generate_rails_rdoc
   cd 'rails' do
     Bundler.with_unbundled_env do
-      sh %(sed -i '' -e 's/sdoc.*$/sdoc", github: "toshimaru\\/sdoc", branch: "railsdoc"/g' ./Gemfile)
+      # replace sdoc gem
+      gemfile = File.read("Gemfile")
+      gemfile.gsub!(/"sdoc.*$/, '"sdoc", github: "toshimaru/sdoc", branch: "railsdoc"')
+      File.write("Gemfile", gemfile)
+
       sh 'bundle install && bundle update sdoc'
       rm_rf 'doc'
       sh 'bundle exec rake rdoc'
     end
   end
+end
 
+def generate_src(target_version: nil)
   copy_sources = Dir.glob('rails/doc/rdoc/*').reject { |path| path.end_with?("panel", "js", "created.rid") }
-  cp_r copy_sources, 'src/'
+  target_dir = "#{SOURCE_DIR}/#{target_version}"
+  cp_r copy_sources, target_dir
 
-  cd 'src' do
-    cp 'files/railties/RDOC_MAIN_rdoc.html', 'index.html'
-    mv 'navigation.html', '_includes/navigation.html', force: true
-  end
-
-  sh 'bundle exec jekyll build'
-end
+  cd target_dir do
+    cp INDEX_HTML, 'index.html'
 
-task :switch_rails do
-  require 'yaml'
+    if target_version.nil?
+      mv 'navigation.html', '_includes/navigation.html', force: true
+    else
+      # Replace absolute path in navigation.html
+      content = File.read("navigation.html")
+      content.gsub!("<a href=\"/", "<a href=\"/#{target_version}/")
+      File.write("navigation.html", content)
 
-  config = YAML.load_file('./_config.yml')
-  target_rails_version = config["target_rails_version"]
-
-  cd 'rails' do
-    sh "git switch v#{target_rails_version} -c v#{target_rails_version}"
+      mv 'navigation.html', "../_includes/navigation#{target_version}.html", force: true
+    end
   end
 end

_config.yml

@@ -2,7 +2,12 @@ title: RailsDoc(β)
 description: Ruby on Rails API Documentation.
 url: https://railsdoc.github.io
 source: src
-target_rails_version: 5.2.5
+default_rails_version: 6.0.3.6
+rails_versions:
+  # "6.0":
+  #   specific_version: "6.0.3"
+  "5.2":
+    specific_version: "5.2.5"
 plugins:
   - jekyll-include-cache
   - jekyll-redirect-from
@@ -17,5 +22,10 @@ defaults:
   - scope:
       path: ""
     values:
+      version: 6.0
       image: https://avatars.githubusercontent.com/u/4223
       toc: true
+  - scope:
+      path: "5.2"
+    values:
+      version: 5.2

rails

@@ -0,0 +1,122 @@
+---
+title: AbstractController
+layout: default
+---
+<div class="main">
+    <div class="banner">
+        
+            <span>Ruby on Rails 5.2.5</span><br />
+        
+        <div class="type">Module</div>
+        <h1>
+            AbstractController
+            
+        </h1>
+        <ul class="files">
+            
+            <li><a href="../files/actionpack/lib/abstract_controller/asset_paths_rb.html">actionpack/lib/abstract_controller/asset_paths.rb</a></li>
+            
+            <li><a href="../files/actionpack/lib/abstract_controller/base_rb.html">actionpack/lib/abstract_controller/base.rb</a></li>
+            
+            <li><a href="../files/actionpack/lib/abstract_controller/caching_rb.html">actionpack/lib/abstract_controller/caching.rb</a></li>
+            
+            <li><a href="../files/actionpack/lib/abstract_controller/caching/fragments_rb.html">actionpack/lib/abstract_controller/caching/fragments.rb</a></li>
+            
+            <li><a href="../files/actionpack/lib/abstract_controller/callbacks_rb.html">actionpack/lib/abstract_controller/callbacks.rb</a></li>
+            
+            <li><a href="../files/actionpack/lib/abstract_controller/collector_rb.html">actionpack/lib/abstract_controller/collector.rb</a></li>
+            
+            <li><a href="../files/actionpack/lib/abstract_controller/error_rb.html">actionpack/lib/abstract_controller/error.rb</a></li>
+            
+            <li><a href="../files/actionpack/lib/abstract_controller/helpers_rb.html">actionpack/lib/abstract_controller/helpers.rb</a></li>
+            
+            <li><a href="../files/actionpack/lib/abstract_controller/logger_rb.html">actionpack/lib/abstract_controller/logger.rb</a></li>
+            
+            <li><a href="../files/actionpack/lib/abstract_controller/railties/routes_helpers_rb.html">actionpack/lib/abstract_controller/railties/routes_helpers.rb</a></li>
+            
+            <li><a href="../files/actionpack/lib/abstract_controller/rendering_rb.html">actionpack/lib/abstract_controller/rendering.rb</a></li>
+            
+            <li><a href="../files/actionpack/lib/abstract_controller/translation_rb.html">actionpack/lib/abstract_controller/translation.rb</a></li>
+            
+            <li><a href="../files/actionpack/lib/abstract_controller/url_for_rb.html">actionpack/lib/abstract_controller/url_for.rb</a></li>
+            
+            <li><a href="../files/actionpack/lib/action_controller/metal/redirecting_rb.html">actionpack/lib/action_controller/metal/redirecting.rb</a></li>
+            
+            <li><a href="../files/actionpack/lib/action_controller/metal/rendering_rb.html">actionpack/lib/action_controller/metal/rendering.rb</a></li>
+            
+            <li><a href="../files/railties/lib/rails/mailers_controller_rb.html">railties/lib/rails/mailers_controller.rb</a></li>
+            
+        </ul>
+    </div>
+    <div id="bodyContent">
+        <div id="content">
+  
+
+  
+
+  
+  
+
+
+  
+    <h2 id="namespace">Namespace</h2>
+
+    
+      <h3 id="module">Module</h3>
+      <ul>
+      
+        <li><a href="AbstractController/Caching.html">AbstractController::Caching</a></li>
+      
+        <li><a href="AbstractController/Callbacks.html">AbstractController::Callbacks</a></li>
+      
+        <li><a href="AbstractController/Collector.html">AbstractController::Collector</a></li>
+      
+        <li><a href="AbstractController/Helpers.html">AbstractController::Helpers</a></li>
+      
+        <li><a href="AbstractController/Railties.html">AbstractController::Railties</a></li>
+      
+        <li><a href="AbstractController/Rendering.html">AbstractController::Rendering</a></li>
+      
+        <li><a href="AbstractController/Translation.html">AbstractController::Translation</a></li>
+      
+        <li><a href="AbstractController/UrlFor.html">AbstractController::UrlFor</a></li>
+      
+      </ul>
+    
+
+    
+      <h3 id="class">Class</h3>
+      <ul>
+      
+        <li><a href="AbstractController/ActionNotFound.html">AbstractController::ActionNotFound</a></li>
+      
+        <li><a href="AbstractController/Base.html">AbstractController::Base</a></li>
+      
+        <li><a href="AbstractController/DoubleRenderError.html">AbstractController::DoubleRenderError</a></li>
+      
+      </ul>
+    
+  
+
+  
+
+  
+
+  
+    
+
+    
+
+    
+
+    
+
+    <!-- Methods -->
+    
+    
+    
+  
+</div>
+
+    </div>
+</div>

src/5.2/classes/AbstractController.html

@@ -0,0 +1,66 @@
+---
+title: AbstractController::ActionNotFound
+layout: default
+---
+<div class="main">
+    <div class="banner">
+        
+            <span>Ruby on Rails 5.2.5</span><br />
+        
+        <div class="type">Class</div>
+        <h1>
+            AbstractController::ActionNotFound
+            
+                <span class="parent">&lt;
+                    
+                    StandardError
+                    
+                </span>
+            
+        </h1>
+        <ul class="files">
+            
+            <li><a href="../../files/actionpack/lib/abstract_controller/base_rb.html">actionpack/lib/abstract_controller/base.rb</a></li>
+            
+        </ul>
+    </div>
+    <div id="bodyContent">
+        <div id="content">
+  
+    <div class="description">
+      
+<p>Raised when a non-existing controller action is triggered.</p>
+
+    </div>
+  
+
+  
+
+  
+  
+
+
+  
+
+  
+
+  
+
+  
+    
+
+    
+
+    
+
+    
+
+    <!-- Methods -->
+    
+    
+    
+  
+</div>
+
+    </div>
+</div>