jekyll-theme-open-project 2.0.22 → 2.1.5
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/LICENSE.txt +1 -1
- data/README.md +51 -17
- data/_includes/legal.html +1 -1
- metadata +11 -11
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: c6366b5adfa5e11bcc91ad0e1931ad6fb7e9f35545610a2f9d37b354b7105afa
|
4
|
+
data.tar.gz: 0632dc0a5fb7d6c21a6c101e4f61163e4def8c42c859b4d1100b6b8ae0fcc432
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: fac11c90495ad46f9dd266652e64239444151d368acc0aef3a89cb99ed6d78480d9de7c3968868350eb588c190f6c03bc6794bb0ca247a5e015a4c2fc7b010ea
|
7
|
+
data.tar.gz: cee45f97d0b8d02f19040d2ad2916af5231c8e57bdb09578ad51b81e4d703ee08b9879e09d098557c5c663dd4c451b2c16cb9400370a45b56934abc8bb5bc28e
|
data/LICENSE.txt
CHANGED
data/README.md
CHANGED
@@ -5,9 +5,11 @@ aiming to help organizations and individuals present
|
|
5
5
|
open-source software and specifications in a navigable and elegant way.
|
6
6
|
|
7
7
|
Open Project fits two types of sites:
|
8
|
-
that describe one individual project, and that combine projects into sort of an open hub.
|
9
8
|
|
10
|
-
|
9
|
+
* a site that describes one individual project
|
10
|
+
* a site that combine projects into sort of an open hub.
|
11
|
+
|
12
|
+
**Demo**: See [Ribose Open](https://open.ribose.com/) project sites -- for example,
|
11
13
|
[Metanorma](https://www.metanorma.com),
|
12
14
|
[RNP](https://www.rnpgp.com),
|
13
15
|
[Cryptode](https://www.cryptode.com),
|
@@ -38,9 +40,9 @@ to AWS S3.
|
|
38
40
|
* [Includes](#theme-includes)
|
39
41
|
|
40
42
|
|
41
|
-
##
|
43
|
+
## Getting started
|
42
44
|
|
43
|
-
###
|
45
|
+
### Set up Ruby and Jekyll
|
44
46
|
|
45
47
|
The currently recommended Ruby version is 2.6.
|
46
48
|
(In case you aren’t using Ruby often, the easiest way to install one may be with RVM.)
|
@@ -48,10 +50,10 @@ The currently recommended Ruby version is 2.6.
|
|
48
50
|
The currently recommended Jekyll version is 3 or newer
|
49
51
|
(read about [Jekyll installation](https://jekyllrb.com/docs/#instructions)).
|
50
52
|
|
51
|
-
|
53
|
+
NOTE: this theme is known to not work with Ruby older than 2.3,
|
52
54
|
and hasn’t been tested on newer versions.
|
53
55
|
|
54
|
-
### Start new Jekyll site
|
56
|
+
### Start a new Jekyll site
|
55
57
|
|
56
58
|
jekyll new my-open-site
|
57
59
|
|
@@ -59,7 +61,7 @@ If you use Git for site source version management,
|
|
59
61
|
see the “Extra .gitignore rules” section below
|
60
62
|
for additional lines you should add to your `.gitignore`.
|
61
63
|
|
62
|
-
###
|
64
|
+
### Install Open Site theme into the Jekyll site
|
63
65
|
|
64
66
|
Add this line to your Jekyll site's `Gemfile`,
|
65
67
|
replacing default theme requirement:
|
@@ -91,15 +93,32 @@ Execute the following to install dependencies:
|
|
91
93
|
|
92
94
|
$ bundle
|
93
95
|
|
94
|
-
###
|
96
|
+
### Configure your Open Site for the first time
|
95
97
|
|
96
|
-
Edit _config.yml to add necessary site-wide configuration options,
|
98
|
+
Edit `_config.yml` to add necessary site-wide configuration options,
|
97
99
|
and add files and folders to site contents. This step depends
|
98
100
|
on the type of site you’re creating: hub or individual project site.
|
99
101
|
|
100
102
|
Further sections explain core concepts of open project and hub, and go
|
101
103
|
into detail about how to configure a project or hub site.
|
102
104
|
|
105
|
+
Before building the first time you must do this:
|
106
|
+
|
107
|
+
1. Configure [common settings](#common-settings)
|
108
|
+
2. Add your logo(s) according to [logo](#logo)
|
109
|
+
|
110
|
+
Please see the [configuration section](#configuration) for more details.
|
111
|
+
|
112
|
+
NOTE: It may be required to copy the following properties from
|
113
|
+
this theme’s `_config.yaml` to your site’s: `collections`, `includes_dir`.
|
114
|
+
|
115
|
+
This is likely caused by changed behavior of jekyll-data gem in recent versions,
|
116
|
+
which is responsible for “inheritance” of `_config.yaml` between theme and site.
|
117
|
+
|
118
|
+
You can add any custom collections for your site
|
119
|
+
after collections copied from theme’s config.
|
120
|
+
|
121
|
+
|
103
122
|
### Building site
|
104
123
|
|
105
124
|
Execute to build the site locally and watch for changes:
|
@@ -110,17 +129,30 @@ This assumes you have mysite.local mapped in your hosts file,
|
|
110
129
|
otherwise omit --host and it’ll use “localhost” as domain name.
|
111
130
|
|
112
131
|
|
113
|
-
##
|
132
|
+
## Configuration
|
133
|
+
|
134
|
+
There are 3 areas to configure when you first create an Open Site, namely:
|
135
|
+
|
136
|
+
* [Common setup](#common-setup), settings that apply to both Hub and Project sites;
|
137
|
+
* [Hub site](#hub-site);
|
138
|
+
* [Project site](#project-site)
|
139
|
+
|
140
|
+
|
141
|
+
## Common setup
|
142
|
+
|
143
|
+
### Common settings
|
144
|
+
|
145
|
+
(mandatory)
|
114
146
|
|
115
147
|
These settings apply to both site types (hub and project).
|
116
148
|
|
117
|
-
- You may want to remove the default about.md page added by Jekyll,
|
149
|
+
- You may want to remove the default `about.md` page added by Jekyll,
|
118
150
|
as this theme does not account for its existence.
|
119
151
|
|
120
152
|
- Add `hero_include: home-hero.html` to YAML frontmatter
|
121
153
|
in your main `index.md`.
|
122
154
|
|
123
|
-
- Add following items to site’s _config.yml
|
155
|
+
- Add following items to site’s `_config.yml`
|
124
156
|
(and don’t forget to remove default theme requirement there):
|
125
157
|
|
126
158
|
```yaml
|
@@ -165,6 +197,8 @@ These settings apply to both site types (hub and project).
|
|
165
197
|
|
166
198
|
### Logo
|
167
199
|
|
200
|
+
(mandatory)
|
201
|
+
|
168
202
|
By “logo” is meant the combination of site symbol as a graphic
|
169
203
|
and name as word(s).
|
170
204
|
|
@@ -172,10 +206,10 @@ and name as word(s).
|
|
172
206
|
Should look OK in dimensions of 30x30px, and fit inside a square.
|
173
207
|
Should be in SVG format (see also the SVG guidelines section).
|
174
208
|
|
175
|
-
-
|
209
|
+
- Provide your site-wide symbol in <site root>/assets/symbol.svg.
|
176
210
|
|
177
|
-
-
|
178
|
-
under
|
211
|
+
- Provide the symbol as PNG renders as `favicon.png` and `favicon-192x192.png`
|
212
|
+
under `<site root>/assets/`; use transparent background.
|
179
213
|
|
180
214
|
- **Site name** displayed to the right of the symbol.
|
181
215
|
Limit the name to 1-3 words.
|
@@ -222,7 +256,7 @@ hero_include: index-page-hero.html
|
|
222
256
|
In general, posts are authored as per usual Jekyll setup.
|
223
257
|
|
224
258
|
It is recommended that you provide explicit hand-crafted post excerpts,
|
225
|
-
as automatically-generated excerpts may break post card
|
259
|
+
as automatically-generated excerpts may break the post card layout.
|
226
260
|
|
227
261
|
Theme also anticipates author information within frontmatter.
|
228
262
|
Together with excerpts, here’s how post frontmatter (in addition to anything
|
@@ -520,7 +554,7 @@ description: A sentence.
|
|
520
554
|
# but used for HTML metadata if jekyll-seo-tag is enabled
|
521
555
|
|
522
556
|
tags: [Ruby, Python, RFC, "<some_namespace_id>:<appropriate_tag>"]
|
523
|
-
#
|
557
|
+
# NOTE: Avoid whitespaces and other characters that may make Jekyll
|
524
558
|
# percent-encode the tag in URLs. Replace " " (a regular space)
|
525
559
|
# with "_" (underline); underlines will be rewritten as spaces when tags
|
526
560
|
# are presented to site users.
|
data/_includes/legal.html
CHANGED
@@ -1,5 +1,5 @@
|
|
1
1
|
<span class="copyright">
|
2
|
-
<span class="copyright-head">Copyright ©
|
2
|
+
<span class="copyright-head">Copyright © {{ site.time | date: '%Y' }} {{ site.legal.name }} —</span>
|
3
3
|
<span class="copyright-tail">All rights reserved.</span>
|
4
4
|
</span>
|
5
5
|
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: jekyll-theme-open-project
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 2.
|
4
|
+
version: 2.1.5
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Ribose Inc.
|
8
|
-
autorequire:
|
8
|
+
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2021-01-10 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: jekyll
|
@@ -16,14 +16,14 @@ dependencies:
|
|
16
16
|
requirements:
|
17
17
|
- - "~>"
|
18
18
|
- !ruby/object:Gem::Version
|
19
|
-
version:
|
19
|
+
version: 4.1.1
|
20
20
|
type: :runtime
|
21
21
|
prerelease: false
|
22
22
|
version_requirements: !ruby/object:Gem::Requirement
|
23
23
|
requirements:
|
24
24
|
- - "~>"
|
25
25
|
- !ruby/object:Gem::Version
|
26
|
-
version:
|
26
|
+
version: 4.1.1
|
27
27
|
- !ruby/object:Gem::Dependency
|
28
28
|
name: jekyll-seo-tag
|
29
29
|
requirement: !ruby/object:Gem::Requirement
|
@@ -72,14 +72,14 @@ dependencies:
|
|
72
72
|
requirements:
|
73
73
|
- - '='
|
74
74
|
- !ruby/object:Gem::Version
|
75
|
-
version: 2.
|
75
|
+
version: 2.1.4
|
76
76
|
type: :runtime
|
77
77
|
prerelease: false
|
78
78
|
version_requirements: !ruby/object:Gem::Requirement
|
79
79
|
requirements:
|
80
80
|
- - '='
|
81
81
|
- !ruby/object:Gem::Version
|
82
|
-
version: 2.
|
82
|
+
version: 2.1.4
|
83
83
|
- !ruby/object:Gem::Dependency
|
84
84
|
name: bundler
|
85
85
|
requirement: !ruby/object:Gem::Requirement
|
@@ -150,7 +150,7 @@ dependencies:
|
|
150
150
|
- - "~>"
|
151
151
|
- !ruby/object:Gem::Version
|
152
152
|
version: '1.3'
|
153
|
-
description:
|
153
|
+
description:
|
154
154
|
email:
|
155
155
|
- open.source@ribose.com
|
156
156
|
executables: []
|
@@ -225,7 +225,7 @@ homepage: https://github.com/riboseinc/jekyll-theme-open-project/
|
|
225
225
|
licenses:
|
226
226
|
- MIT
|
227
227
|
metadata: {}
|
228
|
-
post_install_message:
|
228
|
+
post_install_message:
|
229
229
|
rdoc_options: []
|
230
230
|
require_paths:
|
231
231
|
- lib
|
@@ -240,8 +240,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
240
240
|
- !ruby/object:Gem::Version
|
241
241
|
version: '0'
|
242
242
|
requirements: []
|
243
|
-
rubygems_version: 3.0.
|
244
|
-
signing_key:
|
243
|
+
rubygems_version: 3.0.3
|
244
|
+
signing_key:
|
245
245
|
specification_version: 4
|
246
246
|
summary: Open Project Jekyll theme
|
247
247
|
test_files: []
|