Skip to main content

Module og

Module og 

Source
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 🔒