jekyll-pagefind 0.2.1 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da6350f1cdab2054988ffbd388592a97df71a8a193dd7c086c94f56f63073ae1
-  data.tar.gz: 41ef3c9bbb2e05ab8b7e960ba36f52bb444295f3bf209036635987917d7dc5c9
+  metadata.gz: c6a6ae1c10bcf3ddee440029416aa37c11b0d70e5f90a59e1685691f0a87f65e
+  data.tar.gz: 145d9445e2fcbf64a2671ede567f55aedd69c97431c29032add38fd29593ae91
 SHA512:
-  metadata.gz: 84ceb9bcaeb5feaae2f28c00be44de3a03ceaa8eb26adf0f5060a22807558a0f50f8f4b81179438b88d6971e13cdf44f4089c6e1db3e2a0e4bd2ec8a8968070d
-  data.tar.gz: 8902b9fcb368cec056f541b07a92753e05b98862be590aaaa8ddbc649fc203bd01061919f9689f2836a14fbd5b55ca42842309c683778dddfca5377970560c6e
+  metadata.gz: e0ae99d131a81b48e55c73f01c63bf17dfdf1badea3a66244d2fce2d563610e20af64d3bf1d73636e20bd4d4012ad70784f7df6db66b5f9876ea1b76427a09ea
+  data.tar.gz: c8d0cc4a8cc1ac8ce6b36b7f4c96150f30e37cbf7c4e43d4e41ef10d7fff85f50ee7638b2c2544a84681352a8efb89896f22ec957244845ba2ada14c86bba995

data/README.md

@@ -1,29 +1,25 @@
 <!-- markdownlint-disable MD033 -->
 <!-- markdownlint-disable MD041 -->
 <p align="center">
-<img src="https://github.com/phothinmg/jekykll-pagefind/blob/main/rubygems_logo.png" width="160" height="160" alt="mmdevs" style="border-radius:50%" />
+<img src="https://susee.phothin.dev/logo/rubygems_logo.png" width="160" height="160" alt="mmdevs" style="border-radius:50%" />
 </p>
-<h1 align="center">Jekyll::Pagefind</h1>
+<h1 align="center">jekyll-pagefind</h1>
 
 [![Gem Version](https://badge.fury.io/rb/jekyll-pagefind.svg?icon=si%3Arubygems)](https://badge.fury.io/rb/jekyll-pagefind)
 
 ## Overview
 
-Jekyll-Pagefind is a plugin I use for my personal and project sites. It was inspired by [Adding search to Jekyll using pagefind][pf_to_jekyll]. It fits easily into the default Jekyll GitHub Actions workflow for deploying to GitHub Pages.
+Jekyll-Pagefind is a plugin that runs the Pagefind binary for a Jekyll site.
 
 ## Install
 
-Install the gem and add to the application's Gemfile by executing:
+Install the gem and add it to your application's Gemfile by running:
 
 ```sh
 bundle add jekyll-pagefind
 ```
 
-```sh
-bundle install
-```
-
-In `Gemfile`
+In your `Gemfile`:
 
 ```ruby
 group :jekyll_plugins do
@@ -32,53 +28,211 @@ group :jekyll_plugins do
 end
 ```
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+```sh
+bundle install
+```
+
+If Bundler is not being used to manage dependencies, install the gem by running:
 
 ```sh
 gem install jekyll-pagefind
 ```
 
-## How to
+RubyGems will install the platform-specific package that matches the host OS and CPU.
+If no matching platform gem is selected, the generic `ruby` gem raises a clear error telling the user to add the deploy platform to `Gemfile.lock`.
 
-This guide is intended for Jekyll sites deployed to GitHub Pages.
+## Use
 
-### Download pagefind
+### Jekyll site configuration
 
-First, download the standalone binary (`pagefind`) from the [pagefind releases][pf_release_page] page.
+**`_config.yml`**
 
-Make sure to use the correct binary:
+```yaml
+plugins:
+  # other plugin
+  - jekyll-pagefind
+# other config
+# Optional Jekyll Pagefind Options
+jekyll_pagefind:
+  output_subdir: pagefind
+```
 
-1. For local development, download the standalone binary (`pagefind`) for your host platform.
-2. For deployment to GitHub Pages, the binary must be `pagefind-v{version}-x86_64-unknown-linux-musl.tar.gz`.
+---
 
-### Place the binary file `pagefind`
+### Jekyll Pagefind options (optional)
 
-Place the `pagefind` binary in the root of your Jekyll project, which is the recommended default, or anywhere else under the project root.
+These options map to the settings available in [Pagefind config files](https://pagefind.app/docs/config-sources/#:~:text=overriding%20configuration%20files.-,Config%20files,-Pagefind%20will%20look).
 
-### Jekyll Config
+For more details, see [Pagefind CLI configuration options](https://pagefind.app/docs/config-options/). `jekyll_pagefind` supports the following options.
 
-**`_config.yml`**
+#### 1. output_subdir
+
+The folder where the search bundle is written, relative to Jekyll `{{ site.dest }}`. The default is `pagefind`.
+
+**Example:**
 
 ```yaml
-plugins:
-  # other plugin
-  - jekyll-pagefind
+output_subdir: pf # becomes _site/pf
 ```
 
-If your `pagefind` binary is not in the project root, add this configuration option:
+#### 2. exclude_selectors
+
+Pass extra element selectors that Pagefind should ignore when indexing.
+
+**Example :**
 
 ```yaml
-pagefind: path_to_your/pagefind # where your `pagefind` was located
+exclude_selectors:
+  - "#my_navigation"
+  - "blockquote > span"
+  - "[id^='prefix-']"
+```
+
+#### 3. keep_index_url
+
+Keeps `index.html` at the end of search result paths. The default is `false`.
+
+By default, a file at `animals/cat/index.html` will be given the URL `/animals/cat/`. Setting this option to true will result in the URL `/animals/cat/index.html`.
+
+#### 4. quiet
+
+Logs only errors and warnings while indexing the site.
+
+---
+
+### Pagefind UI
+
+#### 1. Using the Default UI
+
+Using the Default UI is still supported, but it is no longer Pagefind's primary recommendation.
+
+You can add the Pagefind UI to any page with the following snippet. The `/pagefind/` directory, or the directory specified by `output_subdir` in the [config](#1-output_subdir), will be created along with its files.
+
+```liquid
+<script src="{{ '/pagefind/pagefind-ui.js' | relative_url }}"></script>
+<link rel="stylesheet" href="{{ '/pagefind/pagefind-ui.css' | relative_url }}" />
+
+<div id="search"></div>
+<script>
+    window.addEventListener('DOMContentLoaded', (event) => {
+        new PagefindUI({ element: "#search", showSubResults: true });
+    });
+</script>
 ```
 
-## Development
+For dark mode:
+
+```css
+body.dark {
+  --pagefind-ui-primary: #eeeeee;
+  --pagefind-ui-text: #eeeeee;
+  --pagefind-ui-background: #152028;
+  --pagefind-ui-border: #152028;
+  --pagefind-ui-tag: #152028;
+}
+```
 
-After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+For more details, see [Using the Default UI](https://pagefind.app/docs/ui-usage/).
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+#### 2. Pagefind Component UI
+
+Add the following snippet to `<head>`. The `/pagefind/` directory, or the directory specified by `output_subdir` in the [config](#1-output_subdir), will be created along with its files.
+
+```liquid
+<script src="{{ '/pagefind/pagefind-component-ui.js' | relative_url }}" type="module"></script>
+<link rel="stylesheet" href="{{ '/pagefind/pagefind-component-ui.css' | relative_url }}" />
+```
+
+For dark mode:
+
+```html
+<div data-pf-theme="dark">
+  <pagefind-searchbox></pagefind-searchbox>
+</div>
+```
+
+```css
+@media (prefers-color-scheme: dark) {
+  :root {
+    --pf-text: #e5e5e5;
+    --pf-text-secondary: #a0a0a0;
+    --pf-text-muted: #949494;
+    --pf-background: #1a1a1a;
+    --pf-border: #333;
+    --pf-border-focus: #555;
+    --pf-skeleton: #2a2a2a;
+    --pf-skeleton-shine: #333;
+    --pf-hover: #252525;
+    --pf-mark: #e5e5e5;
+    --pf-scroll-shadow: rgba(255, 255, 255, 0.1);
+    --pf-outline-focus: #58a6ff;
+
+    --pf-shadow-sm: 0 2px 8px rgba(0, 0, 0, 0.3);
+    --pf-shadow-md: 0 4px 12px rgba(0, 0, 0, 0.4);
+    --pf-shadow-lg: 0 16px 48px rgba(0, 0, 0, 0.5);
+
+    --pf-error-bg: #2a1a1a;
+    --pf-error-border: #5c2828;
+    --pf-error-text: #f87171;
+    --pf-error-text-secondary: #ef4444;
+  }
+}
+```
+
+For more details, see [Pagefind Component UI](https://pagefind.app/docs/search-ui/).
+
+---
 
 ## Contributing
 
+## Maintainer Release Notes
+
+This gem is published as platform-specific packages so users only download the binary for their host OS.
+
+Build the current host variant:
+
+```sh
+make build
+```
+
+Run the fixture-based smoke test:
+
+```sh
+make smoke-test
+```
+
+Build every supported variant:
+
+```sh
+make build-all
+```
+
+Publish the built platform gems for a version:
+
+```sh
+make publish
+```
+
+GitHub Actions trusted publishing is supported.
+
+To enable it on RubyGems.org for this repo:
+
+1. Open the `jekyll-pagefind` gem page.
+2. Go to `Trusted publishers`.
+3. Create a publisher with repository `phothinmg/jekyll-pagefind`, workflow filename `release.yml`, and environment `release`.
+
+After that, pushing a tag like `v0.3.2` will run `.github/workflows/release.yml` and publish all built gems without a stored API token or manual OTP entry.
+
+`bin/build-platform-gems` currently maps these asset folders to RubyGems platforms:
+
+- `ruby` -> `ruby` (generic fallback gem with no bundled binary)
+- `assets/linux-x64` -> `x86_64-linux-gnu`, `x86_64-linux-musl`
+- `assets/linux-arm64` -> `aarch64-linux-gnu`, `aarch64-linux-musl`
+- `assets/macos-x64` -> `x86_64-darwin`
+- `assets/macos-arm64` -> `arm64-darwin`
+- `assets/windows-x64` -> `x64-mingw32`, `x64-mingw-ucrt`
+- `assets/windows-arm64` -> `arm64-mingw32`, `arm64-mingw-ucrt`
+
 Bug reports and pull requests are welcome on GitHub at <https://github.com/phothinmg/jekyll-pagefind>. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/phothinmg/jekyll-pagefind/blob/master/CODE_OF_CONDUCT.md).
 
 ## License
@@ -87,9 +241,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Jekyll::Pagefind project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/phothinmg/jekyll-pagefind/blob/master/CODE_OF_CONDUCT.md).
-
-<!-- markdownlint-disable MD053 -->
-
-[pf_release_page]: https://github.com/Pagefind/pagefind/releases/latest
-[pf_to_jekyll]: https://www.bfoliver.com/2025/pagefind
+Everyone interacting in the Jekyll::Pagefind project's codebase, issue trackers, chat rooms, and mailing lists is expected to follow the [code of conduct](https://github.com/phothinmg/jekyll-pagefind/blob/master/CODE_OF_CONDUCT.md).

data/jekyll-pagefind.gemspec

@@ -1,10 +1,30 @@
 # frozen_string_literal: true
 
-require_relative "lib/jekyll/pagefind/version"
+require "rbconfig"
+require_relative "lib/version"
+
+host_os = RbConfig::CONFIG["host_os"]
+host_cpu = RbConfig::CONFIG["host_cpu"]
+
+default_pagefind_asset_directory = case host_os
+                                   when /darwin|mac os/i
+                                     host_cpu =~ /arm64|aarch64/i ? "assets/macos-arm64" : "assets/macos-x64"
+                                   when /linux/i
+                                     host_cpu =~ /arm64|aarch64/i ? "assets/linux-arm64" : "assets/linux-x64"
+                                   when /mswin|msys|mingw|cygwin|bccwin/i
+                                     host_cpu =~ /arm64|aarch64/i ? "assets/windows-arm64" : "assets/windows-x64"
+                                   else
+                                     raise "Unable to determine a default Pagefind asset directory for host environment: #{host_os} (#{host_cpu})" # rubocop:disable Layout/LineLength
+                                   end
+
+pagefind_asset_directory = ENV.fetch("PAGEFIND_ASSET_DIR", default_pagefind_asset_directory)
+pagefind_gem_platform = ENV.fetch("PAGEFIND_GEM_PLATFORM", Gem::Platform::RUBY)
+pagefind_include_assets = ENV.fetch("PAGEFIND_INCLUDE_ASSETS", "true") == "true"
 
 Gem::Specification.new do |spec|
   spec.name = "jekyll-pagefind"
   spec.version = Jekyll::Pagefind::VERSION
+  spec.platform = Gem::Platform.new(pagefind_gem_platform)
   spec.authors = ["phothinmg"]
   spec.email = ["phothinmg@disroot.org"]
 
@@ -12,13 +32,16 @@ Gem::Specification.new do |spec|
   spec.description = "Run pagefind binary in jekyll site"
   spec.homepage = "https://rubygems.org/gems/jekyll-pagefind"
   spec.license = "MIT"
-  spec.required_ruby_version = ">= 3.2.0"
+  spec.required_ruby_version = ">= 3.1.0"
+  spec.metadata["rubygems_mfa_required"] = "true"
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = "https://github.com/phothinmg/jekykll-pagefind"
   spec.metadata["changelog_uri"] = "https://github.com/phothinmg/jekykll-pagefind/blob/main/CHANGELOG.md"
 
   spec.files = Dir.chdir(__dir__) do
-    Dir["README.md", "LICENSE.txt", "lib/**/*", "assets/**/*", "jekyll-pagefind.gemspec"]
+    files = ["README.md", "LICENSE.txt", "lib/**/*", "jekyll-pagefind.gemspec"]
+    files << "#{pagefind_asset_directory}/**/*" if pagefind_include_assets
+    Dir[*files]
   end
   spec.require_paths = ["lib"]
   spec.add_dependency "jekyll", "~> 4.4"

data/lib/jekyll-pagefind.rb

@@ -3,15 +3,16 @@
 require "rbconfig"
 require "open3"
 require "jekyll"
+require "shellwords"
 
-require_relative "jekyll/pagefind/version"
+require_relative "version"
 
 module Jekyll
   # module Jekyll::Pagefind
   module Pagefind
     GEM_ROOT = File.expand_path("..", __dir__)
 
-    def self.pagefind_binary_path # rubocop:disable Metrics/MethodLength
+    def self.pagefind_binary_path # rubocop:disable Metrics/MethodLength,Metrics/PerceivedComplexity
       os = RbConfig::CONFIG["host_os"]
       cpu = RbConfig::CONFIG["host_cpu"]
 
@@ -34,13 +35,52 @@ module Jekyll
         end
         # spellchecker:disable-next-line
       when /mswin|msys|mingw|cygwin|bccwin/i
-        File.join(GEM_ROOT, "assets", "windows-x64", "pagefind.exe")
+        # Differentiate between Intel/AMD and ARM Windows machines
+        if cpu =~ /arm64|aarch64/i
+          File.join(GEM_ROOT, "assets", "windows-arm64", "pagefind.exe")
+        else
+          File.join(GEM_ROOT, "assets", "windows-x64", "pagefind.exe")
+        end
       else
-        raise "Jekyll-PF Mismatch Error: Pagefind binary not provided for host environment: #{os} (#{cpu})"
+        raise "Jekyll-Pagefind Mismatch Error: Pagefind binary not provided for host environment: #{os} (#{cpu})"
       end
     end
 
-    def self.run_pagefind(site_destination) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+    # valid the cli flag
+    def self.valid_arg?(arg)
+      %w[output_subdir exclude_selectors keep_index_url quiet].include?(arg)
+    end
+
+    # Converts Jekyll config options into matching Pagefind command line flags
+    def self.build_cli_arguments(config) # rubocop:disable Metrics/MethodLength,Metrics/CyclomaticComplexity
+      plugin_config = config["jekyll_pagefind"] || {}
+      args = []
+
+      plugin_config.each do |key, value|
+        next unless valid_arg?(key)
+
+        # Transform snake_case keys to kebab-case (e.g., keep_index_url -> keep-index-url)
+        flag_name = key.to_s.gsub("_", "-")
+
+        case value
+        when TrueClass
+          # Boolean flags like --keep-index-url require no attached value
+          args << "--#{flag_name}"
+        when FalseClass
+          # Ignore false booleans unless Pagefind specifically supports a negative override
+          next
+        when Array
+          # Arrays like exclude_selectors need to be repeated: --exclude-selectors ".footer" --exclude-selectors "nav"
+          value.each { |val| args << "--#{flag_name} \"#{val}\"" }
+        else
+          # Strings or numbers like --bundle-dir "search"
+          args << "--#{flag_name} \"#{value}\""
+        end
+      end
+      args.join(" ")
+    end
+
+    def self.run_pagefind(site_destination, extra_arguments = "") # rubocop:disable Metrics/MethodLength,Metrics/AbcSize
       binary = pagefind_binary_path
 
       # Force execution bits on UNIX hosts because gem unpacking can reset permissions flags
@@ -49,15 +89,23 @@ module Jekyll
         File.chmod(0o755, binary)
       end
 
-      # Run the indexer pointing explicitly at Jekyll's output directory
-      Jekyll.logger.info "Jekyll-PF:", "Starting Pagefind indexing on target folder..."
-      stdout, stderr, status = Open3.capture3("#{binary} --site \"#{site_destination}\"")
+      # Combine the mandatory --site parameter with any user-defined configuration flags
+      full_command = [
+        Shellwords.escape(binary),
+        "--site",
+        Shellwords.escape(site_destination),
+        extra_arguments
+      ].join(" ").strip
+      started_at = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+
+      Jekyll.logger.info "Jekyll-Pagefind:", "Running Pagefind..."
+      _stdout, stderr, status = Open3.capture3(full_command)
 
       if status.success?
-        Jekyll.logger.info "Jekyll-PF:", "Indexing finished successfully!"
-        puts stdout
+        elapsed = Process.clock_gettime(Process::CLOCK_MONOTONIC) - started_at
+        Jekyll.logger.info "Jekyll-Pagefind:", format("Done in %.2fs", elapsed)
       else
-        Jekyll.logger.error "Jekyll-PF Error:", stderr
+        Jekyll.logger.error "Jekyll-Pagefind Error:", stderr
         raise "Pagefind binary exited with non-zero status code: #{status.exitstatus}"
       end
     end
@@ -66,6 +114,8 @@ end
 
 # Hook ensures Jekyll is entirely done writing HTML pages to disk
 Jekyll::Hooks.register :site, :post_write do |site|
-  # site.dest points dynamically to the configured destination folder (usually '_site')
-  Jekyll::Pagefind.run_pagefind(site.dest)
-end
+  # Parse plugin settings out of site.config
+  custom_flags = Jekyll::Pagefind.build_cli_arguments(site.config)
+  # Run Pagefind with the compiled flags
+  Jekyll::Pagefind.run_pagefind(site.dest, custom_flags)
+end

data/lib/{jekyll/pagefind/version.rb → version.rb}

@@ -2,6 +2,6 @@
 
 module Jekyll
   module Pagefind
-    VERSION = "0.2.1"
+    VERSION = "0.3.3"
   end
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-pagefind
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.3
 platform: ruby
 authors:
 - phothinmg
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-06-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -46,21 +47,18 @@ extra_rdoc_files: []
 files:
 - LICENSE.txt
 - README.md
-- assets/linux-arm64/pagefind
-- assets/linux-x64/pagefind
-- assets/macos-arm64/pagefind
-- assets/macos-x64/pagefind
-- assets/windows-x64/pagefind.exe
 - jekyll-pagefind.gemspec
 - lib/jekyll-pagefind.rb
-- lib/jekyll/pagefind/version.rb
+- lib/version.rb
 homepage: https://rubygems.org/gems/jekyll-pagefind
 licenses:
 - MIT
 metadata:
+  rubygems_mfa_required: 'true'
   homepage_uri: https://rubygems.org/gems/jekyll-pagefind
   source_code_uri: https://github.com/phothinmg/jekykll-pagefind
   changelog_uri: https://github.com/phothinmg/jekykll-pagefind/blob/main/CHANGELOG.md
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -68,14 +66,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.11
+rubygems_version: 3.4.19
+signing_key:
 specification_version: 4
 summary: Pagefind plugin for Jekyll
 test_files: []