Table of Contents

Installing and Configuring Pico

There are many options for downloading and installing Pico. From automated choices like Composer and Git to just downloading an old-fashioned zip file. There’s even a version of Pico available on the Nextcloud App Store.

This guide will cover all the basics of getting Pico installed, configuring your webserver (whether you use Apache, Nginx, Lighttpd, or Caddy), to configuring Pico itself.

If you’re new to Pico altogether, you’ll probably want to start here, and make your way through each section as you go.

Creating Content

Pico’s flat file approach makes creating content a breeze. This guide discusses the basics of using Pico. We’ll go over the URL structure of Pico’s content folder, the YAML/Markdown format of your content files, and where you should put your assets.

Theming with Twig

Twig is an incredibly powerful templating language. In this guide, we’ll go over how Pico Themes work, how to access the extra Twig variables and filters Pico provides, and point you to some Twig related learning resources.

Deconstructing the Defaults

The best way to learn is through example, right? Here we break the Default Theme down into bite sized code snippets and explain what the Twig code is doing in them. A lot of the code you’ll see will be similer, if not identical, to what you’ll need for your own projects. You can even copy them if you’d like.

Twig Tips and Tricks

Moving on from the Default Theme, here we’ll look at some more advanced examples of tricks you can pull off with Pico and Twig. We’ll take a look at how to implement some blogging features as well, like pagination, tagging, and search.

The Power of Plugins

So you’ve mastered the power offered by Twig and you’re still wanting more?

Welcome to the world of Plugins. Pico is incredibly extendable via its Plugin system. Utilizing PHP, you can easily hook into Pico to create your own custom functionality.