jekyll-theme-profile
This theme is based on GitHub's primer style. It supports both light and dark modes, and four style options: appbar, sidebar, topbar, and stacked. Setting up is a breeze, as it automatically populates your profile using your GitHub user info. Add custom links like Linktree and share engaging blog posts effortlessly.
Installation
Add this line to your Jekyll site's Gemfile:
gem "jekyll-theme-profile"
And add this line to your Jekyll site's _config.yml:
theme: jekyll-theme-profile
And then execute:
$ bundle
Or install it yourself as:
$ gem install jekyll-theme-profile
Usage
Start with a sample config that you can copy and customize.
You can also use this with github acions. Below is a typical worfklow file
# Sample workflow for building and deploying a Jekyll site to GitHub Pages
name: Docs
on:
# Runs on pushes targeting the default branch
push:
branches: ["main"]
# Run on every pull request
pull_request:
types: [opened, reopened, synchronize ]
# Allows you to run this workflow manually from the Actions tab
workflow_dispatch:
schedule:
# This will refresh your repositories and other user information every day
# * is a special character in YAML so you have to quote this string
# Generate from https://crontab.guru/
# ┌───────────── minute (0 - 59)
# │ ┌───────────── hour (0 - 23)
# │ │ ┌───────────── day of the month (1 - 31)
# │ │ │ ┌───────────── month (1 - 12 or JAN-DEC)
# │ │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT)
# │ │ │ │ │
# │ │ │ │ │
# │ │ │ │ │
# * * * * *
- cron: "0 0 * * *"
# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
permissions:
contents: read # needed to read your repository
pages: write # needed to enable and deploy github pages
id-token: write
# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
concurrency:
group: "pages"
cancel-in-progress: false
jobs:
# Build job
build:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v3
- name: Setup Ruby
uses: ruby/[email protected]
with:
bundler-cache: true # runs 'bundle install' and caches installed gems automatically
- name: Setup Pages
id: pages
uses: actions/configure-pages@v3
with:
enablement: true # Enable github pages if it's not
- name: Build
run: bundle exec jekyll build
env:
JEKYLL_ENV: production
JEKYLL_GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
- name: Upload artifact
uses: actions/upload-pages-artifact@v3
# Deployment job
deploy:
if: github.ref == 'refs/heads/main' # Only deploy from the main branch
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
runs-on: ubuntu-latest
needs: build
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v4
Choose your style
Select the default style for your theme by adding style to your config file:
style: sidebar # One of "stacked", "sidebar", "topbar", "appbar"
You can also set the style of a particular page by adding style to your frontmatter.
---
style: sidebar # One of "stacked", "sidebar", "topbar", "appbar
---
Sidebar
Stacked
Topbar
Appbar
Background
You can even change the background by adding the following to your _config.yml file.
background:
image: /media/background-img.jpg
overlay: rgba(0, 0, 0, 0.5) # Overlay for both light and dark styles
or
background:
image: /media/background-img.jpg
light: # custom overlay for light and dark styles
overlay: rgba(255, 255, 255, 0.5)
dark:
overlay: rgba(0, 0, 0, 0.5)
Header
You can change the header color by adding the following to your _config.yml file
header:
color: "#4051b5"
text: "rgba(255,255,255,0.7)"
accent: "#ffffff"
Nav
In the nav section, you can add navigation links that will show up on every page of your website.
{: .border}
nav:
- name: Topbar
url: /demo/topbar.html
- name: Sidebar
url: /demo/sidebar.html
- name: Stacked
url: /demo/stacked.html
Links
In the links section, you can add links to showcase various pages on the web or your website.
{: .border}
links:
- name: Example full entry
url: https://www.example.com
thumbnail: /media/icon-topbar.png
description: Example description
- name: Example entry with url and image
url: https://www.example.com
thumbnail: /media/icon-sidebar.png
- name: Example entry with image
thumbnail: /media/icon-stacked.png
- name: Example entry with description
description: Example Description
- name: Example entry with only a name
Repositories
The repositories section allows you to display your GitHub repositories on your page. You can sort them by stars or latest pushes, set a limit to the number of repositories displayed, and exclude archived, forked, or specific repositories from the list
{: .border}
repositories:
sort_by: stars
# sort_by options:
# - pushed
# - stars
limit: 24
exclude:
archived: true
forks: true
repositories:
# - respositories to exclude
Social media and SEO
Setting the social media card
You can set the social media image for your site with the setting
image: /screenshot.jpg
This works on both yaml frontmatter for a page and in the _config.yml file. Page settings will override site settings.
Set the default for posts through the default settings in the _config.yml file.
defaults:
- scope:
path: "" # an empty string here means all files in the project
type: "posts"
values:
layout: "post"
permalink: /blog/:year/:month/:day/:title.html
image: /assets/img/default.png # The default image used for social and posts.
toc: true
Adding your socials
Utilize the social_media section to add links to your various social media profiles. For each platform simply provide your username or user ID to have the corresponding icon and link appear on your profile.
{: .border}
social_media:
behance: your_username
dribbble: your_username
docker: your_username
facebook: your_username
github: your_username
hackerrank: your_username
instagram: your_username
keybase: your_username
linkedin: your_username
mail: email@address
mastodon: your_username
medium: your_username
stackoverflow: your_user_id
telegram: your_username
threads: your_username
tiktok: your_username
twitter: your_username
unsplash: your_username
vk: your_username
vscode: your_username
youtube: your_username
x: your_username
You can also set the icon color. If you don't set an icon color, the original icon colors will be used.
icon_color: "#959da5"
Blog timeline
Make entries for the blog the same way you normally would by placing entries in the _posts folder. You can adjust the number of entries that show up in the main page by adjusting posts_limit in the _config.yml file. If you have paginate installed and more posts than the limit, a Read more button will link to the paginated blog post page /blog/index.html.
{: .border}
posts_limit: 3
Additionally, the theme provides a paginate layout you can use.
To use, add gem jekyll-paginate to your gemfile and the following lines to your _config.yml
paginate: 6
paginate_path: "/blog/page:num"
And adding a index.html page at the pagenate_path
---
layout: paginate
title: My Blog
---
Custom styles
Site style
You can override any style with styles defined in /assets/css/style.css or /assets/css/style.scss files. This is to support config based styling which needs jekyll variables.
Page style
You can add css to any page through the css_style variable in front matter.
---
css_style: |
.Link-btn {
background: rgba(0.1, 0.1, 0.1, 0.4);
color: #FFFF;
}
h1 {
color: #FFFF;
}
---
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/athackst/jekyll-theme-profile. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
See Contributing for more information on contributing to this theme.
License
The theme is available as open source under the terms of the MIT License.
