This is a Jekyll theme based on the Read Only style, created by HTML5 UP.
There is a live demo of this theme.
I have also created an experimental color, which I use on my website DigitalAdapt.com; which can be used by appending , branch: 'experimental'
to the gem line below.
Add this line to your Jekyll site's Gemfile
:
gem "html5up-readonly", "~> 0.1", git: 'https://github.com/digitaladapt/html5up-readonly'
And add this line to your Jekyll site's _config.yml
:
theme: html5up-readonly
And then execute:
bundle update
Once installed into your Jekyll website, it should mostly just work, like any other theme, including the default.
To run your site locally call bundle exec jekyll serve
and open your browser at http://localhost:4000
. This starts a Jekyll server complete with theme. Add pages, documents, data, etc. and see how things look. As you make modifications to your site content , your site will regenerate and you should see the changes in the browser after a refresh.
Bug reports and pull requests are welcome on GitHub at https://github.com/digitaladapt/html5up-readonly. 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.
The theme is available as open source under the terms of the MIT License.
Within your _config.yml
file, you can specify a number of options to customize the theme.
# Base Settings
title: Your awesome title
#author: Some User
email: your-email@domain.com
description:
Write an awesome description for your new site here. You can edit this
line in _config.yml. It will appear in your document head meta (for
Google search results) and in your feed.xml site description.
# Site URL
url: "https://theme.digitaladapt.com"
baseurl: /
lang: en
# Matomo Tracking
# matomo_url: "://track.tld"
# matomo_siteId: 1
# google_analytics: "G-XXXXXXXXXX"
# Contact Me About This Page
page_contact: false
# Excerpts
show_excerpts: true
excerpt_separator: <!--more-->
# Avatar, image location override, default /images/avatar.jpg
# avatar: /images/avatar.jpg
# Banner, default location override, default /images/banner.jpg
# this can also be overridden on a per page basis.
# banner: /images/banner.jpg
# Social Links
rss: rss
#twitter_username: digitaladapt
github_username: digitaladapt
#bitbucket_username: digitaladapt
# "Copy ID" from user menu, may need to enable developer mode to see option
#discord_id_number: "570971366833127425"
#discord_username: "DigitalAdapt#8238"
#keybase_username: digitaladapt
# instagram_username: digitaladapt
# dribbble_username: digitaladapt
# facebook_username: digitaladapt
# flickr_username: digitaladapt
# linkedin_username: digitaladapt
# reddit_username: digitaladapt
# pinterest_username: digitaladapt
# youtube_username: digitaladapt
# googleplus_username: +digitaladapt
# Mastodon Instances
# mastodon:
# - username: digitaladapt
# instance: example.com
# custom additions to head/body
# for example, this style will put the page heading on top of the banner image.
#custom_head_html: '<style> header.major h1 { margin-top: -3em !important; position: relative; } </style>'
#custom_body_html: '<script> console.log("you can add stuff here."); </script>'
# Build Settings
# default destination is "_site"
#destination: public
plugins:
- jekyll-feed
- jekyll-seo-tag