This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
This is a static personal website (claudioscheer.github.io) with no build system or package manager. All pages are plain HTML with inline styles, served directly by GitHub Pages.
- Create a Markdown file under
blog/<tag>/post-name.md. The first line (a# Heading) becomes the post title; the directory name becomes the tag/category. - From the
blog/directory, run the generation script to create the HTML wrapper and update the post index:This script reads eachcd blog && bash create-posts.sh
.mdfile, copiestemplate.htmlwith##FILE_NAME##replaced by the.mdpath, and regeneratesposts.json.
Place large images in gallery/large/, then from the gallery/ directory run:
cd gallery && bash create-gallery.shThis uses ImageMagick (convert) to generate 600px thumbnails into gallery/thumb/ and regenerates gallery.json.
index.html— Homepage; static HTML with Tailwind CSS (CDN) and Inter font.blog/— Blog section:index.htmlloadsposts.jsonviajs/blog.jsand renders post links grouped by tag.template.htmlis the per-post shell; it fetches the.mdfile at runtime and renders it with Showdown.js (CDN).posts.jsonis the generated index; do not edit manually — regenerate withcreate-posts.sh.- Markdown source lives alongside the generated HTML (e.g.,
blog/ai/post.md→blog/ai/post.html).
gallery/— Photo gallery:index.htmlloadsgallery.jsonviajs/gallery.js.gallery.jsonis generated bycreate-gallery.sh; do not edit manually.- Thumbnails live in
gallery/thumb/.
css/— Unused legacy stylesheets (air.css,retro.css,github.min.css); current styling is inline in each HTML file.icons/— SVG social icons referenced inindex.html.assets/— Static assets:resume.pdfandpgp-key.txt.
Pushing to master deploys automatically via GitHub Pages. No build step required.