bridgetown-core 1.0.0.beta1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b6953f85017e90090c0078b710b3e447b69366bd9fed38bd5e307ee72ae3181c
-  data.tar.gz: 863dcdcea016110ae4e05922f7357b866bd2a77998b5da78ffb92819238c59c4
+  metadata.gz: fdb62333635d80ceb9561a0cd9be68f0220ea729c8ac4505bb8e4460894075e1
+  data.tar.gz: f7377127b4d64846e694d8ba4c032706ed161ea1595cf8dbf3eca3d2b6e4692d
 SHA512:
-  metadata.gz: eb6a1aa56f1544fcc37c4e204df417b5d7d37fa0e219e6a484872cdf4defee1c165fda09f4f30486d64635ef9ab6cf6db3edc8c63316dd3e61ab37be1394443c
-  data.tar.gz: 81b03e750b6fe6b25c1fbb2e62350f2c2776bf4902c236c5299f90c653720037e74ae8500bf71d928825efd3d83c651ad1d80523cb1362a1db2100d8f88daef9
+  metadata.gz: 051a34337053c1370745d37a7cc3def36e1623193e4c03e0b1006d06280303ad5442c289465185314f916dbcf2aa1b1123990ca196041b03bf3804a03b36f695
+  data.tar.gz: d5adcc3f8c7c7938bbc220329c002c7cea281f4e21f8ea2bab685dabaffe48c5acca3998482d1e0ec6d0c7c172751c0c6b34481821f51b5d1ccc687b137e55a5

data/lib/bridgetown-core/commands/esbuild/esbuild.config.js

@@ -5,23 +5,27 @@ const outputFolder = "output"
 
 // You can customize this as you wish, perhaps to add new esbuild plugins.
 //
-// Eg:
+// ```
+// const path = require("path")
+// const esbuildCopy = require('esbuild-plugin-copy').default
+// const esbuildOptions = {
+//   plugins: [
+//     esbuildCopy({
+//       assets: {
+//         from: [path.resolve(__dirname, 'node_modules/somepackage/files/*')],
+//         to: [path.resolve(__dirname, 'output/_bridgetown/somepackage/files')],
+//       },
+//       verbose: false
+//     }),
+//   ]
+// }
+// ```
 //
-//  ```
-//  const path = require("path")
-//  const esbuildCopy = require('esbuild-plugin-copy').default
-//  const esbuildOptions = {
-//    plugins: [
-//      esbuildCopy({
-//        assets: {
-//          from: [path.resolve(__dirname, 'node_modules/somepackage/files/*')],
-//          to: [path.resolve(__dirname, 'output/_bridgetown/somepackage/files')],
-//        },
-//        verbose: false
-//      }),
-//    ]
-//  }
-//  ```
+// You can also support custom base_path deployments via changing `publicPath`.
+//
+// ```
+// const esbuildOptions = { publicPath: "/my_subfolder/_bridgetown/static" }
+// ```
 const esbuildOptions = {}
 
 build(outputFolder, esbuildOptions)

data/lib/bridgetown-core/concerns/site/configurable.rb

@@ -91,6 +91,8 @@ class Bridgetown::Site
     #   {Bridgetown.sanitized_path} method.
     # @return [Array<String>] Return an array of updated paths if multiple paths given.
     def in_source_dir(*paths)
+      # TODO: this operation is expensive across thousands of iterations. Look for ways
+      # to workaround use of this wherever possible...
       paths.reduce(source) do |base, path|
         Bridgetown.sanitized_path(base, path.to_s)
       end

data/lib/bridgetown-core/concerns/site/processable.rb

@@ -41,6 +41,7 @@ class Bridgetown::Site
       @documents = nil
       @docs_to_write = nil
       @liquid_renderer.reset
+      tmp_cache.clear
 
       if soft
         refresh_layouts_and_data

data/lib/bridgetown-core/concerns/site/renderable.rb

@@ -10,7 +10,7 @@ class Bridgetown::Site
       Bridgetown::Hooks.trigger :site, :pre_render, self
       execute_inline_ruby_for_layouts!
       render_resources
-      render_generated_pages
+      generated_pages.each(&:transform!)
       Bridgetown::Hooks.trigger :site, :post_render, self
     end
 
@@ -46,6 +46,32 @@ class Bridgetown::Site
       matches
     end
 
+    # @return [Array<Bridgetown::Layout>]
+    def validated_layouts_for(convertible, layout_name)
+      layout = layouts[layout_name]
+      warn_on_missing_layout convertible, layout, layout_name
+
+      layout_list = Set.new([layout])
+      while layout
+        layout_name = layout.data.layout
+        layout = layouts[layout_name]
+        warn_on_missing_layout convertible, layout, layout_name
+
+        layout_list << layout
+      end
+
+      layout_list.to_a.compact
+    end
+
+    def warn_on_missing_layout(convertible, layout, layout_name)
+      return unless layout.nil? && layout_name
+
+      Bridgetown.logger.warn(
+        "Build Warning:",
+        "Layout '#{layout_name}' requested via #{convertible.relative_path} does not exist."
+      )
+    end
+
     # Renders all resources
     # @return [void]
     def render_resources
@@ -58,14 +84,6 @@ class Bridgetown::Site
       end
     end
 
-    # Renders all generated pages
-    # @return [void]
-    def render_generated_pages
-      generated_pages.each do |page|
-        render_page page
-      end
-    end
-
     # Renders a content item while ensuring site locale is set if the data is available.
     # @param item [Document, Page, Bridgetown::Resource::Base] The item to render
     # @yield Runs the block in between locale setting and resetting
@@ -80,12 +98,5 @@ class Bridgetown::Site
         yield
       end
     end
-
-    # Regenerates a content item using {Renderer}
-    # @param item [Page] The page to render
-    # @return [void]
-    def render_page(page)
-      Bridgetown::Renderer.new(self, page).run
-    end
   end
 end

data/lib/bridgetown-core/concerns/transformable.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Bridgetown
+  module Transformable
+    # Transforms an input document by running it through available converters
+    # (requires a `converter` method to be present on the including class)
+    #
+    # @param document [Bridgetown::GeneratedPage, Bridgetown::Resource::Base]
+    # @return String
+    # @yieldparam converter [Bridgetown::Converter]
+    # @yieldparam index [Integer] index of the conversion step
+    # @yieldparam output [String]
+    def transform_content(document)
+      converters.each_with_index.inject(document.content.to_s) do |content, (converter, index)|
+        output = if converter.method(:convert).arity == 1
+                   converter.convert content
+                 else
+                   converter.convert content, document
+                 end
+
+        yield converter, index, output if block_given?
+
+        output.html_safe
+      rescue StandardError => e
+        Bridgetown.logger.error "Conversion error:",
+                                "#{converter.class} encountered an error while "\
+                                "converting `#{document.relative_path}'"
+        raise e
+      end
+    end
+
+    # Transforms an input document by placing it within the specified layout
+    #
+    # @param layout [Bridgetown::Layout]
+    # @param output [String] the output from document content conversions
+    # @param document [Bridgetown::GeneratedPage, Bridgetown::Resource::Base]
+    # @return String
+    # @yieldparam converter [Bridgetown::Converter]
+    # @yieldparam layout_output [String]
+    def transform_with_layout(layout, output, document)
+      layout_converters = site.matched_converters_for_convertible(layout)
+      layout_input = layout.content.dup
+
+      layout_converters.inject(layout_input) do |content, converter|
+        next(content) unless [2, -2].include?(converter.method(:convert).arity) # rubocop:disable Performance/CollectionLiteralInLoop
+
+        layout.current_document = document
+        layout.current_document_output = output
+        layout_output = converter.convert content, layout
+
+        yield converter, layout_output if block_given?
+
+        layout_output
+      rescue StandardError => e
+        Bridgetown.logger.error "Conversion error:",
+                                "#{converter.class} encountered an error while "\
+                                "converting `#{document.relative_path}'"
+        raise e
+      end
+    end
+  end
+end

data/lib/bridgetown-core/configurations/gh-pages/gh-pages.yml

@@ -0,0 +1,33 @@
+name: Deploy to GitHub pages
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+
+      - name: Setup Node
+        uses: actions/setup-node@v2
+        with:
+          node-version: "16"
+          cache: "yarn"
+      - run: yarn install
+
+      - name: Build
+        run: bin/bridgetown deploy
+
+      - name: Deploy
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./output

data/lib/bridgetown-core/configurations/gh-pages.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+`bundle lock --add-platform x86_64-linux`
+copy_file in_templates_dir("gh-pages.yml"), ".github/workflows/gh-pages.yml"
+
+# rubocop:disable Layout/LineLength
+say "🎉 A GitHub action to deploy your site to GitHub pages has been configured!"
+say ""
+
+say "🛠️  After pushing the action, go to your repository settings and configure GitHub Pages to deploy from the branch `gh-pages`."
+say ""
+
+say "You'll likely also need to set `base_path` in your `bridgetown.config.yml` to your repository's name. If you do this you'll need to use the `relative_url` helper for all links and assets in your HTML."
+say "If you're using esbuild for frontend assets, edit `esbuild.config.js` to update `publicPath`."
+say ""
+# rubocop:enable Layout/LineLength

data/lib/bridgetown-core/configurations/stimulus.rb

@@ -34,9 +34,10 @@ append_to_file(File.join(javascript_dir, "index.js")) do
 
       import controllers from "./controllers/**/*.{js,js.rb}"
       Object.entries(controllers).forEach(([filename, controller]) => {
-        if (filename.includes("_controller.")) {
+        if (filename.includes("_controller.") || filename.includes("-controller.")) {
           const identifier = filename.replace("./controllers/", "")
-            .replace(/_controller\..*$/, "")
+            .replace(/[_\-]controller\..*$/, "")
+            .replace("_", "-")
             .replace("/", "--")
 
           Stimulus.register(identifier, controller.default)

data/lib/bridgetown-core/configurations/vercel/vercel.json

@@ -0,0 +1,45 @@
+{
+  "cleanUrls": true,
+  "trailingSlash": false,
+  "redirects": [],
+  "headers": [
+    {
+      "source": "/(.*)",
+      "headers": [
+        {
+          "key": "X-Content-Type-Options",
+          "value": "nosniff"
+        },
+        {
+          "key": "X-Frame-Options",
+          "value": "DENY"
+        },
+        {
+          "key": "X-XSS-Protection",
+          "value": "1; mode=block"
+        },
+        {
+          "key": "Referrer-Policy",
+          "value": "strict-origin"
+        },
+        {
+          "key": "Permissions-Policy",
+          "value": "geolocation=(self), microphone=()"
+        }
+      ]
+    },
+    {
+      "source": "/feed.xml",
+      "headers": [
+        {
+          "key": "Content-Type",
+          "value": "application/rss+xml"
+        },
+        {
+          "key": "Cache-Control",
+          "value": "public, max-age=3600"
+        }
+      ]
+    }
+  ]
+}

data/lib/bridgetown-core/configurations/vercel/vercel_url.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+class Builders::VercelUrl < SiteBuilder
+  def build
+    hook :site, :pre_render do |site|
+      next unless ENV["VERCEL_URL"] && ENV["VERCEL_ENV"] != "production"
+
+      Bridgetown.logger.info("Subbing Vercel URL")
+      site.config.update(url: "https://#{ENV["VERCEL_URL"]}")
+    end
+  end
+end

data/lib/bridgetown-core/configurations/vercel.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+copy_file in_templates_dir("vercel.json"), "vercel.json"
+copy_file in_templates_dir("vercel_url.rb"), "plugins/builders/vercel_url.rb"

data/lib/bridgetown-core/converters/erb_templates.rb

@@ -83,16 +83,14 @@ module Bridgetown
       options.merge!(options[:locals]) if options[:locals]
       options[:content] = yield if block_given?
 
-      partial_segments = partial_name.split("/")
-      partial_segments.last.sub!(%r!^!, "_")
-      partial_name = partial_segments.join("/")
-
-      Tilt::ErubiTemplate.new(
-        site.in_source_dir(site.config[:partials_dir], "#{partial_name}.erb"),
+      partial_path = _partial_path(partial_name, "erb")
+      tmpl = site.tmp_cache["partial-tmpl:#{partial_path}"] ||= Tilt::ErubiTemplate.new(
+        partial_path,
         outvar: "@_erbout",
         bufval: "Bridgetown::OutputBuffer.new",
         engine_class: ERBEngine
-      ).render(self, options)
+      )
+      tmpl.render(self, options)
     end
   end
 

data/lib/bridgetown-core/converters/serbea_templates.rb

@@ -11,13 +11,10 @@ module Bridgetown
       options.merge!(options[:locals]) if options[:locals]
       options[:content] = capture(&block) if block
 
-      partial_segments = partial_name.split("/")
-      partial_segments.last.sub!(%r!^!, "_")
-      partial_name = partial_segments.join("/")
-
-      Tilt::SerbeaTemplate.new(
-        site.in_source_dir(site.config[:partials_dir], "#{partial_name}.serb")
-      ).render(self, options)
+      partial_path = _partial_path(partial_name, "serb")
+      tmpl = site.tmp_cache["partial-tmpl:#{partial_path}"] ||=
+        Tilt::SerbeaTemplate.new(partial_path)
+      tmpl.render(self, options)
     end
   end
 

data/lib/bridgetown-core/generated_page.rb

@@ -5,6 +5,7 @@ module Bridgetown
     include LayoutPlaceable
     include LiquidRenderable
     include Publishable
+    include Transformable
 
     attr_writer :dir
     attr_accessor :site, :paginator, :name, :ext, :basename, :data, :content, :output
@@ -12,7 +13,7 @@ module Bridgetown
     alias_method :extname, :ext
 
     # A set of extensions that are considered HTML or HTML-like so we
-    # should not alter them,  this includes .xhtml through XHTM5.
+    # should not alter them
 
     HTML_EXTENSIONS = %w(
       .html
@@ -54,11 +55,11 @@ module Bridgetown
       output || content || ""
     end
 
-    # Accessor for data properties by Liquid.
+    # Accessor for data properties by Liquid
     #
-    # property - The String name of the property to retrieve.
+    # @param property [String] name of the property to retrieve
     #
-    # Returns the String value or nil if the property isn't included.
+    # @return [Object]
     def [](property)
       data[property]
     end
@@ -67,7 +68,7 @@ module Bridgetown
     # upon generation. This is derived from the permalink or, if
     # permalink is absent, will be '/'
     #
-    # Returns the String destination directory.
+    # @return [String]
     def dir
       if url.end_with?("/")
         url
@@ -78,6 +79,8 @@ module Bridgetown
     end
 
     # Liquid representation of current page
+    #
+    # @return [Bridgetown::Drops::GeneratedPageDrop]
     def to_liquid
       @liquid_drop ||= Drops::GeneratedPageDrop.new(self)
     end
@@ -90,7 +93,7 @@ module Bridgetown
 
     # The template of the permalink.
     #
-    # Returns the template String.
+    # @return [String]
     def template
       if !html?
         "/:path/:basename:output_ext"
@@ -103,7 +106,7 @@ module Bridgetown
 
     # The generated relative url of this page. e.g. /about.html.
     #
-    # Returns the String url.
+    # @return [String]
     def url
       @url ||= URL.new(
         template: template,
@@ -123,6 +126,22 @@ module Bridgetown
       }
     end
 
+    # Layout associated with this resource
+    # This will output a warning if the layout can't be found.
+    #
+    # @return [Bridgetown::Layout]
+    def layout
+      return @layout if @layout
+      return if no_layout?
+
+      @layout = site.layouts[data.layout].tap do |layout|
+        unless layout
+          Bridgetown.logger.warn "Generated Page:", "Layout '#{data.layout}' " \
+                                                    "requested via #{relative_path} does not exist."
+        end
+      end
+    end
+
     # Overide this in subclasses for custom initialization behavior
     def process
       # no-op by default
@@ -139,21 +158,68 @@ module Bridgetown
       @relative_path ||= File.join(*[@dir, @name].map(&:to_s).reject(&:empty?)).delete_prefix("/")
     end
 
-    # FIXME: spinning up a new Renderer object just to get an extension
-    # seems excessive
-    #
     # The output extension of the page.
     #
-    # Returns the output extension
+    # @return [String]
     def output_ext
-      @output_ext ||= Bridgetown::Renderer.new(site, self).output_ext
+      @output_ext ||= (permalink_ext || converter_output_ext)
+    end
+
+    def permalink_ext
+      page_permalink = permalink
+      if page_permalink &&
+          !page_permalink.end_with?("/")
+        permalink_ext = File.extname(page_permalink)
+        permalink_ext unless permalink_ext.empty?
+      end
+    end
+
+    def converter_output_ext
+      if output_exts.size == 1
+        output_exts.last
+      else
+        output_exts[-2]
+      end
+    end
+
+    def output_exts
+      @output_exts ||= converters.filter_map do |c|
+        c.output_ext(extname)
+      end
+    end
+
+    # @return [Array<Bridgetown::Converter>]
+    def converters
+      @converters ||= site.matched_converters_for_convertible(self)
+    end
+
+    def transform!
+      Bridgetown.logger.debug "Transforming:", relative_path
+
+      trigger_hooks :pre_render
+      self.content = transform_content(self)
+      place_in_layout? ? place_into_layouts : self.output = content.dup
+      trigger_hooks :post_render
+
+      self
+    end
+
+    def place_into_layouts
+      Bridgetown.logger.debug "Placing in Layouts:", relative_path
+      rendered_output = content.dup
+
+      site.validated_layouts_for(self, data.layout).each do |layout|
+        rendered_output = transform_with_layout(layout, rendered_output, self)
+      end
+
+      self.output = rendered_output
     end
 
     # Obtain destination path.
     #
-    # dest - The String path to the destination dir.
+    # @param dest [String] path to the destination dir
     #
-    # Returns the destination file path String.
+    # @return [String]
     def destination(dest)
       path = site.in_dest_dir(dest, URL.unescape_path(url))
       path = File.join(path, "index") if url.end_with?("/")
@@ -163,9 +229,7 @@ module Bridgetown
 
     # Write the generated page file to the destination directory.
     #
-    # dest - The String path to the destination dir.
-    #
-    # Returns nothing.
+    # @param dest [String] path to the destination dir
     def write(dest)
       path = destination(dest)
       FileUtils.mkdir_p(File.dirname(path))

data/lib/bridgetown-core/rack/roda.rb

@@ -48,8 +48,6 @@ module Bridgetown
         Bridgetown::Current.preloaded_configuration ||=
           self.class.opts[:bridgetown_preloaded_config]
 
-        request.public
-
         request.root do
           output_folder = Bridgetown::Current.preloaded_configuration.destination
           File.read(File.join(output_folder, "index.html"))

data/lib/bridgetown-core/rack/routes.rb

@@ -41,6 +41,24 @@ module Bridgetown
         end
 
         def start!(roda_app)
+          if Bridgetown::Current.preloaded_configuration.base_path == "/"
+            load_all_routes roda_app
+            return
+          end
+
+          # Support custom base_path configurations
+          roda_app.request.on(
+            Bridgetown::Current.preloaded_configuration.base_path.delete_prefix("/")
+          ) do
+            load_all_routes roda_app
+          end
+
+          nil
+        end
+
+        def load_all_routes(roda_app)
+          roda_app.request.public
+
           if Bridgetown.env.development? &&
               !Bridgetown::Current.preloaded_configuration.skip_live_reload
             setup_live_reload roda_app
@@ -50,11 +68,9 @@ module Bridgetown
             klass.merge roda_app
           end
 
-          if defined?(Bridgetown::Routes::RodaRouter)
-            Bridgetown::Routes::RodaRouter.start!(roda_app)
-          end
+          return unless defined?(Bridgetown::Routes::RodaRouter)
 
-          nil
+          Bridgetown::Routes::RodaRouter.start!(roda_app)
         end
 
         def setup_live_reload(app) # rubocop:disable Metrics/AbcSize

data/lib/bridgetown-core/resource/base.rb

@@ -30,7 +30,7 @@ module Bridgetown
       def initialize(model:)
         @model = model
         @site = model.site
-        @data = front_matter_defaults
+        @data = collection.data? ? HashWithDotAccess::Hash.new : front_matter_defaults
 
         trigger_hooks :post_init
       end

data/lib/bridgetown-core/resource/transformer.rb

@@ -3,6 +3,8 @@
 module Bridgetown
   module Resource
     class Transformer
+      include Transformable
+
       # @return [Array<Hash>]
       attr_reader :conversions
 
@@ -30,10 +32,18 @@ module Bridgetown
         permalink_ext || output_ext
       end
 
-      def process!
+      def process! # rubocop:disable Metrics/AbcSize
         Bridgetown.logger.debug "Transforming:", resource.relative_path
         resource.around_hook :render do
-          run_conversions
+          resource.content = transform_content(resource) do |converter, index, output|
+            conversions[index] = {
+              type: :content,
+              converter: converter,
+              output: Bridgetown.env.production? ? nil : output,
+              output_ext: conversions[index]&.dig(:output_ext) ||
+                converter.output_ext(resource.extname),
+            }
+          end
           resource.place_in_layout? ? place_into_layouts : resource.output = resource.content.dup
         end
       end
@@ -85,95 +95,21 @@ module Bridgetown
           .fetch(:output_ext)
       end
 
-      # @return [Array<Bridgetown::Layout>]
-      def validated_layouts
-        layout = site.layouts[resource.data.layout]
-        warn_on_missing_layout layout, resource.data.layout
-
-        layout_list = Set.new([layout])
-        while layout
-          layout_name = layout.data.layout
-          layout = site.layouts[layout_name]
-          warn_on_missing_layout layout, layout_name
-
-          layout_list << layout
-        end
-
-        layout_list.to_a.compact
-      end
-
-      def warn_on_missing_layout(layout, layout_name)
-        return unless layout.nil? && layout_name
-
-        Bridgetown.logger.warn(
-          "Build Warning:",
-          "Layout '#{layout_name}' requested via #{resource.relative_path} does not exist."
-        )
-      end
-
-      ### Transformation Actions
-
-      def run_conversions # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
-        input = resource.content.to_s
-
-        # @param content [String]
-        # @param converter [Bridgetown::Converter]
-        resource.content = converters.each_with_index.inject(input) do |content, (converter, index)|
-          output = if converter.method(:convert).arity == 1
-                     converter.convert content
-                   else
-                     converter.convert content, resource
-                   end
-          conversions[index] = {
-            type: :content,
-            converter: converter,
-            output: Bridgetown.env.production? ? nil : output,
-            output_ext: conversions[index]&.dig(:output_ext) ||
-              converter.output_ext(resource.extname),
-          }
-          output.html_safe
-        rescue StandardError => e
-          Bridgetown.logger.error "Conversion error:",
-                                  "#{converter.class} encountered an error while "\
-                                  "converting `#{resource.relative_path}'"
-          raise e
-        end
-      end
-
       def place_into_layouts
         Bridgetown.logger.debug "Placing in Layouts:", resource.relative_path
         output = resource.content.dup
-        validated_layouts.each do |layout|
-          output = run_layout_conversions layout, output
+        site.validated_layouts_for(resource, resource.data.layout).each do |layout|
+          output = transform_with_layout(layout, output, resource) do |converter, layout_output|
+            conversions << {
+              type: :layout,
+              layout: layout,
+              converter: converter,
+              output: Bridgetown.env.production? ? nil : layout_output,
+            }
+          end
         end
         resource.output = output
       end
-
-      def run_layout_conversions(layout, output)
-        layout_converters = site.matched_converters_for_convertible(layout)
-        layout_input = layout.content.dup
-
-        layout_converters.inject(layout_input) do |content, converter|
-          next(content) unless [2, -2].include?(converter.method(:convert).arity) # rubocop:disable Performance/CollectionLiteralInLoop
-
-          layout.current_document = resource
-          layout.current_document_output = output
-          layout_output = converter.convert content, layout
-
-          conversions << {
-            type: :layout,
-            layout: layout,
-            converter: converter,
-            output: Bridgetown.env.production? ? nil : layout_output,
-          }
-          layout_output
-        rescue StandardError => e
-          Bridgetown.logger.error "Conversion error:",
-                                  "#{converter.class} encountered an error while "\
-                                  "converting `#{resource.relative_path}'"
-          raise e
-        end
-      end
     end
   end
 end

data/lib/bridgetown-core/ruby_template_view.rb

@@ -107,5 +107,12 @@ module Bridgetown
         strict_variables: site.config["liquid"]["strict_variables"],
       }
     end
+
+    def _partial_path(partial_name, ext)
+      partial_name = partial_name.split("/").tap { _1.last.prepend("_") }.join("/")
+
+      # TODO: see if there's a workaround for this to speed up performance
+      site.in_source_dir(site.config[:partials_dir], "#{partial_name}.#{ext}")
+    end
   end
 end

data/lib/bridgetown-core/site.rb

@@ -53,6 +53,7 @@ module Bridgetown
       @reader          = Reader.new(self)
       @liquid_renderer = LiquidRenderer.new(self)
 
+      Bridgetown::Cache.base_cache["site_tmp"] = {}.with_dot_access
       ensure_not_in_dest
 
       Bridgetown::Current.site = self
@@ -74,6 +75,10 @@ module Bridgetown
       end
     end
 
+    def tmp_cache
+      Bridgetown::Cache.base_cache["site_tmp"]
+    end
+
     def inspect
       "#<Bridgetown::Site #{metadata.inspect.delete_prefix("{").delete_suffix("}")}>"
     end

data/lib/bridgetown-core/utils/loaders_manager.rb

@@ -33,6 +33,12 @@ module Bridgetown
           return
         end
 
+        if defined?(ActiveSupport::RubyFeatures) && ActiveSupport::RubyFeatures::CLASS_SUBCLASSES
+          ActiveSupport::DescendantsTracker.clear([value.superclass])
+          return
+        end
+
+        # TODO: this could probably be refactored to work like the above
         ActiveSupport::DescendantsTracker.class_variable_get(
           :@@direct_descendants
         )[value.superclass]&.reject! { _1 == value }

data/lib/bridgetown-core/utils.rb

@@ -457,7 +457,7 @@ module Bridgetown
       code = <<~JAVASCRIPT
         let lastmod = 0
         function startReloadConnection() {
-          const evtSource = new EventSource("/_bridgetown/live_reload")
+          const evtSource = new EventSource("#{site.base_path(strip_slash_only: true)}/_bridgetown/live_reload")
           evtSource.onmessage = event => {
             if (event.data == "reloaded!") {
               location.reload()

data/lib/bridgetown-core/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Bridgetown
-  VERSION = "1.0.0.beta1"
+  VERSION = "1.0.0"
   CODE_NAME = "Pearl"
 end

data/lib/bridgetown-core.rb

@@ -92,11 +92,11 @@ module Bridgetown
   autoload :Publishable,         "bridgetown-core/concerns/publishable"
   autoload :Publisher,           "bridgetown-core/publisher"
   autoload :Reader,              "bridgetown-core/reader"
-  autoload :Renderer,            "bridgetown-core/renderer"
   autoload :RubyTemplateView,    "bridgetown-core/ruby_template_view"
   autoload :LogWriter,           "bridgetown-core/log_writer"
   autoload :Site,                "bridgetown-core/site"
   autoload :StaticFile,          "bridgetown-core/static_file"
+  autoload :Transformable,       "bridgetown-core/concerns/transformable"
   autoload :URL,                 "bridgetown-core/url"
   autoload :Utils,               "bridgetown-core/utils"
   autoload :VERSION,             "bridgetown-core/version"

data/lib/site_template/Gemfile.erb

@@ -26,4 +26,4 @@ gem "bridgetown", "~> <%= Bridgetown::VERSION %>"
 
 # Puma is a Rack-compatible server used by Bridgetown
 # (you can optionally limit this to the "development" group)
-gem "puma", "~> 5.5"
+gem "puma", "~> 5.6"

data/lib/site_template/TEMPLATES/erb/_components/shared/navbar.erb

@@ -1,11 +1,11 @@
 <header>
-  <img src="/images/logo.svg" alt="Logo" />
+  <img src="<%= relative_url '/images/logo.svg' %>" alt="Logo" />
 </header>
 
 <nav>
   <ul>
-    <li><a href="/">Home</a></li>
-    <li><a href="/about">About</a></li>
-    <li><a href="/posts">Posts</a></li>
+    <li><a href="<%= relative_url '/' %>">Home</a></li>
+    <li><a href="<%= relative_url '/about' %>">About</a></li>
+    <li><a href="<%= relative_url '/posts' %>">Posts</a></li>
   </ul>
 </nav>

data/lib/site_template/TEMPLATES/liquid/_components/navbar.liquid

@@ -1,11 +1,11 @@
 <header>
-  <img src="/images/logo.svg" alt="Logo" />
+  <img src="{{ '/images/logo.svg' | relative_url }}" alt="Logo" />
 </header>
 
 <nav>
   <ul>
-    <li><a href="/">Home</a></li>
-    <li><a href="/about">About</a></li>
-    <li><a href="/posts">Posts</a></li>
+    <li><a href="{{ '/' | relative_url }}">Home</a></li>
+    <li><a href="{{ '/about' | relative_url }}">About</a></li>
+    <li><a href="{{ '/posts' | relative_url }}">Posts</a></li>
   </ul>
 </nav>

data/lib/site_template/TEMPLATES/serbea/_components/shared/navbar.serb

@@ -1,11 +1,11 @@
 <header>
-  <img src="/images/logo.svg" alt="Logo" />
+  <img src="{{ '/images/logo.svg' | relative_url }}" alt="Logo" />
 </header>
 
 <nav>
   <ul>
-    <li><a href="/">Home</a></li>
-    <li><a href="/about">About</a></li>
-    <li><a href="/posts">Posts</a></li>
+    <li><a href="{{ '/' | relative_url }}">Home</a></li>
+    <li><a href="{{ '/about' | relative_url }}">About</a></li>
+    <li><a href="{{ '/posts' | relative_url }}">Posts</a></li>
   </ul>
 </nav>

data/lib/site_template/bridgetown.config.yml

@@ -19,8 +19,12 @@ url: "" # the base hostname & protocol for your site, e.g. https://example.com
 permalink: pretty
 
 # Other options you might want to investigate:
-# 
-# base_path: "/" # the subpath of your site, e.g. /blog
+#
+# base_path: "/" # the subpath of your site, e.g. /blog. If you set this option,
+# ensure you use the `relative_url` helper for all links and assets in your HTML.
+# If you're using esbuild for frontend assets, edit `esbuild.config.js` to
+# update `publicPath`.
+
 # timezone: America/Los_Angeles
 # pagination:
-#   enabled: true
+#   enabled: true

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bridgetown-core
 version: !ruby/object:Gem::Version
-  version: 1.0.0.beta1
+  version: 1.0.0
 platform: ruby
 authors:
 - Bridgetown Team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-13 00:00:00.000000000 Z
+date: 2022-03-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -418,6 +418,7 @@ files:
 - lib/bridgetown-core/concerns/site/renderable.rb
 - lib/bridgetown-core/concerns/site/ssr.rb
 - lib/bridgetown-core/concerns/site/writable.rb
+- lib/bridgetown-core/concerns/transformable.rb
 - lib/bridgetown-core/configuration.rb
 - lib/bridgetown-core/configurations/.keep
 - lib/bridgetown-core/configurations/bt-postcss.rb
@@ -430,6 +431,8 @@ files:
 - lib/bridgetown-core/configurations/cypress/cypress_dir/support/commands.js
 - lib/bridgetown-core/configurations/cypress/cypress_dir/support/index.js
 - lib/bridgetown-core/configurations/cypress/cypress_tasks
+- lib/bridgetown-core/configurations/gh-pages.rb
+- lib/bridgetown-core/configurations/gh-pages/gh-pages.yml
 - lib/bridgetown-core/configurations/minitesting.rb
 - lib/bridgetown-core/configurations/netlify.rb
 - lib/bridgetown-core/configurations/netlify/netlify.sh
@@ -443,6 +446,9 @@ files:
 - lib/bridgetown-core/configurations/tailwindcss/postcss.config.js
 - lib/bridgetown-core/configurations/turbo.rb
 - lib/bridgetown-core/configurations/turbo/turbo_transitions.js
+- lib/bridgetown-core/configurations/vercel.rb
+- lib/bridgetown-core/configurations/vercel/vercel.json
+- lib/bridgetown-core/configurations/vercel/vercel_url.rb
 - lib/bridgetown-core/converter.rb
 - lib/bridgetown-core/converters/erb_templates.rb
 - lib/bridgetown-core/converters/identity.rb
@@ -505,7 +511,6 @@ files:
 - lib/bridgetown-core/readers/defaults_reader.rb
 - lib/bridgetown-core/readers/layout_reader.rb
 - lib/bridgetown-core/readers/plugin_content_reader.rb
-- lib/bridgetown-core/renderer.rb
 - lib/bridgetown-core/resource/base.rb
 - lib/bridgetown-core/resource/destination.rb
 - lib/bridgetown-core/resource/permalink_processor.rb
@@ -602,9 +607,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubygems_version: 3.1.4
 signing_key: 

data/lib/bridgetown-core/renderer.rb

@@ -1,169 +0,0 @@
-# frozen_string_literal: true
-
-module Bridgetown
-  # This class handles the output rendering and layout placement of pages and
-  # documents. For rendering of resources in particular, see Bridgetown::Resource::Transformer
-  class Renderer
-    attr_reader :document, :site
-
-    def initialize(site, document)
-      @site     = site
-      @document = document
-    end
-
-    # Determine which converters to use based on this document's
-    # extension.
-    #
-    # Returns Array of Converter instances.
-    def converters
-      @converters ||= site.converters.select do |converter|
-        if converter.method(:matches).arity == 1
-          converter.matches(document.extname)
-        else
-          converter.matches(document.extname, document)
-        end
-      end.sort
-    end
-
-    # Determine the extname the outputted file should have
-    #
-    # Returns String the output extname including the leading period.
-    def output_ext
-      @output_ext ||= (permalink_ext || converter_output_ext)
-    end
-
-    # Run hooks and render the document
-    #
-    # Returns nothing
-    def run
-      Bridgetown.logger.debug "Rendering:", document.relative_path
-
-      document.trigger_hooks :pre_render
-      document.output = render_document
-      document.trigger_hooks :post_render
-    end
-
-    # Render the document.
-    #
-    # Returns String rendered document output
-    def render_document
-      execute_inline_ruby!
-
-      output = document.content
-      Bridgetown.logger.debug "Rendering Markup:", document.relative_path
-      output = convert(output.to_s, document)
-      document.content = output.html_safe
-
-      if document.place_in_layout?
-        Bridgetown.logger.debug "Rendering Layout:", document.relative_path
-        output = place_in_layouts(output)
-      end
-
-      output
-    end
-
-    def execute_inline_ruby!
-      return unless site.config.should_execute_inline_ruby?
-
-      Bridgetown::Utils::RubyExec.search_data_for_ruby_code(document)
-    end
-
-    # Convert the document using the converters which match this renderer's document.
-    #
-    # Returns String the converted content.
-    def convert(content, document)
-      converters.reduce(content) do |output, converter|
-        if converter.method(:convert).arity == 1
-          converter.convert output
-        else
-          converter.convert output, document
-        end
-      rescue StandardError => e
-        Bridgetown.logger.error "Conversion error:",
-                                "#{converter.class} encountered an error while "\
-                                "converting `#{document.relative_path}'"
-        raise e
-      end
-    end
-
-    # Render layouts and place document content inside.
-    #
-    # Returns String rendered content
-    def place_in_layouts(content)
-      output = content.dup
-      layout = site.layouts[document.data["layout"]]
-      validate_layout(layout)
-
-      used = Set.new([layout])
-
-      while layout
-        output = render_layout(output, layout)
-
-        next unless (layout = site.layouts[layout.data["layout"]])
-        break if used.include?(layout)
-
-        used << layout
-      end
-      output
-    end
-
-    private
-
-    # Checks if the layout specified in the document actually exists
-    #
-    # layout - the layout to check
-    # Returns nothing
-    def validate_layout(layout)
-      return unless document.data["layout"].present? &&
-        layout.nil? &&
-        !(document.is_a? Bridgetown::Excerpt)
-
-      Bridgetown.logger.warn "Build Warning:", "Layout '#{document.data["layout"]}' requested " \
-                                               "in #{document.relative_path} does not exist."
-    end
-
-    # Render layout content into document.output
-    #
-    # Returns String rendered content
-    def render_layout(output, layout)
-      layout_converters = site.matched_converters_for_convertible(layout)
-
-      layout_content = layout.content.dup
-      layout_converters.reduce(layout_content) do |layout_output, converter|
-        next(layout_output) unless converter.method(:convert).arity == 2
-
-        layout.current_document = document
-        layout.current_document_output = output
-        converter.convert layout_output, layout
-      rescue StandardError => e
-        Bridgetown.logger.error "Conversion error:",
-                                "#{converter.class} encountered an error while "\
-                                "converting `#{document.relative_path}'"
-        raise e
-      end
-    end
-
-    def permalink_ext
-      document_permalink = document.permalink
-      if document_permalink &&
-          !document_permalink.end_with?("/")
-        permalink_ext = File.extname(document_permalink)
-        permalink_ext unless permalink_ext.empty?
-      end
-    end
-
-    def converter_output_ext
-      if output_exts.size == 1
-        output_exts.last
-      else
-        output_exts[-2]
-      end
-    end
-
-    def output_exts
-      @output_exts ||= converters.filter_map do |c|
-        c.output_ext(document.extname)
-      end
-    end
-  end
-end