Casper2 π»
Grav theme
Notes
As you can see, this theme uses images in the header of every post.
If you don't have an image set and ready, you can select a placeholder image from unsplash that will show as background.
To do this, use the default card background image under theme options.
You can find examples on how to set desired unsplash image or set of images that will change upon reloading on unsplash
...
Basic usage instructions:
-
Change the logo in Themes Β» Casper 2.
-
Change social icons by writing your id after the site name in the theme configuration.
-
Change the favicon tagline text there too.
-
Create a page of type : blog and go to Advanced in the admin.
-
Under
body-classes
writehome-template
-
While you're there, in blog page
- Go to content tab
- Upload your own primary Image
- Hit save
The blog page should be blank, without any text.
Under blog page you can now create as many posts with page template item
as you want.
This is how you populate your blog.
In this theme you can also create a page of type : archive. Pages with type archive will list all your posts written so far.
Details
This Grav theme is port of a Casper theme for ghost, which is released under MIT licence.
GPM Installation (Preferred)
The simplest way to install this theme is via the Grav Package Manager (GPM) through your system's Terminal (also called the command line). From the root of your Grav install type:
bin/gpm install casper
This will install the Gateway theme into your /user/themes
directory within Grav. Its files can be found under /your/site/grav/user/themes/casper
.
Manual Installation
To install this theme, just download the zip version of this repository and unzip it under /your/site/grav/user/themes
. Then, rename the folder to casper
.
You should now have all the theme files under
/your/site/grav/user/themes/casper
If you want to set Casper2 as the default theme, you can do so by following these steps:
- Navigate to
/your/site/grav/user/config
. - Open the system.yaml file.
- Change the
theme:
setting totheme: casper
. - Save your changes.
- Clear the Grav cache. The simplest way to do this is by going to the root Grav directory in Terminal and typing
bin/grav clear-cache
.
GPM Update (Preferred)
The simplest way to update this theme is via the Grav Package Manager (GPM). You can do this with this by navigating to the root directory of your Grav install using your system's Terminal (also called command line) and typing the following:
bin/gpm update casper
This command will check your Grav install to see if your Gateway theme is due for an update. If a newer release is found, you will be asked whether or not you wish to update. To continue, type y
and hit enter. The theme will automatically update and clear Grav's cache.
Manual Update
Manually updating theme is pretty simple. Here is what you will need to do to get this done:
- Delete the
your/site/user/themes/casper2
directory. - Download the new version of theme from this repository.
- Unzip the zip file in
your/site/user/themes
and rename the resulting folder tocasper2
. - Clear the Grav cache. The simplest way to do this is by going to the root Grav directory in terminal and typing
bin/grav clear-cache
.
Thank You
Grav has fantastic team, people that are very helpful and people that I probably bored to death,
or at least quite a lot to achieve what I want.
In Slack's chat room I bugged always helpful @andrewscofield
@ricardo
, and @olevik
.
Words cannot express how thankful I am to all of you. I'm the one to blame if anything is wrong, π but you guys helped to get most of the things right. So kudos to you.
And at last, but not least - Thank You if you're using this theme. π