role Documentable::DocPage
Pod to be rendered and its url
Defined as
role Documentable::DocPage
This role must be implemented by all classes that generate an HTML page.
Defined as
method render(| --> Hash) { ... }
It's an abstract method. It needs to return a Hash
object following this format:
%(
document => pod to be rendered as HTML,
url => URL assigned to this document
)
Returning the pod
is necessary because we need to wrap it in a common HTML template (see Documentable::To::HTML::Wrapper).