在子域名上发布带编辑面板的着陆页
将已经批准的着陆页转换为一个部署好的网站,附带编辑面板。不撰写文案,也不重新设计:输入的是已批准的HTML;输出的是一个可以正常访问、进行数据统计且符合法律要求的URL。
黄金法则
没有用户对设计稿的明确确认,绝不部署任何内容。 如果着陆页尚未获批准,请停止操作并将控制权交还给相应的落地页技能。
如何执行:全自动模式
老板不想一直回答问题。你来决定,然后推进。 以下所有内容都已确定,无需询问:
- 使用哪个托管服务 → 由
dig +short NS决定(阶段 0.5)。 - 项目叫什么名字 → 客户名的短横线命名(kebab-case)+ 角度 (
Cliente14-metodo)。 - 什么是可编辑的 → 标题、副标题、要点、按钮文本、消除疑虑内容、步骤、评价、常见问题、数字、图片、跟踪ID、Cookie通知文本以及感谢页面上的所有内容。
- 搭建感谢页面和数据库 → 它们是标配,不是需要询问的附加功能。
- 创建仓库、部署、创建DNS记录、激活SSL、移除托管服务的水印 → 直接执行,无需咨询。
- 在客户DNS中添加CNAME或TXT记录 → 这是增量操作,直接执行(见阶段 0.5)。
仅有的三个合法停靠点:
- 已批准的HTML不明确或有多个候选文件。 询问是哪一个,并且不要猜测:磁盘上最明显的文件可能是旧版本。如有疑问,请让对方粘贴给你。
- 缺少你无法编造的数据:GTM或像素的ID、视频嵌入代码、电话号码。询问用户;永远不要用占位符填充。
- 遇到密钥或付款。 永远不要处理
client_secret、密码或购买东西(见阶段 8)。
其他所有事情:直接推进,最后报告已完成的工作。
账户、会话和浏览器(已验证于2026年9月11日)
知道哪个账户和哪个Chrome对应哪些东西,可以节省一半的会话时间。任何密码都不应该经过你的手:如果某个访问要求输入密码或验证码,请停止并交给老板处理。
账户
| 服务 | 账户 | 用途 |
|---|---|---|
| GitHub | <github-username> (SSH 已配置) | 存储落地页的仓库。使用 ssh -T [email protected] 验证 |
| Cloudflare | <work-email> | Pages: 所有落地页都在这里。它已经连接了 <github-username> 的 GitHub 应用 |
| Netlify | ⚠️ 两个账户,不要混淆 | 仅用于将旧站点迁移出去。不部署任何新内容 |
↳ <work-account> 团队 | <work-email> | 没有积分("operational credits"):部署暂停 |
↳ Fb 团队 | <boss-email> | 拥有 tiseraconstrucciones.com,免费计划,待迁移 |
| Clarity | 每个落地页一个项目 | 在 clarity.microsoft.com 上创建;ID 将添加到面板 |
两个 Chrome 浏览器
通常会有两个已登录的浏览器。每个浏览器中的会话如下:
| Chrome 浏览器 | 会话 |
|---|---|
<work-account> | Cloudflare, GitHub, Netlify 团队 <work-account> |
<boss-email> | 客户的 Sered 客户区,Typeform,Netlify 团队 Fb |
- 不要强迫老板在 deviceId 之间选择:他们看不懂。使用
switch_browser并通过一行话告知:"你会看到一个 Connect 按钮,点击它,选择那些打开了 X 的账户"。 - 如果某个网站要求登录,而那个 Chrome 中没有保存的账户,在询问之前先试试另一个。
- 如果 Google 显示账户选择器,选择账户并不是输入密码:可以操作。如果之后要求输入密码或验证码,则停止操作。
🚨 Sered 是客户的账户
位于 Chrome 浏览器 <boss-email> 中的 Sered 客户区是以客户身份登录的(在客户14中,显示为 "欢迎,Alejandro")。在那里你只能操作落地页相关的记录(CNAME 及其验证 TXT 记录)。不要碰任何不是你创建的 zone 区域。
路径:客户区 → 进入 cPanel → Zone Editor → Manage 域名。
🚨 删除 Netlify 站点需要拥有它的账户
如果 Chrome 浏览器登录的是另一个团队,项目会显示 Page not found,即使它实际存在。你需要注销 (app.netlify.com/logout) 并重新使用 Google 登录,选择正确的账户。这会在浏览器中注销另一个账户的会话:请告知老板你进行了此操作。
🚨 React 表单字段:使用 form_input,不要手动输入
在由 React 构建的面板中(如 Keystatic 助手、Pages 表单),使用 computer type 手动输入会导致屏幕白屏。form_input 可以直接设置值并且有效。对于 form_input 无法更改的下拉菜单,请用鼠标点击打开并选择选项。
步骤 0 — 你需要的数据
- 已批准的 HTML。 如果此技能是链式调用的,那么它就是已组装好的
index.html。如果你在磁盘上查找它,请确认它是当前有效的版本:使用grep -rl --include="*.html" -i "<cliente>" ~/Desktop ~/Downloads搜索,如果出现多个文件,或者现有文件看起来像课堂素材或不属于客户文件夹,请询问。发布旧版本将迫使你重做整个转换过程。 - 项目名称,使用短横线命名法(kebab-case)(
Cliente14-metodo)。这是仓库和托管服务的项目名称。 - 子域名 (
metodo.cliente.com)。不要问DNS在哪里:你自己查。 - 落地页使用哪种表单:Tally 还是 Typeform。 不要问,要看 HTML (
grep -oE "data-tf-live|data-tally-src")。这将改变嵌入代码、隐藏字段和 webhook(阶段 9)。 - Google Tag Manager 和/或 Meta 像素的 ID(如果有)(阶段 3)。
- 客户网站的 favicon 和 logo(如果有)(阶段 4)。
在转换之前,检查 HTML 中是否有未填充的占位符:
# 该文件是必须的:如果没有它,grep 会一直等待标准输入,从而导致会话挂起。
grep -nE '\{\{[A-Z0-9_]+\}\}|VIDEO_ID|SUBDOMINIO|TODO:|XXXX|LOREM|placeholder|Lorem ipsum' <fichero.html>
⛔ [A-Z0-9_],包含数字。 这里的正则表达式之前是 [A-Z_]+,而内部的占位符包含数字:已验证,从 {{H1_LINEA_1}}、{{FUD_1}}、{{VP_1_TITULO}}、{{URL_LOGO_PRENSA_1}} 到 {{SUBDOMINIO}},之前的正则只能捕获最后一个。这意味着那个旨在确保“绝不允许占位符被发布”的检查机制,在即将发布之前,每五个占位符会漏掉四个。
任何发现都会阻止该部分,并需要进行询问。绝不允许占位符被发布。
⛔ 阶段 0.5 — 托管:唯一路径(2026年9月11日)
该落地页是静态的。没有 SSR,没有适配器,无需做任何决定。
以前,根据客户 DNS 的位置有一个决策树。现在没有了:因为它存在是因为 Cloudflare Workers 的 Custom Domains 要求 DNS 区域在 Cloudflare 内部,而这只在需要服务器时才重要。这个落地页不需要服务器。
| 组件 | 运行位置 |
|---|---|
| 落地页 | 静态 HTML |
| 表单 | Tally/Typeform 的 iframe,运行在浏览器中 |
| 统计工具(GTM/像素) | 浏览器 |
| Cookie 通知 | localStorage |
| 潜在客户数据 | 从表单到 CRM,不经过我们 |
| Keystatic 面板 | 本地,npm run dev。不部署。 |
托管:Cloudflare Pages。始终如此,无论客户的托管服务是什么。 Pages 的 CNAME 可以来自任何 DNS 提供商(Sered、IONOS、Hostinger、GoDaddy、本地托管的 cPanel 等),并且由于没有 SSR,因此不需要那个不再支持它的适配器。
免费计划:每月 500 次构建、100 个项目、每个项目 100 个域名,无带宽限制。
⚠️ 为什么不选择 Netlify(已于2026年9月11日验证,不再重复说明)
Netlify 已切换到积分制:免费计划每月 300 积分,并且一次生产部署消耗 15 积分。这意味着整个账户下所有网站每月总共只能进行 20 次部署——而且每次有人在面板中保存更改,都会触发一次提交和一次部署。
但严重的问题不是配额上限:积分用完后,Netlify 会暂停你的所有网站,访问者会看到 Site not available。在免费计划中,这是一个硬性上限,无法购买更多积分。客户的落地页如果正在运行活动,就会下线。这对客户工作来说是致命的,而不仅仅是不便。
⚠️ 为什么不选择 Vercel(已验证,不再重复说明)
Vercel 的免费计划 (Hobby) 仅限非商业用途。 其官方文档说明:"Hobby 计划限制用户只能用于非商业的个人用途"。客户的落地页属于商业用途:需要使用 Pro 计划(每位用户每月 20 美元)。
唯一需要查明的事情:DNS 在哪里
托管服务和 DNS 不是一回事。起决定作用的是域名服务器 (nameservers):客户可能将网站托管在 Sered,而域名服务器 (NS) 在 Cloudflare,这种情况下 Sered 的面板毫无用处。
dig +short NS <客户域名>
这可以告诉你在请求访问之前应该向哪个面板请求访问,并且查询时不需要凭据。很多时候甚至不需要访问权限:你可以直接提供写好的记录,让客户或他们的技术人员在两分钟内创建。
🚨 cPanel 和 Plesk 会自动创建 A 记录,这会破坏 CNAME
当创建子域名时,cPanel 和 Plesk 会自动创建一个 A 记录,指向它们的服务器。一个 CNAME 记录不能与同名的 A 记录共存——这是 DNS 的工作原理,不是面板的任性行为。
必须删除那个 A 记录,否则 CNAME 永远不会生效。这是最耗时的错误,因为面板上看起来一切都“正常”。
关于客户 DNS 的规则
- 永远不要首先提议移动域名服务器。 客户的邮件 (MX)、网站和验证 (TXT) 都依赖于它:错误地复制一条记录可能会导致客户无法接收邮件。这是最后的手段,并且需要获得客户的明确许可。
- 添加新的 CNAME 或 TXT 记录并不等于移动 DNS。 这是增量操作:它不会影响 MX 记录或现有网站。可以毫不犹豫地执行。
- 购买一个新域名不是选项。永远不是。 不要提出这个建议,即使是作为备用方案。落地页始终挂载在客户已有域名的子域名下。
- 如果有疑问,如何解释:
"这是一个新的记录,用于一个今天还不存在的子域名。它不会修改或删除任何内容:邮件 (MX)、网站和验证记录保持完整。如果出了问题,删除这条记录,一切就能恢复原状。"
- 如果真的无法访问客户的面板,落地页将保留在
<项目>.pages.dev,活动可以由此开始。这是临时的并且会进行通知,但永远不要为此购买域名。 - 客户的凭据:你不处理它们。 你准确地告诉他们需要创建什么记录,然后验证记录是否生效。访问权限由老板或客户使用。
🚨 在创建子域名之前不要查询它
dig +short metodo.cliente.com # ⛔ 在创建记录之前不要这样做
许多供应商的 SOA 记录将否定缓存时间设为 86400 秒(24 小时)。如果你在子域名存在之前查询它,解析器会缓存“不存在”的结果整整一天——你的解析器,有时甚至是认证机构的。结果是:证书生成延迟或失败,看起来像是配置错误,但实际上并非如此。
通过以下方式查看 SOA 记录,以了解你将面临什么情况,同时避免查询子域名本身:
dig +short SOA <域名> # 最后一个数字是否定缓存 TTL
阶段 1 — 搭建项目
最小技术栈。不使用 Tailwind 和 Fontsource:落地页技能会生成带有 !important 的纯 CSS,并在主样式块中包含自己的字体。引入 Tailwind 只会增加 Bug。
也不使用适配器。 不要安装 @astrojs/netlify 或 @astrojs/cloudflare:输出是静态的。
npm create astro@latest <项目名> -- --template minimal --install --no-git --skip-houston --yes
cd <项目名>
npm install @keystatic/core @keystatic/astro @astrojs/react react react-dom @astrojs/sitemap zod
npm install -D @astrojs/check typescript
已验证的版本(执行于 2026年9月11日):astro 7.3.2 · @keystatic/core 0.6.9 · @keystatic/astro 6.0.0 · @astrojs/react 6.0.5 · react 19.3.0。
astro.config.mjs — 唯一版本
// @ts-check
import { defineConfig } from 'astro/config';
import react from '@astrojs/react';
import keystatic from '@keystatic/astro';
import sitemap from '@astrojs/sitemap';
// Keystatic 仅用于开发环境。在生产构建时只生成纯 HTML:没有 /api 路由,没有
// React 运行时,没有适配器。面板在本地使用并提交更改。
const isDev = process.argv.includes('dev');
export default defineConfig({
// 在子域名生效之前,请指向托管服务的真实 URL。
// 一个无法解析的 site: 会生成指向虚无的 canonical 和 sitemap。
site: 'https://<项目名>.pages.dev',
output: 'static',
integrations: [...(isDev ? [react(), keystatic()] : []), sitemap()],
});
通过实际执行验证(2026年9月11日),非推断所得:
astro build→ 在dist/目录中生成仅.html文件。没有/api,没有_worker.js,没有服务端入口点。astro dev→/keystatic返回 200 状态码,显示真实面板,同时落地页仍然可以正常访问。
keystatic.config.ts — 使用 local,而非 github
storage: { kind: 'local' },
使用 local 模式,面板会将文件写入磁盘,然后你执行 git commit && git push。Cloudflare Pages 会自动重建。
这消除了对 GitHub App、client_secret 和三个环境变量的需求:整个阶段 10 不再需要,除非特定客户想要自己编辑(参见该阶段)。
.gitignore 文件必须包含 node_modules/、dist/、.astro/ 以及 .env。
阶段 2 — 转换已批准的 HTML
- 主样式块移至真实的
<head>中。 由于 Elementor 的限制,技能通常将其放在第一个 widget 内部;但在这里不需要。字体、preconnect和preload都放在<head>中。 - 添加
body{margin:0}。 主样式块假设了 Elementor 的 CSS 重置;在一个独立的页面中,没有这个会错位。 - 创建
BaseLayout.astro,包含<head>、SEO 信息(title, description, canonical, OG, Twitter, JSON-LD)和<slot />。 index.astro将BaseLayout.astro包裹起来,并放置着陆页的主体 HTML 内容。- 创建
gracias.astro(感谢页面):一个在表单提交后显示的简单确认页面。它可以包含转化像素或跟踪代码。 robots.txt:在生产环境中,允许所有机器人访问。在开发环境中,禁止所有机器人访问。sitemap.xml:Astro 的 sitemap 集成会自动生成此文件,其中包含/和/gracias。
转换 HTML 的具体步骤(关键!):
- 获取落地页的完整
index.html文件。 - 提取
<head>和<body>的内容。 - 创建
src/layouts/BaseLayout.astro:- 从原始 HTML 复制
<title>和<meta>标签(description、OG、Twitter 等)。 - 复制主样式块(通常在
<style>或<link>标签内)到<head>中。 - 复制任何
preconnect或preload标签。 - 添加
body{margin:0}样式。 - 添加
<!-- COOKIE CONSENT BANNER -->和<!-- COOKIE CONSENT SCRIPT -->的占位符。 - 添加
<!-- GOOGLE TAG MANAGER (noscript) -->和<!-- GOOGLE TAG MANAGER (script) -->的占位符。 - 添加
<!-- META PIXEL BASE CODE -->和<!-- META PIXEL EVENT CODE -->的占位符。 - 添加
<!-- MICROSOFT CLARITY -->的占位符。
- 从原始 HTML 复制
- 创建
src/pages/index.astro:- 导入
BaseLayout。 - 将着陆页的
<body>内容放入<BaseLayout>的<slot />位置。
- 导入
- 创建
src/pages/gracias.astro:- 使用
BaseLayout或创建一个简单的布局。 - 包含“谢谢”和一条简短的消息。
- 包含转化跟踪事件。
- 使用
测试构建:
npm run build
这会生成 dist/ 目录。使用 npx serve dist/ 或类似工具进行本地测试。
阶段 3 — 集成 Cookie 同意、GTM 和像素
这是最微妙的方面。关键要求是:
- 必须向用户显示 Cookie 同意横幅。
- 只有在用户接受后,才能加载 GTM、Meta Pixel、Microsoft Clarity 或其他跟踪脚本。
- 同意记录必须存储在 Cloudflare D1 数据库中(这是 AEPD 的要求)。
- 感谢页面(
/gracias)也应遵守这些规则。
实施策略
我们使用一个简单的客户端脚本,该脚本在用户接受后设置 localStorage 标志,然后动态加载跟踪脚本。同意记录也会异步发送到 Cloudflare D1。(注意: 在项目的这个阶段,实际的 D1 数据库和 API 端点尚未创建;这将在后续或最终阶段设置。我们暂时只包含客户端逻辑。)
脚本示例 (简化版):
<script>
(function() {
var cookieConsentKey = 'cookie_consent';
var consent = localStorage.getItem(cookieConsentKey);
function loadScript(url, id) {
if (document.getElementById(id)) return;
var s = document.createElement('script');
s.id = id;
s.src = url;
s.async = true;
document.head.appendChild(s);
}
function loadTrackingScripts() {
// GTM、像素和 Clarity 在此处加载
}
function recordConsent(status) {
// 将同意记录发送到 /api/consent 端点 (使用 fetch)。
}
if (consent === 'accepted') {
loadTrackingScripts();
}
// 暴露接受/拒绝函数供横幅使用
window.acceptCookies = function() {
localStorage.setItem(cookieConsentKey, 'accepted');
loadTrackingScripts();
recordConsent('accepted');
};
window.rejectCookies = function() {
localStorage.setItem(cookieConsentKey, 'rejected');
recordConsent('rejected');
};
})();
</script>
重要提示: 此脚本必须在任何其他第三方脚本执行之前加载。一个常见的方法是直接将内联脚本放在 <head> 中,紧跟在 <title> 之后。
阶段 4 — 品牌元素(Favicon 和 Logo)
如果你有客户的 favicon 和/或 logo:
- 将 favicon(通常是
favicon.ico、favicon.svg或类似文件)放在public/目录中。 - 在
BaseLayout.astro的<head>中添加<link rel="icon" ...>标签。 - 如果着陆页的 HTML 中有 logo 图片,请更新其
src以指向public/中的正确路径(例如/logo-cliente.png)。
如果没有 favicon 或 logo,请跳过此步骤。
阶段 5 — 创建 GitHub 仓库
- 在
<github-username>账户下创建一个新的私有 GitHub 仓库。- 仓库名称:
<项目名>(例如cliente14-metodo)
- 仓库名称:
- 初始化仓库(可以在 GitHub 上不使用 README 初始化,或者手动操作)。
- 将本地项目推送到仓库:
git remote add origin [email protected]:<github-username>/<项目名>.git
git add .
git commit -m "feat: initial project setup with Astro and Keystatic"
git branch -M main
git push -u origin main
阶段 6 — 部署到 Cloudflare Pages
- 登录 Cloudflare 仪表板(使用
<work-email>)。 - 导航到 Workers & Pages > Pages。
- 点击 Connect to Git。
- 选择
<github-username>和仓库<项目名>。 - 构建设置:
- 框架预设: Astro(Cloudflare Pages 应该会自动检测到)。
- 构建命令:
npm run build - 构建输出目录:
dist
- 无需添加环境变量(尚无服务器端密钥)。
- 点击 Save and Deploy。
- 等待构建完成。Cloudflare Pages 会提供一个
<项目名>.pages.devURL。 - 验证该 URL 是否显示着陆页。
阶段 7 — 添加自定义域名 (CNAME)
7a. 确定 DNS 提供商
dig +short NS <客户域名>
7b. 添加 CNAME 记录
在你的 Cloudflare Pages 项目中,转到 Custom domains 并添加 <subdomain>.<client-domain>.com。
然后,在客户的 DNS 提供商处:
- 创建一个 CNAME 记录,名称为
<subdomain>,目标为<项目名>.pages.dev。 - 重要提示: 如果存在一个同名的
A记录(cPanel/Plesk 经常自动创建),必须删除它。 - 如果提供商需要 TXT 验证记录(例如,在 Sered 中),请一并添加。
关于 cPanel/Plesk 的特别提醒: 它们会自动为创建的子域名创建 A 记录。你需要手动删除该 A 记录,因为 CNAME 不能与它共存。如果自动创建设置中的“管理 DNS”看起来不清晰,请不要犹豫进行探索。
7c. 验证
dig +short <subdomain>.<client-domain>.com
创建记录后,它应该马上解析到 Cloudflare Pages IP 地址。如果无法立即解析,请等待几分钟并重试。DNS 传播可能需要一些时间,但通常很快。
7d. SSL/TLS
Cloudflare Pages 会自动为你的自定义域名提供 SSL 证书。无需手动执行任何操作。
阶段 8 — 设置 Keystatic CMS(本地)
8a. 配置
keystatic.config.ts 文件应放在 src/ 目录中。
import { config, fields, collection } from '@keystatic/core';
export default config({
storage: {
kind: 'local',
},
collections: {
landing: {
label: 'Landing Page',
path: 'src/content/landing',
format: { contentField: 'content' },
schema: {
title: fields.text({ label: 'Title' }),
subtitle: fields.text({ label: 'Subtitle' }),
// ... 其他所有可编辑字段
},
},
},
});
8b. 使用
要启动 Keystatic 面板:
npm run dev
然后访问 http://localhost:4321/keystatic。你会看到 CMS UI。
自定义
- 字段: 配置你需要的内容字段(标题、副标题、图像、列表项等)。
- 分组: 使用
fields.object将相关字段分组(例如,hero、features、testimonials)。 - 块: 对于丰富的文本,如果需要,使用
fields.document或fields.markdown。
8c. 提交和推送更改
当使用 CMS 保存更改时,文件会写入本地磁盘。你需要手动提交并推送它们:
git add .
git commit -m "update: landing content via Keystatic"
git push
Cloudflare Pages 将在每次推送时自动重新构建。
阶段 9 — 表单处理(Tally 或 Typeform)
集成
- 识别表单: 在原始 HTML 中查找
data-tf-live(Typeform)或data-tally-src(Tally)。 - 嵌入: 将 iframe 或脚本嵌入代码放到 HTML 相应的位置。
- 隐藏字段: 如果原始表单使用隐藏字段(例如 UTM 参数、潜在客户 ID),你需要在编辑面板中添加这些字段,或者直接硬编码。
- Webhook/重定向: Typeform 和 Tally 都允许在提交后重定向到 URL。将重定向 URL 设置为
https://<项目名>.pages.dev/gracias,以确保用户在提交后到达感谢页面。如果原始 HTML 已经配置了重定向,请确保它指向正确的/graciasURL。
重要提示: 表单的 iframe 源通常是你的实际表单。除非更改表单链接是即将到来的阶段(阶段 12)的一部分,否则我们通常保留它。
阶段 10 — Cloudflare D1(同意记录)
注意: 此阶段目前是概念性的,尚未实施,但必须实施以满足 AEPD 的要求。
10a. 创建数据库
- 在 Cloudflare 仪表板的 Workers & Pages > D1 > Create database 中。
- 将其命名为
<项目名>-consent。 - 将 ID 复制到剪贴板。
10b. 创建 Worker
- 创建一个新的 Cloudflare Worker(在 Workers & Pages > Create application > Worker 中)。
- 将其命名为
<项目名>-api。 - 编写一个处理 POST 请求并将记录插入 D1 数据库的 Worker。
示例 Worker 代码(简化版):
export default {
async fetch(request, env) {
if (request.method === 'POST') {
const { consent, timestamp, ip } = await request.json();
// 插入到 D1
await env.DB.prepare(
'INSERT INTO consents (consent, timestamp, ip) VALUES (?, ?, ?)'
).bind(consent, timestamp, ip).run();
return new Response('OK');
}
return new Response('Not found', { status: 404 });
}
};
- 将该 Worker 绑定到 D1 数据库(在 Cloudflare 仪表板的 Worker 设置中)。
- 同样,在 Cloudflare Pages 项目设置中的 Functions > D1 Database Bindings 下,将 Pages 项目连接到相同的 Worker(或者更好的是,将 API Worker 路由到
/api/consent)。 - 更新客户端的 Cookie 同意脚本,以将 POST 请求发送到
/api/consent。
阶段 11 — SEO 和社交分享
| 元素 | 描述 | 在何处设置 |
|---|---|---|
| 标题标签 | 对 SEO 至关重要。 | 在 BaseLayout.astro 的 <title> 中。 |
| Meta 描述 | 向搜索引擎描述页面。 | 在 BaseLayout.astro 的 <meta name="description" content="..."> 中。 |
| Canonical URL | 表示首选的 URL 版本。 | 在 BaseLayout.astro 的 <link rel="canonical" href="..."> 中。 |
| Open Graph 标签 | 控制链接在 Facebook、LinkedIn 等平台上的显示方式。 | 在 BaseLayout.astro 的 <meta property="og:..."> 中。 |
| Twitter 卡片 | 控制链接在 Twitter 上的显示方式。 | 在 BaseLayout.astro 的 <meta name="twitter:..."> 中。 |
| JSON-LD 结构化数据 | 为搜索引擎提供结构化信息。 | 在 BaseLayout.astro 的 <script type="application/ld+json">...</script> 中。 |
重要提示: 所有这些元素都应存在于 BaseLayout.astro 中,并适当地从页面的 frontmatter 或 CMS 中动态填充。
阶段 12 — 剧终 (Fin)*
最终检查清单:
- 着陆页的 HTML 已正确转换为 Astro 组件。
- 主样式块已正确放置在
<head>中。 - 已添加
body{margin:0}。 - SEO 标签 (title, description, canonical, OG, Twitter, JSON-LD) 已配置。
- 已配置 Cookie 同意横幅。
- GTM / Meta Pixel / Microsoft Clarity 仅在同意后加载。
- 同意记录逻辑已就位(客户端和 D1)。
- 感谢页面 (
/gracias) 存在并已配置。 - 表单将用户重定向到
/gracias。 - 品牌元素 (favicon, logo) 已就位。
- GitHub 仓库已创建并推送。
- Cloudflare Pages 部署成功。
- 自定义域名 (CNAME) 已配置并解析。
- SSL/TLS 正在工作。
- Keystatic CMS 配置完毕,可在本地进行编辑。
- Cloudflare D1 数据库和 API(如果实施)已配置。
完成! 着陆页现已上线,由 Keystatic CMS 提供支持,已为统计、转化和 AEPD 合规做好准备。