jekyll-theme-image-grid 0.1.2 → 1.0.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/LICENSE.txt +0 -0
- data/README.md +107 -38
- data/_config.yml +2 -2
- data/_includes/bootstrap-scripts.html +3 -0
- data/_includes/bootstrap-style.html +1 -0
- data/_includes/head.html +1 -1
- data/_layouts/default.html +1 -3
- data/_layouts/{grid.html → home.html} +0 -0
- data/_layouts/page.html +1 -2
- data/_layouts/post.html +0 -0
- data/_sass/style.scss +0 -0
- data/assets/minima-social-icons.svg +0 -0
- data/assets/style.scss +0 -0
- metadata +36 -14
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 4d6db0af9fc76c6aad9feac3c45086fb834108c07ff51d3fbcbfab824dc4ad3e
|
|
4
|
+
data.tar.gz: 76cde1c18da8e7a78d819dc914043f5b8dd90db8bf1b342edbf7ae5d7c0b1cfc
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 397009b7152f781f3a74d6044eb8b266c7dbc35f7679edd7f21d2f93f52a289e2b4991b10c3eaabafcf1f2d8cefd0e3ec9c5600414a92bd067243c3b9f581ca9
|
|
7
|
+
data.tar.gz: 23b42c65b357b47159ca9643bb0bf7ba36040d9f1cd586edccc9ea497c5d68327f83b80f43eb332c782f7b95fa72eca6bc8ccf1fc1d0525f7d87c99b296adf80
|
data/LICENSE.txt
CHANGED
|
File without changes
|
data/README.md
CHANGED
|
@@ -1,17 +1,29 @@
|
|
|
1
1
|
# jekyll-theme-image-grid
|
|
2
2
|
|
|
3
|
-
A simple responsive image grid theme for displaying image-based content with various built-in customization options.
|
|
3
|
+
A simple responsive image grid theme for displaying image-based content with various built-in customization options.
|
|
4
|
+
|
|
5
|
+
- [Live example site](http://www.jzhong.today/image-grid-example/)
|
|
6
|
+
- [Example site repository](https://github.com/jirrian/image-grid-example)
|
|
7
|
+
- [In-depth installation tutorial](https://pages.virtualgoodsdealer.com/articles/2021/01/21/simple-website-tutorial-part-three/)
|
|
4
8
|
|
|
5
9
|
|
|
6
10
|
|
|
11
|
+
## Dependencies
|
|
12
|
+
|
|
13
|
+
This theme uses the jekyll plugin [jekyll-seo-tag](https://github.com/jekyll/jekyll-seo-tag).
|
|
14
|
+
|
|
15
|
+
This theme also uses [Bootstrap 4](https://getbootstrap.com/docs/4.6/getting-started/introduction/). Edit the files `_includes/bootstrap-scripts.html` and `_includes/bootstrap-style.html` to change the Bootstrap version.
|
|
16
|
+
|
|
7
17
|
## Installation
|
|
8
18
|
|
|
19
|
+
### Github Pages remote theme method
|
|
20
|
+
|
|
9
21
|
[Create a new Jekyll site.](https://jekyllrb.com/docs/#instructions)
|
|
10
22
|
|
|
11
23
|
Add this line to your Jekyll site's `Gemfile`:
|
|
12
24
|
|
|
13
25
|
```ruby
|
|
14
|
-
gem "
|
|
26
|
+
gem "github-pages", group: :jekyll_plugins
|
|
15
27
|
```
|
|
16
28
|
And then execute:
|
|
17
29
|
|
|
@@ -20,50 +32,56 @@ And then execute:
|
|
|
20
32
|
To use this theme with Github Pages, add this line to your Jekyll site's `_config.yml`:
|
|
21
33
|
|
|
22
34
|
```yaml
|
|
23
|
-
remote_theme: jirrian/jekyll-theme-image-grid
|
|
35
|
+
remote_theme: jirrian/jekyll-theme-image-grid@main
|
|
24
36
|
```
|
|
25
37
|
|
|
26
38
|
Then build your site:
|
|
27
39
|
|
|
28
40
|
$ bundle exec jekyll serve
|
|
29
41
|
|
|
30
|
-
Preview your new site at `http://localhost:4000`.
|
|
42
|
+
Preview your new site at `http://localhost:4000`. Now you should be able to test your site locally as well as deploy it on Github Pages.
|
|
31
43
|
|
|
32
|
-
|
|
44
|
+
### Ruby gem installation method
|
|
33
45
|
|
|
34
|
-
|
|
46
|
+
[Create a new Jekyll site.](https://jekyllrb.com/docs/#instructions)
|
|
35
47
|
|
|
36
|
-
|
|
37
|
-
All images are stored in folders in the `_images` folder. Post images are stored in folders `_images/yyyy-mm-dd-name-of-post` that correspond to the name of the post `yyyy-mm-dd-name-of-post.md`. For example, if your post markdown file is named `2020-12-26-hello-world.md`, it must be in the `_posts` folder. And, all images that are displayed in that post must be in a folder `2020-12-26-hello-world` that is inside the `_images` folder.
|
|
48
|
+
Add this line to your Jekyll site's `Gemfile`:
|
|
38
49
|
|
|
39
|
-
|
|
50
|
+
```ruby
|
|
51
|
+
gem "jekyll-theme-image-grid"
|
|
40
52
|
```
|
|
41
|
-
|
|
42
|
-
layout: post
|
|
43
|
-
title: Title of Post (optional)
|
|
44
|
-
show_title: true (optional)
|
|
45
|
-
---
|
|
53
|
+
And then execute:
|
|
46
54
|
|
|
47
|
-
|
|
48
|
-
```
|
|
55
|
+
$ bundle install
|
|
49
56
|
|
|
50
|
-
|
|
57
|
+
Add this line to your Jekyll site's `_config.yml`:
|
|
51
58
|
|
|
52
|
-
|
|
59
|
+
```yaml
|
|
60
|
+
theme: jekyll-theme-image-grid
|
|
53
61
|
```
|
|
54
|
-
---
|
|
55
|
-
layout: page
|
|
56
|
-
title: About
|
|
57
|
-
---
|
|
58
62
|
|
|
59
|
-
|
|
60
|
-
|
|
63
|
+
Then build your site:
|
|
64
|
+
|
|
65
|
+
$ bundle exec jekyll serve
|
|
66
|
+
|
|
67
|
+
Preview your new site at `http://localhost:4000`. Now you should be able to test your site locally.
|
|
61
68
|
|
|
62
|
-
##
|
|
69
|
+
## Usage
|
|
70
|
+
### First time setup
|
|
63
71
|
|
|
64
|
-
|
|
72
|
+
Copy the contents of the [sample `_config.yml` file](https://github.com/jirrian/image-grid-example/blob/main/_config.yml) into your `_config.yml` file and edit the values with your information and preferred settings.
|
|
65
73
|
|
|
66
|
-
|
|
74
|
+
Delete the contents of the `_posts` folder.
|
|
75
|
+
|
|
76
|
+
Create a folder named `_images` in the root of your site directory. Make sure the `_images` folder is included in `_config.yml`.
|
|
77
|
+
|
|
78
|
+
Check out the [example site repo](https://github.com/jirrian/image-grid-example) for reference.
|
|
79
|
+
|
|
80
|
+
### Display Settings
|
|
81
|
+
|
|
82
|
+
Edit settings in the `_config.yml` file to change display settings for the grid and post pages. See the [sample `_config.yml` file](https://github.com/jirrian/image-grid-example/blob/main/_config.yml) for reference.
|
|
83
|
+
|
|
84
|
+
#### Grid Page Display Settings
|
|
67
85
|
|
|
68
86
|
Choose whether to show all images from posts on home grid page or only show the first image from posts by editing the following field.
|
|
69
87
|
```yaml
|
|
@@ -82,7 +100,7 @@ square-cropped - Images are displayed in square grid and cropped to a square asp
|
|
|
82
100
|
square-og - Images are displayed in square grid and with original aspect ratios.
|
|
83
101
|
masonry - Images are displayed in original aspect ratios but staggered (like Pinterest). Please note this will display the images in top to bottom (then left to right) order instead of left to right (then top to bottom).
|
|
84
102
|
|
|
85
|
-
|
|
103
|
+
#### Post Page Display Settings
|
|
86
104
|
|
|
87
105
|
Change settings for what information is displayed on post pages.
|
|
88
106
|
|
|
@@ -110,22 +128,73 @@ post_settings:
|
|
|
110
128
|
true - Displays date of post.
|
|
111
129
|
false - Does not show date of post.
|
|
112
130
|
|
|
113
|
-
|
|
131
|
+
### Adding a New Post
|
|
132
|
+
|
|
133
|
+
Posts in this theme are image based. A post must have at least one corresponding image for it to show on the home grid page.
|
|
134
|
+
|
|
135
|
+
All post markdown files are stored in the `_posts` folder.
|
|
136
|
+
All images are stored in folders in the `_images` folder. Post images are stored in folders `_images/yyyy-mm-dd-name-of-post` that correspond to the name of the post `yyyy-mm-dd-name-of-post.md`. For example, if your post markdown file is named `2020-12-26-hello-world.md`, it must be in the `_posts` folder. And, all images that are displayed in that post must be in a folder `2020-12-26-hello-world` that is inside the `_images` folder.
|
|
137
|
+
|
|
138
|
+
Post markdown files can contain the following:
|
|
139
|
+
```
|
|
140
|
+
---
|
|
141
|
+
layout: post
|
|
142
|
+
title: Title of Post (optional)
|
|
143
|
+
show_title: true (optional)
|
|
144
|
+
---
|
|
145
|
+
|
|
146
|
+
Post content here. (optional)
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
### Adding a Page
|
|
150
|
+
|
|
151
|
+
Pages are linked in the top nav bar. Markdown files for pages are stored in the root of the repository. Page markdown files can contain the following:
|
|
152
|
+
```
|
|
153
|
+
---
|
|
154
|
+
layout: page
|
|
155
|
+
title: About
|
|
156
|
+
---
|
|
157
|
+
|
|
158
|
+
Add your about me here. (optional)
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
## Customization
|
|
162
|
+
Customize the layout HTML, includes HTML, and sass files, by copying the theme files to your site directory and making edits to it there.
|
|
163
|
+
|
|
164
|
+
### Theme files structure
|
|
165
|
+
- `_layouts` - folder of layouts
|
|
166
|
+
- `default.html` - default layout
|
|
167
|
+
- `home.html` - grid page layout
|
|
168
|
+
- `page.html` - page layout
|
|
169
|
+
- `post.html` - post layout
|
|
170
|
+
- `_includes` - folder of html code used in other layouts
|
|
171
|
+
- `bootstrap-scripts.html` - Bootstrap 4 scripts (edit to change version of Bootstrap)
|
|
172
|
+
- `bootstrap-style.html` - Bootstrap 4 stylesheet (edit to change version of Bootstrap)
|
|
173
|
+
- `footer.html` - footer
|
|
174
|
+
- `head.html` - head tag
|
|
175
|
+
- `header.html` - navigation bar
|
|
176
|
+
- `_sass` - folder of scss files
|
|
177
|
+
- `style.scss` - styles for theme
|
|
178
|
+
|
|
179
|
+
### Built in customization
|
|
114
180
|
|
|
115
181
|
The following variables can be edited in the `_sass/style.scss` file to change colors of the website's design.
|
|
116
182
|
```sass
|
|
117
|
-
$body-bg-color: white;
|
|
118
|
-
$header-title-color: blue;
|
|
119
|
-
$header-bg-color: white;
|
|
120
|
-
$footer-color: silver;
|
|
121
|
-
$post-title-color: gray;
|
|
122
|
-
$post-date-color: darkgray;
|
|
123
|
-
$page-title-color: gray;
|
|
183
|
+
$body-bg-color: white; /* background color */
|
|
184
|
+
$header-title-color: blue; /* color of title of website */
|
|
185
|
+
$header-bg-color: white; /* color of nav bar */
|
|
186
|
+
$footer-color: silver; /* color of footer icons */
|
|
187
|
+
$post-title-color: gray; /* color of post titles */
|
|
188
|
+
$post-date-color: darkgray; /* color of post dates */
|
|
189
|
+
$page-title-color: gray; /* color of page titles */
|
|
124
190
|
```
|
|
125
191
|
|
|
126
|
-
For complete customization, add css to the `_sass/style.scss` file.
|
|
127
|
-
|
|
128
192
|
## License
|
|
129
193
|
|
|
130
194
|
The theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
|
|
131
195
|
|
|
196
|
+
## Future updates
|
|
197
|
+
|
|
198
|
+
- lazy loading
|
|
199
|
+
- video post support
|
|
200
|
+
- text post support
|
data/_config.yml
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
title: image grid
|
|
2
2
|
author: author
|
|
3
3
|
email: your-email@example.com
|
|
4
|
-
description: A simple image grid theme. Add your site description here in the _config.yml file. It will appear in your document head meta (for
|
|
4
|
+
description: A simple responsive image grid theme for displaying image-based content with various built-in customization options. Add your site description here in the _config.yml file. It will appear in your document head meta (for
|
|
5
5
|
Google search results).
|
|
6
6
|
|
|
7
7
|
# generate social links in footer
|
|
8
8
|
social_links:
|
|
9
|
-
twitter:
|
|
9
|
+
twitter: jekyll
|
|
10
10
|
github: jekyll
|
|
11
11
|
# facebook: jekyll
|
|
12
12
|
# instagram: jekyll
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
<script src="https://code.jquery.com/jquery-3.5.1.slim.min.js" integrity="sha384-DfXdz2htPH0lsSSs5nCTpuj/zy4C+OGpamoFVy38MVBnE+IbbVYUew+OrCXaRkfj" crossorigin="anonymous"></script>
|
|
2
|
+
<script src="https://cdn.jsdelivr.net/npm/popper.js@1.16.1/dist/umd/popper.min.js" integrity="sha384-9/reFTGAW83EW2RDu2S0VKaIzap3H66lZH81PoYlFhbGU+6BZp6G7niu735Sk7lN" crossorigin="anonymous"></script>
|
|
3
|
+
<script src="https://cdn.jsdelivr.net/npm/bootstrap@4.6.0/dist/js/bootstrap.min.js" integrity="sha384-+YQ4JLhjyBLPDQt//I+STsc9iw4uQqACwlvpslubQzn4u2UU2UFM80nGisd026JF" crossorigin="anonymous"></script>
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.6.0/dist/css/bootstrap.min.css" integrity="sha384-B0vP5xmATw1+K9KRQjQERJvTumQW0nPEzvF6L/Z6nronJ3oUOFUFpCjEUQouq2+l" crossorigin="anonymous">
|
data/_includes/head.html
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
<meta charset='utf-8'>
|
|
3
3
|
<meta name='viewport' content='width=device-width, initial-scale=1'>
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
{% include bootstrap-style.html %}
|
|
6
6
|
|
|
7
7
|
<link rel='stylesheet' href='{{ '/assets/style.css' | relative_url }}'>
|
|
8
8
|
|
data/_layouts/default.html
CHANGED
|
@@ -11,8 +11,6 @@
|
|
|
11
11
|
{% include footer.html %}
|
|
12
12
|
</div>
|
|
13
13
|
</div>
|
|
14
|
-
|
|
15
|
-
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.12.9/umd/popper.min.js" integrity="sha384-ApNbgh9B+Y1QKtv3Rn7W3mgPxhU9K/ScQsAP7hUibX39j7fakFPskvXusvfa0b4Q" crossorigin="anonymous"></script>
|
|
16
|
-
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0/js/bootstrap.min.js" integrity="sha384-JZR6Spejh4U02d8jOt6vLEHfe/JQGiRRSQQxSfFWpi1MquVdAyjUar5+76PVCmYl" crossorigin="anonymous"></script>
|
|
14
|
+
{% include bootstrap-scripts.html %}
|
|
17
15
|
</body>
|
|
18
16
|
</html>
|
|
File without changes
|
data/_layouts/page.html
CHANGED
data/_layouts/post.html
CHANGED
|
File without changes
|
data/_sass/style.scss
CHANGED
|
File without changes
|
|
File without changes
|
data/assets/style.scss
CHANGED
|
File without changes
|
metadata
CHANGED
|
@@ -1,44 +1,64 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: jekyll-theme-image-grid
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.1
|
|
4
|
+
version: 1.0.1
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- jirrian
|
|
8
|
-
autorequire:
|
|
8
|
+
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date:
|
|
11
|
+
date: 2021-01-23 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: jekyll
|
|
15
15
|
requirement: !ruby/object:Gem::Requirement
|
|
16
16
|
requirements:
|
|
17
|
-
- - "
|
|
17
|
+
- - ">="
|
|
18
18
|
- !ruby/object:Gem::Version
|
|
19
|
-
version: '
|
|
20
|
-
|
|
19
|
+
version: '3.5'
|
|
20
|
+
- - "<"
|
|
21
|
+
- !ruby/object:Gem::Version
|
|
22
|
+
version: '5.0'
|
|
23
|
+
type: :runtime
|
|
21
24
|
prerelease: false
|
|
22
25
|
version_requirements: !ruby/object:Gem::Requirement
|
|
23
26
|
requirements:
|
|
24
|
-
- - "
|
|
27
|
+
- - ">="
|
|
28
|
+
- !ruby/object:Gem::Version
|
|
29
|
+
version: '3.5'
|
|
30
|
+
- - "<"
|
|
25
31
|
- !ruby/object:Gem::Version
|
|
26
|
-
version: '
|
|
32
|
+
version: '5.0'
|
|
27
33
|
- !ruby/object:Gem::Dependency
|
|
28
34
|
name: jekyll-seo-tag
|
|
29
35
|
requirement: !ruby/object:Gem::Requirement
|
|
30
36
|
requirements:
|
|
31
37
|
- - "~>"
|
|
32
38
|
- !ruby/object:Gem::Version
|
|
33
|
-
version: '2.
|
|
39
|
+
version: '2.1'
|
|
34
40
|
type: :runtime
|
|
35
41
|
prerelease: false
|
|
36
42
|
version_requirements: !ruby/object:Gem::Requirement
|
|
37
43
|
requirements:
|
|
38
44
|
- - "~>"
|
|
39
45
|
- !ruby/object:Gem::Version
|
|
40
|
-
version: '2.
|
|
41
|
-
|
|
46
|
+
version: '2.1'
|
|
47
|
+
- !ruby/object:Gem::Dependency
|
|
48
|
+
name: bundler
|
|
49
|
+
requirement: !ruby/object:Gem::Requirement
|
|
50
|
+
requirements:
|
|
51
|
+
- - ">="
|
|
52
|
+
- !ruby/object:Gem::Version
|
|
53
|
+
version: '0'
|
|
54
|
+
type: :development
|
|
55
|
+
prerelease: false
|
|
56
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
57
|
+
requirements:
|
|
58
|
+
- - ">="
|
|
59
|
+
- !ruby/object:Gem::Version
|
|
60
|
+
version: '0'
|
|
61
|
+
description:
|
|
42
62
|
email:
|
|
43
63
|
- jillianzhong@yahoo.com
|
|
44
64
|
executables: []
|
|
@@ -48,11 +68,13 @@ files:
|
|
|
48
68
|
- LICENSE.txt
|
|
49
69
|
- README.md
|
|
50
70
|
- _config.yml
|
|
71
|
+
- _includes/bootstrap-scripts.html
|
|
72
|
+
- _includes/bootstrap-style.html
|
|
51
73
|
- _includes/footer.html
|
|
52
74
|
- _includes/head.html
|
|
53
75
|
- _includes/header.html
|
|
54
76
|
- _layouts/default.html
|
|
55
|
-
- _layouts/
|
|
77
|
+
- _layouts/home.html
|
|
56
78
|
- _layouts/page.html
|
|
57
79
|
- _layouts/post.html
|
|
58
80
|
- _sass/style.scss
|
|
@@ -62,7 +84,7 @@ homepage: https://github.com/jirrian/jekyll-theme-image-grid
|
|
|
62
84
|
licenses:
|
|
63
85
|
- MIT
|
|
64
86
|
metadata: {}
|
|
65
|
-
post_install_message:
|
|
87
|
+
post_install_message:
|
|
66
88
|
rdoc_options: []
|
|
67
89
|
require_paths:
|
|
68
90
|
- lib
|
|
@@ -78,7 +100,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
|
78
100
|
version: '0'
|
|
79
101
|
requirements: []
|
|
80
102
|
rubygems_version: 3.0.8
|
|
81
|
-
signing_key:
|
|
103
|
+
signing_key:
|
|
82
104
|
specification_version: 4
|
|
83
105
|
summary: A simple responsive image grid theme for displaying image-based content with
|
|
84
106
|
various built-in customization options.
|