Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rohitjain00/dev-portfolio-blog
Minimal theme for blog and portfolio
https://github.com/rohitjain00/dev-portfolio-blog
blog blog-theme github-pages github-pagespeed html-css-javascript jekyll jekyll-blog jekyll-site jekyll-template jekyll-theme jekyll-themes minimal-theme portfolio theme yaml-parameters
Last synced: 1 day ago
JSON representation
Minimal theme for blog and portfolio
- Host: GitHub
- URL: https://github.com/rohitjain00/dev-portfolio-blog
- Owner: rohitjain00
- License: mit
- Created: 2020-02-18T18:06:08.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-08-09T12:53:08.000Z (5 months ago)
- Last Synced: 2024-12-14T08:03:56.873Z (9 days ago)
- Topics: blog, blog-theme, github-pages, github-pagespeed, html-css-javascript, jekyll, jekyll-blog, jekyll-site, jekyll-template, jekyll-theme, jekyll-themes, minimal-theme, portfolio, theme, yaml-parameters
- Language: HTML
- Homepage: https://therohitjain.com/dev-portfolio-blog/
- Size: 434 KB
- Stars: 106
- Watchers: 1
- Forks: 96
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
Awesome Lists containing this project
README
[](https://opensource.org/licenses/MIT)
[](https://badge.fury.io/rb/dev-portfolio-blog)
[](https://www.codefactor.io/repository/github/rohitjain00/dev-portfolio-blog)
[](https://www.codacy.com/manual/rohitjain00/dev-portfolio-blog?utm_source=github.com&utm_medium=referral&utm_content=rohitjain00/dev-portfolio-blog&utm_campaign=Badge_Grade)
[](https://hits.seeyoufarm.com)
## Home pagespeed
## Blog pagespeed
# dev-portfolio-blog
This is a minimal jekyll theme for writing blogs and about yourself.
## features
1. Google Analytics
2. Many themes such as: Default, Solarized, and Sepia. All in light and dark modes.
3. Disqus comments
4. Categorization
5. Emojis Support
6. Highly optimized blog
#### PageSpeed Insights
* [Home](https://developers.google.com/speed/pagespeed/insights/?url=https%3A%2F%2Ftherohitjain.com)[(therohitjain.com)](https://therohitjain.com)
* [Blog](https://developers.google.com/speed/pagespeed/insights/?url=https%3A%2F%2Ftherohitjain.com/blog/)[(therohitjain.com/blog/)](https://therohitjain.com/blog/)
* [About](https://developers.google.com/speed/pagespeed/insights/?url=https%3A%2F%2Ftherohitjain.com/about/)[(therohitjain.com/about/)](https://therohitjain.com/about/)
## Desktop Preview
## Mobile Preview
## Installation
Add this line to your Jekyll site's `Gemfile`:
```ruby
gem "dev-portfolio-blog"
```
And add this line to your Jekyll site's `_config.yml`:
```yaml
theme: dev-portfolio-blog
```
And then execute:
$ bundle install
Or install it yourself as:
$ gem install dev-portfolio-blog
## Usage
To start using the theme you either follow these steps or simply fork my repo https://github.com/rohitjain00/rohitjain00.github.io and update the files.
### Recommended
Please use the theme as the plugin so that all the latest updated for this theme comes directly in your website.
#### Clone the branch `master` and change the theme accordingly.
### Starting from the beginning:
Assuming that you started your first website based on `minima` theme from [here](https://jekyllrb.com/docs/)
1. Add a `favicon.ico` to the root directory for favicon.
2. Create `blog.md` in the root folder ans set its yaml parameters to
```yaml
layout: blog
permalink: /blog/
title: [Blog Page Title]
pagination:
enabled: true
```
3. Change your `about.md` yaml parameters to following
```yaml
layout: description
permalink: /about/
title: About
```
3. In the `index.md` file add
```yaml
layout: home
home_text: Text
title: [Home Page Title]
```
4. Create a new `categories.md` file in root with following yaml parameters
```yaml
layout: categories
permalink: /categories/
title: Categories
```
4. In the `_config.yml` file add following and change accordingly
Path is relative to the root directory
```yaml
resume_url: [PATH_TO_RESUME]
author_name: [YOUR_NAME]
description: [SITE_DESCRIPTION]
url: [WEBSITE_URL]
google_analytics: '[google analytics Id]'
disqus:
shortname: [discus-shotname]
```
### Minifier
Visit [Jekyll-minifier](https://github.com/digitalsparky/jekyll-minifier) and add this to your `_config.yml` file to enable minifier.
### Pagination
Visit [jekyll-paginate-v2](https://github.com/sverrirs/jekyll-paginate-v2/blob/master/README-GENERATOR.md#site-configuration) and add this to your `_config.yml` file to enable pagination.
### Check here [_config.yml](https://github.com/rohitjain00/rohitjain00.github.io/blob/site/_config.yml) for example config file.
## Writing a new blog
Create a new folder `_posts` in root folder if not already exists.
1. Create a new markdown file in the format `yyyy-mm-dd-postname.md`
2. Make sure that disqus's shortname is valid.
3. Add yaml configuartion to the post
```yaml
---
layout: post
comments: [true | false]
title: Hello World
categories: [category1, category2]
---
Post Text.
```
## Troubleshooting
- ` Could not find a JavaScript runtime. See https://github.com/rails/execjs for a list of available runtimes`
Node JS is missing from your system. In ubuntu install using `sudo apt-get install nodejs` or refer to [this](https://stackoverflow.com/questions/9202324/execjs-could-not-find-a-javascript-runtime-but-execjs-and-therubyracer-are-in)
## Contributing
Bug reports and pull requests are welcome on GitHub at This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
## Development
To set up your environment to develop this theme, run `bundle install`.
Your theme is setup just like a normal Jekyll site! To test your theme, run `bundle exec jekyll serve` and open your browser at `http://localhost:4000`. This starts a Jekyll server using your theme. Add pages, documents, data, etc. like normal to test your theme's contents. As you make modifications to your theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal.
When your theme is released, only the files in `_layouts`, `_includes`, `_sass` and `assets` tracked with Git will be bundled.
To add a custom directory to your theme-gem, please edit the regexp in `dev-portfolio-blog.gemspec` accordingly.
### Read about the themes and how it's implemented [here](https://github.com/rohitjain00/dev-portfolio-blog/wiki/Theme-Management)
## License
The theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
If you like my work, you can buy me a coffee here :smile:
