Assorted updates

[XhmikosR]

@az0: please check the individual patches. A preview can be found on https://super-salamander-00b8ec.netlify.app. The sitemap is here: https://super-salamander-00b8ec.netlify.app/sitemap.xml

[az0]

In a quick review, it looks good, and I appreciate you doing it.

Only issue I saw was that the sitemap uses the document creation date, but I haven't checked whether that's an existing issue.

[XhmikosR]

I can't check the original sitemap because for some reason Cloudflare is blocking my IP...

Sorry, you have been blocked
You are unable to access bleachbit.org

[XhmikosR]

Anyway, if the dates are an issue, I suggest that you update the front mater values to match the real dates because that's how Jekyll is supposed to work.

[XhmikosR]

All these rm and find calls could be replaced with a git clean -dfx call if you only support repo runs.

EDIT: here's my suggestion

# Makefile for BleachBit documentation site

.PHONY: help clean serve build install update

# Default target
help:
	@echo "Available targets:"
	@echo "  help     - Show this help message"
	@echo "  clean    - Remove generated files and dependencies"
	@echo "  serve    - Start local development server"
	@echo "  build    - Build the static site"
	@echo "  install  - Install Ruby dependencies"
	@echo "  update   - Update Ruby dependencies"

# Clean generated files and dependencies
clean:
	@echo "Cleaning generated files..."
	git clean -dfx
	@echo "Collecting garbage in git..."
	git gc
	@echo "Clean complete."

# Install Ruby dependencies
install:
	@echo "Installing Ruby dependencies..."
	bundle install
	@echo "Dependencies installed"

# Update Ruby dependencies
update:
	@echo "Updating Ruby dependencies..."
	bundle update
	@echo "Dependencies updated."
	@echo "Listing outdated dependencies..."
	bundle outdated

# Build the static site
build:
	@echo "Building site..."
	bundle exec jekyll build
	@echo "Site built in _site/"

# Serve locally for development
serve:
	@echo "Starting development server..."
	bundle exec jekyll serve --drafts

# Serve locally without drafts (production-like)
serve-prod:
	@echo "Starting production-like server..."
	bundle exec jekyll serve

[XhmikosR]

OK, I think I got all the changes I wanted to make in.

One change from your side is to set deploy for Pages to GitHub Actions. If anything else is needed, I will create a followup PR.

[az0]

I can't check the original sitemap because for some reason Cloudflare is blocking my IP...

The original sitemap had no timestamps

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://docs.bleachbit.org/404.html</loc>
</url>
<url>
<loc>https://docs.bleachbit.org/</loc>
</url>
<url>
<loc>https://docs.bleachbit.org/assets/css/style.css</loc>

After your changes, the new sitemap has good timestamps. I verified ./_posts/2015-09-25-general-usage.md was modified on March 18, so that's correct. Thanks

<urlset xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9 http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd">
<url>
<loc>http://localhost:4000/cml/cleanerml.html</loc>
<lastmod>2026-08-30T12:14:09+00:00</lastmod>
</url>
<url>
<loc>http://localhost:4000/doc/preferences.html</loc>
<lastmod>2026-08-30T12:31:43+00:00</lastmod>
</url>
<url>
<loc>http://localhost:4000/doc/general-usage.html</loc>
<lastmod>2026-03-19T04:53:20+00:00</lastmod>
</url>

[XhmikosR]

Just remember to change deployment for pages to GitHub Actions in repo settings and everything should work.

I can fix any issues that might arise later.