larsp.de

AI/LLM Resources

Sun, 19 Apr 2026 00:00:00 GMT

Collection of Artificial Intelligence / LLM resources I actually use day to day. Biased towards Claude and the Ruby ecosystem, because that's where I spend most of my time.

Claude Code

Claude Code is Anthropic's agentic coding CLI. It lives in the terminal, reads and edits files, runs commands, and keeps track of project context across sessions. Paired with CLAUDE.md files in the repo root, it becomes a pretty capable pair programmer.

Plugins & extensions

Ralph Wiggum plugin — a Stop-hook that catches Claude trying to exit and feeds the same prompt back in. Useful for iterative tasks with clear success criteria ("all tests green") where you want the agent to keep grinding until it's done.
Codex plugin for Claude Code — makes OpenAI's Codex available from inside Claude Code. Handy for a second opinion (/codex:review, /codex:adversarial-review) or for delegating background tasks (/codex:rescue).

Spec-driven workflows

Both of these treat specifications as the source of truth: you write the spec first, then agents implement against it. Different flavours for different project sizes.

CCPM – Claude Code Project Management — uses GitHub Issues and Git worktrees to let up to 12 Claude instances work in parallel. Workflow is Brainstorm → PRD → Epic → Issues → Tracking, all via /pm:* slash commands.
Spec Kitty — CLI plus live Kanban dashboard, 6-phase lifecycle (spec → plan → tasks → implement → review → merge). Supports 12 agents including Claude Code, Cursor, Windsurf, Gemini and GitHub Copilot.

Agent Skills

Skills are self-contained capability packages — a folder of instructions, scripts and resources that Claude can load on demand.

Model Context Protocol (MCP)

MCP is the open protocol that lets LLMs talk to external tools and data sources in a standardised way. The magic is that any MCP-compatible client (Claude Desktop, Claude Code, Cursor, …) can use any MCP server.

Get started with the Model Context Protocol

MCP servers I rely on:

Linear MCP — read and update Linear issues from within Claude.
Sunsama MCP — full CRUD on Sunsama tasks, subtasks and streams. Great for keeping the daily plan in sync without leaving the terminal.
Member Berries MCP — built on apple-mcp, adds memory-style tools for calendar, notes and reminders. Turns Claude into "a helpful friend who remembers your day".

Ruby/Rails tools and frameworks

Raif (Ruby AI Framework) — a Rails engine that helps you add AI-powered features to your Rails apps.
Claude on Rails — Obie Fernandez's framework that orchestrates specialised agents (Architect, Models, Controllers, Views, Services, Tests, DevOps) on top of claude-swarm. Rails-aware, test-driven, integrates with the Rails MCP Server for up-to-date documentation.
classifier-reborn — a general classifier module for Bayesian and other types of classification. Pre-LLM, but still useful for lightweight text categorisation without calling an API.

IMAP migration and backup

Thu, 05 Feb 2026 00:00:00 GMT

Tools for working with IMAP accounts.

Notes on moving mail between servers and keeping local backups.

imapsync

The go-to tool. Handles folder mapping, deduplication, resumable.

imapsync \
  --host1 old.server.com --user1 me@old.com --password1 xxx \
  --host2 new.server.com --user2 me@new.com --password2 yyy

Flags I actually use:

--dry                     # test run
--exclude "Spam|Trash"    # skip junk
--folder "INBOX"          # single folder only
--regextrans2 s/Sent Items/Sent/  # rename folders

imapsync.lamiral.info

imap-backup

Ruby gem, stores mail as Mbox + JSON index. Good for offline archives.

gem install imap-backup
imap-backup setup    # interactive config
imap-backup backup   # run it

github.com/joeyates/imap-backup

Gotchas

Gmail/iCloud need app passwords
Check destination quota before migrating
--dry first, always

Open Source Software

Wed, 21 Jan 2026 00:00:00 GMT

Recommendable (web) applications

Chat / Messaging

once-campfire - GitHub repository by Basecamp
Revolt - A chat application designed with community in mind
Gotify - A simple server for sending and receiving messages

CMS

Ghost CMS - An open-source CMS favored for content sites
Writebook - Publish your own books on the web for free

Development

TestLink - Open source test and requirement management system

Document Management

paperless-ngx - A document management system for scanning, indexing, and archiving documents

Home

Home Assistant - Open source home automation with local control and privacy first, ideal for Raspberry Pi or local servers

Hosting

Databasus - Free tool for PostgreSQL scheduled backups with cloud storage and notifications
Dokku - Self-hosted open-source PaaS alternative to Heroku
copyparty - Portable file server with WebDAV, FTP, TFTP, and media indexing

Mail

Plunk - Open-source email platform combining marketing, transactional, and broadcast emails

Project Management

OpenProject - Open source project management with task management, Gantt charts, boards, and team collaboration

Tasks

TaskTrove - Self-hostable, privacy-focused TODO list management application

Ruby on Rails resources

Wed, 21 Jan 2026 00:00:00 GMT

Link directory and notes for Ruby on Rails. Continually updated.

My link directory and notes for Ruby on Rails. As usual, a work in progress and continually updated.

Admin interfaces

Madmin
Avo

AI

Raif (Ruby AI Framework) is a Rails engine that helps you add AI-powered features to your Rails apps

APIs

Apple Wallet

Apple Wallet Passes in Rails Apps

Authorization

rails g sessions

Bundling

Propshaft

Caching

Memcache

How key-based cache expiration works – Signal v. Noise

def get_ops client_id
  latest_import = ImportLog.maximum :updated_at
  cache_tag = "ops-#{client_id}-#{latest_import.iso8601}"
  Rails.cache.fetch(cache_tag, expires_in: 1.day) do
    Rails.logger.info("Cache miss for #{cache_tag}")
    Op.where(client_id: client_id).to_json
  end
end

CAPTCHAs

https://github.com/ambethia/recaptcha

CLI

TableTennis is a Ruby library for printing stylish tables in your terminal

CMS

Concurrency

# Subprocess
pid = Process.fork do 
  long_process
end
Process.detach pid

Config

ActiveSupport::Configurable

Commerce

https://businessclasskit.com (SaaS with Gumroad integration)

CSS

Databases

Indices

Exclude nulls from indexes

A database index is a B-tree structure. It is very efficient when data has a high cardinality. However, when a column allows nulls, it often becomes the most redundant value. The index is less efficient and takes up more space. Unless null is an infrequently repeated value, there are only disadvantages to indexing them.

Exclude them when creating the index with a where clause.

add_index :table, :column, where: "(column IS NOT NULL)"

Or in pure SQL:

CREATE INDEX name ON table (column) \
  WHERE column IS NOT NULL;

Do not index column with a low cardinality such as boolean

The reason is the same as in the previous paragraph. B-tree indexes work best when cardinality is high. So a Boolean is the worst column you can index. So don't index booleans.

As with other types, if you have very repetitive values that are not significant from a business point of view, it's probably a good idea to exclude.

Debugging

Prosopite is able to auto-detect Rails N+1 queries

Development

Documentation

nshki/chusaku: Annotate your Rails controllers with route info.

Error Reporting and Exception Handling

Solid Errors is a DB-based, app-internal exception tracker for Rails applications, designed with simplicity and performance in mind.

Events

Rails Event Store

Files and Storage

# tempfiles
Tempfile.open("voucher", Rails.root.join("tmp")) do |f|
  f.print(price.name)
  f.flush
end

Forms

Date Picker

<%= f.text_field :birthday, label: t(:form_birthday),
    floating: true, required: true,
    data: {
      controller: "flatpickr",
      flatpickr_date_format: "d.m.Y",
      flatpickr_min_date: "1900-01-01",
      flatpickr_allow_input: true,
    }
%>

Frontend

ViewComponent
Breadcrumbs
Rails Blocks UI components
Hotwire dev tools
RubyUI component library
Better StimulusJS Examples
Give a SPA Feel to Your Static Website with Hotwire's Turbo
Phlex

Gems

Ruby Toolbox

Generators

rails g scaffold_controller
rails g migration addAddressToOps address:reference

Hosting

Dokku

Howtos/Guides

Images

Fileboost - Supercharge Your Rails Images

Jobs

https://mileswoodroffe.com/articles/solid-queue-and-mission-control
https://dev.37signals.com/introducing-solid-queue
https://github.com/rails/mission_control-jobs
https://www.driftingruby.com/episodes/processing-large-jobs
SOLID_QUEUE_IN_PUMA=1
chrono_forge - a robust framework for building durable, distributed workflows in Ruby on Rails applications

Logging

log_bench

log_bench - A terminal-based Rails log viewer with real-time monitoring and filtering capabilities
Internal product analytics with Ahoy

Honeybadger

Honeybadger.event("SUCCESS", 
  { message: "A new customer just signed up" })

Mail

joshmn/caffeinate: A Rails engine for drip campaigns/scheduled sequences and periodical support. Works with ActionMailer, and other things.

Migration

https://www.akshaykhot.com/rails-database-migrations-cheatsheet/

Load schema instead of migrations

rake db:schema:load

If you're on the latest (8) version of Ruby on Rails, there's a nice shortcut to add the not null modifier to your database columns. Just add an exclamation mark after the type, and Rails will mark that column as not null.

rails generate migration CreateUsers \
  email_address:string!:uniq password_digest:string!

MySQL

ALTER USER 'opos'@'localhost' \
  IDENTIFIED WITH mysql_native_password BY 'opos';

Multiple Databases with Active Record — Ruby on Rails Guides

# models/application_record.rb     
class ApplicationRecord < ActiveRecord::Base
  primary_abstract_class
  connects_to database: {writing: :primary, reading: :primary_replica}
end

Payment

Active Merchant is a simple payment abstraction library extracted from Shopify
Pay gem - used in Jumpstart Pro

PDF

Search

Security

Rate limiting

Scraping

https://github.com/glaucocustodio/tanakai

Storage

# Purge orphan files and blob records
ActiveStorage::Blob.unattached.each(&:purge)

SQLite

Testing

Minitest

# test_helper.rb
# Set up minitest-reporters to show a 
# spec-style progress report.
require "minitest/reporters"
Minitest::Reporters.use! 
  [Minitest::Reporters::SpecReporter.new]

Capybara System Tests

bin/rails generate system_test users

Test Coverage

# test_helper.rb
require "simplecov"
SimpleCov.start "rails"

Templates/ERB

Disable Turbo

<%= link_to l.to_s.upcase, "/#{l}", 
  class: ("active" if locale == l), 
  data: {"turbo": false } %>

Translation

Rails translation cheatsheet

Updating

URLs

Canonical URLs

Favorite CLI Tools

Wed, 12 Nov 2025 00:00:00 GMT

Command line tool recommendations

These CLI tools save me lots of time and I find them generally a joy to work with. It's all about sharing the love and magic, and maybe you'll find a new favorite or two. Let me know if you have a CLI tool that brings you joy - or comment below.

bat - a cat(1) clone with wings

I love this. It's a drop-in replacement for cat that adds syntax highlighting, Git integration and lots more. It's written in Rust and is blazing fast. sharkdp/bat: A cat(1) clone with wings.

How to use bat

To glance at a file using bat, simply provide the path:

bat /path/to/your/file

The syntax highlighting and file-specific metadata make bat a joy to use, ensuring you can inspect code and text files in style.

Claude Code

Even though it's more application than classic tool, my favorite command line tool has recently become Claude Code (also see AI/LLM index page).

Homebrew - The missing macOS package manager

It's simply a must-have for every Mac user. Whether it's installing a new programming language, a database server, or the latest web framework, Homebrew streamlines the process, taking out the need for locating and manually downloading software.

The brew command

Working with Homebrew is straightforward:

brew update
brew install <package>

httpie - HTTP client for the command line

Making HTTP requests from the command line has never been more elegant than with httpie. It simplifies interaction with APIs and web services, offering a user-friendly interface and an eye-pleasing HTTP request syntax colorization.

There also is a very neat httpie desktop application!

Crafting requests with httpie

A basic GET request:

https httpie.io/hello

Output:

{
    "ahoy": [
        "Hello, World! 👋 Thank you for trying out HTTPie 🥳",
        "We hope this will become a friendship."
    ],
    "links": {
        "discord": "https://httpie.io/discord",
        "github": "https://github.com/httpie",
        "homepage": "https://httpie.io",
        "twitter": "https://twitter.com/httpie"
    }
}

jq - Command-line JSON processor

jq is a sed-like tool that parses, manipulates, and displays JSON objects from the comfort of the command line. It excels at selectively filtering and transforming complex JSON data, which is a common task when working with APIs and backend services.

Transforming with jq

Filtering results:

https httpie.io/hello | jq "{links}"

This will present just the links from the JSON response. jq is nice for quickly juggling JSON data.

kopia - Fast and Secure Open-Source Backup Software

Encrypted backups with kopia to Amazon S3 and any cloud storage that is compatible with S3, Azure Blob Storage, Backblaze B2, Google Cloud Storage, WebDAV, SFTP, Rclone.

Creating a repository (e.g. SFTP)

kopia repository create sftp \
      --path=... \
      --host=... \
      --username=... \
      --sftp-password=...

Connecting to a repository

kopia repository connect sftp \
      --path=... \
      --host=... \
      --username=...

Creating a snapshot

kopia snapshot create $HOME/Projects/github.com/kopia/kopia

lando - Local development environment and DevOps tool built on Docker containers

For local development, lando is mighty. It configures and manages Docker-based development environments, providing an abstraction layer that spares developers the mundanity of configuring development Docker environments and installing necessary tools and software versions.

A lando starter

Creating a Wordpress site:

lando init --recipe wordpress

And with that simple command, you're on your way to local Wordpress development with a containerized environment. lando integrates with other tools such as composer, npm, and gulp to streamline development workflows. It's an excellent tool for building, testing, and deploying applications locally. One of the most powerful features is the ability to define multiple environments in a single configuration file (e.g. local, staging, production) that can be easily switched between.

lazygit - Terminal UI Git Command Manager

lazygit is a simple yet powerful terminal UI with Norton Commander vibes that transforms how you interact with Git, making complex operations accessible through intuitive keyboard shortcuts.

It reduces context switching. Instead of running multiple commands and checking different windows, everything is visible in one organized interface. The tool even guides you through operations interactively - for example, it warns about divergence with upstream when pushing and lets you choose between force push or cancel.

mise-en-place - Polyglot tool version manager

mise is a tool that manages installations of programming language runtimes and other tools for local development. For example, it can be used to manage multiple versions of Node.js, Python, Ruby, Go, etc. on the same machine.

ohmyzsh - Delightful framework for managing your zsh configuration

ohmyzsh transforms the already powerful zsh into a feature-rich and stylish terminal environment. With themes, plugins, and an active community contributing enhancements, ohmyzsh makes the terminal experience more personal and productive.

ohmyzsh also comes packed with a variety of plugins that add new features to zsh, such as an auto-suggestion tool and syntax highlighting, making it even more powerful. These can be easily enabled or disabled through the ~/.zshrc file as well.

zsh-autosuggestions

Getting along well with ohmyzsh, this tool offers context-aware auto-completion, predicting your command line moves, and saving keystrokes in the process. Start by typing a command and, based on your history, zsh-autosuggestions will begin offering predictions. You can cycle through suggestions with the right arrow key or accept one with the tab key.

rbenv - Ruby Version Manager

For managing multiple Ruby environments, rbenv is vital. It allows for per-project Ruby versions, which is a blessing when working on legacy software that demands older Ruby interpreters alongside the current releases.

Install a Ruby version

# List installable versions
rbenv install -l

3.1.6
3.2.6
3.3.7
3.4.3
jruby-9.4.10.0
mruby-3.3.0
picoruby-3.0.0
truffleruby-24.1.1
truffleruby+graalvm-24.1.1

# Build and install version 3.4.3
rbenv install 3.4.3

Switching global Ruby version

rbenv global 3.4.3

This indicates that generally Ruby 3.4.3 should be used, while local projects can specify a different version in their .ruby-version file. When executing bundle command, or any other code that requires a Ruby environment, rbenv will use the specified or else the global version.

MacOS setup

Sun, 19 Oct 2025 00:00:00 GMT

My installation steps for setting up a new Mac computer.

Essentials

# Homebrew (https://brew.sh)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# bat - better cat
brew install bat

# ripgrep - recursively searches directories for a regex pattern
brew install ripgrep

Better Shell

# Oh my zsh
sh -c "$(wget -O- https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

# Powerlevel10k theme
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

# Change theme in .zshrc
ZSH_THEME="powerlevel10k/powerlevel10k"

# Syntax highlighting and auto suggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

# Activate the plugin in ~/.zshrc:
plugins=(git zsh-syntax-highlighting zsh-autosuggestions)

Development

brew install git-delta
brew install httpie
brew install rbenv
brew install php
brew install yarn
brew install sass
brew install jq
brew install gh

Install Homebrew packages from list

Making a list of installed software

brew leaves > brews.txt

Next, include installed casks in the same list:

brew list --cask >> brews.txt

This appends the cask list to brews.txt, giving a complete list of all explicitly installed packages.

Reviewing package descriptions

It is helpful to verify all packages are still needed on a new computer. Review packages as follows:

cat brews.txt | xargs brew desc –eval-all

This command provides a short description for each package in the list.

Reinstalling on a new machine

Transfer brews.txt to the new computer, install Homebrew, and run:

xargs brew install < brews.txt

This installs all the packages listed in the file.

Ghost CMS

Thu, 04 Sep 2025 00:00:00 GMT

My favorite open-source CMS for content sites

Ghost is a fantastic open-source, headless Node.js CMS and my go-to system for setting up content sites (e.g. my German consulting business site itpeters.com or my private travel logbook reisepedia.de). Essentially, it's a customizable platform for running blogs, magazines, or journals. It's fully open-source and runs blogs from OpenAI, DigitalOcean, Mozilla and many other big names.

The Ghost Foundation is offering a hosted version of Ghost, so it's accessible for non-technical content creators. This is really great and should be used by all means, if you don't want to deal with the technical aspects of running a web server. For me, however, it comes natural to set up a Ghost instance on my own server with the offical Docker image and Dokku.

There are also a ton of themes for purchase (and for free!) on Ghost's official website. I personally like the themes from Bright Themes, which are very well designed and easy to customize. They offer a lifetime license for all themes, which I think is a fantastic deal. This site uses the Array theme by Bright Themes.

Key features

Very fast and stable
Open Source (MIT license)
Paid subscription and membership support
SEO and social media optimization
Newsletter integration
Native REST API in core
Admin dashboard
Hosted version available
Self-hosting possible and well-documented
Great themes available (paid and free)

Notes

Sort posts on last updated

{{#get "posts" include="authors,tags" order="updated_at desc"
  limit=@config.posts_per_page}}
  {{> post-feed}}
{{/get}}

index.hbs

{{!-- Date --}}
<time class="leading-none font-medium" datetime="{{date updated_at format="YYYY-MM-DD"}}">{{date updated_at}}</time>

post-card.hbs

Code word wrap

code[class*="language-"], 
pre[class*="language-"] {
    white-space: pre-wrap;
    overflow-wrap: break-word;
    word-break: normal;
    overflow-x: auto;
}

/* Mobile responsive adjustments */
@media screen and (max-width: 768px) {
    code[class*="language-"], 
    pre[class*="language-"] {
        font-size: 0.85em;
        line-height: 1.3;
        -webkit-overflow-scrolling: touch;
    }
}

Dokku: Open source Heroku alternative

Mon, 16 Jun 2025 00:00:00 GMT

Dokku is a self-hosted open-source PaaS similar to Heroku.

My favorite hosting solution for several years. It's lightweight, open-source and really stable. There are two general modes of operation: Buildpacks (e.g. Herokuish) and Dockerfiles.

On a freshly installed Linux machine, after installing Dokku you can push to Git repos on the server, and a container will be build and started for your app, with Nginx as a reverse proxy running in front of everything.

Installation

Linux

# download the installation script
wget -NP . https://dokku.com/bootstrap.sh

# run the installer
sudo DOKKU_TAG=v0.35.18 bash bootstrap.sh

Mac (Homebrew)

brew install dokku/repo/dokku

Plugins

dokku-letsencrypt - Automatic Let's Encrypt TLS Certificate installation
dokku-mariadb - MariaDB plugin
dokku-postgres - PostgreSQL plugin
dokku-redirect - Simple redirects for applications

General config settings

Change deploy branch

dokku git:set deploy-branch main

Timezone

dokku config:set TZ=Europe/Berlin

Nginx settings

Disable HSTS header

dokku nginx:set hsts false
dokku proxy:build-config

Max upload size

dokku nginx:set sitename client-max-body-size 25m

Rate limiting

See Rate limiting with dokku

Redirects

Redirect www to non-www using dokku-redirect plugin:

dokku redirect:set larsp www.larsp.de larsp.de
-----> Configuring redirect for www.larsp.de to larsp.de via HTTP 301...

Ruby on Rails

Rails config

dokku config:set myrailsapp \
  SECRET_KEY_BASE=mysecret RAILS_ENV=production \
  RACK_ENV=production RAILS_LOG_TO_STDOUT=enabled \
  RAILS_SERVE_STATIC_FILES=enabled

PHP

Troubleshooting buildpack error

In case there is a problem with the PHP buildpack:

/tmp/buildpacks/08_buildpack-php/bin/compile: line 236: /tmp/buildpacks/08_buildpack-php/support/build/_util/formulae-hash.sh: No such file or directory

Reset the PHP herokuish buildpack:

rm -rf /home/dokku/<app>/cache/*
dokku config:set <app> BUILDPACK_URL=https://github.com/heroku/heroku-buildpack-php --no-restart
dokku ps:rebuild <app>

Rails translation cheatsheet

Thu, 08 May 2025 00:00:00 GMT

How to translate a Rails application.

Locales

# config/application.rb

config.i18n.available_locales = %i[de fr it]
config.i18n.default_locale = :de

# app/controllers/application_controller.rb

class ApplicationController < ActionController::Base
  around_action :switch_locale

  def switch_locale(&)
    locale = params[:locale] || I18n.default_locale
    I18n.with_locale(locale, &)
  end

  def default_url_options
    { locale: I18n.locale }
  end
end

# config/routes.rb

scope "(:locale)", locale: /de|fr|it/ do
  get "thankyou", to: "pages#thankyou"
  get "terms", to: "pages#terms"

  resource :submissions, only: %i[new create]
  get "submissions", to: "submissions#new"
  get "/", to: "submissions#new"
end

Field translation

Translatable columns for Ruby on Rails, stored in the model table itself

# Gemfile
gem "traco"

# app/models/question.rb

class Question < ApplicationRecord
  translates :question, :answer
end

Syncthing

Tue, 06 May 2025 00:00:00 GMT

The best (IMHO) multi-platform open-source file synchronization solution.

As much I wanted it to work, iCloud file synchronization used to give me headaches. I work with two Macs - one Mini in the office, and a MacBook on the go. In addition, I'm using a large iPad Pro and an older, small iPad Pro for traveling. My work files, mostly Git repositories of projects I am working on and additional reference material, should be shared across all these devices. I tried to use iCloud for this, but it was always a pain to get it to work reliably. I also used Dropbox in the past, but moved away after they went the course of integration everything and whatnot in their software. Also, it was a resource hog.

The problem with iCloud is that you don't really know what's going on. It's a black box. You can't see what's happening, and you can't really control it. When the service thinks your files might have been changed on another device, it will create a copy of the file with a suffix " 2". Sometimes this happens for hundreds of files in a folder, and I resorted to just deleting them with:

find . -name "*\ 2" -delete

Also, sometimes iCloud is not updating at all for some reason.

Enter Syncthing

Yesterday, I was fed up with this and installed Syncthing on my Macs. It's a free, open-source file synchronization software that works on all major platforms and works really smoothly. I used it in the past already, and never had a problem.

iOS

For iOS, there is a very good open source client app called Synctrain. There's also an older third party solution (MöbiusSync), but I'd recommend Synctrain because it's much smoother.

There is a goals document describing Syncthing if you're interested.

Linux install

sudo apt install syncthing
sudo systemctl enable syncthing@lape.service
sudo systemctl start syncthing@lape.service

CLI commands

syncthing cli config devices add --device-id ...
syncthing cli config options relays-enabled set false
find . -name "*sync-conflict*" -print

Files to ignore

(?d).DS_Store
Thumbs.db
desktop.ini
.Trashes
.Spotlight-V100
._*
lost+found

Archiving CMS websites to static files with httrack

Wed, 23 Apr 2025 00:00:00 GMT

Using httrack to archive a CMS website to keep only as static site.

When to Archive CMS Sites

When a website built with a content management system like Drupal or WordPress is no longer updated with content or a campaign has ended, the webpages sometimes need to be archived for reference or remain online without further changes. It's not always feasible to upgrade all CMS components along the way. A major version change might require expensive custom module upgrades for a site no longer in production use. Archiving to static files is a practical solution.

Using the httrack tool to archive a website

There are several options for archiving websites (see Awesome Web Archiving List). The httrack command line tool is a preferred option. On macOS using Homebrew, install it with:

brew install httrack

These optimal httrack options for mirroring:

httrack http://SITE_TO_ARCHIVE -O DESTINATION_DIR \
  -N "%h%p/%n/index%[page].%t" \
  -WqQ%v --robots=0 --footer ''

The tool will prompt you if external links should be followed.

Post-Processing Steps

Relative links can be rewritten afterwards (e.g., "about.html" to "about"). This is optional but useful if you want to preserve URL paths for inbound links.

find . -name "*.html" -type f -print0 \
  | xargs -0 perl -i -pe "s/\/index.html/\//g"

Copy the homepage index from index/index.html to the site root and change include paths and links in it (remove "../" everywhere).

If the source site uses HTTP authentication, provide username and password as part of the URL: username:password@your.url

Hosting Archived Sites

The resulting files can be served from inexpensive static web hosting like Netlify or GitHub Pages.

References

Httrack users guide
Archiving Drupal sites on drupal.org
About archiving Drupal sites by Karen from Lullabot

Barcode PDFs with Ruby on Rails

Sun, 20 Apr 2025 00:00:00 GMT

Using Barby and Prawn to imprint PDFs with individual barcodes

For a Rails project, I researched methods to generate individual PDFs with imprinted EAN barcodes. This guide documents a working approach using modern Ruby libraries.

Libraries Used

Barby is a barcode generator library for Ruby that generates barcodes as images or PDFs. Prawn is a PDF generation library for Ruby that creates PDFs from scratch and annotates existing PDFs with text, images, and barcodes.

Implementation Approach

The solution uses two model classes:

A voucher class with a code property (printed as a barcode)
A PDF generation class that subclasses Prawn::Document

The PDF generation class accepts a path and code as arguments, generates a PDF with the barcode imprinted, and returns the path to a temporary file that is automatically deleted when the Rails process exits.

PDF Specifications

The resulting PDF is 100mm x 133mm with a PNG background image. Initially, the background option of Prawn::Document was tested but didn't scale the image properly. Instead, the image method with the fit option scales the image to the page size.

Prawn's measurement_extensions allow using millimeters as a unit instead of the default 1/72 inch.

Code Example

require "barby/barcode/code_128"
require "barby/outputter/prawn_outputter"
require "prawn/measurement_extensions"

class CodePdf < Prawn::Document
  def initialize path, code, background
    super({
      page_size: [100.mm, 177.mm],
      margin: 0
    })

    image background, fit: [100.mm, 177.mm]
    barcode code
    render_file path
  end

  def barcode code
    barcode = Barby::Code128.new code
    barcode.annotate_pdf self, height: 18.mm, x: 17.mm, y: 3.mm
  end
end

Voucher Generation

In the code class, a temporary file is created and the PDF generation class is called. The background image is located in the app/assets/images/{language} directory. The I18n.locale method returns the current locale (e.g., de or fr) to find the correct background image:

def voucher
  # Create temporary file e.g. tmp/voucher20230805-66997-kozjms.pdf
  tmpfile = Tempfile.new "voucher", Rails.root.join("tmp")
  path = tmpfile.path + ".pdf"
  bg_path = Rails.root.join "app", "assets", "images", I18n.locale.to_s, price.voucher
  CodePdf.new path, code, bg_path
  path
end

Here is an example of the resulting voucher PDF with the barcode:

larsp.de

AI/LLM Resources

Claude Code

Plugins & extensions

Spec-driven workflows

Agent Skills

Model Context Protocol (MCP)

Ruby/Rails tools and frameworks

IMAP migration and backup

imapsync

imap-backup

Gotchas

Open Source Software

Chat / Messaging

CMS

Development

Document Management

Home

Hosting

Mail

Project Management

Tasks

Ruby on Rails resources

Admin interfaces

AI

APIs

Apple Wallet

Authorization

Bundling

Caching

Memcache

CAPTCHAs

CLI

CMS

Concurrency

Config

Commerce

CSS

Databases

Indices

Debugging

Development

Documentation

Error Reporting and Exception Handling

Events

Files and Storage

Forms

Date Picker

Frontend

Gems

Generators

Hosting

Howtos/Guides

Images

Jobs

Logging

Honeybadger

Mail

Migration

MySQL

Payment

PDF

PostgreSQL

Proxy

Redis

Rich Text

Routing

Search

Security

Rate limiting

Scraping

Storage

SQLite

Testing

Minitest

Capybara System Tests

Test Coverage

Templates/ERB

Disable Turbo

Translation