Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ronynn/jekyll-theme-comics
A minimalist yet exciting jekyll theme based on action comics.
https://github.com/ronynn/jekyll-theme-comics
blog-theme css github-pages jekyll-blog jekyll-theme jekyll-themes ruby-gem theme
Last synced: 3 months ago
JSON representation
A minimalist yet exciting jekyll theme based on action comics.
- Host: GitHub
- URL: https://github.com/ronynn/jekyll-theme-comics
- Owner: ronynn
- License: mit
- Created: 2022-04-21T21:46:04.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-06-09T15:40:40.000Z (7 months ago)
- Last Synced: 2024-09-29T02:42:24.537Z (3 months ago)
- Topics: blog-theme, css, github-pages, jekyll-blog, jekyll-theme, jekyll-themes, ruby-gem, theme
- Language: SCSS
- Homepage: https://ronynn.github.io/jekyll-theme-comics/
- Size: 18.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Jekyll Theme Comics
Comics is a Jekyll Theme inspired by action comics. You can [preview the theme to see what it looks like](https://ronynn.github.io/jekyll-theme-comics), or even [use it today](#usage).*
## Contents
- [Get Started](#get-started)
- [Make it yours](#make-it-yours)
- [Usage](#usage)
- [Customizing](#customizing)
- [Configuration Variables](#configuration-variables)
- [Stylesheet](#stylesheet)
- [Layouts](#layouts)
- [Roadmap](#roadmap)
- [Project Philosophy](#project-philosophy)
- [Contributing](#contributing)
- [Author](#author)
- [License](#license)
## Get started
First, follow the steps in this [Quickstart Guide](https://jekyllrb.com/docs/) if you're starting with Jekyll from scratch. Skip this if you already have an existing jekyll project.
1. [Fork the repository](https://github.com/ronynn/jekyll-theme-comics/fork)
2. Clone the repository: `git clone https://github.com/username/jekyll-theme-comics`
3. Run `bundle install`
4. Run Jekyll: `jekyll serve -w`
5. Go to http://localhost:4000 for your site.
## Make it yours
1. Edit `_config.yml`, then rerun `jekyll serve -w`
2. Change `about.md` for blog intro
3. For domain settings see [the guide from GitHub](https://help.github.com/articles/setting-up-a-custom-domain-with-pages)
## Usage
To use the comics theme on github pages:
1. Add the following to your site's `_config.yml`:
```yml
remote_theme: ronynn/jekyll-theme-comics
plugins:
- jekyll-remote-theme # add this line to the plugins list if you already have one
```
2. Optionally, if you'd like to preview your site on your computer, add the following to your site's `Gemfile`:
```ruby
gem "github-pages", group: :jekyll_plugins
```
## Customizing
### Configuration variables
Comics will respect the following variables, if set in your site's `_config.yml`:
```yml
title: [The title of your site]
description: [A short description of your site's purpose]
```
### Stylesheet
If you'd like to add your own custom styles:
1. Create a file called `/assets/css/style.scss` in your site
2. Add the following content to the top of the file, exactly as shown:
```scss
---
---
@import "{{ site.theme }}";
```
3. Add any custom CSS (or Sass, including imports) you'd like immediately after the `@import` line
*Note: If you'd like to change the theme's Sass variables, you must set new values before the `@import` line in your stylesheet.*
### Layouts
If you'd like to change the theme's HTML layout:
1. For some changes you can add custom files in your local `_includes` folder. The files provided with the themeprovide a starting point and are included by the [original layout template]
2. Create a file called `/_layouts/default.html` in your site
3. Paste the default layout content copied in the first step
4. Customize the layout as you'd like
## Roadmap
See the [open issues](https://github.com/ronynn/jekyll-theme-comics/issues) for a list of proposed features (and known issues).
## Project philosophy
The Comics theme originated from the idea of presenting a page with a colorscheme that excites the vision. It is intended to make it quick and easy for users to create a website. The theme is perfect for exciting projects, erring on the side of simplicity rather than flexibility, and provide users the opportunity to opt-in to additional complexity if they have specific needs or wish to further customize their experience (such as adding custom CSS or modifying the default layout). It should also look great, but that goes without saying.
## Contributing
Interested in contributing to Comics? I'd love your help. Comics is an open source project.
## Author
[ronynn](https://github.com/ronynn)
## License
Open sourced under the [MIT license](LICENSE.md).
<3