Files
marqdo/examples/web-site-zh/components/head.mq.md

2.7 KiB

markup, title, import
markup title import
occlusion 首页 SEO、共享字体与主题声明
组件 页头
ext/web/网页/组件/索引.mq.md ext/web/页头.mq.md

本叶子保留原站的首页元数据与 Google Fonts 资源地址。装配只声明链接,不下载字体;主题由服务入口从表编译并写到明确静态目录。

nodes

参数 类型 默认 说明
homepage bool False 仅首页显式保留原来的首页 SEO
返回 类型 说明
result list 进入真正 head 的纯 SEO、字体与主题资源

使用homepage=False,在装配阶段纯构造。元数据为 key/value 行记录,字体与样式继续使用 rel/href/crossorigin 原生字段。只有首页显式选择原来的 SEO,其余页面只共享字体与主题,避免把首页描述错误地复制到每篇文章。原生渲染将它们收集到真正 head,去重相同链接,不在正文或片段中输出占位。

字体是否成功送达取决于浏览器能否访问外部服务;不可用时仍使用主题声明的后备字体。地址声明不等于生成文件,服务入口须在监听之前编译并写出确切路径。资源构造不加载插件、不验证远端状态、不运行脚本,也不把网络错误当作已经加载成功。

字体表中的第一项预连接样式服务,第二项保留字体源的 anonymous 跨域设置,第三项保留原始字体集合与字重。最后的站内样式链接只对应本次生成产物,源头仍是可读属性表。标题与文案保留在各自 Document,页头不承担整页配置或应用变异。离线预览使用同一个元数据收集过程,片段只更新已打开页面,不重复注入字体与 SEO。

元数据 =

@ key value
1 description 表即全栈 — Marqdo 网页示例;作者零业务 JavaScript。
2 og:type website
3 og:title Marqdo 中文站

链接 =

@ rel href crossorigin
1 preconnect https://fonts.googleapis.com
2 preconnect https://fonts.gstatic.com anonymous
3 stylesheet https://fonts.googleapis.com/css2?family=Great+Vibes&family=Noto+Sans+SC:wght@300;400;500;700&family=Noto+Serif+SC:wght@400;600&display=swap
4 stylesheet /static/generated/theme.css

我们 选定元数据 = None,其他页面只保留共享链接。

  1. homepage 我们 选定元数据 = 元数据,只给首页保留原 SEO。 我们 资源 = [保留实际元数据与原生资源链接](页头.声明(元数据=选定元数据, 链接=链接))。 最后返回 [把纯页头声明与结构一起保留](组件.请求资源(值=资源, 槽="document-head"))。