This is the Starter Template and is the main Branch to get started using Calliope. It is focused on being the easiest tool to get started with when using calliope. If you want to read more about the project development and other features - check out the Readme in the _calliope
folder.
All you site content can be managed from _site
while the core application and server resides inside of _calliope
. There is a starter script inside of the _site
folder to help boostrap your static facing website. For docker or live hosting - you can access more functionality inside the main _calliope/*
folder.
To generate your static website the following should be sufficient (note you may need some development dependencies on your system such as node
and yarn
)
mkdir website
git clone https://github.com/ConflictingTheories/calliope website
cd website\_site
Add Content:
You content lives inside of the _site/content
folders. Here you can put your pages and posts and media files you wish to compile into your static site. (For more control - look at using the admin panel for customization and more advanced editing - including Live Preview, Zip Generation, and more.)
Configure Environment:
Once you have some content and are ready to build you site, it is time to make sure you have configured the final settings correctly. Here is where you would configure your .env
file and make your configurations for calliope to build your site. Once you have configured your .env
(see the sample for help)
- Source your Env file, and the finally build you site with the following,
. build.ps1
This should generate your new website inside of the _site/output
folder and here you can host and deploy your site statically.
To Test you can statically serve it or deploy it to your favourite host. If you are using http-server
you can do the following.
ex. http-server _site/output
--> Then open browser to (http://localhost:8080)
For License and more information on Calliope, please see the LICENSE file inside of the _calliope
folder.