samhuri.net

Source code for samhuri.net, powered by a Ruby static site generator.

Overview

This repository is now a single integrated Ruby project. The legacy Swift generators (gensite/ and samhuri.net/) have been removed.

• Generator core: lib/
• Build tasks and utility workflows: bake.rb
• Tests: spec/
• Config: site.toml and projects.toml
• Content: posts/ and public/
• Output: www/

Requirements

• Ruby (see .ruby-version)
• Bundler
• rbenv recommended

Setup

bin/bootstrap

Or manually:

rbenv install -s "$(cat .ruby-version)"
rbenv exec bundle install

Build And Serve

rbenv exec bundle exec bake debug   # build for http://localhost:8000
rbenv exec bundle exec bake serve   # serve www/ locally

Configuration

Site metadata and project data are configured with TOML files at the repository root:

• site.toml: site identity, default scripts/styles, and a plugins list (for example ["posts", "projects"]), plus projects_plugin assets when that plugin is enabled.
• projects.toml: project listing entries using [[projects]].

Pressa.create_site loads both files from the provided source_path and still supports URL overrides for debug, beta, and release builds.

Customizing for your site

If this workflow seems like a good fit, here is the minimum to make it your own:

• Update site.toml with your site identity (author, email, title, description, url) and any global scripts / styles.
• Set plugins in site.toml to explicitly enable features ("posts", "projects"). Safe default if omitted is no plugins.
• Define your projects in projects.toml using [[projects]] entries with name, title, description, and url.
• Configure project-page-only assets in site.toml under [projects_plugin] (scripts and styles) when using the "projects" plugin.
• Add custom plugins by implementing Pressa::Plugin in lib/ and registering them in lib/config/loader.rb.
• Adjust rendering and layout in lib/views/ and the static content in public/ as needed.

Other targets:

rbenv exec bundle exec bake mudge
rbenv exec bundle exec bake beta
rbenv exec bundle exec bake release
rbenv exec bundle exec bake watch target=debug
rbenv exec bundle exec bake clean
rbenv exec bundle exec bake publish_beta
rbenv exec bundle exec bake publish

Draft Workflow

rbenv exec bundle exec bake new_draft "Post title"
rbenv exec bundle exec bake drafts
rbenv exec bundle exec bake publish_draft public/drafts/post-title.md

Published posts in posts/YYYY/MM/*.md require YAML front matter keys:

• Title
• Author
• Date
• Timestamp

Tests And Lint

rbenv exec bundle exec bake test
rbenv exec bundle exec standardrb

Or via bake:

rbenv exec bundle exec bake test
rbenv exec bundle exec bake lint
rbenv exec bundle exec bake lint_fix

Notes

• bake watch is Linux-only and requires inotifywait.
• Deployment uses rsync to host mudge (configured in bake.rb):
  • production: /var/www/samhuri.net/public
  • beta: /var/www/beta.samhuri.net/public