README.md

deanbot-site

Kirby blog and memex.

Requirements

Kirby (v4) runs on PHP 8.1+, Apache or Nginx.

Dev tooling uses node v20.17.

Kirby Dependencies

• tobimori/kirby-seo.git: provides meta/search tags, sitemap and and robots
• bnomei/kirby3-feed: generate RSS feed https://github.com/tobimori/kirby-seo.git (submodule: site/plugins/seo) provides meta/search tags, sitemap and and robots

Develop

Webpack tooling is set up for sass & js compiliation, but it assumes you're already serving the site via xampp/mamp/etc w/ a vhost address of spiritedrefactor.localhost.

Setup

Updating Kirby CMS and Plugins

• install submodules: git submodule update --init --recursive
• update kirby to latest: ./tools/update.sh

Web Server

1. Install xampp
2. Clone project into /Applications/XAMPP/xampfiles/htdocs, e.g., as deanbot.local

• to clone with submodules include --recurse-submodules -j8

3. Edit /Applications/XAMPP/xampfiles/etc/httpd.conf.

• Update User/Group as indicated below or you get cannot write error during panel installation. User is the name of your home directory.
• httpd.conf configuration:
  • change: User daemon /n Group daemon
  • to: User your_username /n Group staff

4. Configure vhosts

• Edit /private/etc/hosts and add line: 127.0.0.1 deanbot.local (requires sudo)
• Edit files in /Applications/XAMPP/xampfiles/
  • Edit etc/extra/httpd-vhosts.conf and add configuration below.
  • Edit etc/httpd.conf and uncomment line following # Virtual hosts

5. Restart apache server in xammpp (manager-osx).

httpd-vhosts.conf configuration:

<VirtualHost *:80>
  ServerName localhost
  DocumentRoot "/Applications/XAMPP/xamppfiles/htdocs"
</VirtualHost>

<VirtualHost *:80>
  ServerName bluemooncommunityfarm.local
  DocumentRoot "/Applications/XAMPP/xamppfiles/htdocs/bluemooncommunityfarm.local"
  ErrorLog "logs/bluemooncommunityfarm.local-error_log"
  CustomLog "logs/bluemooncommunityfarm.local-access_log" common
</VirtualHost>

JS tooling

Warning: JS tooling has vulnerabilities - do not install node packages until resolved.

• Node
  • install/update nvm
  • install latest lts nvm install --lts and use it nvm use --lts
• PNPM
  • install pnpm

Scripts

• pnpm run build - create prod build of css and js in assets/builds
• pnpm run start - launch dev build with webpack + browser-sync

Mentions

• Icon svgs are from Remix Icon