Expand description
分享图端点与分享元信息上下文(server-only)。 分享图端点与分享元信息上下文(server-only)。
GET /og/site.png:站点图,标语读站点设置,底部为站点地址与已发布篇数;GET /og/post/{slug}.png:文章图,标题、摘要与「日期·时长·标签」。
PNG 按展示内容缓存(moka,同一内容并发请求只渲染一次),渲染放进
spawn_blocking 并限制同时渲染数。文章不存在或渲染失败时回退为站点图;站点
标语缺字时改用默认标语,保证总能返回一张图。地址里的 ?v= 只用于让外部缓存
换图,服务端不读取。
Enums§
- Card 🔒
Constants§
- CACHE_
CONTROL 🔒 - 内容版本化的地址可以缓存久一些;回退图很快就该重试。
- FALLBACK_
CACHE_ 🔒CONTROL
Statics§
- IMAGES 🔒
- RENDER_
SLOTS 🔒 - 渲染吃满一个核约几十毫秒,同时最多两张,避免挤占请求线程。
Functions§
- base_
url 🔒 - 站点绝对地址(无尾斜杠),只取 APP_BASE_URL;未配置时为空,页面退回站内相对地址。
- cached_
render 🔒 - png_
response 🔒 - post_
card 🔒 - post_
image - share_
context - 前台页面服务端渲染时写分享元信息所需的站点信息,由中间件放进请求扩展。
- site_
footer 🔒 - 「站点地址·N 篇文章」;地址只取 APP_BASE_URL 的主机部分,任一项取不到就省略。
- site_
image - site_
png 🔒