HydePage API Reference

make()#

Create a new page instance. Static alias for the constructor.

HydePage::make(string $identifier, Hyde\Markdown\Models\FrontMatter|array $matter): static

isDiscoverable()#

Returns whether the page type is discoverable through auto-discovery.

HydePage::isDiscoverable(): bool

get()#

Get a page instance from the Kernel's page index by its identifier.

HydePage::get(string $identifier): Hyde\Pages\Concerns\HydePage

• Throws: \Hyde\Framework\Exceptions\FileNotFoundException If the page does not exist.

parse()#

Parse a source file into a new page model instance.

/** @param string $identifier The identifier of the page to parse. */
HydePage::parse(string $identifier): static // New page model instance for the parsed source file.

• Throws: \Hyde\Framework\Exceptions\FileNotFoundException If the file does not exist.

files()#

Get an array of all the source file identifiers for the model.

Note that the values do not include the source directory or file extension.

HydePage::files(): array<string>

all()#

Get a collection of all pages, parsed into page models.

HydePage::all(): \Hyde\Foundation\Kernel\PageCollection<static>

sourceDirectory()#

Get the directory where source files are stored for the page type.

HydePage::sourceDirectory(): string

outputDirectory()#

Get the output subdirectory to store compiled HTML files for the page type.

HydePage::outputDirectory(): string

fileExtension()#

Get the file extension of the source files for the page type.

HydePage::fileExtension(): string

setSourceDirectory()#

Set the output directory for the page type.

HydePage::setSourceDirectory(string $sourceDirectory): void

setOutputDirectory()#

Set the source directory for the page type.

HydePage::setOutputDirectory(string $outputDirectory): void

setFileExtension()#

Set the file extension for the page type.

HydePage::setFileExtension(string $fileExtension): void

sourcePath()#

Qualify a page identifier into file path to the source file, relative to the project root.

HydePage::sourcePath(string $identifier): string

outputPath()#

Qualify a page identifier into a target output file path, relative to the _site output directory.

HydePage::outputPath(string $identifier): string

path()#

Get an absolute file path to the page's source directory, or a file within it.

HydePage::path(string $path): string

pathToIdentifier()#

Format a filename to an identifier for a given model. Unlike the basename function, any nested paths within the source directory are retained in order to satisfy the page identifier definition.

/** @param string $path Example: index.blade.php */
HydePage::pathToIdentifier(string $path): string // Example: index

baseRouteKey()#

Get the route key base for the page model.

This is the same value as the output directory.

HydePage::baseRouteKey(): string

__construct()#

Construct a new page instance.

$page = new HydePage(string $identifier, Hyde\Markdown\Models\FrontMatter|array $matter): void

compile()#

Compile the page into static HTML.

$page->compile(): string // The compiled HTML for the page.

toArray()#

Get the instance as an array.

$page->toArray(): array

getSourcePath()#

Get the path to the instance source file, relative to the project root.

$page->getSourcePath(): string

getOutputPath()#

Get the path where the compiled page will be saved.

$page->getOutputPath(): string // Path relative to the site output directory.

getRouteKey()#

Get the route key for the page.

The route key is the page URL path, relative to the site root, but without any file extensions. For example, if the page will be saved to _site/docs/index.html, the key is docs/index.

Route keys are used to identify page routes, similar to how named routes work in Laravel, only that here the name is not just arbitrary, but also defines the output location, as the route key is used to determine the output path which is $routeKey.html.

$page->getRouteKey(): string

getRoute()#

Get the route object for the page.

$page->getRoute(): Hyde\Support\Models\Route

getLink()#

Format the page instance to a URL path, with support for pretty URLs if enabled.

Note that the link is always relative to site root, and does not contain ../ segments.

$page->getLink(): string

getIdentifier()#

Get the page model's identifier property.

The identifier is the part between the source directory and the file extension. It may also be known as a 'slug', or previously 'basename', but it retains the nested path structure if the page is stored in a subdirectory.

For example, the identifier of a source file stored as '_pages/about/contact.md' would be 'about/contact', and 'pages/about.md' would simply be 'about'.

$page->getIdentifier(): string

getBladeView()#

Get the Blade template/view key for the page.

$page->getBladeView(): string

title()#

Get the page title to display in HTML tags like <title> and <meta> tags.

$page->title(): string

metadata()#

Get the generated metadata for the page.

$page->metadata(): Hyde\Framework\Features\Metadata\PageMetadataBag

showInNavigation()#

Can the page be shown in the navigation menu?

$page->showInNavigation(): bool

navigationMenuPriority()#

Get the priority of the page in the navigation menu.

$page->navigationMenuPriority(): int

navigationMenuLabel()#

Get the label of the page in the navigation menu.

$page->navigationMenuLabel(): string

navigationMenuGroup()#

Get the group of the page in the navigation menu, if any.

$page->navigationMenuGroup(): string

getCanonicalUrl()#

No description provided.

$page->getCanonicalUrl(): string

data()#

Get a value from the computed page data, or fallback to the page's front matter, then to the default value.

$page->data(string $key, mixed $default): \Hyde\Markdown\Models\FrontMatter|mixed

matter()#

Get the front matter object, or a value from within.

$page->matter(string $key, mixed $default): \Hyde\Markdown\Models\FrontMatter|mixed

has()#

See if a value exists in the computed page data or the front matter.

$page->has(string $key): bool

make()#

Create a new page instance. Static alias for the constructor.

BaseMarkdownPage::make(string $identifier, Hyde\Markdown\Models\FrontMatter|array $matter, Hyde\Markdown\Models\Markdown|string $markdown): static

__construct()#

Construct a new page instance.

$page = new BaseMarkdownPage(string $identifier, Hyde\Markdown\Models\FrontMatter|array $matter, Hyde\Markdown\Models\Markdown|string $markdown): void

markdown()#

Return the document's Markdown object.

$page->markdown(): Hyde\Markdown\Models\Markdown

compile()#

Compile the page into static HTML.

$page->compile(): string // The compiled HTML for the page.

save()#

Save the Markdown page object to disk by compiling the front matter array to YAML and writing the body to the file.

$page->save(): $this

make()#

Static alias for the constructor.

InMemoryPage::make(string $identifier, Hyde\Markdown\Models\FrontMatter|array $matter, string $contents, string $view): static

__construct()#

Create a new in-memory/virtual page instance.

The in-memory page class offers two content options. You can either pass a string to the $contents parameter, Hyde will then save that literally as the page's contents. Alternatively, you can pass a view name to the $view parameter, and Hyde will use that view to render the page contents with the supplied front matter during the static site build process.

Note that $contents take precedence over $view, so if you pass both, only $contents will be used. You can also register a macro with the name 'compile' to overload the default compile method.

If the identifier for an in-memory page is "foo/bar" the page will be saved to "_site/foo/bar.html". You can then also use the route helper to get a link to it by using the route key "foo/bar". Take note that the identifier must be unique to prevent overwriting other pages. all this data will be passed to the view rendering engine.

• Parameter $view: The view key or Blade file for the view to use to render the page contents.
• Parameter $matter: The front matter of the page. When using the Blade view rendering option,

$page = new InMemoryPage(string $identifier, \Hyde\Markdown\Models\FrontMatter|array $matter, string $contents, string $view): void

getContents()#

Get the contents of the page. This will be saved as-is to the output file when this strategy is used.

$page->getContents(): string

getBladeView()#

Get the view key or Blade file for the view to use to render the page contents when this strategy is used.

$page->getBladeView(): string

compile()#

Get the contents that will be saved to disk for this page.

In order to make your virtual page easy to use we provide a few options for how the page can be compiled. If you want even more control, you can register a macro with the name 'compile' to overload the method, or simply extend the class and override the method yourself, either in a standard or anonymous class.

$page->compile(): string

macro()#

Register a macro for the instance.

Unlike most macros you might be used to, these are not static, meaning they belong to the instance. If you have the need for a macro to be used for multiple pages, you should create a custom page class instead.

$page->macro(string $name, callable $macro): void

hasMacro()#

Determine if a macro with the given name is registered for the instance.

$page->hasMacro(string $method): bool

__call()#

Dynamically handle macro calls to the class.

$page->__call(string $method, array $parameters): mixed

__construct()#

No description provided.

/** @param string $identifier The identifier, which also serves as the view key. */
$page = new BladePage(string $identifier, Hyde\Markdown\Models\FrontMatter|array $matter): void

getBladeView()#

Get the Blade template/view key for the page.

$page->getBladeView(): string

compile()#

Compile the page into static HTML.

$page->compile(): string // The compiled HTML for the page.

getLatestPosts()#

No description provided.

MarkdownPost::getLatestPosts(): \Hyde\Foundation\Kernel\PageCollection<\Hyde\Pages\MarkdownPost>

toArray()#

No description provided.

$page->toArray(): array

home()#

No description provided.

DocumentationPage::home(): Hyde\Support\Models\Route

homeRouteName()#

No description provided.

DocumentationPage::homeRouteName(): string

hasTableOfContents()#

No description provided.

DocumentationPage::hasTableOfContents(): bool

getOnlineSourcePath()#

No description provided.

$page->getOnlineSourcePath(): string|false

getTableOfContents()#

Generate Table of Contents as HTML from a Markdown document body.

$page->getTableOfContents(): string

getRouteKey()#

Get the route key for the page.

If flattened outputs are enabled, this will use the identifier basename so nested pages are flattened.

$page->getRouteKey(): string

getOutputPath()#

Get the path where the compiled page will be saved.

If flattened outputs are enabled, this will use the identifier basename so nested pages are flattened.

$page->getOutputPath(): string

contents()#

No description provided.

$page->contents(): string

compile()#

No description provided.

$page->compile(): string

getBladeView()#

No description provided.

$page->getBladeView(): string