https://github.com/stefanbc/Asgar

A two-column, clean and minimalist theme for @TryGhost
https://github.com/stefanbc/Asgar

blogging ghost ghost-blog ghost-blog-theme ghost-cms ghost-theme ghost-themes magazine minimalist publishing theme two-columns

Last synced: 3 months ago
JSON representation

A two-column, clean and minimalist theme for @TryGhost

• Host: GitHub
• URL: https://github.com/stefanbc/Asgar
• Owner: stefanbc
• License: mit
• Created: 2019-02-25T08:54:20.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2023-09-05T02:36:38.000Z (about 1 year ago)
• Last Synced: 2024-05-17T23:33:01.798Z (6 months ago)
• Topics: blogging, ghost, ghost-blog, ghost-blog-theme, ghost-cms, ghost-theme, ghost-themes, magazine, minimalist, publishing, theme, two-columns
• Language: Handlebars
• Homepage:
• Size: 9.95 MB
• Stars: 24
• Watchers: 4
• Forks: 7
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-starred - stefanbc/Asgar - A two-column, clean and minimalist theme for @TryGhost (publishing)

README

        
# 
Asgar


[![Build Status](https://travis-ci.com/stefanbc/Asgar.svg?branch=master)](https://travis-ci.com/stefanbc/Asgar) ![Code scanning](https://github.com/stefanbc/Asgar/workflows/Code%20scanning/badge.svg) [![Maintainability](https://api.codeclimate.com/v1/badges/db551b4c7a25f474e729/maintainability)](https://codeclimate.com/github/stefanbc/Asgar/maintainability) [![Known Vulnerabilities](https://snyk.io/test/github/stefanbc/Asgar/badge.svg?targetFile=package.json)](https://snyk.io/test/github/stefanbc/Asgar?targetFile=package.json) 

A two column, free and open source theme for Ghost.

![asgar stefancosma xyz_ (1)](https://user-images.githubusercontent.com/1278794/133379640-a6988b62-c5b4-45e1-9b9e-8b985e3e836d.png)

## Installation

1. Download the theme from GitHub.

2. Upload the theme as described in the [Ghost Documentation](https://docs.ghost.org/concepts/config/).

3. This theme has multiple custom pages: `about`, `projects` and `speaking`.

Checkout the Ghost [docs](https://docs.ghost.org/api/handlebars-themes/context/page/#templates) for more info about custom pages.

To customize the data, on the right side, in the `projects` and `speaking` pages

you'll first need to add this to your `routes.yaml` file, bellow the `routes` key:

```yaml

  /custom/api/:

    permalink: /custom/api/

    template: api

    content_type: json

```

*More info about the `routes.yaml` file [here](https://docs.ghost.org/api/handlebars-themes/routing/).*

4. After that you can customize the `api.hbs` file with your data, just make sure the structure remains the same.

5. Additionally you should replace all the image in the `assets/images` folder. You can use [this useful tool](http://realfavicongenerator.net/).

6. After you've completed the steps above, you can zip the theme and upload it.

## Development

You can install all the theme dependencies using:

```bash

yarn install

```

Available scripts:

* `yarn prod` - will build the whole theme for production.

* `yarn deploy` - will build the theme for production, zip and validate.