jekyll-vitepress-theme 0.9.0

data/lib/jekyll/vitepress_theme/hooks.rb

@@ -0,0 +1,111 @@
+require 'pathname'
+require 'rouge'
+
+module Jekyll
+  module VitePressTheme
+    module LastUpdated
+      module_function
+
+      def source_file_time(site, path)
+        return nil unless path
+
+        source_path = if Pathname.new(path).absolute?
+                        path
+                      else
+                        File.join(site.source, path)
+                      end
+
+        return nil unless File.file?(source_path)
+
+        File.mtime(source_path).utc
+      rescue StandardError
+        nil
+      end
+    end
+
+    module RougeStyles
+      module_function
+
+      DEFAULT_LIGHT = 'github'.freeze
+      DEFAULT_DARK = 'github.dark'.freeze
+
+      def apply(site)
+        vp_theme = site.config['vp_theme']
+        return unless vp_theme.is_a?(Hash)
+
+        light_name, dark_name = resolved_theme_names(vp_theme)
+        light_name = valid_theme_name(light_name, DEFAULT_LIGHT)
+        dark_name = valid_theme_name(dark_name, DEFAULT_DARK)
+
+        vp_theme['rouge_theme'] = {
+          'light' => light_name,
+          'dark' => dark_name
+        }
+        vp_theme['_generated_rouge_css'] = generated_css(light_name, dark_name)
+      rescue StandardError => e
+        Jekyll.logger.warn('jekyll-vitepress-theme', "Rouge theme generation failed: #{e.message}")
+      end
+
+      def resolved_theme_names(vp_theme)
+        rouge_theme = vp_theme['rouge_theme']
+
+        light = nil
+        dark = nil
+
+        if rouge_theme.is_a?(String)
+          light = normalized_name(rouge_theme)
+        elsif rouge_theme.is_a?(Hash)
+          light = normalized_name(rouge_theme['light'] || rouge_theme[:light])
+          dark = normalized_name(rouge_theme['dark'] || rouge_theme[:dark])
+        end
+
+        [light || DEFAULT_LIGHT, dark || DEFAULT_DARK]
+      end
+
+      def normalized_name(name)
+        return nil unless name
+
+        value = name.to_s.strip
+        return nil if value.empty?
+
+        value
+      end
+
+      def valid_theme_name(name, fallback)
+        return name if Rouge::Theme.find(name)
+
+        Jekyll.logger.warn('jekyll-vitepress-theme', "Unknown Rouge theme '#{name}', falling back to '#{fallback}'.")
+        fallback
+      end
+
+      def generated_css(light_name, dark_name)
+        light_theme = Rouge::Theme.find(light_name)
+        dark_theme = Rouge::Theme.find(dark_name)
+        return '' unless light_theme && dark_theme
+
+        [
+          light_theme.render(scope: '.vp-doc .highlighter-rouge .highlight'),
+          dark_theme.render(scope: '.dark .vp-doc .highlighter-rouge .highlight')
+        ].join("\n")
+      end
+    end
+  end
+end
+
+Jekyll::Hooks.register :site, :after_reset do |site|
+  Jekyll::VitePressTheme::RougeStyles.apply(site)
+end
+
+Jekyll::Hooks.register :documents, :pre_render do |document|
+  next if document.data.key?('last_updated_at')
+
+  updated_at = Jekyll::VitePressTheme::LastUpdated.source_file_time(document.site, document.path)
+  document.data['last_updated_at'] = updated_at if updated_at
+end
+
+Jekyll::Hooks.register :pages, :pre_render do |page|
+  next if page.data.key?('last_updated_at')
+
+  updated_at = Jekyll::VitePressTheme::LastUpdated.source_file_time(page.site, page.path)
+  page.data['last_updated_at'] = updated_at if updated_at
+end

data/lib/jekyll/vitepress_theme/version.rb

@@ -0,0 +1,5 @@
+module Jekyll
+  module VitePressTheme
+    VERSION = "0.9.0".freeze
+  end
+end

data/lib/jekyll-vitepress-theme.rb

@@ -0,0 +1,3 @@
+require 'jekyll'
+require_relative 'jekyll/vitepress_theme/version'
+require_relative 'jekyll/vitepress_theme/hooks'

metadata

@@ -0,0 +1,143 @@
+--- !ruby/object:Gem::Specification
+name: jekyll-vitepress-theme
+version: !ruby/object:Gem::Version
+  version: 0.9.0
+platform: ruby
+authors:
+- Carmine Paolino
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-03-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.3'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.3'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: Jekyll VitePress Theme brings the VitePress default theme look and behavior
+  to Jekyll sites.
+email:
+- carmine@paolino.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- _includes/doc_footer.html
+- _includes/head.html
+- _includes/home.html
+- _includes/local_nav.html
+- _includes/nav.html
+- _includes/search.html
+- _includes/sidebar.html
+- _includes/vp_slots/doc_footer.html
+- _includes/vp_slots/head.html
+- _includes/vp_slots/layout_bottom.html
+- _layouts/default.html
+- _layouts/home.html
+- assets/css/vitepress-components.css
+- assets/css/vitepress-core.css
+- assets/css/vitepress-overrides.css
+- assets/css/vp-icons.css
+- assets/images/favicon/apple-touch-icon.png
+- assets/images/favicon/favicon-96x96.png
+- assets/images/favicon/favicon.ico
+- assets/images/favicon/site.webmanifest
+- assets/images/favicon/web-app-manifest-192x192.png
+- assets/images/favicon/web-app-manifest-512x512.png
+- assets/images/file-icons/css.svg
+- assets/images/file-icons/default.svg
+- assets/images/file-icons/docker.svg
+- assets/images/file-icons/env.svg
+- assets/images/file-icons/go.svg
+- assets/images/file-icons/html.svg
+- assets/images/file-icons/java.svg
+- assets/images/file-icons/javascript.svg
+- assets/images/file-icons/json.svg
+- assets/images/file-icons/kotlin.svg
+- assets/images/file-icons/make.svg
+- assets/images/file-icons/markdown.svg
+- assets/images/file-icons/php.svg
+- assets/images/file-icons/python.svg
+- assets/images/file-icons/ruby.svg
+- assets/images/file-icons/rust.svg
+- assets/images/file-icons/shell.svg
+- assets/images/file-icons/sql.svg
+- assets/images/file-icons/text.svg
+- assets/images/file-icons/toml.svg
+- assets/images/file-icons/typescript.svg
+- assets/images/file-icons/vue.svg
+- assets/images/file-icons/xml.svg
+- assets/images/file-icons/yaml-dark.svg
+- assets/images/file-icons/yaml.svg
+- assets/images/logo.svg
+- assets/images/social-icons/bitbucket.svg
+- assets/images/social-icons/bluesky.svg
+- assets/images/social-icons/devdotto.svg
+- assets/images/social-icons/discord.svg
+- assets/images/social-icons/dribbble.svg
+- assets/images/social-icons/facebook.svg
+- assets/images/social-icons/github.svg
+- assets/images/social-icons/gitlab.svg
+- assets/images/social-icons/instagram.svg
+- assets/images/social-icons/linkedin.svg
+- assets/images/social-icons/mastodon.svg
+- assets/images/social-icons/medium.svg
+- assets/images/social-icons/npm.svg
+- assets/images/social-icons/reddit.svg
+- assets/images/social-icons/rss.svg
+- assets/images/social-icons/slack.svg
+- assets/images/social-icons/stackoverflow.svg
+- assets/images/social-icons/telegram.svg
+- assets/images/social-icons/twitch.svg
+- assets/images/social-icons/twitter.svg
+- assets/images/social-icons/x.svg
+- assets/images/social-icons/youtube.svg
+- assets/images/theme/vitepress-logo-large.svg
+- assets/images/theme/vitepress-logo-mini.svg
+- assets/js/vitepress-theme.js
+- lib/jekyll-vitepress-theme.rb
+- lib/jekyll/vitepress_theme/hooks.rb
+- lib/jekyll/vitepress_theme/version.rb
+homepage: https://github.com/crmne/jekyll-vitepress-theme
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: A VitePress-like docs theme for Jekyll.
+test_files: []