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

49 lines
2.7 KiB
Markdown

---
markup: occlusion
title: 首页 SEO、共享字体与主题声明
import:
组件: 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"))*。