Struct CanonicalPlugin 

pub struct CanonicalPlugin { /* private fields */ }

Injects <link rel="canonical"> tags into HTML files.

For each HTML file missing a canonical link, this plugin computes the canonical URL from the base URL and the file’s relative path, then injects the tag before </head>.

The plugin is idempotent — it will not add a duplicate canonical link if one already exists.

Example

use ssg::plugin::PluginManager;
use ssg::seo::CanonicalPlugin;

let mut pm = PluginManager::new();
pm.register(CanonicalPlugin::new("https://example.com"));

Implementations

impl CanonicalPlugin

pub fn new(base_url: impl Into<String>) -> Self

Creates a new CanonicalPlugin with the given base URL.

Examples

use ssg::seo::CanonicalPlugin;
use ssg::plugin::Plugin;

let p = CanonicalPlugin::new("https://example.com");
assert_eq!(p.name(), "canonical");

Trait Implementations

impl Clone for CanonicalPlugin

fn clone(&self) -> CanonicalPlugin

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CanonicalPlugin

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Plugin for CanonicalPlugin

fn name(&self) -> &'static str

Returns the unique name of this plugin.

fn has_transform(&self) -> bool

Returns true if this plugin implements transform_html. Override to true to opt in to the fused transform pass.

fn transform_html( &self, html: &str, path: &Path, ctx: &PluginContext, ) -> Result<String, SsgError>

Per-file HTML transform hook — called once per HTML file during the fused transform pass.

fn after_compile(&self, _ctx: &PluginContext) -> Result<(), SsgError>

Called after site compilation completes.

fn before_compile(&self, _ctx: &PluginContext) -> Result<(), SsgError>

Called before site compilation begins.

fn needs_all_files(&self) -> bool

Returns true if this plugin must always observe the full cache.html_files() list — even during --incremental rebuilds that only invalidated a handful of pages.

fn on_serve(&self, _ctx: &PluginContext) -> Result<(), SsgError>

Called before the development server starts serving files.