jekyll-theme-hydeout 3.7.1 → 4.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: c8b6186e8fc0867a2364926d9242887c10f5b8f3
4
- data.tar.gz: b67f562ffa575888c0cbd5918948e4fbd767a46c
3
+ metadata.gz: 61a9f26f5d08ea52740dc4c5b0873f3aa9d9075b
4
+ data.tar.gz: 8e17561df2f49a04b8ace7da4ea3332edd1c38c0
5
5
  SHA512:
6
- metadata.gz: 5f8fdc3d6f8963fd1d4fb285f15582fc2a18ee26bd42a05da0854792393c36aed5b15c85225b7a94580bcacdf319364fb7702ab40cc84e32962f4a6daaccf485
7
- data.tar.gz: 36ae8c142eaa2df9dbf072199b371fc5bab5c7869684e2733d0ce7cb88eea02a5539716b77c550949c4b9b44d926070fbe50e206edf6e9f0b18f196db6cc53ef
6
+ metadata.gz: 7ec501edef52d459d0bf36bc48f50a53ed72b8167c8c16f3977d68e31754b493b72db527837a930b7785e2b42a70a5b8b341d5e776f26fd4a350ded6e847647f
7
+ data.tar.gz: fe9807f296712b82b49610b6f76bb25abd0c5df949b46c982f428ab993633b6acebe7bebc2d3f5527d187e1c99eeeee81ff691f9c6e37c80e91efa70e003327b
data/README.md CHANGED
@@ -1,167 +1,168 @@
1
- # Hydeout
2
-
3
- Hydeout updates the original [Hyde](https://github.com/poole/hyde)
4
- theme for [Jekyll](http://jekyllrb.com) 3.x and adds new functionality.
5
-
6
- ![Desktop](/_screenshots/1.png?raw=true)
7
- <img alt="Mobile home page" src="/_screenshots/2.png?raw=true" width="300px" />
8
- <img alt="Mobile post page" src="/_screenshots/3.png?raw=true" width="300px" />
9
-
10
- ### Usage
11
-
12
- Hydeout is available as the `jekyll-theme-hydeout` Ruby Gem.
13
- Add `gem "jekyll-theme-hydeout", "~> 3.4"` to your Gemfile and run
14
- `bundle install`.
15
-
16
- If you're installing on Github pages, you may also have to add
17
- `remote_theme: fongandrew/hydeout` to your `_config.yml`. [See the Github
18
- instructions for more details.](https://help.github.com/articles/adding-a-jekyll-theme-to-your-github-pages-site/)
19
-
20
- Hydeout uses pagination, so if you have an `index.md`, you'll need to swap
21
- it with an `index.html` that uses the `index` layout:
22
-
23
- ```
24
- ---
25
- layout: index
26
- title: Home
27
- ---
28
- ```
29
-
30
- You'll also need to add a setting to `_config.yml` telling Jekyll how many posts
31
- to include per page (e.g. `paginate: 5`).
32
-
33
- ### Keep It Simple
34
-
35
- In keeping with the original Hyde theme, Hydeout aims to keep the overall
36
- design lightweight and plugin-free. JavaScript is currently limited only
37
- to Disqus and Google Analytics (and is only loaded if you provide configuration
38
- variables).
39
-
40
- Hydeout makes heavy use of Flexbox in its CSS. If Flexbox is not available,
41
- the CSS degrades into a single column layout.
42
-
43
- ### Customization
44
-
45
- Hydeout replaces Hyde's class-based theming with the use
46
- of the following SASS variables:
47
-
48
- ```scss
49
- $sidebar-bg-color: #202020 !default;
50
- $sidebar-sticky: true !default;
51
- $layout-reverse: false !default;
52
- $link-color: #268bd2 !default;
53
- ```
54
-
55
- To override these variables, create your own `assets/css/main.scss` file.
56
- Define your own variables, then import in Hydeout's SCSS, like so:
57
-
58
- ```scss
59
- ---
60
- # Jekyll needs front matter for SCSS files
61
- ---
62
-
63
- $sidebar-bg-color: #ac4142;
64
- $link-color: #ac4142;
65
- $sidebar-sticky: false;
66
- @import "hydeout";
67
- ```
68
-
69
- See the [_variables](_sass/hydeout/_variables.scss) file for other variables
70
- you can override.
71
-
72
- You can see the full set of partials you can replace in the
73
- [`_includes`](_includes) folder, but there are a few worth noting:
74
-
75
- * `_includes/copyright.html` - Insert your own copyright here.
76
-
77
- * `_includes/custom-head.html` - Insert custom head tags (e.g. to load your
78
- own stylesheets)
79
-
80
- * `_includes/custom-foot.html` - Insert custom elements at the end of the
81
- body (e.g. for custom JS)
82
-
83
- * `_includes/custom-nav-links.html` - Additional nav links to insert at the
84
- end of the list of links in the sidebar.
85
-
86
- Pro-tip: The `nav`s in the sidebar are flexboxes. Use the `order` property
87
- to order your links.
88
-
89
- * `_includes/custom-icon-links.html`- Additional icon links to insert at the
90
- end of the icon links at the bottom of the sidebar. You can use the `order`
91
- property to re-order.
92
-
93
- * `_includes/favicons.html` - Replace references to `favicon.ico` and
94
- `favicon.png` with your own favicons references.
95
-
96
- * `_includes/font-includes.html` - The Abril Fatface font used for the site
97
- title is loaded here. If you're overriding that font in the CSS, be sure
98
- to also remove the font load reference here.
99
-
100
- ### New Features
101
-
102
- * Hydeout adds a new tags page (accessible in the sidebar). Just create a
103
- new page with the tags layout:
104
-
105
- ```
106
- ---
107
- layout: tags
108
- title: Tags
109
- ---
110
- ```
111
-
112
- * Hydeout adds a new "category" layout for dedicated category pages.
113
- Category pages are automatically added to the sidebar. All other pages
114
- must have `sidebar_link: true` in their front matter to show up in
115
- the sidebar. To create a category page, use the `category` layout"
116
-
117
- ```
118
- ---
119
- layout: category
120
- title: My Category
121
- ---
122
-
123
- Description of "My Category"
124
- ```
125
-
126
- * You can control how pages are sorted by using the `sidebar_sort_order`
127
- parameter in the front matter. This works for both category and non-category
128
- pages, although non-category pages will always come first. Take a look at
129
- [`_includes/sidebar-nav-links.html`](./_includes/sidebar-nav-links.html) if
130
- you want to customize this behavior.
131
-
132
- ```
133
- ---
134
- layout: page
135
- title: My page
136
- sidebar_sort_order: 123
137
- ---
138
-
139
- Some content.
140
- ```
141
-
142
- * A simple redirect-to-Google search is available. Just create a page with
143
- the `search` layout.
144
-
145
- ```
146
- ---
147
- layout: search
148
- title: Google Search
149
- ---
150
- ```
151
-
152
- * Disqus integration is ready out of the box. Just add the following to
153
- your config file:
154
-
155
- ```yaml
156
- disqus:
157
- shortname: my-disqus-shortname
158
- ```
159
-
160
- If you don't want Disqus or want to use something else, override
161
- `comments.html`.
162
-
163
- * For Google Analytics support, define a `google_analytics` variable with
164
- your property ID in your config file.
165
-
166
- There's also a bunch of minor tweaks and adjustments throughout the
167
- theme. Hope this works for you!
1
+ # Hydeout
2
+
3
+ Hydeout updates the original [Hyde](https://github.com/poole/hyde)
4
+ theme for [Jekyll](http://jekyllrb.com) 3.x and 4.x and adds new functionality.
5
+
6
+ ![Desktop](/_screenshots/1.png?raw=true)
7
+ <img alt="Mobile home page" src="/_screenshots/2.png?raw=true" width="300px" />
8
+ <img alt="Mobile post page" src="/_screenshots/3.png?raw=true" width="300px" />
9
+
10
+ ### Usage
11
+
12
+ Hydeout is available as the `jekyll-theme-hydeout` Ruby Gem.
13
+ Add `gem "jekyll-theme-hydeout", "~> 4.1"` to your Gemfile and run
14
+ `bundle install`.
15
+
16
+ If you're installing on Github pages, you may also have to add
17
+ `remote_theme: fongandrew/hydeout` to your `_config.yml`. [See the Github
18
+ instructions for more details.](https://help.github.com/articles/adding-a-jekyll-theme-to-your-github-pages-site/)
19
+
20
+ Hydeout uses pagination, so if you have an `index.md`, you'll need to swap
21
+ it with an `index.html` that uses the `index` layout:
22
+
23
+ ```
24
+ ---
25
+ layout: index
26
+ title: Home
27
+ ---
28
+ ```
29
+
30
+ You'll also need to add a setting to `_config.yml` telling Jekyll how many posts
31
+ to include per page (e.g. `paginate: 5`).
32
+
33
+ ### Keep It Simple
34
+
35
+ In keeping with the original Hyde theme, Hydeout aims to keep the overall
36
+ design lightweight and plugin-free. JavaScript is currently limited only
37
+ to Disqus and Google Analytics (and is only loaded if you provide configuration
38
+ variables).
39
+
40
+ Hydeout makes heavy use of Flexbox in its CSS. If Flexbox is not available,
41
+ the CSS degrades into a single column layout.
42
+
43
+ ### Customization
44
+
45
+ Hydeout replaces Hyde's class-based theming with the use
46
+ of the following SASS variables:
47
+
48
+ ```scss
49
+ $sidebar-bg-color: #202020 !default;
50
+ $sidebar-fg-color: white !default;
51
+ $sidebar-sticky: true !default;
52
+ $layout-reverse: false !default;
53
+ $link-color: #268bd2 !default;
54
+ ```
55
+
56
+ To override these variables, create your own `assets/css/main.scss` file.
57
+ Define your own variables, then import in Hydeout's SCSS, like so:
58
+
59
+ ```scss
60
+ ---
61
+ # Jekyll needs front matter for SCSS files
62
+ ---
63
+
64
+ $sidebar-bg-color: #ac4142;
65
+ $link-color: #ac4142;
66
+ $sidebar-sticky: false;
67
+ @import "hydeout";
68
+ ```
69
+
70
+ See the [_variables](_sass/hydeout/_variables.scss) file for other variables
71
+ you can override.
72
+
73
+ You can see the full set of partials you can replace in the
74
+ [`_includes`](_includes) folder, but there are a few worth noting:
75
+
76
+ * `_includes/copyright.html` - Insert your own copyright here.
77
+
78
+ * `_includes/custom-head.html` - Insert custom head tags (e.g. to load your
79
+ own stylesheets)
80
+
81
+ * `_includes/custom-foot.html` - Insert custom elements at the end of the
82
+ body (e.g. for custom JS)
83
+
84
+ * `_includes/custom-nav-links.html` - Additional nav links to insert at the
85
+ end of the list of links in the sidebar.
86
+
87
+ Pro-tip: The `nav`s in the sidebar are flexboxes. Use the `order` property
88
+ to order your links.
89
+
90
+ * `_includes/custom-icon-links.html`- Additional icon links to insert at the
91
+ end of the icon links at the bottom of the sidebar. You can use the `order`
92
+ property to re-order.
93
+
94
+ * `_includes/favicons.html` - Replace references to `favicon.ico` and
95
+ `favicon.png` with your own favicons references.
96
+
97
+ * `_includes/font-includes.html` - The Abril Fatface font used for the site
98
+ title is loaded here. If you're overriding that font in the CSS, be sure
99
+ to also remove the font load reference here.
100
+
101
+ ### New Features
102
+
103
+ * Hydeout adds a new tags page (accessible in the sidebar). Just create a
104
+ new page with the tags layout:
105
+
106
+ ```
107
+ ---
108
+ layout: tags
109
+ title: Tags
110
+ ---
111
+ ```
112
+
113
+ * Hydeout adds a new "category" layout for dedicated category pages.
114
+ Category pages are automatically added to the sidebar. All other pages
115
+ must have `sidebar_link: true` in their front matter to show up in
116
+ the sidebar. To create a category page, use the `category` layout"
117
+
118
+ ```
119
+ ---
120
+ layout: category
121
+ title: My Category
122
+ ---
123
+
124
+ Description of "My Category"
125
+ ```
126
+
127
+ * You can control how pages are sorted by using the `sidebar_sort_order`
128
+ parameter in the front matter. This works for both category and non-category
129
+ pages, although non-category pages will always come first. Take a look at
130
+ [`_includes/sidebar-nav-links.html`](./_includes/sidebar-nav-links.html) if
131
+ you want to customize this behavior.
132
+
133
+ ```
134
+ ---
135
+ layout: page
136
+ title: My page
137
+ sidebar_sort_order: 123
138
+ ---
139
+
140
+ Some content.
141
+ ```
142
+
143
+ * A simple redirect-to-Google search is available. Just create a page with
144
+ the `search` layout.
145
+
146
+ ```
147
+ ---
148
+ layout: search
149
+ title: Google Search
150
+ ---
151
+ ```
152
+
153
+ * Disqus integration is ready out of the box. Just add the following to
154
+ your config file:
155
+
156
+ ```yaml
157
+ disqus:
158
+ shortname: my-disqus-shortname
159
+ ```
160
+
161
+ If you don't want Disqus or want to use something else, override
162
+ `comments.html`.
163
+
164
+ * For Google Analytics support, define a `google_analytics` variable with
165
+ your property ID in your config file.
166
+
167
+ There's also a bunch of minor tweaks and adjustments throughout the
168
+ theme. Hope this works for you!
@@ -0,0 +1,6 @@
1
+ {% assign back_page = site.pages | find: "name", page.back_page %}
2
+ {% if back_page != null %}
3
+ <p class="back-link">
4
+ <a href="{{ back_page.url | relative_url }}"><span class="back-arrow icon">{% include svg/back-arrow.svg %}</span>{{ back_page.short_title | default: back_page.title }}</a>
5
+ </p>
6
+ {% endif %}
@@ -6,7 +6,7 @@
6
6
  {% if node.title != null %}
7
7
  {% if node.layout == "category" %}
8
8
  <a class="category-link {% if page.url == node.url %} active{% endif %}"
9
- href="{{ site.baseurl }}{{ node.url }}">{{ node.title }}</a>
9
+ href="{{ node.url | relative_url }}">{{ node.title }}</a>
10
10
  {% endif %}
11
11
  {% endif %}
12
12
  {% endfor %}
@@ -1,4 +1,4 @@
1
1
  <p>
2
2
  &copy; {{ site.time | date: '%Y' }}.
3
- <a href="{{ site.baseurl }}/LICENSE.md">MIT License.</a>
3
+ <a href="{{ "/LICENSE.md" | relative_url }}">MIT License.</a>
4
4
  </p>
@@ -1,2 +1,2 @@
1
- <link rel="apple-touch-icon-precomposed" sizes="144x144" href="{{ site.baseurl }}/favicon.png" />
2
- <link rel="shortcut icon" href="{{ site.baseurl }}/favicon.ico" />
1
+ <link rel="apple-touch-icon-precomposed" sizes="144x144" href="{{ "/favicon.png" | relative_url }}" />
2
+ <link rel="shortcut icon" href="{{ "/favicon.ico" | relative_url}}" />
data/_includes/head.html CHANGED
@@ -1,5 +1,5 @@
1
1
  <head>
2
- <link href="http://gmpg.org/xfn/11" rel="profile" />
2
+ <link href="https://gmpg.org/xfn/11" rel="profile" />
3
3
  <meta http-equiv="X-UA-Compatible" content="IE=edge" />
4
4
  <meta http-equiv="content-type" content="text/html; charset=utf-8" />
5
5
 
@@ -17,14 +17,14 @@
17
17
  {% include google-analytics.html %}
18
18
 
19
19
  <!-- CSS -->
20
- <link rel="stylesheet" href="{{ site.baseurl }}/assets/css/main.css" />
20
+ <link rel="stylesheet" href="{{ "/assets/css/main.css" | relative_url }}" />
21
21
  {% include font-includes.html %}
22
22
 
23
23
  <!-- Icons -->
24
24
  {% include favicons.html %}
25
25
 
26
26
  <!-- RSS -->
27
- <link rel="alternate" type="application/rss+xml" title="RSS" href="/{{ site.feed.path | default: 'feed.xml' }}" />
27
+ <link rel="alternate" type="application/rss+xml" title="RSS" href="{{ site.feed.path | default: 'feed.xml' | relative_url }}" />
28
28
 
29
29
  {% include custom-head.html %}
30
30
  </head>
@@ -7,7 +7,7 @@
7
7
  {% if node.title != null %}
8
8
  {% if node.sidebar_link %}
9
9
  <a class="page-link {% if page.url == node.url %} active{% endif %}"
10
- href="{{ site.baseurl }}{{ node.url }}">{{ node.title }}</a>
10
+ href="{{ node.url | relative_url }}">{% if node.short_title != null %}{{ node.short_title }}{% else %}{{ node.title }}{% endif %}</a>
11
11
  {% endif %}
12
12
  {% endif %}
13
13
  {% endfor %}
@@ -1,7 +1,7 @@
1
1
  {% if paginator.previous_page %}
2
2
  <div class="pagination">
3
3
  <a class="pagination-item newer"
4
- href="{{ site.baseurl }}{{ paginator.previous_page_path }}">
4
+ href="{{ paginator.previous_page_path | relative_url }}">
5
5
  Newer
6
6
  </a>
7
7
  </div>
@@ -1,7 +1,7 @@
1
1
  {% if paginator.next_page %}
2
2
  <div class="pagination">
3
3
  <a class="pagination-item older"
4
- href="{{ site.baseurl }}{{ paginator.next_page_path }}">
4
+ href="{{ paginator.next_page_path | relative_url }}">
5
5
  Older
6
6
  </a>
7
7
  </div>
@@ -18,7 +18,7 @@
18
18
  {% endfor %}
19
19
 
20
20
  {% if category_page %}
21
- <a href="{{ site.baseurl }}{{ category_page.url }}">
21
+ <a href="{{ category_page.url | relative_url }}">
22
22
  {{ category_page.title | default: category_page.category }}
23
23
  </a>
24
24
  {% else %}
@@ -11,7 +11,7 @@
11
11
  <div class="post-tags">
12
12
  {% for tag in include.post.tags %}
13
13
  {% if tags_page %}
14
- <a href="{{ site.baseurl }}{{ tags_page.url }}#{{ tag | slugify }}">
14
+ <a href="{{ tags_page.url | relative_url }}#{{ tag | slugify }}">
15
15
  {% else %}<span>{% endif %}
16
16
  <span class="icon">
17
17
  {% include svg/tags.svg %}