mark
/
msos
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
msos/tools
History
popovskik af294ce8a4 chore: stop tracking compiled .pyc bytecode 
These auto-generated Python caches were committed before .gitignore
listed __pycache__/ and *.pyc, so Git kept tracking them and they showed
up as spurious changes on every build. Untrack them (files stay on disk)
so .gitignore takes effect and they no longer appear in diffs.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 		2026-08-22 08:17:17 +02:00
..
git-hooks GEO: FAQPage/NGO/Event schema + autonomous generation for new projects 2026-08-07 22:17:03 +02:00
tests feat(cms): U4 one-command site build + local preview 2026-08-08 17:04:00 +02:00
README.md feat(cms): U4 one-command site build + local preview 2026-08-08 17:04:00 +02:00
build_blog.py Blog: add personal essay "How I coped with leaving home" (trilingual, prose) 2026-08-05 17:37:14 +02:00
build_botlinks.py Bot pages: use root-relative links so they work on any host 2026-08-05 18:18:32 +02:00
build_content.py feat(cms): U4 one-command site build + local preview 2026-08-08 17:04:00 +02:00
build_listings.py GEO: FAQPage/NGO/Event schema + autonomous generation for new projects 2026-08-07 22:17:03 +02:00
build_search_index.py feat(assistant): v2 — query-language detection, analytics, chips, auto-index 2026-08-04 01:48:39 +02:00
build_site.py feat(cms): U4 one-command site build + local preview 2026-08-08 17:04:00 +02:00
content_index.py feat(cms): U3 derive article dates from content/ front-matter 2026-08-08 16:47:03 +02:00
migrate_pages_to_content.py feat(cms): U3 derive article dates from content/ front-matter 2026-08-08 16:47:03 +02:00
seo_inject.py feat(cms): U3 derive article dates from content/ front-matter 2026-08-08 16:47:03 +02:00

README.md

tools/

content_index.py

Reads the content/ source tree (front-matter) as structured data. Its load_dates() builds the article date registry consumed by seo_inject.py, so adding a post no longer needs a manual ARTICLE_DATES edit — the date lives in the post's front-matter (date / date_type). See docs/content-model.md.

build_site.py

One command to build the whole site from content/, in dependency order (content pages -> listings -> SEO/sitemap -> bot links -> search index). This is what CI runs before deploying. --check verifies without writing; --images also runs image optimisation. Idempotent. See docs/local-preview.md.

build_content.py

Renders the content/ source files into the blog/news/event detail pages (--check verifies the output matches the current site; --write emits pages). See docs/content-model.md and the no-code CMS plan in docs/plans/.

seo_inject.py

Injects a technical-SEO block into every language page (en|mk|si/**/index.html) and regenerates sitemap.xml + robots.txt. Safe to re-run — the block lives between <!-- SEO:START --> and <!-- SEO:END --> and is replaced in place.

The block adds: meta description (auto-extracted from the page's lead/subtitle where available), canonical, hreflang alternates (en / mk / sl / x-default), Open Graph, Twitter Card, and an Organization JSON-LD.

All absolute URLs point at the final domain https://msosorg.com (not the temporary host), so nothing needs rewriting at launch. Note: the Slovene folder is /si/ but the ISO code is sl — the script maps si → sl for hreflang/locale.

Usage

python tools/seo_inject.py            # dry run: print the block for pilot pages
python tools/seo_inject.py --all      # write the block into every page
python tools/seo_inject.py --all --sitemap   # also rebuild sitemap.xml + robots.txt

Run --all --sitemap after adding, renaming, or deleting any page so canonical tags, hreflang alternates, and the sitemap stay in sync.