jekyll-theme-isabelline 0.1.7 → 0.1.8

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.
Files changed (4) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +47 -23
  3. data/_includes/footer.html +1 -1
  4. metadata +2 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: d1ac9d1ab122327a347b63634460e9e27eca1f3a96b9048e575826daadf6785a
4
- data.tar.gz: be20039cfafe23ae3726c61021e9bc155731bdf5b4b841521950ebf2da616882
3
+ metadata.gz: c86e7ba806cf1689be2fe65ccef7ce8011e118ffca5f50a02968c94e3548ee88
4
+ data.tar.gz: 855aa3f4f2e56526af0361db65d7c6053a837ab3b2e6fa570b18a103b86a14ec
5
5
  SHA512:
6
- metadata.gz: fb2442d7e0c4af10f546598a9ee9b17d2f4ff9e506c44bd26ba302bb95f44ac594e1ea9bcaad303c8f61da7ea54080ec01716d6399f807833ce3640e894f9c40
7
- data.tar.gz: fe71026b4f98f2bb9159f860c7b9f913de9b39856e60e66406b1f79edc035db09711b06a3dc0cfad9108688414c404fbaf0959ddb6d893a584a3ca2d92560d12
6
+ metadata.gz: 53d3da548f5ec902fc5655f527bbd5150681567a5c66a58b40f3812fe0d2e00768cca67a53fc4af8a66e0e5b1f01f997b4bcd69e4994ec07b19ef2582800a2c0
7
+ data.tar.gz: 1067bf70e9496673aac0d3ae6cd2c93b8ac5c9cdcc52094d7a83ce903aabc0dbae2815554157daf204aa90e20960978fc28d5e2fb07f55e1b66855125ca1a393
data/README.md CHANGED
@@ -1,54 +1,78 @@
1
1
  # jekyll-theme-isabelline
2
2
 
3
- Welcome to your new Jekyll theme! In this directory, you'll find the files you need to be able to package up your theme into a gem. Put your layouts in `_layouts`, your includes in `_includes`, your sass files in `_sass` and any other assets in `assets`.
3
+ Simple clean mobile-friendly theme for long form blogging. Also good for private note taking.
4
4
 
5
- To experiment with this code, add some sample content and run `bundle exec jekyll serve` – this directory is setup just like a Jekyll site!
5
+ ## Installation
6
6
 
7
- TODO: Delete this and the text above, and describe your gem
7
+ Fundamentally setting up a jekyll website with a theme is a straightforward process.
8
8
 
9
+ 1. Start with a website ([new](#how-to-create-new-jekyll-website) or existing).
9
10
 
10
- ## Installation
11
+ 2. Update Gemfile to reference the new theme and plugins it requires
11
12
 
12
- Add this line to your Jekyll site's `Gemfile`:
13
+ 3. (Optionally) Backup previous configs.
13
14
 
14
- ```ruby
15
- gem "jekyll-theme-isabelline"
16
- ```
15
+ 4. Copy `isabelline`'s starter `_config.yaml` and customize it to your liking.
16
+
17
+ 5. Run bundle install.
18
+
19
+ ## Docker based cookbook
17
20
 
18
- And add this line to your Jekyll site's `_config.yml`:
21
+ ### How to create a new jekyll website
19
22
 
20
- ```yaml
21
- theme: jekyll-theme-isabelline
23
+ ```sh
24
+ $ docker run --rm -it -v "$PWD:/srv/jekyll" jekyll/jekyll:3.8 jekyll new .
22
25
  ```
23
26
 
24
- And then execute:
27
+ ### How to backup previous configs
28
+
29
+ `isabelline` needs the following files placed in the root directory of your jekyll website:
30
+
31
+ `index.html`
32
+
33
+ `_config.yaml`
34
+
35
+ `Gemfile`
36
+
37
+ `404.html`
25
38
 
26
- $ bundle
39
+ `private.html`
27
40
 
28
- Or install it yourself as:
41
+ `docker-compose.yaml`
29
42
 
30
- $ gem install jekyll-theme-isabelline
43
+ These need to be copied manulaly.
31
44
 
32
- ## Usage
33
45
 
34
- This theme supports pages, posts and blogs. Unlike posts, blogs can be setup to not show the date of the post in the article's URL.
46
+ ### Basic customization
35
47
 
36
- Theme can be configured by tweaking `_sass/_config.scss`. To do so you need to first copy it from [github]() and place in `_sass/_config.scss`.
48
+ Simply follow instructions in `_config.yaml`.
49
+
50
+
51
+ ### Run jekyll locally using docker
52
+
53
+ ```sh
54
+ $ docker-compose up jekyll-serve
55
+ ```
56
+
57
+
58
+ ### Tweaking color scheme
59
+
60
+ `isabelline` is a pretty color but she likes to play. Copy `_config.scss` from the source and place it under `_sass/_config.scss`. Follow instructions in that file on how to adjust colors.
37
61
 
38
- All colors are derived from `$hue`. You can tweak individual colors to your liking further down the config file.
39
62
 
40
63
  ## Contributing
41
64
 
42
65
  Bug reports and pull requests are welcome on GitHub at https://github.com/rzen/jekyll-theme-isabelline. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
43
66
 
67
+
44
68
  ## Development
45
69
 
46
- To set up your environment to develop this theme, run `bundle install`.
70
+ To develop and test simply run from the root of a cloned `jekyll-theme-isabelline` project:
47
71
 
48
- 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.
72
+ ```sh
73
+ $ docker-compose up jekyll-serve
74
+ ```
49
75
 
50
- When your theme is released, only the files in `_layouts`, `_includes`, `_sass` and `assets` tracked with Git will be bundled.
51
- To add a custom directory to your theme-gem, please edit the regexp in `jekyll-theme-isabelline.gemspec` accordingly.
52
76
 
53
77
  ## License
54
78
 
@@ -2,7 +2,7 @@
2
2
  <nav>
3
3
  <p>
4
4
  <span class="copy">&copy;</span> {{ 'now' | date: '%Y' }} {{ site.copyright_owner.full_name }}.
5
- <a href="/legal/">MIT License</a>.
5
+ <a href="{{ site.license.url | default: '/legal/' }}">{{ site.license.name }}</a>.
6
6
  <a class="edit" href="{{ site.edit_url | append: page.path }}">Edit</a>.
7
7
  </p>
8
8
  </nav>
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: jekyll-theme-isabelline
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.1.7
4
+ version: 0.1.8
5
5
  platform: ruby
6
6
  authors:
7
7
  - Rouslan Zenetl
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2019-07-22 00:00:00.000000000 Z
11
+ date: 2019-07-23 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: jekyll