You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
If you're running Jekyll v3.3+ and self-hosting you can quickly install the
62
-
theme as Ruby gem. If you're hosting with GitHub Pages you'll have to use the
63
-
"repo fork" method or directly copy all of the theme files (see
64
-
[structure](#structure)below) into your project.
71
+
If you're running Jekyll v3.5+ and self-hosting you can quickly install the
72
+
theme as a Ruby gem. If you're hosting with GitHub Pages you can install as a
73
+
remote theme or directly copy all of the theme files (see[structure](#structure)
74
+
below) into your project.
65
75
66
76
### Ruby Gem Method
67
77
68
-
1.Install the theme as a Ruby Gem by adding it to your `Gemfile` like so:
78
+
1.Add this line to your Jekyll site's `Gemfile`:
69
79
70
80
```ruby
71
81
gem "jekyll-theme-basically-basic"
72
82
```
73
-
74
-
2. Fetch and update your bundled gems by running the following
75
-
[Bundler](http://bundler.io/) command:
76
-
77
-
```bash
78
-
bundle
79
-
```
80
-
81
-
3. Set the `theme` in your project's Jekyll configuration, `_config.yml`:
83
+
2. Add this line to your Jekyll site's `_config.yml` file:
82
84
83
85
```yaml
84
86
theme: jekyll-theme-basically-basic
85
87
```
86
88
87
-
### GitHub Pages Method
89
+
2. Then run [Bundler](http://bundler.io/) to install the theme gem and dependencies:
90
+
91
+
```terminal
92
+
bundle install
93
+
```
88
94
89
-
If you're hosting with GitHub Pages follow these steps instead:
95
+
### GitHub Pages Method
90
96
91
-
Replace `gem "jekyll"` with:
97
+
GitHub Pages has added [full support](https://github.com/blog/2464-use-any-theme-with-github-pages)
98
+
for any GitHub-hosted theme.
92
99
93
-
```ruby
94
-
gem "github-pages", group: :jekyll_plugins
95
-
```
100
+
1. Replace `gem "jekyll"` with:
96
101
97
-
Run `bundle update` and verify that all gems install properly.
102
+
```ruby
103
+
gem "github-pages", group::jekyll_plugins
104
+
```
98
105
99
-
Add `remote_theme: "mmistakes/jekyll-theme-basically-basic"` to your `_config.yml` file.
106
+
2. Run `bundle update` and verify that all gems install properly.
100
107
101
-
Then add [`jekyll-remote-theme`](https://github.com/benbalter/jekyll-remote-theme) to the `plugins` (previously gems) array in your `_config.yml` file like so:
108
+
3. Add `remote_theme: "mmistakes/jekyll-theme-basically-basic"` to your
109
+
`_config.yml` file. Remove any other `theme:` or `remote_theme:` entries.
102
110
103
-
```yaml
104
-
plugins:
105
-
- jekyll-remote-theme
106
-
```
107
-
108
-
Remove any other `theme:` or `remote_theme:` entry.
111
+
---
109
112
110
-
**Note:** Your Jekyll site should be viewable immediately at <http://USERNAME.github.io>. If it's not, you can force a rebuild by **Customizing Your Site** (see below for more details).
113
+
**Note:** Your Jekyll site should be viewable immediately at
114
+
<http://USERNAME.github.io>. If it's not, you can force a rebuild by
115
+
**Customizing Your Site** (see below for more details).
111
116
112
-
If you're hosting several Jekyll based sites under the same GitHub username you will have to use Project Pages instead of User Pages. Essentially you rename the repo to something other than **USERNAME.github.io** and create a `gh-pages` branch off of `master`. For more details on how to set things up check [GitHub's documentation](https://help.github.com/articles/user-organization-and-project-pages/).
117
+
If you're hosting several Jekyll based sites under the same GitHub username you
118
+
will have to use Project Pages instead of User Pages. Essentially you rename the
119
+
repo to something other than **USERNAME.github.io** and create a `gh-pages`
120
+
branch off of `master`. For more details on how to set things up check
0 commit comments