Publii Documentation

Build extremely safe, fast and amazing blog with Publii Static CMS

Introduction

Publii is an app that brings a new concept to the web-development table; the first desktop static-website CMS. Designed with the simplicity for beginners to use, but boasting extensive options and functionalities that allow experienced web developers to make more complex modifications, Publii creates a safe, fast static website without all the hassle. In this guide you'll be able to learn how it works, from installation to creation.

This guide is separated into sections, with each one covering a particular aspect of Publii, such as creating a new post, or looking at the available options and what they do in a particular section. You may read through the guide in order, but if you're in a rush or know exactly what you're looking for then you can use the quick links to rapidly get to the section you need.

How It Works

Before starting using Publii it is important to understand that while it is technically a CMS (Content Management System), it does not work in the same way as other CMSs you may have seen such as WordPress or Joomla!. Usually, the defining characteristic of a CMS is that it is software that runs on a server; first, you must buy hosting that gives you access to a server, then upload the CMS files to the server and install it directly there.

What this means is that everything related to your website is run on the server; if you want to create a new post, edit a category, or add images to your site, you must first login to the CMS on the server and make your changes there. You must be constantly connected to the internet for this so that any changes can be sent to the software as you make them. Though it's possible to create the website offline and then transfer it to your server, it's not an easy process and prone to issues.

With Publii things are different. The Publii app runs on your desktop; this means that when creating or modifying your site, you are doing everything locally on your computer; there's no need to be connected to the internet or to login to your server; once it's setup, Publii will take care of everything. Within the Publii app you can create posts and tags (categories), add images, and modify options that control the overall look of your site. In fact, you can create every aspect of your site even before you've purchased any hosting! Once you feel your site is ready, you'll only need to sync your website to your server and Publii will generate and upload all the necessary files.