App Settings

The general settings customize your experience when using Publii, rather than changing individual websites that the app has created. There are five areas in this section, starting with a Basic Settings block that contains the following options:

Publii General Settings
  • Color Theme - Sets the color theme for Publii; choose between light or dark mode, or automatically use the same setting as your desktop.
  • Load At Start - This option sets which of your websites will be opened when you start Publii, or to default to the last-used website.
  • Time Format - Set your timestamps to be in 12 or 24-hour format.
  • Image Resize Engine - Set which engine should handle image manipulation; Sharp is faster, but some users encounter issues with their images when this is enabled. In such cases, use Jimp, which is more stable.
  • Always save search state - When enabled, Publii will save the current search results even when creating a new post, allowing you to return to the listing. By default, Publii only saves search results when opening a post to edit.
  • Show modification date - When enabled, the modification date will be displayed under the publication date.
  • Show modification date as column - When enabled, an additional column with the modification date will be displayed in the post list.
  • Show post slugs on the listing - When enabled, the post slug will be displayed under the post title in the post list.
  • Show post tags on the listing - When enabled, the tags will be displayed under the post title in the post list.
  • Use wider scrollbars - Enables wider scrollbars in the Publii app; useful if you're using a high resolution and want the scrollbars to be more visible.

The second block in this section is the Files Location block; there are three options available:

Publii Files Location

  • Sites Location - Define where the files for the websites you create with Publii, including themes, are stored. This can be set to, for example, your Dropbox folder to backup your site in the cloud, or any local directory.
  • Backup Location - Defines where backups created in the Backups section of the app are stored; again, this can be set your local cloud folder to allow for your backups to be stored online, or stored locally.
  • Preview Location - Define where the files of the website preview are stored. Leave blank to use default preview directory.

The third block covers Default lists ordering; this tells Publii how you want your content such as posts, tags, authors etc...to be displayed in their respective listings. By default, all lists are sorted descending by ID i.e. newest item first, oldest item last. The available options here are:

Default posts ordering on the lists
  • Default posts ordering - Sets the ordering for the Posts listing. 
  • Default tags ordering - Defines the ordering for Tag listings.
  • Default authors ordering - Sets the ordering of the Authors listing.

Each listing can be set to order by IDCreation DateDate last modified, or alphabetically by Title or Author; each of these can also be set to ascending or descending.

The fourth block in this section contains Options for Editors; that is, the people that write and edit posts. These options set the default behaviour when writing posts. The available options are:

Options for post editors
  • Font Size (px) - Sets the standard font size in pixels that the post editor should use.
  • Font Family - Defines the basic font that the post editor should use.
  • Close Post Editor on Save - If enabled, the post editor will default to using the Save & Close option for the save button; this can still be changed manually when editing a document by clicking on the down-arrow on the right-side of the button.

The fifth block in this section covers Options for Developers, with tools that may be useful for developers creating their own themes or branches of Publii. The available options in this section are:

Options for developers
  • Open DevTools Automatically in the Main Window - When enabled, this option will automatically load DevTools for troubleshooting as soon as Publii is loaded. Requires a restart of the app before changes will take effect.
  • Enable Advanced Preview - When enabled, clicking the Preview Your Changes button will generate the site preview files, but will not render them for display.

The final section of the App Settings is for Experimental Features; features that are still being tested, or have not been fully-implemented. The currently available options in this section are:

  • Publii UI Translations - When enabled, a Languages section will be added to the Three-Dot Menu, in which you will be able to select which UI language you wish to use, and link to the Publii GitHub page where user translations into other languages may be downloaded for installation.
  • Auto-Beautify Source Code in WYSIWYG Editor - If enabled, when viewing a post's content in the editor as the source HTML code, it will be automatically laid out in order to be more readable, rather than minified.