History

popovskik abd9103500 feat(seo): add Google Preferred Sources button + footer link New self-contained preferred-source.js (referenced site-wide via seo_inject GA_LINES): - small "Add us on Google" text link in the footer (.legal-links) on every page, trilingual, using the domain deeplink; - Google's official interactive pill (publisher.js) on the homepage, News hub and Blog hub only, localized (en/mk/sl). Lets readers mark MSOS as a preferred source (Top Stories / Discover / News / AI surfaces). Cache-bust bump included. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>		2026-08-30 11:25:07 +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	content(mss-2026): add sponsor logo + event banners, update venue to NLB branch	2026-08-27 07:05:41 +02:00
build_listings.py	content(mss-2026): add sponsor logo + event banners, update venue to NLB branch	2026-08-27 07:05:41 +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	build: content-hash cache-busting for local CSS/JS (?v=hash)	2026-08-27 18:14:44 +02:00
cache_bust.py	build: content-hash cache-busting for local CSS/JS (?v=hash)	2026-08-27 18:14:44 +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(seo): add Google Preferred Sources button + footer link	2026-08-30 11:25:07 +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  and  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.