This is repo for for the cosmogrammatics website.
Testing out if the kirby CMS can be stretched to build what we need.
You can use devenv to create a working shell environment dedicated to the project (with PHP, npm, etc) or simply install the belowed required software.
If going with devenv, simply start a new shell:
devenv shellthen follow the rest of the setup to setup Composer and npm.
composer.json's require field)We fetch a copy of Kirby's plainkit (via zip download or git), eventually remove the previous .git folder, re-init git and start tracking our own history.
To upgrade Kirby, run in a terminal the following:
composer update getkirby/cmsTo upgrade everything (eg kirby and any other plugin), run:
composer updateWe don't track the kirby folder into git, but instead handle it as a normal dependency.
Before running the server, make sure you have a content folder.
To run the backend, Kirby suggests to setup a full-on server environment (eg with nginx etc). This is not stricly necessary for the most part. So that you can simply run the backend by doing (from the root of the website folder):
php -S localhost:8000 kirby/router.phpIf going with devenv, you can instead enter a new shell:
devenv shellthen run this devenv script:
run-serverwhich will run php -S localhost:8000 kirby/router.php.
Otherwise you can use something like valet or anything else listed here.
Check Kirby's own guide as a reference.
When working on the js-side of the frontend (eg the article's commenting system), there's two npm scripts available:
npm run watch: to run a local instance of the scripts; any change to any js files will trigger a new version of the final script outputnpm run build: to build a compressed, smaller version of the final js bundleHackers & Designers (André, Anja, Karl)
(TBD)
Copyleft with a difference: This is a collective work, you are invited to copy, distribute, and modify it under the terms of the CC4r.