├── .gitignore
├── Gemfile
├── LICENSE.txt
├── README.md
├── _config.yml
├── _data
└── menu.yml
├── _includes
├── footer.html
├── header.html
└── sidebar-content.html
├── _layouts
├── default.html
├── page.html
└── post.html
├── _posts
├── 2016-08-02-testing-pages.md
├── 2016-08-07-more-pages.md
├── 2016-09-06-another-post.md
└── 2016-09-07-example-post.md
├── _sass
└── rlstevenson.scss
├── index.html
└── static
├── css
├── bootstrap.css
├── bootstrap.min.css
└── rlstevenson.scss
├── fonts
├── glyphicons-halflings-regular.eot
├── glyphicons-halflings-regular.svg
├── glyphicons-halflings-regular.ttf
├── glyphicons-halflings-regular.woff
└── glyphicons-halflings-regular.woff2
└── js
├── bootstrap.js
└── bootstrap.min.js
/.gitignore:
--------------------------------------------------------------------------------
1 | _site
2 | Gemfile.lock
3 | .sass-cache
4 | *.gem
5 | *.gemspec
6 |
--------------------------------------------------------------------------------
/Gemfile:
--------------------------------------------------------------------------------
1 | source "https://rubygems.org"
2 | gemspec
3 | gem 'jekyll-paginate'
--------------------------------------------------------------------------------
/LICENSE.txt:
--------------------------------------------------------------------------------
1 | The MIT License (MIT)
2 |
3 | Copyright (c) 2016 ExchangeRate-API
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in
13 | all copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21 | THE SOFTWARE.
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # RLStevenson - Bootstrap Clone of Hyde
2 |
3 | RLStevenson was built for people who like the original Jekyll theme [Hyde](https://github.com/poole/hyde) but would like to use [Bootstrap](http://getbootstrap.com).
4 |
5 | The theme was built from an empty Bootstrap 3 template with the goal of easy modification for end users. The code is as simple as possible - clearly formatted HTML and a single stylesheet. It's a two column responsive design and currently includes version 3.3.7 of Bootstrap.
6 |
7 | Pull requests are welcome.
8 |
9 | 
10 |
11 | ## Installation
12 |
13 | Add this line to your Jekyll site's Gemfile:
14 |
15 | ```ruby
16 | gem "rlstevenson-jekyll-theme"
17 | ```
18 |
19 | And add this line to your Jekyll site:
20 |
21 | ```yaml
22 | theme: rlstevenson-jekyll-theme
23 | ```
24 |
25 | And then execute:
26 |
27 | $ bundle
28 |
29 | Or install it yourself as:
30 |
31 | $ gem install rlstevenson-jekyll-theme
32 |
33 | The Ruby Gem page is here: [rlstevenson-jekyll-theme](https://rubygems.org/gems/rlstevenson-jekyll-theme)
34 |
35 | ## Usage & Config Options
36 |
37 | There are a number of options you can set in your `_config.yml` file.
38 |
39 | The `description` variable will appear after the Title of your site in your `
` meta tag:
40 |
41 | description: 'A two coloumn blog theme built with Bootstrap for Jekyll.'
42 |
43 | ### Sidebar
44 |
45 | The `description` variable will also appear below the title in your sidebar.
46 |
47 | The `freetext` will appear in a free paragraph below the Title & sidebarDescription and above the menu links. Set it to "" if you don't want it.
48 |
49 | freetext: 'A optional paragraph of free text. Set to blank in _config.yml to clear...'
50 |
51 | ### Sidebar Menu Links
52 |
53 | Take a look at `_data/menu.yml` file to see how you can add menu items to your sidebar.
54 |
55 | ### Pagination
56 |
57 | Simply set the `paginate:` option in your `_config.yml` file to the number of articles you want to show per page. You may need to use the `bundle install` command with Jekyll 3 to make sure you have the `jekyll-paginate` gem.
58 |
59 | Alternatively you can disable pagination by not including the `paginate:` option.
60 |
61 | ### Color Schemes
62 |
63 | In keeping with our attempt to replicate the original Hyde in Bootstrap we've included some colour scheme options. These are not the same as in the original, but we used palettes from the same [Base16](https://github.com/chriskempson/base16) project.
64 |
65 | 
66 |
67 | Using a theme is as simple as changing the `colorscheme` param in your `_config.yml`.
68 |
69 | The themes are:
70 |
71 | - Dark Brown (`colorscheme: 'scheme-darkbrown'`)
72 | - Light Brown (`colorscheme: 'scheme-lightbrown'`)
73 | - Green (`colorscheme: 'scheme-green'`)
74 | - Orange (`colorscheme: 'scheme-orange'`)
75 | - Slate (`colorscheme: 'scheme-slate'`)
76 |
77 | And then a bonus theme that isn't from Base16:
78 |
79 | - Gulf Racing (`colorscheme: 'scheme-gulfracing'`)
80 |
81 | #### Creating Your Own Color Scheme
82 |
83 | To create your own custom color scheme simply scroll to the end of the `rlstevenson.scss` stylesheet in the `_sass` folder and edit the template we've left there.
84 |
85 | We'll happily accept pull requests for quality color schemes.
86 |
87 | ### Analytics
88 |
89 | This theme supports GA & Piwik integration.
90 |
91 | For Google Analytics, simply set your UA number in your `_config.yml` file. Example:
92 |
93 | ga: 'UA-123-456'
94 |
95 | For Piwik, use the following two variables:
96 |
97 | piwikSiteID: ''
98 | piwikURL: ''
99 |
100 | ## Example Config
101 |
102 | Here is a full example `_config.yml`:
103 |
104 | ##
105 | # RLStevenson Theme Options
106 | ####
107 |
108 | title: RLStevenson
109 | description: 'A Bootstrap based clone of the Hyde theme by mdo.'
110 | freetext: 'Released under an MIT license - feel free to make pull requests.'
111 | url: /
112 | baseurl: /
113 | paginate: 5
114 | version: 0.1.0
115 | colorscheme: scheme-lightbrown
116 |
117 | ga: 'UA-123-456'
118 | piwikSiteID: ''
119 | piwikURL: ''
120 |
121 | author:
122 | url: https://www.exchangerate-api.com
123 | name: 'ExchangeRate-API'
124 |
125 | gems: [jekyll-paginate]
126 |
127 | exclude: ['README.md', 'Gemfile.lock', 'Gemfile', 'rlstevenson.gemspec']
128 |
129 |
130 | ## Author
131 |
132 | **ExchangeRate-API.com**
133 |
134 | -
135 | -
136 |
137 | #### RLStevenson Uses Bootstrap
138 |
139 | **Bootstrap**
140 |
141 | -
142 |
143 |
144 | ## Inspired By
145 |
146 | **Mark Otto** - creator of the Hyde theme
147 |
148 | -
149 | -
150 |
151 |
152 | ## Contributing
153 |
154 | Bug reports and pull requests are welcomed.
155 |
156 |
157 | ## License
158 |
159 | The theme is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
--------------------------------------------------------------------------------
/_config.yml:
--------------------------------------------------------------------------------
1 |
2 | ##
3 | # RLStevenson Theme Options
4 | ####
5 |
6 | # For baseurl:
7 | # Use '' for / or '/your-dir' for another directory
8 |
9 | title: RLStevenson
10 | description: 'A Bootstrap based clone of the Hyde theme by mdo.'
11 | freetext: 'Released under an MIT license - feel free to make pull requests.'
12 | baseurl: '/'
13 | paginate: 3
14 | version: 0.1.0
15 | colorscheme: scheme-gulfracing
16 |
17 | ga: 'UA-123-456'
18 | piwikSiteID: ''
19 | piwikURL: ''
20 |
21 | author:
22 | url: https://www.exchangerate-api.com
23 | name: 'ExchangeRate-API'
24 |
25 | github:
26 | repo: https://github.com/ExchangeRate-API/rlstevenson-jekyll-theme
27 |
28 | gems: [jekyll-paginate]
29 |
30 | exclude: ['README.md', 'Gemfile.lock', 'Gemfile', '*.gemspec', '*.gem']
31 |
--------------------------------------------------------------------------------
/_data/menu.yml:
--------------------------------------------------------------------------------
1 | - text: ExchangeRate-API
2 | url: /
3 |
4 | - text: Jekyll
5 | url: https://jekyllrb.com
6 |
7 | - text: Bootstrap
8 | url: http://getbootstrap.com
9 |
10 | - text: Hyde
11 | url: https://github.com/poole/hyde
--------------------------------------------------------------------------------
/_includes/footer.html:
--------------------------------------------------------------------------------
1 |
2 | {% if site.piwikSiteID != '' %}
3 | {% if site.piwikURL != '' %}
4 |
5 |
6 |
18 |
19 |
20 | {% endif %}
21 | {% endif %}
22 |
23 | {% if site.ga != '' %}
24 |
25 |
36 |
37 | {% endif %}
38 |
39 |
40 |
41 |
42 |
43 |
44 |