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-readonlyAnd then execute:
bundle updateOnce 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