Website for Das Habitat Augsburg e.V.

Requirements

• PHP (Kirby runs on PHP 7.1+)
• Composer
• Node.js & Yarn 1

Installing dependencies locally

On macOS

• Install brew
• brew install php to get a recent version of PHP
• brew install composer to get a recent version of Composer, the package manager for PHP
• brew install volta to install a reliable manager for Node.js
• volta install node@lts to install the latest LTS release of Node.js

On Windows

• Install Chocolatey
• choco install php composer imagemagick
• Install volta to manage Node.js
• volta install node@lts to install the latest LTS release of Node.js

PHP Setup

Chocolatey will install PHP in C:\tools\php80.

To run the composer you need to edit the php.ini found in the folder above.

You need to find this line (possibly line 927):

;extension=gd

and remove the leading ; to enable the extension:

extension=gd

Kirby uses the gd extension to manipulate and generate thumbnails for uploaded images.

Project dependendencies

• npm install
• npm run composer install

Running locally

You need two terminal sessions. One should be running Kirby, one is for running the asset generation and reloading.

Kirby

# On macOS/Linux
npm run kirby

# on windows
npm run kirby:win

Asset generation

npm run gulp

Once both are up and running you can open the page here: http://localhost:3000

Development

• Learn more about Kirby at getkirby.com/docs
• This project uses SCSS and PostCSS through a Gulp based pipeline
• Source for generated and static assets is the /src folder
• Source for the Kirby project is /kirby

Content

Note that website content is no longer stored in the repository, but directly on our server. This also includes our binary assets (images, pdfs, etc.) as Kirby manages those as well. No more messing with external providers.

You can download the kirby/content folder from our server directly in case you want to run the project locally with the same contents and assets.