+
+{# ====== MAIN COLUMN — My Writing ====== #}
+
{% if sections %}
{% for section in sections %}
+ {% if section.key == 'writing' %}
{{ section.icon }}
@@ -44,11 +49,12 @@
{% endfor %}
+ {% endif %}
{% endfor %}
{% else %}
- ✍️
+ ✍️
My Writing
@@ -74,4 +80,104 @@
{% endif %}
+
{# /main-column #}
+
+{# ====== SIDEBAR — HN + YouTube ====== #}
+{% if sidebar.hn_stories or sidebar.hn_comments or sidebar.watching %}
+{# /page-sidebar #}
+{% endif %}
+
+{# /page-layout #}
{% endblock %}
diff --git a/config/youtube_channels.txt.example b/config/youtube_channels.txt.example
new file mode 100644
index 0000000..1bb6c71
--- /dev/null
+++ b/config/youtube_channels.txt.example
@@ -0,0 +1,29 @@
+# YouTube channel IDs or handles for the "My Watching" section.
+#
+# HOW TO USE
+# ----------
+# No API key is required! The ingestor uses YouTube's public Atom/RSS feeds.
+#
+# The recommended approach is to set YOUTUBE_CHANNEL_IDS as a GitHub Actions
+# repository Variable (repo Settings → Secrets and variables → Variables).
+# That way your channel IDs are never committed to source control, so forks
+# of this blog start with a clean slate.
+#
+# For local development only, you may create the file
+# config/youtube_channels.txt
+# (without the .example extension) and add one entry per line.
+# That filename is gitignored, so it will never be committed.
+#
+# ACCEPTED FORMATS
+# ----------------
+# @YourChannelHandle — your YouTube handle (e.g. @HanClinto)
+# UCxxxxxxxxxxxxxxxxxxxxxx — raw channel ID starting with UC
+#
+# Handles are resolved automatically at build time by fetching the channel page.
+#
+# Each channel returns up to the 15 most-recently-uploaded videos.
+#
+# EXAMPLE ENTRIES (remove the leading # to activate)
+# ----------------------------------------------------
+# @HanClinto
+# UCxxxxxxxxxxxxxxxxxxxxxx
From 4383b2dbd7999bac5a1396cb49e8a235e622cd01 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Tue, 14 Apr 2026 03:44:42 +0000
Subject: [PATCH 2/4] feat: auto-discover YouTube channel from GitHub profile
social links
Agent-Logs-Url: https://github.com/HanClinto/SimpleGitBlog/sessions/067cd850-bbc4-42f2-aaef-3427ecee8660
Co-authored-by: HanClinto <796749+HanClinto@users.noreply.github.com>
---
blog/generate.py | 39 +++++++-
blog/ingestors/github_profile.py | 166 +++++++++++++++++++++++++++++++
blog/static/style.css | 20 ++++
blog/templates/config.html | 74 +++++++++++++-
4 files changed, 295 insertions(+), 4 deletions(-)
create mode 100644 blog/ingestors/github_profile.py
diff --git a/blog/generate.py b/blog/generate.py
index 843e66b..bf67b39 100644
--- a/blog/generate.py
+++ b/blog/generate.py
@@ -43,7 +43,7 @@
from jinja2 import Environment, FileSystemLoader # noqa: E402
import urllib.parse # noqa: E402
-from blog.ingestors import github_issues, hackernews, youtube # noqa: E402
+from blog.ingestors import github_issues, github_profile, hackernews, youtube # noqa: E402
# ---------------------------------------------------------------------------
# Paths
@@ -107,13 +107,28 @@ def generate_site(
) -> None:
_start = time.monotonic()
+ repo_owner = repo.split("/")[0]
repo_name = repo.split("/")[-1]
repo_url = f"https://github.com/{repo}"
+ # Build GitHub API request headers
+ gh_headers: dict[str, str] = {"Accept": "application/vnd.github+json"}
+ if token:
+ gh_headers["Authorization"] = f"Bearer {token}"
+
# Load config files early so we can pass them to the config page
hidden_labels = github_issues._load_hidden_labels(CONFIG_DIR)
blocked_users = github_issues._load_blocked_users(CONFIG_DIR)
+ # --- GitHub owner profile & social links ---
+ print(f"Fetching GitHub profile for: {repo_owner}…")
+ owner_profile = github_profile.fetch_owner_profile(repo_owner, gh_headers)
+ if owner_profile:
+ print(f" Profile: {owner_profile.name or owner_profile.login}")
+ print(f" Social links: {len(owner_profile.social_links)} found.")
+ else:
+ print(" Could not fetch GitHub profile — social link auto-discovery disabled.")
+
# --- GitHub Issues (My Writing) — always runs ---
print("Fetching GitHub Issues (My Writing)…")
writing_posts = github_issues.ingest(repo, token, CONFIG_DIR)
@@ -123,12 +138,28 @@ def generate_site(
watching_posts: list[dict] = []
playlist_ids = youtube.load_playlist_ids(CONFIG_DIR, youtube_playlist_ids)
channel_ids = youtube.load_channel_ids(CONFIG_DIR, youtube_channel_ids)
+
+ # Auto-discover YouTube channel from GitHub social links when not explicitly configured
+ profile_youtube_handles: list[str] = []
+ if owner_profile:
+ profile_youtube_handles = github_profile.extract_youtube_handles(owner_profile.social_links)
+ auto_discovered_channels = (
+ profile_youtube_handles
+ if (not channel_ids and profile_youtube_handles)
+ else []
+ )
+ effective_channel_ids_str = youtube_channel_ids
+ if auto_discovered_channels and not channel_ids:
+ print(f" Auto-discovered YouTube channel(s) from GitHub profile: {auto_discovered_channels}")
+ effective_channel_ids_str = ",".join(auto_discovered_channels)
+ channel_ids = youtube.load_channel_ids(CONFIG_DIR, effective_channel_ids_str)
+
if playlist_ids or channel_ids:
print("Fetching YouTube content (My Watching)…")
- watching_posts = youtube.ingest(CONFIG_DIR, youtube_playlist_ids, youtube_channel_ids)
+ watching_posts = youtube.ingest(CONFIG_DIR, youtube_playlist_ids, effective_channel_ids_str)
print(f" {len(watching_posts)} post(s) ingested from YouTube.")
else:
- print("YOUTUBE_PLAYLIST_IDS / YOUTUBE_CHANNEL_IDS not configured — skipping YouTube ingestor.")
+ print("YOUTUBE_PLAYLIST_IDS / YOUTUBE_CHANNEL_IDS not configured and none found in GitHub profile — skipping YouTube ingestor.")
# --- Hacker News (My Reading) — requires HN_USERNAME ---
reading_posts: list[dict] = []
@@ -277,6 +308,8 @@ def generate_site(
"hn_usernames": hn_usernames or [],
"playlist_ids": playlist_ids,
"channel_ids": channel_ids,
+ "auto_discovered_channels": auto_discovered_channels,
+ "owner_profile": owner_profile,
"hidden_labels": sorted(hidden_labels),
"blocked_user_count": len(blocked_users),
"writing_post_count": len(writing_posts),
diff --git a/blog/ingestors/github_profile.py b/blog/ingestors/github_profile.py
new file mode 100644
index 0000000..cde4043
--- /dev/null
+++ b/blog/ingestors/github_profile.py
@@ -0,0 +1,166 @@
+"""
+GitHub profile helper for SimpleGitBlog.
+
+Fetches the repository owner's public GitHub profile and linked social accounts
+via the GitHub REST API. Social links are used to auto-discover optional
+integrations (e.g. YouTube channel) when explicit configuration is absent.
+
+The social-accounts endpoint is public — no authentication required — though
+a token raises the rate limit from 60 to 5 000 req/hour.
+
+Endpoints used:
+ GET /users/{username} → name, bio, avatar, website, twitter_username
+ GET /users/{username}/social_accounts → [{provider, url}, …]
+
+Recognised social providers (non-exhaustive):
+ youtube → https://www.youtube.com/@handle or /channel/UCxx
+ twitter → https://twitter.com/handle / https://x.com/handle
+ linkedin → https://www.linkedin.com/in/slug
+ twitch → https://www.twitch.tv/handle
+
+Social links are exposed on the config/transparency page so visitors can see
+exactly where content is pulled from.
+"""
+
+from __future__ import annotations
+
+import re
+from typing import NamedTuple
+
+import requests
+
+_GITHUB_API = "https://api.github.com"
+_TIMEOUT = 15
+
+
+# ---------------------------------------------------------------------------
+# Data structures
+# ---------------------------------------------------------------------------
+
+class SocialLink(NamedTuple):
+ provider: str # e.g. "youtube", "twitter", "linkedin"
+ url: str # canonical URL as stored on GitHub
+
+
+class OwnerProfile(NamedTuple):
+ login: str
+ name: str | None
+ bio: str | None
+ avatar_url: str | None
+ website: str | None # the "blog" field on the profile
+ twitter_username: str | None # dedicated twitter_username field
+ social_links: list[SocialLink]
+
+
+# ---------------------------------------------------------------------------
+# Fetching
+# ---------------------------------------------------------------------------
+
+def fetch_owner_profile(owner: str, headers: dict) -> OwnerProfile | None:
+ """
+ Fetch the public GitHub profile and social accounts for ``owner``.
+
+ Returns ``None`` if either request fails (network error, rate limit, etc.).
+ Failures are non-fatal — the blog simply skips auto-discovery.
+ """
+ # --- Basic profile ---
+ try:
+ resp = requests.get(
+ f"{_GITHUB_API}/users/{owner}",
+ headers=headers,
+ timeout=_TIMEOUT,
+ )
+ resp.raise_for_status()
+ profile_data = resp.json()
+ except requests.RequestException as exc:
+ print(f" Warning: could not fetch GitHub profile for {owner}: {exc}")
+ return None
+
+ # --- Social accounts ---
+ social_links: list[SocialLink] = []
+ try:
+ resp2 = requests.get(
+ f"{_GITHUB_API}/users/{owner}/social_accounts",
+ headers=headers,
+ timeout=_TIMEOUT,
+ )
+ resp2.raise_for_status()
+ for item in resp2.json():
+ provider = (item.get("provider") or "").lower().strip()
+ url = (item.get("url") or "").strip()
+ if provider and url:
+ social_links.append(SocialLink(provider=provider, url=url))
+ except requests.RequestException as exc:
+ print(f" Warning: could not fetch social accounts for {owner}: {exc}")
+ # Non-fatal — continue with an empty list
+
+ return OwnerProfile(
+ login=profile_data.get("login") or owner,
+ name=profile_data.get("name") or None,
+ bio=profile_data.get("bio") or None,
+ avatar_url=profile_data.get("avatar_url") or None,
+ website=profile_data.get("blog") or None,
+ twitter_username=profile_data.get("twitter_username") or None,
+ social_links=social_links,
+ )
+
+
+# ---------------------------------------------------------------------------
+# Social link extraction helpers
+# ---------------------------------------------------------------------------
+
+def extract_youtube_handles(social_links: list[SocialLink]) -> list[str]:
+ """
+ Return YouTube channel handles or IDs found in the owner's social links.
+
+ Recognised URL forms:
+ https://www.youtube.com/@handle
+ https://youtube.com/@handle
+ https://www.youtube.com/channel/UCxxxxxxxx
+ https://www.youtube.com/c/custom-name (treated as @custom-name)
+ https://www.youtube.com/user/username (treated as @username)
+
+ Returns a list of strings that can be passed directly to
+ ``youtube.load_channel_ids()`` or ``youtube._resolve_channel_id()``.
+ """
+ handles: list[str] = []
+ for link in social_links:
+ if link.provider != "youtube":
+ continue
+ url = link.url.rstrip("/")
+
+ # @handle form
+ m = re.search(r'youtube\.com/(@[A-Za-z0-9_.-]+)', url, re.IGNORECASE)
+ if m:
+ handles.append(m.group(1))
+ continue
+
+ # /channel/UCxxxxxxxx
+ m = re.search(r'youtube\.com/channel/(UC[A-Za-z0-9_-]{20,})', url, re.IGNORECASE)
+ if m:
+ handles.append(m.group(1))
+ continue
+
+ # /c/slug or /user/slug — treat as @slug
+ m = re.search(r'youtube\.com/(?:c|user)/([A-Za-z0-9_.-]+)', url, re.IGNORECASE)
+ if m:
+ handles.append(f"@{m.group(1)}")
+ continue
+
+ return handles
+
+
+def extract_twitter_url(social_links: list[SocialLink]) -> str | None:
+ """Return the first Twitter / X social link URL, or None."""
+ for link in social_links:
+ if link.provider in ("twitter", "x"):
+ return link.url
+ return None
+
+
+def extract_linkedin_url(social_links: list[SocialLink]) -> str | None:
+ """Return the first LinkedIn social link URL, or None."""
+ for link in social_links:
+ if link.provider == "linkedin":
+ return link.url
+ return None
diff --git a/blog/static/style.css b/blog/static/style.css
index 823ef19..e959a78 100644
--- a/blog/static/style.css
+++ b/blog/static/style.css
@@ -677,6 +677,26 @@ main.container { padding-top: 2.5rem; padding-bottom: 2.5rem; }
}
.post-nav a:hover { color: #0969da; text-decoration: underline; }
+.config-section__subheading {
+ font-size: 1rem;
+ font-weight: 700;
+ color: #334155;
+ margin: 1.25rem 0 0.4rem;
+}
+
+.config-profile {
+ display: flex;
+ align-items: flex-start;
+ gap: 0.85rem;
+ margin-bottom: 1rem;
+}
+
+.config-profile__avatar {
+ border-radius: 50%;
+ flex-shrink: 0;
+ object-fit: cover;
+}
+
/* --- Config page ------------------------------------------ */
.config-alert {
padding: 0.9rem 1.25rem;
diff --git a/blog/templates/config.html b/blog/templates/config.html
index a1500ea..9c6de21 100644
--- a/blog/templates/config.html
+++ b/blog/templates/config.html
@@ -20,6 +20,73 @@
🔧 Blog Configuration