GitHub

Theme structure

Every Publii theme should contain some required files, but there are also a few files which can be optionally included in the theme.

The following files are required:

  • config.json - main theme configuration file,
  • index.hbs - front page template,
  • post.hbs - single post template,
  • tag.hbs - single tag page template,
  • author.hbs - single author page template,
  • thumbnail.png - that will be displayed in the application settings (required dimensions: 400x300px),
  • partials/ - location for files which will be loaded with use of the {{> fileName}} code,
  • partials/footer.hbs - footer used in all pages,
  • partials/header.hbs - header used in all pages,
  • assets/css/main.css - main CSS file which is used to generate the styles.css file (which is merged with the optionally-generated override.css file).

And these files are optional:

  • visual-override.js - file which contains a function used to generate the override.css file,
  • feed-xml.hbs - The structure of the feed XML file - generated as feed.xml (the feed-xml.hbs file will be replaced with the application's default if one does not exist in the theme),
  • feed-json.hbs - The structure of the feed JSON file - generated as feed.json (the feed-json.hbs file will be replaced with the application's default if one does not exist in the theme),
  • partials/pagination.hbs - pagination for all pages (the pagination partial will be replaced with the application's default if one it does not exist in the theme),
  • partials/menu.hbs - menu structure for all pages (the menu partial will be replaced with the application's default if one does not exist in the theme).

Subscribe

Get the latest Publii news, updates and more delivered directly to your email inbox

You can change your mind at any time by clicking the unsubscribe link in the footer of any email you receive from us, or by contacting us at contact@tidycustoms.net. By clicking below, you agree that we may process your information in accordance with our Privacy Policy.