Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/diomed/casper

grav theme :octocat: you can fork and adopt this theme if you wish so
https://github.com/diomed/casper

casper2 casper2-port casper2-theme css grav html twig yaml

Last synced: 3 months ago
JSON representation

grav theme :octocat: you can fork and adopt this theme if you wish so

Awesome Lists containing this project

README 

        
# Casper2 👻

Grav theme



![Casper2 Theme](thumbnail.jpg)



## 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](https://source.unsplash.com/)



...



## 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`** write **`home-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)](http://learn.getgrav.org/advanced/grav-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 to `theme: 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)](http://learn.getgrav.org/advanced/grav-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 to `casper2`.

* 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](https://getgrav.slack.com/messages) 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. 🙂