Fountain

Installation

Fountain comes with ready-made content and templates to help you get started quickly. At its core, Fountain works like any other Kirby plugin, but requires Python for font processing capabilities.

Requirements

Server Requirements

  • PHP 8.0 or higher with the following extensions:
    • SQLite support (php-sqlite3)
    • Zip support (php-zip)
  • Web server: Apache or Nginx

CMS Requirements

  • Kirby 5.x (recommended)
  • Kirby 4.x minimum supported

Python Requirements

  • Python 3.8 or higher
  • fontbro package for font processing

Installation

1. Set Up Kirby

Download and install the Kirby Starterkit on your local machine:

composer create-project getkirby/starterkit

Or download the Starterkit manually from the Kirby website and extract it to your project directory.

2. Install Fountain Plugin

Copy the Fountain plugin files to your Kirby installation:

  1. Download or clone the Fountain repository
  2. Move the fountain folder to site/plugins/ in your Kirby project
  3. Ensure the path is site/plugins/fountain

3. Copy Starter Content

To get started quickly, copy the Fountain content folder to your project:

  1. Copy the content folder from Fountain to your Kirby project
  2. This will provide example content and templates to help you understand how Fountain works

4. Install Python Dependencies

Install the required Python package:

pip install fontbro

Or if using Python 3 specifically:

pip3 install fontbro

5. Verify Installation

After installation, verify that everything is working:

  1. Start your local server
  2. Visit your Kirby site in a browser
  3. Check that the Fountain panel interface loads correctly
  4. Test font processing features to ensure Python integration works

Docker Installation (Optional)

If you prefer using Docker for your development environment:

Requirements

  • Docker Desktop, or OrbStack (recommended for macOS)

Setup

Fountain includes Dockerfile and docker-compose.yml files for easy setup:

docker-compose up -d

This will build and run your Kirby site with Fountain in a containerized environment with all dependencies pre-configured.

Troubleshooting

Python not found: Ensure Python is in your system PATH and accessible from the command line.

SQLite errors: Verify that the php-sqlite3 extension is installed and enabled in your php.ini.

Zip errors: Verify that the php-zip extension is installed and enabled in your php.ini.

Permission issues: Ensure proper file permissions for the site/plugins/fountain directory and content folder.