alembic-jekyll-theme 0.0.4 → 0.0.5
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +26 -6
- metadata +1 -1
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 6bd815dc74387448ea4655f0677ffec278b35598
|
4
|
+
data.tar.gz: 324115be18610d4575d0af258e210523d35c57f7
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: cf66d6c1eba8be17f90158f61878edbf67782c60b27818dd2b912286b9a967e6e0498659ac406e4ad8ca25dc1109a20958b0e6f6fc143a64e6073725f5c254f5
|
7
|
+
data.tar.gz: 9cbfbccaf6d1fd2cf58dd7564563e60cb6392dcc5a72b587f489b8bdc36304be3aa94dd262893d0344be6e84804e66c4901ecc6ec315e2e7c2898c1a0c92991d
|
data/README.md
CHANGED
@@ -1,5 +1,5 @@
|
|
1
1
|
# [Alembic](https://alembic.darn.es/)
|
2
|
-
⚗ A Jekyll boilerplate designed to be a starting point for any Jekyll website.
|
2
|
+
⚗ A Jekyll boilerplate theme designed to be a starting point for any Jekyll website.
|
3
3
|
|
4
4
|
![Screenshot](https://raw.githubusercontent.com/daviddarnes/alembic/master/screenshot.png)
|
5
5
|
|
@@ -8,7 +8,7 @@
|
|
8
8
|
- [Features](#features)
|
9
9
|
- [Installation](#installation)
|
10
10
|
- [Configuration](#configuration)
|
11
|
-
- [Gem settings](#gem-settings)
|
11
|
+
- [Gem dependency settings](#gem-dependency-settings)
|
12
12
|
- [Site settings](#site-settings)
|
13
13
|
- [Site navigation](#site-navigation)
|
14
14
|
- [Using includes](#using-includes)
|
@@ -18,10 +18,11 @@
|
|
18
18
|
|
19
19
|
## About
|
20
20
|
|
21
|
-
Alembic is a starting point for [Jekyll](https://jekyllrb.com/) projects. Rather than starting from scratch, this boilerplate is designed to get the ball rolling immediately.
|
21
|
+
Alembic is a starting point for [Jekyll](https://jekyllrb.com/) projects. Rather than starting from scratch, this boilerplate is designed to get the ball rolling immediately. Install it, configure it, tweak it, push it.
|
22
22
|
|
23
23
|
## Features
|
24
24
|
|
25
|
+
- Available as a starter kit or as [Jekyll 3.3 theme gem](http://jekyllrb.com/docs/themes/)
|
25
26
|
- Tested in all major browsers, that includes IE as well as Edge
|
26
27
|
- Extensive set of shortcodes to include various elements; such as buttons, icons, figure images and more
|
27
28
|
- Solid typographic framework from [Sassline](https://sassline.com/)
|
@@ -36,18 +37,37 @@ Alembic is a starting point for [Jekyll](https://jekyllrb.com/) projects. Rather
|
|
36
37
|
|
37
38
|
## Installation
|
38
39
|
|
40
|
+
### As a boilerplate kit
|
41
|
+
|
39
42
|
1. Fork the repo
|
40
43
|
2. Clone down the repo with `$ git clone git@github.com:username/reponame.git`
|
41
|
-
3.
|
42
|
-
4.
|
44
|
+
3. Delete the `demo/` folder, `alembic-jekyll-theme.gemspec` and `screenshot.png` files
|
45
|
+
4. Open the `/_config.yml` file and change details to your own project details
|
46
|
+
5. Change the `CNAME` record to your projects' record
|
47
|
+
6. Install GitHub Pages locally with `$ gem install github-pages`
|
48
|
+
7. Run Jekyll from inside the the root of the repo using `$ jekyll serve --watch`
|
49
|
+
8. Begin hacking for your project
|
50
|
+
|
51
|
+
### As a Jekyll 3.3 theme gem
|
52
|
+
|
53
|
+
1. Install the gem with `$ gem install alembic-jekyll-theme`
|
54
|
+
2. Download the starter `/demo` content, [quick download link](https://minhaskamal.github.io/DownGit/#/home?url=https://github.com/daviddarnes/alembic/tree/master/demo)
|
55
|
+
3. Customise demo content to your project content
|
56
|
+
4. Open the `/_config.yml` file and change details to your own project details
|
43
57
|
5. Run Jekyll from inside the the root of the repo using `$ jekyll serve --watch`
|
44
58
|
6. Begin hacking for your project
|
45
59
|
|
60
|
+
### Boilerplate & Theme differences
|
61
|
+
|
62
|
+
The boilerplate kit is better for more drastic hacking and changes, a project that's quite different to any other and needs a lot of custom work done. Additionally, you'll only be able to use this method if you want to host it on GitHub Pages, as themes can't be submitted so [this one hasn't been approved](https://pages.github.com/themes/)... yet.
|
63
|
+
|
64
|
+
Using the theme will allow you to receive updates made and will be more programmatic. To make your own changes you'll need to overwrite the files with your own. For example: If I want to change the colours of my site I'll need to copy the [`_colors.scss`](https://github.com/daviddarnes/alembic/blob/master/_sass/_colors.scss) file and create my own in `_sass/colors.scss` with my own changes. This is the same for all files within the theme, which means your own project will be more lean than if you were to use the boilerplate.
|
65
|
+
|
46
66
|
## Configuration
|
47
67
|
|
48
68
|
There's a number of settings you'll need to change before you can start hacking away at files. Here's a run down of what you'll need to change:
|
49
69
|
|
50
|
-
### Gem settings
|
70
|
+
### Gem dependency settings
|
51
71
|
`twitter`, `author` and `social` values will need to be changed to the projects' social information or removed. Look for the `Gem settings` comment within the `/_config.yml` file. These values are for the [jekyll-seo-tag](https://github.com/jekyll/jekyll-seo-tag) - follow the link to find out more.
|
52
72
|
|
53
73
|
### Site settings
|