Clears all blog post caches.

Useful for testing or when doing bulk updates.

@spec clear_group_cache(String.t()) :: {:ok, non_neg_integer()} | {:error, any()}

Clears the render cache for a specific blog.

Returns {:ok, count} with the number of entries cleared.

Examples

Renderer.clear_group_cache("my-group")
# => {:ok, 15}

@spec global_render_cache_enabled?() :: boolean()

Returns whether the global render cache is enabled. Checks new key first, falls back to legacy key.

@spec group_render_cache_enabled?(String.t()) :: boolean()

Returns whether render cache is enabled for a specific group. Does not check the global setting. Checks new key first, falls back to legacy key.

Invalidates cache for a specific post.

Called when a post is updated in the admin editor.

Examples

Renderer.invalidate_cache("docs", "getting-started", "en")

@spec per_group_cache_key(String.t()) :: String.t()

Returns the settings key for per-group render cache. Used by other modules that need to write to the setting.

@spec render_cache_enabled?(String.t()) :: boolean()

Returns whether render caching is enabled for a blog.

Checks both the global setting and per-blog setting. Both must be enabled (or default to enabled) for caching to work. Checks new keys first, falls back to legacy keys.

Renders markdown or .phk content directly without caching.

Automatically detects .phk XML format and routes to PageBuilder. Falls back to Earmark markdown rendering for non-XML content.

Examples

html = Renderer.render_markdown(content)

Renders a post's markdown content to HTML.

Caches the result for published posts using content-hash-based keys. Lazy-loads cache (only caches after first render).

Respects pages_render_cache_enabled (global) and pages_render_cache_enabled_{blog_slug} (per-blog) settings.

Examples

{:ok, html} = Renderer.render_post(post)