Project properties

Use project.* to access configuration values from your retype.yml file. This keeps your content in sync with project settings and avoids hardcoding values that might change.

For page-level metadata, see Page properties.


Basic usage

Welcome to {{ project.branding.title }}!

If your retype.yml contains:

branding:
  title: My Documentation

Output:

Welcome to My Documentation!

Common properties

Property Description
project.branding.title The project title
project.branding.label The project label
project.branding.logo Path to the logo
project.url The project URL
project.links Custom links in the top navigation bar

The links property is an array. Loop through all links:

Output:

  1. What's New
  2. Pro Pricing
  3. Support
  4. Social

Or access individual links by index:

Output:


Escaping template syntax

Inline escaping

To display literal {{ }} syntax without the template engine processing it, wrap the content in opening {%{ and closing }%} escape tags:

{%{ {{ page.title }} }%}

This is useful when documenting template syntax or showing code samples that include double curly braces.

Page-level escaping

To disable templating for an entire page, set templating: false in the page settings:

---
templating: false
---

Project-level escaping

To disable templating project-wide, update your retype.yml with the following:

templating:
  enabled: false
templating