Publii

https://getpublii.com/dev
Admin
Publii is a desktop-based CMS for creating static websites, offering intuitive content creation,...
Tokens:200,508
Snippets:4,083
Trust Score:9.9
Update:10 months ago
Show doc for...
Tokens:
Raw
### Publii Installation and Usage Guide

Source: https://getpublii.com/dev/visual-overrides

This section outlines the initial steps to get started with Publii. It covers downloading the application and the basic workflow for creating and publishing a website.

```markdown
## Start building your site today.
  1. 1 Download Publii
  2. 2 Write your content
  3. 3 Publish your site

Create website
```

--------------------------------

### Getting Started with Publii Themes

Source: https://getpublii.com/dev/visual-overrides

This section covers the initial steps for theme development in Publii, including installation, understanding theme structure, rendering, and configuration files.

```markdown
* Getting Started
    * Handlebars - intro
    * Installing a new theme
    * Theme structure
    * Rendering theme
    * Theme config.json file
    * Theme supported features
    * Tutorials
```

--------------------------------

### Publii Theme Settings: Image Upload Example

Source: https://getpublii.com/dev/checkif-helper

Shows the setup for an image upload field within Publii's theme settings. This enables users to upload custom images, such as logos or background images, for their site.

```json
{
  "label": "Site Logo",
  "name": "site_logo",
  "type": "image"
}
```

--------------------------------

### Publii Theme Settings API - Switcher Example

Source: https://getpublii.com/dev/tag-tags

Shows the setup for a switcher (toggle) in the Publii Theme Settings API, used for enabling or disabling features.

```json
{
  "label": "Enable Feature",
  "name": "enableFeature",
  "type": "switcher"
}
```

--------------------------------

### Publii responsiveSizes Helper Example

Source: https://getpublii.com/dev/responsivesizes-helper

An example demonstrating the usage of the responsiveSizes helper in Publii, specifying 'featuredImage' as the type and 'header' as the group. This helps in rendering responsive images correctly within the theme.

```Handlebars
{{responsiveSizes 'featuredImage' 'header'}}
```

--------------------------------

### Publii Theme Settings API - Separator Example

Source: https://getpublii.com/dev/tag-tags

Shows the setup for a separator in the Publii Theme Settings API, used to visually divide sections of settings.

```json
{
  "type": "separator"
}
```

--------------------------------

### Handlebars Page Rendering Examples

Source: https://getpublii.com/dev/theme-structure

Demonstrates Handlebars syntax for rendering specific page types like the homepage, post page, tag page, and author page.

```handlebars
{{!-- Homepage --}}
{{!-- Post Page --}}
{{!-- Tag Page --}}
{{!-- Author Page --}}
```

--------------------------------

### Publii Developer Guides

Source: https://getpublii.com/dev/visual-overrides

Information on accessing developer guides for Publii, intended for users who wish to extend or customize Publii's functionality beyond the standard theme development.

```markdown
* Guides
  * Custom Helpers
```

--------------------------------

### Publii Resources and Community

Source: https://getpublii.com/dev/visual-overrides

A guide to the resources available for Publii users and developers, including user documentation, developer guides, community forums, and premium support options.

```markdown
* Resources
    * User Docs
Learn how Publii works, from installation to creation.
    * Developer Docs
Documentation, guides, and tutorials for developers.
    * Community Forum
Explore and interact with others and learn new things.
    * Premium Support
Dedicated customer support for paid products.
    * Blog
Read up on the latest news about Publii and its products.
```

--------------------------------

### responsiveImageAttributes Helper Syntax Example

Source: https://getpublii.com/dev/responsiveimageattributes-helper

Demonstrates the basic syntax for the `responsiveImageAttributes` helper, showing how to target an image defined in the theme's configuration and optionally specify its type and group.

```handlebars
{{responsiveImageAttributes @config.custom.imageOptionName [type] [group]}}
```

--------------------------------

### Handlebars - Basic Pagination Example

Source: https://getpublii.com/dev/prepare-theme-gdpr-compliant

Shows a basic implementation of pagination using Handlebars helpers. This is crucial for navigating through multiple pages of content on a site.

```html
<nav>
  {{#if pagination.prev}}
    <a href="{{pagination.prev.url}}">Previous</a>
  {{/if}}
  <span>Page {{pagination.current}} of {{pagination.total}}</span>
  {{#if pagination.next}}
    <a href="{{pagination.next.url}}">Next</a>
  {{/if}}
</nav>
```

--------------------------------

### Publii Theme Settings API: Text Input Example

Source: https://getpublii.com/dev/post-editor-api

Shows a basic example of defining a 'text' input type in the `config.json` file for theme settings, allowing users to input simple text values.

```JSON
{
  "settings": [
    {
      "id": "custom_text_field",
      "label": "Custom Text",
      "type": "text",
      "default": "Hello World"
    }
  ]
}
```

--------------------------------

### Publii Theme Settings: WYSIWYG Editor Example

Source: https://getpublii.com/dev/checkif-helper

Defines a WYSIWYG (What You See Is What You Get) editor field in Publii theme settings, enabling rich text formatting for content inputs. This is useful for customizable sections like footers or sidebars.

```json
{
  "label": "Custom Footer HTML",
  "name": "footer_html",
  "type": "wysiwyg"
}
```

--------------------------------

### Handlebars {{reverse}} Helper Example

Source: https://getpublii.com/dev/reverse-helper

Demonstrates the usage of the {{reverse}} Handlebars helper to reverse the order of items in a collection. It shows how to apply it to tag posts and restore the original order.

```Handlebars
{{#each @website.contentStructure.tags}}
   {{#checkIf this.name '==' 'test'}}
      {{#if this.postsNumber}}
         {{reverse this.posts}}
         {{#each this.posts}} {{! this output is reversed }}
            {{title}}
         {{/each}}
         {{reverse this.posts}}
      {{else}}
         There are no posts connected with tag name "test"
      {{/if}}
   {{/checkIf}}
{{/each}}
```

--------------------------------

### responsiveImageAttributes Helper with Featured Image Example

Source: https://getpublii.com/dev/responsiveimageattributes-helper

Provides an example of using the `responsiveImageAttributes` helper with a specific image type ('featuredImage') and a custom group name ('hero') for featured images.

```handlebars
{{responsiveImageAttributes @config.custom.heroImage 'featuredImage' 'hero'}}
```

--------------------------------

### Publii Theme Settings API: Repeater Example

Source: https://getpublii.com/dev/post-editor-api

Provides an example of a 'repeater' input type in `config.json`, enabling users to add multiple instances of a set of fields, often used for menus or feature lists.

```JSON
{
  "settings": [
    {
      "id": "social_links",
      "label": "Social Media Links",
      "type": "repeater",
      "fields": [
        {
          "id": "platform",
          "label": "Platform",
          "type": "text"
        },
        {
          "id": "url",
          "label": "URL",
          "type": "text"
        }
      ]
    }
  ]
}
```

--------------------------------

### Handlebars - Homepage Rendering Example

Source: https://getpublii.com/dev/prepare-theme-gdpr-compliant

Illustrates how to render the homepage in Handlebars, typically involving iterating through posts to display summaries or links. Assumes a structure where posts are accessible.

```html
{{#getPosts}} 
  <article>
    <h2>{{post.title}}</h2>
    <p>{{post.excerpt}}</p>
    <a href="{{post.url}}">Read more</a>
  </article>
{{/getPosts}}
```

--------------------------------

### Theme Settings API - Switcher Example

Source: https://getpublii.com/dev/dynamic-assets

Shows how to implement a switcher (toggle) input using the Theme Settings API. This is ideal for enabling or disabling features with a simple on/off switch.

```JSON
{
  "name": "enableDarkMode",
  "label": "Enable Dark Mode",
  "type": "switcher"
}
```

--------------------------------

### Handlebars - {{date}} Helper Example

Source: https://getpublii.com/dev/prepare-theme-gdpr-compliant

Illustrates formatting dates using the {{date}} helper. This is useful for displaying publication dates or other time-sensitive information.

```html
<p>Published on: {{date post.published 'MMMM Do, YYYY'}}</p>
```

--------------------------------

### Publii Theme Settings API - Dropdown Example

Source: https://getpublii.com/dev/tag-tags

Demonstrates a dropdown selection configuration within the Publii Theme Settings API. This allows users to choose from a predefined list of options.

```json
{
  "label": "Choose an Option",
  "name": "dropdownOption",
  "type": "dropdown",
  "options": [
    {"value": "option1", "label": "Option 1"},
    {"value": "option2", "label": "Option 2"}
  ]
}
```

--------------------------------

### {{orderby}} Helper Syntax and Example

Source: https://getpublii.com/dev/orderby-helper

Demonstrates the syntax for the {{orderby}} helper, which sorts collections by a specified field and direction, with an option for locale-sensitive sorting. The example shows how to sort posts by ID in descending and ascending order using Polish locale, emphasizing the need to restore the original order.

```handlebars
{{orderby collection field direction [langForLocaleCompare]}}
```

```handlebars
{{#each @website.contentStructure.tags}}
   {{#checkIf this.name '===' 'test'}}
      {{orderby this.posts 'id' 'DESC' 'pl'}}
      {{#each this.posts}}
         {{title}}
      {{/each}}
      {{orderby this.posts 'id' 'ASC' 'pl'}}
   {{/checkIf}}
{{/each}}
```

--------------------------------

### Publii Theme Settings API - Posts Dropdown Example

Source: https://getpublii.com/dev/tag-tags

Demonstrates a dropdown populated with available posts in the Publii Theme Settings API, allowing users to select a specific post.

```json
{
  "label": "Select a Post",
  "name": "selectedPost",
  "type": "posts"
}
```

--------------------------------

### Handlebars Partials - Introduction and Usage

Source: https://getpublii.com/dev/dynamic-assets

Covers the concept of Handlebars partials, which are reusable template components. Examples include `footer.hbs`, `head.hbs`, and `menu.hbs` for modular theme development.

```Handlebars
// Example of including a partial named 'header'
// {{> header }}
```

--------------------------------

### Handlebars Post Tag Example

Source: https://getpublii.com/dev/checkif-helper

Demonstrates how to use Handlebars tags to display post information, including titles and links. This is fundamental for rendering post listings and individual post pages.

```html
<article>
  <h2><a href="{{postUrl}}">{{postTitle}}</a></h2>
  <p>{{postExcerpt}}</p>
</article>
```

--------------------------------

### Theme Settings API - Dropdown Example

Source: https://getpublii.com/dev/prepare-theme-gdpr-compliant

Sets up a dropdown (select) input for theme settings, allowing users to choose from a predefined list of options.

```json
{
  "type": "dropdown",
  "label": "Color Scheme",
  "key": "color_scheme",
  "options": [
    {"value": "light", "label": "Light"},
    {"value": "dark", "label": "Dark"}
  ]
}
```

--------------------------------

### Publii Theme Settings API - Pages Dropdown Example

Source: https://getpublii.com/dev/tag-tags

Illustrates a dropdown populated with available pages in the Publii Theme Settings API, enabling users to select a specific page.

```json
{
  "label": "Select a Page",
  "name": "selectedPage",
  "type": "pages"
}
```

--------------------------------

### Theme Settings API - Dropdown Example

Source: https://getpublii.com/dev/dynamic-assets

Illustrates the creation of a dropdown (select) element using the Theme Settings API. This provides a predefined list of options for the user to choose from.

```JSON
{
  "name": "themeColor",
  "label": "Theme Color",
  "type": "dropdown",
  "options": [
    {"value": "blue", "label": "Blue"},
    {"value": "red", "label": "Red"}
  ]
}
```

--------------------------------

### Handlebars Partials for Reusable Content

Source: https://getpublii.com/dev/responsiveimageattributes-helper

Explains the concept of Handlebars partials in Publii for creating reusable template components. Examples include footer, head, menu, and pagination partials.

```handlebars
<!-- Including a partial -->
{{> footer.hbs}}

<!-- Including a custom partial -->
{{> my-custom-partial}}
```

--------------------------------

### Publii Theme Settings API - Image Small Upload Example

Source: https://getpublii.com/dev/tag-tags

Demonstrates the configuration for a small image upload field in the Publii Theme Settings API, suitable for smaller image assets.

```json
{
  "label": "Upload Small Image",
  "name": "smallImage",
  "type": "imageSmall"
}
```

--------------------------------

### Theme Settings API - Color Picker Example

Source: https://getpublii.com/dev/author-page-tags

Configures a color picker input for theme customization via the Theme Settings API. Enables users to select colors for various theme elements.

```JSON
{
  "settings": [
    {
      "type": "colorpicker",
      "name": "Primary Color",
      "key": "primaryColor",
      "default": "#007bff"
    }
  ]
}
```

--------------------------------

### Theme Settings API - WYSIWYG Editor Example

Source: https://getpublii.com/dev/prepare-theme-gdpr-compliant

Configures a WYSIWYG (What You See Is What You Get) editor for theme settings. This provides a rich text editing experience for users.

```json
{
  "type": "wysiwyg",
  "label": "About Section Content",
  "key": "about_content"
}
```

--------------------------------

### Publii Theme Settings: Color Picker Example

Source: https://getpublii.com/dev/checkif-helper

Illustrates the configuration for a color picker input in Publii theme settings. This allows users to select colors for various theme elements, like backgrounds or text.

```json
{
  "label": "Primary Color",
  "name": "primary_color",
  "type": "color"
}
```

--------------------------------

### Publii Theme Settings: Text Input Example

Source: https://getpublii.com/dev/checkif-helper

Shows the configuration for a simple text input field within the Publii theme settings. This allows users to input custom text values that can be used in the theme.

```json
{
  "label": "Author Name",
  "name": "author_name",
  "type": "text"
}
```

--------------------------------

### Handlebars - {{asset}} Helper Example

Source: https://getpublii.com/dev/prepare-theme-gdpr-compliant

Shows how to use the {{asset}} helper to correctly reference static assets like CSS and JavaScript files, ensuring proper path resolution.

```html
<link rel="stylesheet" href="{{asset 'css/style.css'}}">
<script src="{{asset 'js/main.js'}}></script>
```

--------------------------------

### Publii Example Menu HTML Structure

Source: https://getpublii.com/dev/default-publii-classes-for-using-with-css

Demonstrates a sample HTML structure for a Publii menu, showcasing how the default CSS classes are applied. This example illustrates the use of `.menu-level-1`, `.active-parent`, `.has-submenu`, `.submenu-level-2`, and `.active` classes.

```html
<nav>
  <ul class="menu menu-level-1">
    <li>
       <li>Item</li>
       <li class="active-parent has-submenu"> Item
          <ul class="submenu submenu-level-2">
             <li class="active"> Item </li>
             <li> Item </li>
          </ul>
       </li>
       <li>Item</li>
    </li>
  </ul>
</nav>
```

--------------------------------

### {{#checkIf}} Helper Syntax and Examples

Source: https://getpublii.com/dev/checkif-helper

Demonstrates the basic syntax of the {{#checkIf}} helper, its use with logical AND, and how it simplifies nested #if conditions. It also shows how to conditionally render content based on specific post IDs and array containment.

```handlebars
{{#checkIf}} ARG_1 OPERATOR ARG_2}}
   Code displayed when above condition is true
{{else}}
   Code displayed when above condition is false
{{/checkIf}}
```

```handlebars
{{#checkIf author '&&' author.avatar}}
    <img src="{{author.avatar}}" alt="" />
{{/checkIf}}
```

```handlebars
{{#post}}
   {{#checkIf id '==' 10}}
         your code here...
   {{/checkIf}}
{{/post}}
```

```handlebars
{{#each tags}}
   {{#checkIf '1,2,3' 'contains' id}}
       <a href="{{url}}" class="filter__item">{{name}}</a>
   {{/checkIf}}
{{/each}}
```

```handlebars
{{#each tags}}
   {{#checkIf '1,2,3' 'notContains' id}}
       <a href="{{url}}" class="filter__item">{{name}}</a>
   {{/checkIf}}
{{/each}}
```

--------------------------------

### Handlebars Introduction and Basic Items

Source: https://getpublii.com/dev/getpagesbycustomfields-helper

An introduction to Handlebars, a templating language used in Publii, and its basic items like Post, Page, Tag, Author, and Featured image.

```handlebars
// Example of a basic Handlebars item structure (conceptual)
// This is not actual runnable code but illustrates the concept.

// Post item might contain properties like:
// post.title
// post.content
// post.date

// Page item might contain properties like:
// page.title
// page.url

// Tag item might contain properties like:
// tag.name
// tag.url

// Author item might contain properties like:
// author.name
// author.bio

// Featured image might be accessed via a helper or a property:
// {{featuredImage post}}
// post.featuredImage.url
```

--------------------------------

### Publii Gallery SCSS Structure

Source: https://getpublii.com/dev/default-publii-classes-for-using-with-css

Provides an SCSS example demonstrating a more nested approach to styling Publii gallery elements. It utilizes SCSS features like nesting and interpolation to achieve the same structure as the plain CSS example.

```scss
.gallery {
	&-wrapper {
		&--wide {}
		&--full {}
	}
	&__item {}
}
```

--------------------------------

### Example: Filter Pages with getPagesByCustomFields Helper

Source: https://getpublii.com/dev/getpagesbycustomfields-helper

An example demonstrating the `getPagesByCustomFields` helper to display up to 5 posts where a specific custom field (`indexTest1`) does not equal a certain value (`XYZ`). This showcases filtering capabilities using query string parameters.

```handlebars
{{#getPagesByCustomFields "count=5&customField=indexTest1&customFieldValue=XYZ&customFieldCompare=not-equals"}}
    <h2>{{ title }}</h2>
    <div>{{{ excerpt }}}</div>
{{/getPagesByCustomFields}}

```

--------------------------------

### Set Up Post, Page, Tag, and Author Templates

Source: https://getpublii.com/dev/theme-configjson-file

Configures custom templates for rendering posts, pages, tags, and authors. Each entry maps a template key to a description, indicating the corresponding Handlebars file used for generation.

```json
"postTemplates": {
       "alternative": "Post alternative template (from post-alternative.hbs file)"
},
"pageTemplates": {
       "alternative": "Page alternative template (from page-alternative.hbs file)"
},
"tagTemplates": {
       "alternative": "Tag alternative template (from tag-alternative.hbs file)"
},
"authorTemplates": {
       "alternative": "Author alternative template (from author-author-alternative.hbs file)"
}
```

--------------------------------

### Handlebars Introduction and Basic Items

Source: https://getpublii.com/dev/getpages-helper

Introduces Handlebars templating in Publii and details basic items like Post, Page, Tag, Author, and Featured Image. This section is crucial for understanding how to structure and display content within themes.

```handlebars
// Example of accessing a post title in Handlebars
{{post.title}}
```

```handlebars
// Example of accessing a page title in Handlebars
{{page.title}}
```

```handlebars
// Example of accessing a tag name in Handlebars
{{tag.name}}
```

```handlebars
// Example of accessing an author name in Handlebars
{{author.name}}
```

```handlebars
// Example of accessing a featured image URL in Handlebars
{{post.featuredImage.url}}
```

--------------------------------

### Publii Theme Settings API - WYSIWYG Input

Source: https://getpublii.com/dev/theme-structure

Defines the configuration for a WYSIWYG (What You See Is What You Get) editor input within the Publii Theme Settings API.

```json
{
  "type": "wysiwyg",
  "label": "WYSIWYG Editor",
  "defaultValue": "<b>Default</b> content"
}
```

--------------------------------

### Theme Settings API - Switcher Example

Source: https://getpublii.com/dev/prepare-theme-gdpr-compliant

Implements a switcher (toggle) input for theme settings, typically used for enabling or disabling features.

```json
{
  "type": "switcher",
  "label": "Enable Comments",
  "key": "enable_comments"
}
```

--------------------------------

### Theme Settings API - Textarea Example

Source: https://getpublii.com/dev/dynamic-assets

Shows how to implement a textarea input using the Theme Settings API for multi-line text input. This is suitable for longer text descriptions or custom content.

```JSON
{
  "name": "siteDescription",
  "label": "Site Description",
  "type": "textarea"
}
```

--------------------------------

### Text Alignment HTML Markup

Source: https://getpublii.com/dev/default-publii-classes-for-using-with-css

Example HTML markup for text with alignment classes applied. The '.align-left' class is shown here applied to a paragraph element.

```html
<p class="align_left">
   Lorem ipsum dolor sit amet, consectetur adipisicing elit
</p>
```

--------------------------------

### Publii Theme Settings API - Authors Dropdown Example

Source: https://getpublii.com/dev/tag-tags

Demonstrates a dropdown populated with available authors in the Publii Theme Settings API, enabling users to select a specific author.

```json
{
  "label": "Select an Author",
  "name": "selectedAuthor",
  "type": "authors"
}
```

--------------------------------

### Handlebars Introduction and Basic Tags

Source: https://getpublii.com/dev/amp-global-variable

This section introduces Handlebars, a templating engine used by Publii, and outlines basic tags for accessing post, page, tag, author, and featured image data. It's essential for understanding how to dynamically render content within themes.

```handlebars
<!-- Example of Post Tag -->
{{#Post}}
  <h1>{{title}}</h1>
  <p>{{content}}</p>
{{/Post}}
```

```handlebars
<!-- Example of Page Tag -->
{{#Page}}
  <h2>{{title}}</h2>
  <p>{{content}}</p>
{{/Page}}
```

```handlebars
<!-- Example of Tag Tag -->
{{#Tag}}
  <span>{{name}}</span>
{{/Tag}}
```

```handlebars
<!-- Example of Author Tag -->
{{#Author}}
  <p>By {{name}}</p>
{{/Author}}
```

```handlebars
<!-- Example of Featured Image Tag -->
{{#featuredImage}}
  <img src="{{url}}" alt="{{alt}}">
{{/featuredImage}}
```

--------------------------------

### Publii Theme Settings API - Tags Dropdown Example

Source: https://getpublii.com/dev/tag-tags

Shows a dropdown populated with available tags in the Publii Theme Settings API, allowing users to select a specific tag.

```json
{
  "label": "Select a Tag",
  "name": "selectedTag",
  "type": "tags"
}
```

--------------------------------

### Handlebars Introduction and Basic Items

Source: https://getpublii.com/dev/responsiveimageattributes-helper

Introduces Handlebars templating engine used in Publii themes. Covers basic items like Post, Page, Tag, Author, and Featured image for content rendering.

```handlebars
<!-- Example of using Post object -->
<h1>{{post.title}}</h1>
<p>{{post.content}}</p>

<!-- Example of using Author object -->
<p>By {{author.name}}</p>

<!-- Example of using Featured image -->
<img src="{{post.featuredImage.url}}" alt="{{post.featuredImage.alt}}">
```

--------------------------------

### Handlebars Introduction and Basic Tags

Source: https://getpublii.com/dev/getpostsbycustomfields

Introduces Handlebars templating engine used in Publii. Explains basic tags like Post, Page, Tag, Author, and Featured image for content rendering.

```handlebars
{{Post.title}}
{{Page.title}}
{{Tag.name}}
{{Author.name}}
{{Post.featuredImage.url}}
```

--------------------------------

### Handlebars Introduction and Basic Items

Source: https://getpublii.com/dev/dynamic-assets

Introduction to Handlebars templating engine used in Publii themes. Covers basic items like Post, Page, Tag, Author, and Featured image, which are essential for rendering dynamic content.

```Handlebars
// Example of accessing basic items in Handlebars
// {{ Post.title }}
// {{ Page.title }}
// {{ Tag.name }}
// {{ Author.name }}
// {{ Post.featuredImage.url }}
```

--------------------------------

### Publii Theme Settings API - Radio Buttons Example

Source: https://getpublii.com/dev/tag-tags

Illustrates the configuration for radio buttons in the Publii Theme Settings API, allowing users to select one option from a group.

```json
{
  "label": "Select a Style",
  "name": "themeStyle",
  "type": "radio",
  "options": [
    {"value": "style1", "label": "Style 1"},
    {"value": "style2", "label": "Style 2"}
  ]
}
```

--------------------------------

### Handlebars - Introduction to Helpers

Source: https://getpublii.com/dev/tag-config-options

Discover a wide array of Handlebars helpers for manipulating data and controlling output in Publii themes. These helpers cover linking, asset management, date formatting, conditional logic, string manipulation, image handling, and more, providing powerful templating capabilities.

```handlebars
{{ampLink}}
{{asset}}
{{canonicalLink}}
{{#checkIf}}
{{#checkIfAll}}
{{#checkIfAny}}
{{#checkIfNone}}
{{concatenate}}
{{contains}}
{{notContains}}
{{css}}
{{date}}
{{encodeUrl}}
{{encodeUrlFragment}}
{{feedLink}}
{{font}}
{{gdprScriptBlocker}}
{{imageDimensions}}
{{#is}}
{{#isNot}}
{{#isCurrentPage}}
{{#isEmpty}}
{{#isNotEmpty}}
{{join}}
{{js}}
{{jsonify}}
{{jsonLD}}
{{lazyload}}
{{math}}
{{menuItemClasses}}
{{menuUrl}}
{{metaDescription}}
{{metaRobots}}
{{orderby}}
{{pageUrl}}
{{{publiiFooter}}}
{{{publiiHead}}}
{{responsiveImageAttributes}}
{{responsiveSizes}}
{{responsiveSrcSet}}
{{reverse}}
{{socialMetaTags}}
{{translate}}
```

--------------------------------

### Publii Theme Settings API - Textarea Example

Source: https://getpublii.com/dev/tag-tags

Illustrates the configuration for a textarea field in the Publii Theme Settings API. This enables users to input multi-line text for theme customization.

```json
{
  "label": "Custom Textarea",
  "name": "customTextarea",
  "type": "textarea"
}
```

--------------------------------

### Theme Settings API - Radio Buttons Example

Source: https://getpublii.com/dev/prepare-theme-gdpr-compliant

Configures radio buttons for theme settings, offering users a choice between mutually exclusive options.

```json
{
  "type": "radio",
  "label": "Layout Style",
  "key": "layout_style",
  "options": [
    {"value": "classic", "label": "Classic"},
    {"value": "modern", "label": "Modern"}
  ]
}
```
Tokens:
Raw