/joshbushdash.github.io

An emotional and adorable blog theme powered by Jekyll.

Primary LanguageSCSSMIT LicenseMIT

CI License: MIT Jekyll Jekyll Jekyll Themes Shield

Satellite🛰️ - Jekyll blog theme

An emotional and adorable blog theme powered by Jekyll.

Live demo is available here

Demo Page

Light Mode

Demo Page-light

Dark Mode

Demo Page-dark

Fresh and Attractive Design



Features

  • Comment System using giscus
  • Copy contents of Code Block
  • Dark/Light Theme
  • Google Analytics
  • Hierarchical Categorization
  • Mobile friendly design
  • Related Posts
  • RSS/Sitemap support
  • Search Post by Title or Tags
  • Syntax Highlighter (highlight.js)
  • Table of Contents
  • Visitor Counter (goatcounter)

Installation

There are two ways to setup this theme:

Method 1: Build from source (Recommended)

Fork this repository or download the source as a zip.

If you use as destination a repository named USERNAME.github.io, then your url will be https://USERNAME.github.io/.

Method 2: Utilize Gem package

Create a clean site directory (Follow the Instruction 1~4 described here).

The following materials are redundant, so remove them.

  • index.markdown
  • about.markdown

Then, add this line to your Jekyll site's Gemfile:

gem "jekyll-theme-satellite"

You need to replace the initial _config.yml file with the prepared one.

Modify your site setting

Now fill in the site variable such as blog name, profile image, and social accounts in _config.yml.

title: Example.com
description: "Satellite - jekyll blog theme"
logo_img: "/assets/img/favicon.webp"
profile_img: "/assets/img/profile.jpg"

# Social Links
email: example@gmail.com
github_username: github
twitter_username: twitter
instagram_username: instagram
linkedin_username: linkedin
facebook_username: facebook

Run site locally

From the site root directory, install the dependencies:

bundle install

Start a Jekyll service.

bundle exec jekyll serve

Now open http://localhost:4000 in your browser.

Customizing

You can find useful manuals for customizing your site from the below table:

Posting guidelines link
Enabling comment system link
Enabling Visitor counter link

Contribution

If you would like to report a bug or request a new feature, please open an issue We are open to any kind of feedback or collaboration.

License

© 2024 Yankos. This theme is available as open source under the terms of the MIT License.