jekyll-highlight-cards 0.3.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c7cd9e66e3ef41ee1ac316caaac55c23904731e57913a8de95701fafc4a1aab7
+  data.tar.gz: 4dc6209363472413dbcde00f2d997e577997ec0eff43bec5c230aad2e3667409
+SHA512:
+  metadata.gz: e33330d053557b592175187c7da9f2c1b8ce3ea8e29b3b1798b21fd07b5b4c074965a9e461ebd9a61ce600ab3917f509504021ac026ecbb84a2a8f3fdbc768e6
+  data.tar.gz: 5942858336904a92024164afd15d20ab1a0c0f6cb11301ad138e0af2b18fcedbd6fee608e1361d5531cb01bad93146cb1c5c1aff319d34b4c98f4c558430110f

data/.cursorignore

@@ -0,0 +1 @@
+!.cursor/rules/**/*

data/.github/workflows/ci.yaml

@@ -0,0 +1,21 @@
+name: "PR"
+
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  test:
+    name: "Test"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+      - name: Install dependencies
+        run: bundle install
+      - name: Run tests
+        run: bundle exec rspec

data/.github/workflows/release-please.yaml

@@ -0,0 +1,69 @@
+name: Release Please
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+  issues: write
+  id-token: write  # Required for OIDC trusted publishing
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
+env:
+  GEM_NAME: jekyll-highlight-cards
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      version: ${{ steps.release.outputs.version }}
+    steps:
+      - name: Generate GitHub App Token
+        id: generate-token
+        uses: actions/create-github-app-token@v2
+        with:
+          app-id: ${{ vars.HELPER_APP_ID }}
+          private-key: ${{ secrets.HELPER_APP_PRIVATE_KEY }}
+
+      - uses: googleapis/release-please-action@v4
+        id: release
+        with:
+          token: ${{ steps.generate-token.outputs.token }}
+
+  publish-gem:
+    needs: release-please
+    if: ${{ needs.release-please.outputs.release_created }}
+    runs-on: ubuntu-latest
+    environment: rubygems.org
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+
+      - name: Run tests with coverage
+        run: bundle exec rspec
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          fail_ci_if_error: false
+
+      - name: Build gem
+        run: gem build ${{ env.GEM_NAME }}.gemspec
+
+      - name: Configure RubyGems credentials
+        uses: rubygems/configure-rubygems-credentials@v1.0.0
+
+      - name: Publish to RubyGems
+        run: gem push ${{ env.GEM_NAME }}-${{ needs.release-please.outputs.version }}.gem

data/.github/workflows/update-gemfile-lock.yaml

@@ -0,0 +1,52 @@
+name: "Release PR"
+
+on:
+  pull_request:
+    paths:
+      - 'lib/jekyll-highlight-cards/version.rb'
+
+permissions:
+  contents: write
+
+jobs:
+  update-gemfile-lock:
+    name: "Update Gemfile.lock"
+    # Only run on Release Please PRs
+    if: startsWith(github.head_ref, 'release-please--')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Generate GitHub App Token
+        id: generate-token
+        uses: actions/create-github-app-token@v2
+        with:
+          app-id: ${{ vars.HELPER_APP_ID }}
+          private-key: ${{ secrets.HELPER_APP_PRIVATE_KEY }}
+
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ github.head_ref }}
+          token: ${{ steps.generate-token.outputs.token }}
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: false
+
+      - name: Update Gemfile.lock
+        run: bundle install
+
+      - name: Commit updated Gemfile.lock
+        uses: nick-fields/retry@v3
+        with:
+          timeout_minutes: 2
+          max_attempts: 3
+          retry_wait_seconds: 5
+          command: |
+            git config user.name "texarkanine-s-little-helper[bot]"
+            git config user.email "texarkanine-s-little-helper[bot]@users.noreply.github.com"
+            if ! git diff --quiet Gemfile.lock; then
+              git pull --rebase origin ${{ github.head_ref }}
+              git add Gemfile.lock
+              git commit -m "chore(deps): update Gemfile.lock for new version"
+              git push
+            fi

data/.gitignore

@@ -0,0 +1,59 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+.rspec_status
+
+# Used by dotenv library to load environment variables.
+# .env
+
+# Ignore Byebug command history file.
+.byebug_history
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Specific to RubyMotion (use of CocoaPods):
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+#
+# vendor/Pods/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+# Used by RuboCop. Remote config files pulled in from inherit_from directive.
+# .rubocop-https?--*
+
+planning/

data/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+    ".": "0.3.1"
+}

data/.rspec

@@ -0,0 +1,5 @@
+--require spec_helper
+--format documentation
+--color
+
+

data/.rubocop.yml

@@ -0,0 +1,64 @@
+# RuboCop configuration for jekyll-highlight-cards
+
+require:
+  - rubocop-rake
+  - rubocop-rspec
+
+AllCops:
+  TargetRubyVersion: 3.1
+  NewCops: enable
+  Exclude:
+    - 'vendor/**/*'
+    - 'spec/fixtures/**/*'
+    - 'examples/**/*'
+    - 'planning/**/*'
+
+# Style preferences
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Style/Documentation:
+  Enabled: false  # Will enable after adding YARD documentation
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+  EnforcedStyle: always
+
+# Metrics - relaxed for initial development
+Metrics/MethodLength:
+  Max: 25
+  Exclude:
+    - 'spec/**/*'
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+    - '*.gemspec'
+
+Metrics/ClassLength:
+  Max: 200
+
+Metrics/ModuleLength:
+  Max: 200
+
+# Layout preferences
+Layout/LineLength:
+  Max: 120
+  AllowedPatterns: ['^\s*#']
+
+# RSpec-specific
+RSpec/ExampleLength:
+  Max: 15
+
+RSpec/MultipleExpectations:
+  Max: 5
+
+RSpec/NestedGroups:
+  Max: 5
+
+

data/.ruby-version

@@ -0,0 +1 @@
+3.1.7

data/CHANGELOG.md

@@ -0,0 +1,54 @@
+# Changelog
+
+## [0.3.1](https://github.com/Texarkanine/jekyll-highlight-cards/compare/v0.3.0...v0.3.1) (2025-12-08)
+
+
+### Bug Fixes
+
+* CSS was not automatically loaded when plugin was added to a site ([#9](https://github.com/Texarkanine/jekyll-highlight-cards/issues/9)) ([2183771](https://github.com/Texarkanine/jekyll-highlight-cards/commit/21837712ea9d47d61495c082dfc6a1d99c7dcac2))
+
+## [0.3.0](https://github.com/Texarkanine/jekyll-highlight-cards/compare/v0.2.3...v0.3.0) (2025-12-08)
+
+
+### Features
+
+* **polaroid:** Wrap Polaroids in a container to allow block or inline-block display ([#7](https://github.com/Texarkanine/jekyll-highlight-cards/issues/7)) ([9904795](https://github.com/Texarkanine/jekyll-highlight-cards/commit/990479582798b0741472e8555da09221c6cdd2e9))
+
+## [0.2.3](https://github.com/Texarkanine/jekyll-highlight-cards/compare/v0.2.2...v0.2.3) (2025-12-08)
+
+
+### Bug Fixes
+
+* **ci:** bot name ([f440e8e](https://github.com/Texarkanine/jekyll-highlight-cards/commit/f440e8e50f514e7905185849c12dd8dba0f579e4))
+* **ci:** Bump Gemfile.lock in release-please PRs ([daa500f](https://github.com/Texarkanine/jekyll-highlight-cards/commit/daa500f0464504349c0e7daffc76a2d6ac8c3451))
+* **ci:** Decorate commits properly when updating Gemfile.lock ([a2d17c4](https://github.com/Texarkanine/jekyll-highlight-cards/commit/a2d17c49e4857b548f2fea050581d671757e0afb))
+* **ci:** Need to point rp at version-file ([17ad648](https://github.com/Texarkanine/jekyll-highlight-cards/commit/17ad648778f73ef27c0c0c122259276aed978197))
+* **deps:** re-lock Gemfile? ([8988d60](https://github.com/Texarkanine/jekyll-highlight-cards/commit/8988d609a050d8b4f46007f7407df5c9c3be2b57))
+
+## [0.2.2](https://github.com/Texarkanine/jekyll-highlight-cards/compare/v0.2.1...v0.2.2) (2025-12-08)
+
+
+### Bug Fixes
+
+* **ci:** something up w/ trusted publishing, make deployment env explicit...? ([f391a7e](https://github.com/Texarkanine/jekyll-highlight-cards/commit/f391a7e341730f80b7bbf1db21212c1c9511c4a6))
+
+## [0.2.1](https://github.com/Texarkanine/jekyll-highlight-cards/compare/v0.2.0...v0.2.1) (2025-12-08)
+
+
+### Bug Fixes
+
+* **ci:** tests run w/ rspec directly, not rake ([e14f8ed](https://github.com/Texarkanine/jekyll-highlight-cards/commit/e14f8edb4e41e165c516970eddbfa6adba3d5832))
+
+## [0.2.0](https://github.com/Texarkanine/jekyll-highlight-cards/compare/v0.1.0...v0.2.0) (2025-12-08)
+
+
+### Features
+
+* Add RubyGems trusted publishing to release workflow ([#2](https://github.com/Texarkanine/jekyll-highlight-cards/issues/2)) ([905bd50](https://github.com/Texarkanine/jekyll-highlight-cards/commit/905bd50a11b788b3948b6ee2d995c8c1118060f1))
+
+
+### Bug Fixes
+
+* **ci:** Add release-please-manifest.json ([30719ab](https://github.com/Texarkanine/jekyll-highlight-cards/commit/30719abdfb5964d55d26780ce9771c110d44f5cd))
+* **ci:** leave all rp config to the JSON file ([47ca188](https://github.com/Texarkanine/jekyll-highlight-cards/commit/47ca1881c35e9946caa6e4deeee836f547c367f4))
+* **ci:** separate Release-creation from gem publishing ([07114f9](https://github.com/Texarkanine/jekyll-highlight-cards/commit/07114f9e286f09c74812078b5b1f132257ab7b91))

data/CONTRIBUTING.md

@@ -0,0 +1,219 @@
+# Contributing to jekyll-highlight-cards
+
+## Development Setup
+
+### Prerequisites
+
+- Ruby 3.1 or higher
+- Bundler
+
+### Clone and Setup
+
+```bash
+git clone https://github.com/texarkanine/jekyll-highlight-cards.git
+cd jekyll-highlight-cards
+bundle install
+```
+
+### Running Tests
+
+Run the full test suite:
+
+```bash
+bundle exec rspec
+```
+
+Run specific test file:
+
+```bash
+bundle exec rspec spec/linkcard_tag_spec.rb
+```
+
+Run with documentation format:
+
+```bash
+bundle exec rspec --format documentation
+```
+
+### Code Quality
+
+Check code style:
+
+```bash
+bundle exec rubocop
+```
+
+Auto-fix style issues:
+
+```bash
+bundle exec rubocop --autocorrect
+```
+
+### Building the Gem
+
+```bash
+gem build jekyll-highlight-cards.gemspec
+```
+
+This creates `jekyll-highlight-cards-VERSION.gem`.
+
+### Installing Locally
+
+```bash
+gem install ./jekyll-highlight-cards-*.gem
+```
+
+Or in a test Jekyll site's Gemfile:
+
+```ruby
+gem 'jekyll-highlight-cards', path: '/path/to/jekyll-highlight-cards'
+```
+
+## Project Structure
+
+```
+jekyll-highlight-cards/
+├── lib/
+│   ├── jekyll-highlight-cards.rb          # Main entry point
+│   └── jekyll-highlight-cards/
+│       ├── version.rb                     # Version constant
+│       ├── archive_helper.rb              # Archive integration
+│       ├── dimension_parser.rb            # Image sizing utilities
+│       ├── expression_evaluator.rb        # Liquid expression evaluation
+│       ├── template_renderer.rb           # Template rendering
+│       ├── linkcard_tag.rb               # Linkcard Liquid tag
+│       ├── polaroid_tag.rb               # Polaroid Liquid tag
+│       └── image_sizing_hooks.rb         # Markdown image sizing
+├── _includes/highlight-cards/
+│   ├── linkcard.html                     # Default linkcard template
+│   └── polaroid.html                     # Default polaroid template
+├── assets/css/
+│   └── highlight-cards.scss              # Default styles
+├── spec/                                  # Test files
+│   ├── spec_helper.rb
+│   ├── *_spec.rb                         # Tests for each module
+│   └── fixtures/                         # Test fixtures
+└── jekyll-highlight-cards.gemspec        # Gem specification
+```
+
+## Development Workflow
+
+### TDD Approach
+
+This project follows Test-Driven Development:
+
+1. **Write tests first** - Define expected behavior in specs
+2. **Run tests** - Watch them fail (red)
+3. **Write code** - Implement to make tests pass (green)
+4. **Refactor** - Improve code while keeping tests green
+5. **Verify** - Run full suite and Rubocop
+
+### Adding Features
+
+1. Create feature branch: `git checkout -b feature/my-feature`
+2. Write tests in `spec/`
+3. Implement feature in `lib/`
+4. Run tests: `bundle exec rspec`
+5. Check style: `bundle exec rubocop`
+6. Commit with descriptive message
+7. Push and create pull request
+
+### Commit Messages
+
+Use conventional commit format:
+
+- `feat: Add new feature`
+- `fix: Fix bug in XYZ`
+- `docs: Update README`
+- `test: Add tests for ABC`
+- `refactor: Improve XYZ`
+- `style: Fix Rubocop issues`
+
+## Testing Guidelines
+
+### Test Coverage
+
+- Aim for >95% line coverage
+- Cover happy paths and edge cases
+- Test error handling
+- Mock external dependencies (HTTP requests, file I/O)
+
+### Test Structure
+
+```ruby
+RSpec.describe MyModule do
+  describe ".method_name" do
+    context "with valid input" do
+      it "returns expected result" do
+        # test code
+      end
+    end
+    
+    context "with invalid input" do
+      it "raises appropriate error" do
+        # test code
+      end
+    end
+  end
+end
+```
+
+### Running Specific Tests
+
+```bash
+# Run single test file
+bundle exec rspec spec/linkcard_tag_spec.rb
+
+# Run single test (by line number)
+bundle exec rspec spec/linkcard_tag_spec.rb:42
+
+# Run tests matching pattern
+bundle exec rspec spec/linkcard_tag_spec.rb -e "renders with title"
+```
+
+## Code Style
+
+### Ruby Style Guide
+
+Follow standard Ruby conventions:
+
+- 2 space indentation
+- Snake_case for methods and variables
+- CamelCase for classes and modules
+- SCREAMING_SNAKE_CASE for constants
+- Maximum 120 characters per line
+
+### Module Organization
+
+- One class/module per file
+- File names match class names (snake_case)
+- Public methods documented with YARD comments
+- Private methods below `private` keyword
+
+## Troubleshooting
+
+### Tests failing after changes
+
+1. Run full suite: `bundle exec rspec`
+2. Check specific failing test
+3. Review recent changes
+4. Verify test fixtures are correct
+
+### Rubocop errors
+
+```bash
+bundle exec rubocop --autocorrect
+```
+
+If auto-correct doesn't work, manually fix reported issues.
+
+### Gem won't build
+
+1. Check `jekyll-highlight-cards.gemspec` for errors
+2. Verify all required files exist
+3. Check Ruby version compatibility
+
+## Questions?
+
+Open an issue on GitHub for questions, bug reports, or feature requests.
+

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec