{"id":15288593,"url":"https://github.com/agraphie/kaschber","last_synced_at":"2025-04-13T07:52:22.127Z","repository":{"id":62364981,"uuid":"558398358","full_name":"Agraphie/kaschber","owner":"Agraphie","description":"Jekyll theme ported from Ghost's default theme Casper.","archived":false,"fork":false,"pushed_at":"2022-12-14T22:51:26.000Z","size":301,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-26T23:43:47.493Z","etag":null,"topics":["casper-theme","jekyll","jekyll-theme","static-site"],"latest_commit_sha":null,"homepage":"https://github.com/Agraphie/kaschber","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Agraphie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-10-27T13:23:33.000Z","updated_at":"2024-10-09T17:07:02.000Z","dependencies_parsed_at":"2023-01-29T01:15:27.029Z","dependency_job_id":null,"html_url":"https://github.com/Agraphie/kaschber","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agraphie%2Fkaschber","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agraphie%2Fkaschber/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agraphie%2Fkaschber/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agraphie%2Fkaschber/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Agraphie","download_url":"https://codeload.github.com/Agraphie/kaschber/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248681493,"owners_count":21144700,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["casper-theme","jekyll","jekyll-theme","static-site"],"created_at":"2024-09-30T15:50:06.145Z","updated_at":"2025-04-13T07:52:22.104Z","avatar_url":"https://github.com/Agraphie.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kaschber\n\nKaschber is a Jekyll port for Ghost's default theme Casper [https://github.com/TryGhost/Casper](https://github.com/TryGhost/Casper). It's unopinionated and tries to stick as closely as possible to the Casper stylings and layout. It only comes with three pre-defined plugins: jekyll-feed, jekyll-paginate-v2 and jekyll-seo.\n\nThe overall goal is to be a simple default theme like minima, looking closely to Casper and trying to be as lean and flexible as possible.\n\nFor a demo of Ghost see [https://demo.ghost.io/](https://demo.ghost.io/).\n\n# Features\n- (Auto) dark mode\n- Full author pages \u0026 information via Jekyll collections\n- Auto generated tag pages plus custimisation via Jekyll collections\n- Pagination via jekyll-paginate-v2\n- Atom Feeds by [Jekyll-feed](https://github.com/jekyll/jekyll-feed)\n\n# Installation\nAdd this line to your Jekyll site's Gemfile:\n```\ngem \"kaschber\"\n```\n\nAnd then execute:\n```bash\n$ bundle\n```\n\n# Usage\nChange the theme in your config file to Kaschber\n```\ntheme: kaschber\n```\n\nThen change your index.html or index.md to look like this\n```\n---\nlayout: home\ncurrent: home\nclass: 'home-template'\n---\n```\n\nIf you have a custom index.html, you will have to copy the index.html from the Git repository and add your changes manually.\n\n## Customisation\nYou can specifiy these customisation options in your `_config.yml` for site-wide options\n\n| Config                  | Default           | Options                           |\n|-------------------------|-------------------|-----------------------------------|\n| title_font              | System default    | Elegant serif                     |\n| body_font               | System default    | Modern sans-serif                 |\n| header_style            | Center aligned    | Center aligned, Left, aligned, Hidden |\n| show_logo_in_navigation | false             | True, False                        |\n| feed_layout             | Classic           | Classic, Grid, List                 |\n| color_scheme            | Auto              | Light, Dark, Auto                   |\n| post_image_style        | Wide              | Wide, Full, Small, Hidden            |\n| navigation_layout       | Logo on cover     | Logo on cover, Logo in the middle, stacked | \n\nYou can specifiy these additional customisation options per post or in the default section for posts `_config.yml`\n| Config                  | Default           | Options                           |\n|-------------------------|-------------------|-----------------------------------|\n| show_recent_posts_footer | True | True, False   |\n| post_image_style        | Wide              | Wide, Full, Small, Hidden            |\n| custom_excerpt        | \"\"              | \u003cYour custom excerpt shown on the page and the post card\u003e           |\n\nKaschber also features several points to inject your custom code into the template. You can create\n- `_includes/custom-head.html` to include custom css or any other tags which get rendered in the head section\n- `_includes/custom-js.html` to include any additional Javascript at the bottom of your page\n- `_includes/custom-post-content.html` to include any custom post-specific content which gets inserted in every post. E.g. a table of content tag\n\n### Navigation\nPer default, Kaschber will include all files in your root folder in the header navigation bar. You can customise this with the setting `header_pages` in your `_config.yml`. E.g.\n\n```\nheader_pages:\n  - my_page.md\n  - about.md\n```\n\n### Colours\nYou can overwrite any colours and styles by just adding css files and include them in your `custom-head.html`. To overwrite the default accent colour #ff0095, do the following\n1. Create a file in your assets folder with the following content\n```css\n:root {\n  --ghost-accent-color: #6D7C86;\n}\n```\n2. Create `custom-head.html` in your `_includes` folder\n3. Include the new css file in your `custom-head.html`\n\n## Authors\nTo include author information, just create a folder called `_authors` and create your author information via markdown or html files. E.g.\n```\n---\nusername: Ghost\nname: Casper Ghost\nwebsite: https://github.com/TryGhost/Casper/\nbio: The professional publishing platform\npicture: assets/images/ghost.png\nfacebook_url: ghost\ntwitter_url: tryghost\ncover: False\n---\n```\n\nThen include the following Jekyll config in your `_config.yml`\n```\ncollections:\n  authors:\n    output: true\n\ndefaults:\n  - scope:\n      path: \"\"\n      type: \"authors\"\n    values:\n      layout: author\n      current: author\n      cover: false\n      class: 'author-template'\n      label: Author\n```\n\n## Tags\nTo create tags specifically, create a folder `_tags` and insert your tags there as markdown or html file. E.g.\n```\nname: speeches\ndescription: Some of the greatest words ever spoken.\ncover: assets/images/speeches.jpg\n```\n\nThen include the following Jekyll config in your `_config.yml`\n```\ncollections:\n  tags:\n    output: true\n\ndefaults:\n  - scope:\n      path: \"\"\n      type: \"tags\"\n    values:\n      layout: tag\n      current: tag\n      cover: false\n      class: 'tag-template'\n      label: Tag\n```\n\n# Contribute\nIf you would like to contribute, please keep the files as closely as possible to the original Ghost handlebar files. This will make maintenance easier. This is also the reason why the files haven't been really broken down into smaller parts.\n\n## Build\nTo build the files locally, you have to have npm and gulp installed.\n```\n$ gulp build\n```\n\nTo test your changes locally execute\n```bash\n$ gem build\n$ gem install kaschber-\u003ccurrent-version-in-gemspec\u003e\n```\n\n\n# Acknowledgements\nThis theme was heavily inspired by [Jasper2](https://github.com/jekyllt/jasper2).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagraphie%2Fkaschber","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagraphie%2Fkaschber","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagraphie%2Fkaschber/lists"}