arrow-jekyll-theme 0.1.0 → 0.1.2
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 +4 -4
- data/Devlog.md +25 -1
- data/README.md +86 -15
- data/_includes/footer.html +5 -5
- data/_includes/header.html +1 -1
- data/_layouts/default.html +3 -3
- data/index.md +2 -2
- data/posts.md +1 -1
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: dc551864eaadae739b31a7b9c85a1d8a29cdf73dd63e81cc217d07cf59b2201f
|
|
4
|
+
data.tar.gz: f81663a1c0ca30bb7e4b6b9abdf85c92c52e7d2b4ba086297f02289c42c16a55
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 05d7605ab6d98d4c85d8cf61fc76655f5d3f6e11ae9dfd3aa48ea8ef4abac7d76e337c5c65cf9999300e013025c9c2d2aeeb7e2830ada41c4d94fbc50d27f560
|
|
7
|
+
data.tar.gz: 98521309b4dcea2bf663236339e6985d87b3f14d2193614c33c293dda4893f601339609d912cff91306bd6a5294784089e81335442558aae65c65df74edc8c17
|
data/Devlog.md
CHANGED
|
@@ -36,6 +36,9 @@ Note: To include default index.md, posts.md, and devlog.md, I had to update the
|
|
|
36
36
|
spec.files = `git ls-files -z`.split("\x0").select { |f| f.match(%r!^(assets|_data|_layouts|_includes|_sass|LICENSE|README|_config\.yml|Devlog\.md|index\.md|posts\.md)!i) }
|
|
37
37
|
```
|
|
38
38
|
|
|
39
|
+
<time class="timestamp--time">06:32 AM</time>
|
|
40
|
+
**Update**: These files are not automatically included, so I will make sure to note that in the README.md
|
|
41
|
+
|
|
39
42
|
## Building Gem
|
|
40
43
|
|
|
41
44
|
```shell
|
|
@@ -71,9 +74,30 @@ gem "arrow-jekyll-theme"
|
|
|
71
74
|
And then execute:
|
|
72
75
|
|
|
73
76
|
```shell
|
|
74
|
-
$ bundle
|
|
77
|
+
$ bundle install
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## Finding where gem was installed
|
|
81
|
+
|
|
82
|
+
```shell
|
|
83
|
+
$ bundle info arrow-jekyll-theme
|
|
75
84
|
```
|
|
76
85
|
|
|
86
|
+
## Build Your Site
|
|
87
|
+
|
|
88
|
+
```shell
|
|
89
|
+
$ bundle exec jekyll serve
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
<time class="timestamp--time">07:03 AM</time>
|
|
93
|
+
I just published the gem to RubyGems [here](https://rubygems.org/gems/arrow-jekyll-theme)
|
|
94
|
+
|
|
77
95
|
|
|
96
|
+
<time class="timestamp--time">07:22 AM</time>
|
|
97
|
+
I just noticed I forgot to update the link to the RSS feed. Fixing and pushing an update right now.
|
|
78
98
|
|
|
99
|
+
<time class="timestamp--time">07:40 AM</time>
|
|
100
|
+
Updating relative_url links for Github Pages deployment.
|
|
79
101
|
|
|
102
|
+
<time class="timestamp--time">07:51 AM</time>
|
|
103
|
+
Looks like I have to temporarily remove the base_url when developing locally.
|
data/README.md
CHANGED
|
@@ -1,50 +1,121 @@
|
|
|
1
1
|
# Arrow
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Arrow is a text-first Jekyll theme featuring minimal CSS by relying on default browser stylesheets to produce highly readable, responsive websites and blogs.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
## Demo site
|
|
8
|
+
|
|
9
|
+
You can check out a demo of the site [here](https://cspablocortez.github.io/arrow-jekyll-theme/)
|
|
8
10
|
|
|
9
11
|
## Installation
|
|
10
12
|
|
|
11
13
|
Add this line to your Jekyll site's `Gemfile`:
|
|
12
14
|
|
|
13
15
|
```ruby
|
|
14
|
-
gem "
|
|
16
|
+
gem "arrow-jekyll-theme"
|
|
15
17
|
```
|
|
16
18
|
|
|
17
19
|
And add this line to your Jekyll site's `_config.yml`:
|
|
18
20
|
|
|
19
21
|
```yaml
|
|
20
|
-
theme:
|
|
22
|
+
theme: arrow-jekyll-theme
|
|
21
23
|
```
|
|
22
24
|
|
|
23
25
|
And then execute:
|
|
24
26
|
|
|
25
|
-
$ bundle
|
|
27
|
+
$ bundle install
|
|
26
28
|
|
|
27
29
|
Or install it yourself as:
|
|
28
30
|
|
|
29
|
-
$ gem install
|
|
31
|
+
$ gem install arrow-jekyll-theme
|
|
30
32
|
|
|
31
33
|
## Usage
|
|
32
34
|
|
|
33
|
-
|
|
35
|
+
After installing the theme, you should copy the default markdown files into your Jekyll site.
|
|
34
36
|
|
|
35
|
-
|
|
37
|
+
```bash
|
|
38
|
+
cp -r path/to/arrow-jekyll-theme/*.md path/to/your-jekyll-site/
|
|
39
|
+
```
|
|
36
40
|
|
|
37
|
-
|
|
41
|
+
To find the correct path, run:
|
|
42
|
+
|
|
43
|
+
```shell
|
|
44
|
+
$ bundle info arrow-jekyll-theme
|
|
45
|
+
```
|
|
38
46
|
|
|
39
|
-
|
|
47
|
+
This will add the following files to your site:
|
|
40
48
|
|
|
41
|
-
|
|
49
|
+
- index.md
|
|
50
|
+
- about.md
|
|
51
|
+
- post.md
|
|
52
|
+
- devlog.md
|
|
53
|
+
|
|
54
|
+
Feel free to change or delete any of these files as you see fit.
|
|
42
55
|
|
|
43
56
|
Your theme is setup just like a normal Jekyll site! To test your theme, run `bundle exec jekyll serve` and open your browser at `http://localhost:4000`. This starts a Jekyll server using your theme. Add pages, documents, data, etc. like normal to test your theme's contents. As you make modifications to your theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal.
|
|
44
57
|
|
|
45
|
-
|
|
46
|
-
|
|
58
|
+
## Layouts
|
|
59
|
+
|
|
60
|
+
By default, you will find three layout files:
|
|
61
|
+
|
|
62
|
+
- default.html
|
|
63
|
+
- page.html
|
|
64
|
+
- post.html
|
|
65
|
+
|
|
66
|
+
The only difference between the page and post layouts is for displaying the date. The devlog is built using the page layout.
|
|
67
|
+
|
|
68
|
+
## Utility Classes
|
|
69
|
+
|
|
70
|
+
To make writing devlogs easier, the theme includes a couple of CSS utility classes:
|
|
71
|
+
|
|
72
|
+
- `.timestamp--time`
|
|
73
|
+
- `.timestamp--date`
|
|
74
|
+
|
|
75
|
+
For example, you can add a `<time>` element above a paragraph:
|
|
76
|
+
|
|
77
|
+
```html
|
|
78
|
+
<time class="timestamp--time">10:08 PM</time>
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
This will create a small timestamp element above paragraphs. This was created with the use of [TextMate Snippets](https://macromates.com/textmate/manual/snippets) in mind, but surely the functionality can be replicated with your text editor of choice.
|
|
82
|
+
|
|
83
|
+
## CSS
|
|
84
|
+
|
|
85
|
+
The CSS theme is minimal, mostly to improve readability and accessibility. There are three CSS files in the project.
|
|
86
|
+
|
|
87
|
+
- base.css
|
|
88
|
+
- article.css
|
|
89
|
+
- monokai.css
|
|
90
|
+
|
|
91
|
+
In the `base.css` file you will find variable definitions, media queries, and utility classes. The `article.css` file includes custom classes for styling blog posts. Custom CSS classes follow the [BEM methodology](https://en.bem.info/methodology/css/).
|
|
92
|
+
|
|
93
|
+
## Syntax Highlighting
|
|
94
|
+
|
|
95
|
+
By default, Arrow uses the Monokai [rouge](https://github.com/rouge-ruby/rouge) theme by inclusion of a CSS file from this list of [themes](https://github.com/brazacz/rouge-themes). These can be updated or deleted by following the instructions in the following section.
|
|
96
|
+
|
|
97
|
+
## Overriding Default Files
|
|
98
|
+
|
|
99
|
+
To override any theme file, you can either create it in your local development environment or update it directly by finding where bundle has installed the gem.
|
|
100
|
+
|
|
101
|
+
To do so, you must run:
|
|
102
|
+
|
|
103
|
+
```shell
|
|
104
|
+
$ bundle info arrow-jekyll-theme
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
## Uninstalling
|
|
108
|
+
|
|
109
|
+
To uninstall the theme using bundler:
|
|
110
|
+
|
|
111
|
+
```shell
|
|
112
|
+
$ gem uninstall arrow-jekyll-theme
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
## Contributing
|
|
116
|
+
|
|
117
|
+
Bug reports and pull requests are welcome on GitHub at https://github.com/cspablocortez/arrow-jekyll-theme. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](https://www.contributor-covenant.org/) code of conduct.
|
|
47
118
|
|
|
48
119
|
## License
|
|
49
120
|
|
|
50
|
-
The theme is available as open source under the terms of the [
|
|
121
|
+
The theme is available as open source under the terms of the [GNU GPL v3](https://www.gnu.org/licenses/gpl-3.0.en.html#license-text).
|
data/_includes/footer.html
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
<footer role="contentinfo">
|
|
2
2
|
<h4>Menu</h4>
|
|
3
3
|
<ul id="menu">
|
|
4
|
-
<li><a href="/">Home</a></li>
|
|
5
|
-
<li><a href="/posts">Posts</a></li>
|
|
6
|
-
<li><a href="/about">About</a></li>
|
|
7
|
-
<li><a href="/devlog">Devlog</a></li>
|
|
8
|
-
<li><a href="
|
|
4
|
+
<li><a href="{{ '/' | relative_url }}">Home</a></li>
|
|
5
|
+
<li><a href="{{ '/posts' | relative_url }}">Posts</a></li>
|
|
6
|
+
<li><a href="{{ '/about' | relative_url }}">About</a></li>
|
|
7
|
+
<li><a href="{{ '/devlog' | relative_url }}">Devlog</a></li>
|
|
8
|
+
<li><a href="{{ '/feed.xml' | relative_url }}">RSS</a></li>
|
|
9
9
|
</ul>
|
|
10
10
|
<small>
|
|
11
11
|
The <a href="https://github.com/cspablocortez/arrow-jekyll-theme">code for this project</a>
|
data/_includes/header.html
CHANGED
data/_layouts/default.html
CHANGED
|
@@ -7,9 +7,9 @@
|
|
|
7
7
|
|
|
8
8
|
<link rel="icon" href="data:,">
|
|
9
9
|
<title>{{ site.title }} | {{ page.title }}</title>
|
|
10
|
-
<link rel="stylesheet" href="/assets/css/base.css">
|
|
11
|
-
<link rel="stylesheet" href="/assets/css/article.css">
|
|
12
|
-
<link rel="stylesheet" href="/assets/css/monokai.css">
|
|
10
|
+
<link rel="stylesheet" href="{{ '/assets/css/base.css' | relative_url }}">
|
|
11
|
+
<link rel="stylesheet" href="{{ '/assets/css/article.css' | relative_url }}">
|
|
12
|
+
<link rel="stylesheet" href="{{ '/assets/css/monokai.css' | relative_url }}">
|
|
13
13
|
|
|
14
14
|
<meta name="theme-color" content="#FFF" media="(prefers-color-scheme: light)">
|
|
15
15
|
<meta name="theme-color" content="#111" media="(prefers-color-scheme: dark)">
|
data/index.md
CHANGED
|
@@ -13,11 +13,11 @@ Arrow is a text-first Jekyll theme available as a Ruby gem. It features minimal
|
|
|
13
13
|
{% for post in site.posts limit:3 %}
|
|
14
14
|
<li class="feed-item">
|
|
15
15
|
<p class="feed-item__date"><time>{{ post.date | date: "%Y-%m-%d"}}</time></p>
|
|
16
|
-
<h1 class="feed-item__title"><a href="{{ post.url }}">{{ post.title }}</a></h1>
|
|
16
|
+
<h1 class="feed-item__title"><a href="{{ post.url | relative_url }}">{{ post.title }}</a></h1>
|
|
17
17
|
</li>
|
|
18
18
|
{% endfor %}
|
|
19
19
|
|
|
20
|
-
<p style="margin-top: 1.5rem;"><a href="/posts">View all posts →</a></p>
|
|
20
|
+
<p style="margin-top: 1.5rem;"><a href="{{ '/posts' | relative_url }}">View all posts →</a></p>
|
|
21
21
|
</ul>
|
|
22
22
|
|
|
23
23
|
## Features
|
data/posts.md
CHANGED
|
@@ -8,7 +8,7 @@ permalink: posts
|
|
|
8
8
|
{% for post in site.posts %}
|
|
9
9
|
<li class="feed-item">
|
|
10
10
|
<p class="feed-item__date"><time>{{ post.date | date: "%Y-%m-%d"}}</time></p>
|
|
11
|
-
<h1 class="feed-item__title"><a href="{{ post.url }}">{{ post.title }}</a></h1>
|
|
11
|
+
<h1 class="feed-item__title"><a href="{{ post.url | relative_url }}">{{ post.title }}</a></h1>
|
|
12
12
|
</li>
|
|
13
13
|
{% endfor %}
|
|
14
14
|
</ul>
|