docs: improve/fix jekyll setup

.gitignore

@@ -171,7 +171,6 @@
 
 # Ignore generated documentation site
 /docs/_site
-/docs/bin
 /docs/.jekyll-metadata
 /docs/vendor
 /docs/Gemfile.lock

docs/Brewfile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+brew "ruby", version_file: ".ruby-version"
+brew "xz"

docs/Gemfile

@@ -6,6 +6,10 @@ ruby file: ".ruby-version"
 
 gem "github-pages", group: :jekyll_plugins
 
+gem "csv"
+gem "faraday-retry"
+gem "logger"
+
 group :test do
   gem "html-proofer"
   gem "mdl"

docs/bin/jekyll

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'jekyll' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("jekyll", "jekyll")