Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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.