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.

Basic Settings

• Color Theme - Set 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 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 enabled. In such cases, use Jimp, which is more stable.
• Interface Scale - Adjust the interface scale to enhance visibility and comfort while managing your content within Publii. This option allows you to scale the user interface according to your preference, ensuring that text, icons, and other UI elements are easily readable and accessible. It's particularly useful for users with high-resolution displays or those who prefer larger elements for ease of use.
• 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 use a high resolution and want the scrollbars to be more visible.

Files Location

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

• 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.

Default lists ordering

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 - 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 ID, Creation Date, Date last modified, or alphabetically by Title or Author; each of these can also be set to ascending or descending.

Options for Editors

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:

• 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.

Options for Developers

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:

• 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:

• 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 to be more readable rather than minified.