Colophon: Bagaimana ini situs berfungsi

TL;DR — Static-pertama Astro pada Cloudflare, dua dengan sengaja terpisah Workers untuk dynamic bagian, nyata data atau sebuah dengan jelas tidak tersedia state, honest status codes, dan sebuah design sistem itu dresses situs like sebuah hasil pencarian halaman. ini adalah “tentang itu membuat dari” (terjemahan) “tentang membuat dari” halaman untuk edge-SEO case study situs menjadi.

Apa ini halaman adalah (dan tidak)

sebuah colophon adalah sebuah membuat-dari dan credits record — ini menjelaskan technology, sistem, dan orang behind sebuah published berfungsi, cara sebuah book’s colophon names -nya typeface dan printer. ini adalah tidak sebuah substitute untuk halaman itu carry legal atau biographical weight: tentang halaman covers siapa I am, Privacy Policy covers apa data adalah collected dan mengapa, dan istilah dari gunakan cover aturan untuk menggunakan situs. ini halaman hanya documents bagaimana situs adalah dibangun dan operated; di mana sebuah claim di bawah overlaps dengan satu dari itu halaman, itu halaman adalah authoritative sumber.

stack

ini situs menggunakan Astro’s static output untuk generate HTML halaman di bangun time. Bukti untuk klaim ini Astro prerenders pages statically by default unless on-demand rendering is enabled. Cakupan: Astro rendering modes used by this site's implementation. Tingkat keyakinan: tinggi · Diverifikasi: 2026-07-14 Astro: On-demand rendering Static pengiriman dapat reduce runtime dependencies, although SEO outcomes masih bergantung pada dirender konten, tautan, dan teknis configuration. Bukti untuk klaim ini Static delivery is an implementation choice; search performance still depends on accessible content, links, and other SEO fundamentals. Cakupan: Editorial conclusion combining the site's stack with Google's general SEO guidance; static generation alone does not guarantee rankings. Tingkat keyakinan: medium · Diverifikasi: 2026-07-14 Google: SEO Starter Guide

• Astro generates artikel, glossary, hubs, alat shells, data terstruktur, penelusuran dan agent indeks, dan Markdown twins di deploy time. corpus perubahan too quickly untuk sebuah hand-maintained halaman count untuk menjadi berguna.
• Cloudflare Workers Static Assets menyajikan itu bangun dari edge. situs configuration routes hanya dynamic dan specially handled paths melalui code; ordinary halaman dan asset permintaan bypass Worker compute. configuration adalah sumber kebenaran untuk itu route boundary alih-alih sebuah copied list pada ini halaman.
• situs Worker owns editorial dan community concerns: contact, reader Q&sebuah, reactions, newsletter, penelusuran telemetry, expert layer, dan owner operations.
• sebuah secara terpisah deployed product Worker owns free-alat execution dan product persistence. situs Worker reaches ini melalui sebuah Cloudflare service binding, so browser pertahankan sama-origin /api/ URLs tanpa collapsing dua security dan data boundaries.

Dua data planes, separated pada purpose

situs dan product Workers setiap memiliki mereka own D1 database dan KV namespace, connected melalui sebuah Cloudflare service binding. situs D1 berisi community dan editorial records; product D1 berisi alat usage, ratings, bug reports, fitur permintaan, research jobs, dan monitoring data. KV adalah digunakan untuk scoped caches dan fallback counters.

R2 adalah split oleh purpose too. situs media bucket holds expert photos dan audio jawaban. Privat situs dan product backup buckets menerima scheduled D1 exports pada terpisah schedules, dengan retention dan health surfaced untuk owner operations. product Worker juga memiliki bounded Workers AI, browser rendering, native rate-limit bindings, dan sebuah Durable Object itu coordinates browser-rendering budget. fitur dengan tidak tersedia bindings atau exhausted budgets kembalikan sebuah jelas tidak tersedia state alih-alih dibuat-buat output.

Apa ini bagian dengan sengaja leaves out: binding names, bucket identifiers, database schemas, credentials, internal endpoints, dan backup schedules. Naming publik purpose dari setiap service adalah berguna untuk understanding situs; naming -nya privat topology mostly hanya helps sebuah attacker, so ini tetap out dari sebuah publik halaman oleh policy, tidak oleh oversight.

Mengapa static-pertama adalah sebuah SEO position, tidak hanya sebuah hosting pilihan

setiap dapat diindeks editorial halaman adalah delivered sebagai sebuah fully dirender HTML document dengan sebuah nyata kode status. Interactive alat hasil dapat jalankan di browser atau panggil sebuah Worker, tetapi alat’s purpose dan instructions melakukan tidak bergantung pada client rendering untuk exist. 404 halaman mengembalikan sebuah sebenarnya 404, deleted halaman dapat kembalikan sebuah sebenarnya 410, dan /coffee mengembalikan sebuah sebenarnya 418 karena sebuah teapot dapat’t brew coffee. uptime dan TTFB properties itu membuat sebuah situs pleasant untuk pengguna adalah yang sama ones itu membuat ini cheap untuk crawler.

data-honesty aturan

pengunjung-facing production metrics come dari sebuah identified sumber: kata counts dan reading time dari artikel body, reaction counts dari D1, bot-crawl data dari Cloudflare’s zone analytics, dan Anda own Core Web Vitals dari Anda browser melalui PerformanceObserver. sebuah alat dapat offer sebuah labeled contoh atau fixture untuk jelaskan -nya output, tetapi ini adalah tidak presented sebagai sebuah langsung pengukuran. fitur itu perlu sebuah tidak tersedia credential atau memiliki exhausted sebuah budget say so atau hide affected hasil alih-alih silently inventing production data.

Editorial provenance

konten sistem memperlakukan AI provenance sebagai review state, tidak decoration. sebuah wholly AI-generated artikel menggunakan sebuah artikel-tingkat label; sebuah kemudian AI lulus pada previously reviewed copy re-labels hanya lens atau lenses ini changed unless lulus spans seluruh artikel. AI revision metadata records lulus dan -nya date. Sementara apa pun AI label tetap, artikel displays AI authorship alih-alih attributing copy untuk Patrick dan adalah excluded dari aggregate konten counts dan related situs-wide tallies. hanya peninjauan manusia atau revision menghapus label; lainnya AI lulus melakukan tidak.

itu contract melakukan tidak certify unlabeled copy sebagai error-free. ini mempertahankan authorship, review status, dan publik counts dari silently overstating apa sebuah human memiliki vetted. istilah dari gunakan state reader-facing boundary, dan repository’s shared label helper mempertahankan yang sama aturan di seluruh consumers.

Jelas interfaces untuk agents

AI crawler dapat gunakan yang sama dirender HTML sebagai everyone else, tetapi mereka Tidak lebih lama memiliki untuk scrape ini. setiap published artikel memiliki sebuah generated index.md twin dan sebuah “Copy as Markdown” (terjemahan) “Copy sebagai Markdown” control. /llms.txt poin di corpus, /llms-penuh.txt menyediakan bulk Markdown, /agent-indeks.json mendeskripsikan menyelesaikan publik retrieval corpus, dan /konten-graph.json publishes -nya internal-tautan graph. sebuah rate-limited, baca-hanya MCP server exposes konten penelusuran, artikel retrieval, taxonomy, dan sebuah kecil set dari bounded diagnostic alat. langsung roster dan connection instructions adalah pada untuk agents halaman. None dari ini adalah presented sebagai sebuah jaminan dari pengindeksan, citation, atau peringkat — ini adalah sebuah stable retrieval contract, tidak sebuah SEO claim.

Apa adalah tidak enabled adalah sama-URL Accept: text/markdown negotiation melalui Cloudflare’s Markdown untuk Agents. jelas Markdown URLs adalah stable publik contract hari ini; jika konten negotiation adalah enabled kemudian, ini dapat sit di front dari yang sama generated sumber alih-alih membuat sebuah kedua editorial copy.

alat dan expert review

free SEO alat range dari browser-local parsers, validators, dan calculators untuk bounded langsung fetches, rendering comparisons, field-data lookups, dan AI-assisted operations. Shared aturan registries pertahankan browser, Worker, bulk, dan MCP hasil aligned di mana sebuah alat memiliki lebih daripada satu interface.

publik expert panel turns artikel ke anchored discussions. Verified experts dapat attach notes untuk stable paragraf IDs dan jawaban pertanyaan; trusted contributions publish secara langsung sementara others enter moderation. Published notes dan jawaban adalah baked ke artikel output dan -nya data terstruktur rather daripada dimuat sebagai sebuah unindexable afterthought.

penelusuran-native design sistem

situs adalah styled like medium ini lives di: homepage feed, konten hub, dan situs penelusuran semua render sebagai SERP hasil (green crumb, blue judul, snippet), artikel carry sebuah self-referential “In search results” (terjemahan) “di hasil pencarian” preview, TL;DRs adalah styled sebagai featured snippets, dan reader Q&sebuah collapses like Orang juga tanyakan. Five skins (Bersih, Magazine, Neo-Brutalist, Punk, Cyberpunk) restyle semuanya melalui CSS custom properties — radius, borders, shadows, jenis — so sebuah component ditulis setelah terhadap tokens berfungsi di semua five.

performa budget

Fonts muat melalui Astro’s Fonts API dengan size-adjusted fallbacks so swaps jangan shift layout; hanya display face behind biasa LCP element adalah preloaded. ketiga-party embeds dan situs’s own /api/* panggilan di SEO-data tab adalah lazy-dimuat hanya ketika tab opens. Speculation aturan prerender sama-situs tautan pada hover di Chromium. Core Web Vitals chips di setiap artikel’s health strip adalah receipts — mereka’re Anda session’s nyata angka.

Credits dan sources

• Owner dan author: Patrick Stox menulis dan maintains ini situs; tentang halaman memiliki background.
• kerangka kerja dan platform: Astro untuk bangun; Cloudflare Workers, D1, KV, dan R2 untuk runtime dan data layer.
• Agent protocol: Model Context Protocol specification, untuk MCP server described di atas.
• Contributors: verified experts pada expert panel siapa tambahkan notes dan jawaban untuk artikel passages, credited oleh name di mana mereka publish.
• ini halaman’s own sourcing: claims tentang deployed perilaku adalah diperiksa terhadap ini repository’s sumber dan configuration; claims tentang platform perilaku adalah diperiksa terhadap official Astro dan Cloudflare documentation ditautkan throughout. Naming sebuah technology di sini adalah sebuah factual credit, tidak sebuah endorsement atau sebuah claimed SEO outcome.

ini halaman adalah reviewed periodically terhadap langsung repository dan saat ini platform documentation alih-alih left untuk drift; updated date di bawah reflects terakhir such lulus.

easter eggs adalah muat-bearing

/robots.txt adalah satu file itu’s simultaneously sebuah valid robots.txt dan sebuah webpage (konten negotiation pada label, byte-identical body). console memiliki sebuah egg. /coffee adalah sebuah berfungsi HTCPCP demonstration. setiap satu ada untuk teach mechanism ini plays dengan — yang adalah situs’s seluruh thesis di miniature.

TL;DR — Operasikan situs dengan menjaga batas eksplisit: HTML statis tetap menjadi jalur default, kerja dinamis berada di Worker dan data plane yang benar, dependensi yang tidak tersedia menghasilkan status jujur, dan kontrak crawler, agen, provenance, serta performa tetap sinkron.

Rilis permukaan statis dan dinamis secara terpisah

Artefak statis adalah baseline publik. Verifikasi HTML lengkap dan pastikan asset biasa tidak masuk ke Worker tanpa sengaja. Editorial dan komunitas berada di Site Worker; eksekusi tool dan data produk berada di Product Worker; service binding tetap menjadi antarmukanya.

Pertahankan batas data dan pengungkapan

Pertahankan D1, KV, dan backup situs serta produk secara terpisah, dan media pakar pada R2 yang dimaksud. Jelaskan tujuan publik tanpa membuka kredensial, nama binding privat, identifier, schema, endpoint internal, atau jadwal.

Uji kejujuran sebagai properti rilis

Tentukan sumber setiap data yang dilihat pengunjung. Metrik live berasal dari produksi yang disebutkan, contoh tetap berlabel, dan dependensi atau anggaran yang tidak tersedia menunjukkan status eksplisit. Uji status HTTP nyata: halaman valid sesuai tujuan, halaman hilang 404, penghapusan 410 bila tepat, dan hanya /coffee dengan 418 yang disengaja.

Sinkronkan retrieval dan provenance

Perubahan belum selesai jika hanya HTML yang berubah. Periksa twin Markdown, indeks agen, content graph, structured data, dan MCP read-only bersama-sama. Pertahankan label AI serta metadata revisi hingga tinjauan manusia.

Checklist operator

• Verifikasi routing asset dan Worker yang bertanggung jawab.
• Uji /api/ same-origin melalui service binding.
• Picu status tidak tersedia yang eksplisit.
• Bandingkan HTML, Markdown, indeks, graph, dan structured data.
• Periksa Core Web Vitals dan anggaran font, embed, API, serta prerender.
• Tinjau About, Privacy, dan Terms bila cakupan berubah.

• Cakupan: sebuah membuat-dari dan credits record, distinct dari tentang, Privacy, dan istilah halaman, yang tetap authoritative pada overlapping claims.
• Stack: Astro static bangun disajikan oleh Cloudflare Workers Static Assets; ordinary static traffic bypasses Worker compute.
• Runtime split: sebuah situs Worker owns editorial/community APIs dan delegates product paths di atas sebuah service binding untuk sebuah secara terpisah deployed product Worker.
• data layer: terpisah situs dan product D1/KV stores; R2 untuk expert media dan privat scheduled backups; bounded Workers AI, browser rendering, rate-limit bindings, dan sebuah Durable Object pada product side.
• SEO properties: fully dirender editorial HTML, honest kode status (nyata 404/410/418), Speculation aturan prerendering, dan per-artikel JSON-LD; interactive alat hasil dapat gunakan browser atau Worker execution.
• data honesty: production metrics identify mereka nyata sumber; contoh adalah labeled, dan tidak tersedia langsung fitur expose itu state alih-alih fabricating production hasil.
• Editorial provenance: AI-generated atau AI-revised copy tetap labeled until peninjauan manusia, displays AI authorship sementara labeled, dan melakukan tidak enter aggregate konten counts selama itu review state.
• Agent access: HTML plus per-artikel Markdown, bulk dan structured indeks, konten graph, dan sebuah baca-hanya MCP server. sama-URL Markdown negotiation adalah tidak enabled.
• Publik sistem: sebuah free-alat platform dan moderated expert notes/jawaban attached untuk stable artikel passages.
• Design: penelusuran-native motif (SERP-styled feeds, featured-snippet TL;DRs, PAA-style Q&sebuah) dengan five token-driven skins.
• performa: size-adjusted font fallbacks, LCP-hanya preloads, lazy ketiga-party embeds, terlihat per-session CWV chips.
• Disclosure boundary: publishes publik purposes untuk -nya services (D1, KV, R2, service bindings, MCP), tidak binding names, bucket identifiers, schemas, credentials, atau backup schedules.
• Credits: Patrick Stox sebagai owner/author, Astro dan Cloudflare sebagai platform, Model Context Protocol spec untuk agent access, dan verified experts siapa contribute notes dan jawaban.

Log perubahan