jekyll-theme-jsblog 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 42e643355884076d5ab9d14c35db5fb400f6e148a920555a60ceb9d731b1fae4
+  data.tar.gz: 8599f0145b5442d138076d29e21549104240670e699fb9124b747973ec294377
+SHA512:
+  metadata.gz: 5a2a6d230f57b1cb6b00e7341be9caa38330d9d64c86d5af0572ce25bcc3044caed639d8aec98a77c3b2e321ce7c42a57f243ade1faf4343f76cd83da7719f35
+  data.tar.gz: 65056b9b1b9690d6b4597a6eeb5fcaa5a3714a6faadc4e3f039e1725f3af808ada3f3e2051aa6561b8a9d0842c293e77946ee2573e41bfb81ba490c9631160e0

data/LICENSE

@@ -0,0 +1,23 @@
+The MIT License (MIT)
+
+Original Theme Copyright (c) 2017 Chayoung You
+`jekyll-apple` Theme Copyright (c) 2018 Jamie Bishop
+`jekyll-theme-jsblog` Theme Copyright (c) 2019 Julian Schiavo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,341 @@
+# jekyll-theme-jsblog
+
+<!--[![Gem Version](https://badge.fury.io/rb/jekyll-theme-jsblog.svg)](https://badge.fury.io/rb/jekyll-theme-jsblog)
+[![Build Status](https://travis-ci.org/justjs/jekyll-theme-jsblog.svg?branch=master)](https://travis-ci.org/justjs/jekyll-theme-jsblog)-->
+
+Minimal, responsive theme used on my blog.
+
+![jsblog theme](screenshot.png)
+
+## Installation
+
+Add this line to your Jekyll site's Gemfile:
+
+``` ruby
+gem "jekyll-theme-jsblog"
+```
+
+And add this line to your Jekyll site's `_config.yml`:
+
+``` yaml
+theme: jekyll-theme-jsblog
+```
+
+And then execute:
+
+``` sh
+bundle
+```
+
+Or install it yourself as:
+
+``` sh
+gem install jekyll-theme-jsblog
+```
+
+## Quick Start
+
+1. Generate a new Jekyll blog:
+
+   ``` sh
+   jekyll new blog --skip-bundle
+   cd blog
+   ```
+
+2. Edit `Gemfile` to use the theme:
+
+   ``` ruby
+   gem "jekyll-theme-jsblog"
+   ```
+
+3. Edit `_config.yml` to use the theme and its plugins:
+
+   ``` yaml
+   theme: jekyll-theme-jsblog
+   plugins:
+     - jekyll-paginate
+     - jekyll-sitemap
+
+   permalink: /:year/:month/:day/:title/
+   paginate_path: /posts/:num/
+   paginate: 5
+   ```
+
+4. Copy
+   [`index.html`](https://github.com/justjs/jekyll-theme-jsblog/blob/master/index.html),
+   [`about.md`](https://github.com/justjs/jekyll-theme-jsblog/blob/master/about.md),
+   [`archives.md`](https://github.com/justjs/jekyll-theme-jsblog/blob/master/archives.md),
+   [`feed.xml`](https://github.com/justjs/jekyll-theme-jsblog/blob/master/feed.xml), and
+   [`_data/navigation.yml`](https://github.com/justjs/jekyll-theme-jsblog/blob/master/_data/navigation.yml)
+   from the theme:
+
+   ``` sh
+   rm index.md
+   curl -L -O "https://github.com/justjs/jekyll-theme-jsblog/raw/master/{index.html,about.md,archives.md,feed.xml}"
+   curl -L --create-dirs -o _data/navigation.yml https://github.com/justjs/jekyll-theme-jsblog/raw/master/_data/navigation.yml
+   ```
+
+5. Install gems and you're good to go! The blog will be available on
+   `http://127.0.0.1:4000`.
+
+   ``` sh
+   bundle install
+   bundle exec jekyll serve
+   ```
+
+## Deployment to GitHub Pages using Travis CI
+
+This theme uses [jekyll-archives](https://github.com/jekyll/jekyll-archives) gem
+which is [not supported by GitHub Pages](https://help.github.com/articles/configuring-jekyll-plugins/).
+If you want to use full features like categories and tags, I recommend you to
+use Travis CI or other CI services.
+
+To deploy using Travis CI, first copy the [`.travis.yml`](.travis.yml) of this
+repository. You can change `target-branch` (`gh-pages` by default) and
+`on.branch` (`master` by default) as you want. If you want further
+customization, see [Travis CI's documentation page](https://docs.travis-ci.com/user/deployment/pages/).
+
+You'll see there's `github-token: $GITHUB_TOKEN`, and this is what you should
+configure. Go to your [personal access tokens](https://github.com/settings/tokens)
+page, and generate new token with `public_repo` or `repo` permission as you
+need. Then go to Travis CI's settings page of your repository, and add a new
+environment variable `GITHUB_TOKEN` with the value of the token you generated.
+
+## Usage
+
+### Customization
+
+To override the default structure and style of this theme, simply create the
+concerned directory at the root of your site, copy the file you wish to
+customize to that directory, and then edit the file. e.g., to override the
+[`_includes/footer_content.html`](_includes/footer_content.html) file to add
+contents to footer, create an `_includes` directory, copy
+`_includes/footer_content.html` from jekyll-theme-jsblog gem folder to
+`<your-site>/_includes` and start editing that file.
+
+For example, you can add favicons to `_includes/head_custom.html`:
+
+``` html
+<link rel="icon" type="image/x-icon" href="{{ "/favicon.ico" | relative_url }}">
+<link rel="apple-touch-icon" href="{{ "/apple-touch-icon.png" | relative_url }}">
+<link rel="apple-touch-icon" sizes="76x76" href="{{ "/apple-touch-icon-76x76.png" | relative_url }}">
+<link rel="apple-touch-icon" sizes="120x120" href="{{ "/apple-touch-icon-120x120.png" | relative_url }}">
+<link rel="apple-touch-icon" sizes="152x152" href="{{ "/apple-touch-icon-152x152.png" | relative_url }}">
+<link rel="apple-touch-icon" sizes="180x180" href="{{ "/apple-touch-icon-180x180.png" | relative_url }}">
+```
+
+The site's default CSS is in the gem itself,
+[`assets/main.scss`](assets/main.scss). To override the default CSS, the file
+has to exist at your site source. Do either of the following:
+
+- Create a new instance of `main.scss` at site source
+  - Create a new file `main.scss` at `<your-site>/assets/`
+  - Add the frontmatter dashes, and
+  - Add `@import "theme-jsblog";`, to `<your-site>/assets/main.scss`
+  - Add your custom CSS
+- Download the file from this repo
+  - Create a new file `main.scss` at `<your-site>/assets/`
+  - Copy the contents at [`assets/main.scss`](assets/main.scss) onto the `main.scss` you just created, and edit away
+- Copy directly from jekyll-theme-jsblog gem
+  - Go to your local jekyll-theme-jsblog gem installation directory (run `bundle show jekyll-theme-jsblog` to get the path to it)
+  - Copy the `assets/` folder from there into the root of `<your-site>`
+  - Change whatever values you want, inside `<your-site>/assets/main.scss`
+
+### Locale
+
+`site.lang` is used to declare the primary language for each web page within the
+site.
+
+`lang: en-US` sets the `lang` attribute for the site to the United States flavor
+of English, while `en-GB` would be for the United Kingdom style of English.
+Country codes are optional and the shorter variation `lang: en` is also
+acceptable. You may want to write a post in different language, then add `lang`
+attribute to the frontmatter of that post:
+
+``` yaml
+layout: post
+title: "안녕하세요"
+lang: ko
+```
+
+### Description
+
+`site.description` describes the site. This is mainly used in meta descriptions
+for improving SEO. Also, you can set `description` attribute for each post:
+
+``` yaml
+layout: post
+title: Awesome Post
+description: This is an awesome post.
+```
+
+If you don't specify `post.description`, then `post.excerpt` will be used if it
+exist.
+
+### External URL
+
+`external-url` turns the title of your post to a link. Specify a URL which you
+want to link to.
+
+``` yaml
+layout: post
+title: Jekyll Theme
+external-url: https://github.com/justjs/jekyll-theme-jsblog
+```
+
+Then the title of your post would look like a link with text
+`Jekyll Theme →`. This also applies to your blog feed.
+
+### Category
+
+Each post can have `categories` attribute. It can be a string or an array. This
+will be displayed on index, archive and each post, and provide a link to the
+archive of category.
+
+``` yaml
+layout: post
+title: Awesome Post
+categories: Misc
+```
+
+``` yaml
+layout: post
+title: Another Awesome Post
+categories:
+  - Misc
+  - Idea
+```
+
+### Tag
+
+Each post can have `tags` attribute. It can be a string or an array. This will
+be displayed on index, archive and each post, and provide a link to the archive
+of tag.
+
+``` yaml
+layout: post
+title: Awesome Post
+tags: food
+```
+
+``` yaml
+layout: post
+title: Another Awesome Post
+tags:
+  - food
+  - trip
+```
+
+### Feed
+
+Create `<your-site>/feed.xml` with:
+
+``` yaml
+---
+layout: feed
+---
+```
+
+If you want to use another path for feed, you can specify a non-default path via
+your site's config.
+
+``` yaml
+feed:
+  path: atom.xml
+```
+
+Then create `<your-site>/atom.xml` with the same content of `feed.xml` above.
+
+### Comments
+
+This theme provides the ability to include your favourite commenting service, like [Disqus](https://disqus.com) or [Isso](https://posativ.org/isso).
+
+To enable comments on pages and posts:
+1. Overwrite the `_includes/custom_comments_provider.html` with your custom provider of comments.
+2. Add `comments: true` to your `_config.yml`.
+
+To disable comments on certain pages or posts specify `comments: false` in the front matter of the page or post.
+
+### Metadata for SEO
+
+#### Keywords
+
+Each post can have `keywords` attribute. This is a comma-separated list which is
+used in meta descriptions for improving SEO.
+
+``` yaml
+layout: post
+title: How to configure jekyll-theme-jsblog
+keywords: jekyll, js, github pages
+```
+
+YAML list is also available:
+
+``` yaml
+keywords:
+  - jekyll
+  - js
+  - github pages
+```
+
+#### Twitter
+
+- `site.twitter_username` sets `twitter:site` and `twitter:creator` meta tag
+- `site.twitter_image` sets `twitter:image:src` meta tag
+- `page.twitter_card.type` sets `twitter:card` meta tag (default: `summary`)
+  - If `page.twitter_card.type` is `gallery`, it sets `twitter:image0`, `twitter:image1`, `twitter:image2` and `twitter:image3` meta tags with `page.twitter_card.image`, `page.twitter_card.image1`, `page.twitter_card.image2` and `page.twitter_card.image3`, respectively
+  - If `page.twitter_card.type` is `photo`, `page.twitter_card.width` sets `twitter:image:width` meta tag and `page.twitter_card.height` sets `twitter:image:height` meta tag
+- `page.twitter_card.creator` sets `twitter:creator` meta tag. It overrides `site.twitter_username`
+- `page.twitter_card.image` sets `twitter:image:src` meta tag if `page.twitter_card.type` is not `gallery`. It overrides `site.twitter_image`
+
+#### Facebook
+
+- `site.facebook_app_id` sets `fb:admins` meta tag
+- `site.facebook_page` sets `article:author` meta tag
+- `site.facebook_image` sets `og:image` meta tag
+- `page.facebook.image` sets `og:image` meta tag. It overrides `site.facebook_image`
+
+### Navigation
+
+To define header links, add titles and URLs under the `main` key in
+`_data/navigation.yml`:
+
+``` yaml
+main:
+  - title: "About"
+    url: /about/
+  - title: "GitHub"
+    url: https://github.com/justjs/jekyll-theme-jsblog
+```
+
+### Enabling Google Analytics
+
+To enable Google Analytics, add the following lines to your Jekyll site:
+
+``` yaml
+google_analytics: UA-NNNNNNNN-N
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at
+<https://github.com/justjs/jekyll-theme-jsblog>. 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.
+
+## Development
+
+To set up your environment to develop this theme, run `bundle install`.
+
+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/jsblog/`. 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.
+
+## License
+
+The theme is available as open source under the terms of the
+[MIT License](http://opensource.org/licenses/MIT).

data/_includes/custom_comments_provider.html

@@ -0,0 +1,3 @@
+<hr />
+<h1>Comments</h1>
+<p>Insert your custom comment provider like <a href="https://disqus.com">Disqus</a> or <a href="https://posativ.org/isso">Isso</a> here.</p>

data/_includes/fonts.html

@@ -0,0 +1,2 @@
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css?family=Bitter:400,400i,700" rel="stylesheet">

data/_includes/footer.html

@@ -0,0 +1,11 @@
+<footer class="site-footer">
+
+  <div class="wrapper">
+
+    <p>
+      {% include footer_content.html %}
+    </p>
+
+  </div>
+
+</footer>

data/_includes/footer_content.html

@@ -0,0 +1,5 @@
+{% assign feed_path = "/feed.xml" %}
+{% if site.feed and site.feed.path %}
+  {% assign feed_path = site.feed.path %}
+{% endif %}
+&copy; {{ site.author }} - Powered by <a href="https://jekyllrb.com">Jekyll</a> <!--&amp; <a href="https://github.com/justjs/jekyll-theme-jsblog">jsblogtheme</a>--> - Subscribe via <a href="{{ feed_path | absolute_url }}">RSS</a>

data/_includes/google_analytics.html

@@ -0,0 +1,13 @@
+{% if site.google_analytics %}
+  <!-- Google Analytics -->
+  <script>
+    (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+    (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+    m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+    })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+    ga('create', '{{ site.google_analytics }}', 'auto');
+    ga('send', 'pageview');
+
+  </script>
+{% endif %}

data/_includes/head.html

@@ -0,0 +1,78 @@
+<head>
+  <meta charset="utf-8">
+  <meta http-equiv="X-UA-Compatible" content="IE=edge">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+
+  {% assign title = page.title | default: site.title | escape %}
+  {% assign canonical = page.url | replace:'index.html','' | absolute_url %}
+  {% assign description = page.description | default: page.excerpt | default: site.description | strip_html | normalize_whitespace | escape %}
+  <title>{{ title }}</title>
+  <meta name="description" content="{{ description }}">
+  {% if page.keywords %}
+    {% if page.keywords.first %}
+      {% assign keywords = page.keywords | join: ',' %}
+    {% else %}
+      {% assign keywords = page.keywords %}
+    {% endif %}
+    <meta name="keywords" content="{{ keywords }}">
+  {% endif %}
+
+  <link rel="stylesheet" href="{{ "/assets/main.css" | relative_url }}">
+  <link rel="canonical" href="{{ canonical }}">
+  {% assign feed_path = "/feed.xml" %}
+  {% if site.feed and site.feed.path %}
+    {% assign feed_path = site.feed.path %}
+  {% endif %}
+  <link rel="alternate" type="application/rss+xml" title="{{ site.title | escape }}" href="{{ feed_path | absolute_url }}">
+
+  <link rel="icon" type="image/x-icon" href="/favicon.ico">
+  <link rel="apple-touch-icon" href="/apple-touch-icon.png">
+  <link rel="apple-touch-icon" sizes="76x76" href="/apple-touch-icon-76x76.png">
+  <link rel="apple-touch-icon" sizes="120x120" href="/apple-touch-icon-120x120.png">
+  <link rel="apple-touch-icon" sizes="152x152" href="/apple-touch-icon-152x152.png">
+  <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon-180x180.png">
+
+  {% include head_custom.html %}
+
+  {% if site.facebook_app_id %}
+    <meta property="fb:admins" content="{{ site.facebook_app_id }}">
+    <meta property="og:title" content="{{ title }}">
+    <meta property="og:site_name" content="{{ site.title | escape }}">
+    <meta property="og:url" content="{{ canonical }}">
+    <meta property="og:description" content="{{ description }}">
+    {% if site.facebook_page %}<meta property="article:author" content="{{ site.facebook_page }}">{% endif %}
+    {% if page.facebook.image %}
+      <meta property="og:image" content="{{ page.facebook.image }}">
+    {% elsif site.facebook_image %}
+      <meta property="og:image" content="{{ site.facebook_image }}">
+    {% endif %}
+  {% endif %}
+  <meta name="twitter:card" content="{{ page.twitter_card.type | default: "summary" }}">
+  {% if site.twitter_username %}<meta name="twitter:site" content="{{ site.twitter_username }}">{% endif %}
+  <meta name="twitter:title" content="{{ title | truncate: 70 }}">
+  <meta name="twitter:description" content="{{ description | truncate: 200 }}">
+  {% if page.twitter_card.creator %}
+    <meta name="twitter:creator" content="{{ page.twitter_card.creator }}">
+  {% elsif site.twitter_username %}
+    <meta name="twitter:creator" content="{{ site.twitter_username }}">
+  {% endif %}
+  {% if page.twitter_card.image %}
+    {% if page.twitter_card.type == 'gallery' %}
+      <meta name="twitter:image0" content="{{ page.twitter_card.image }}">
+      <meta name="twitter:image1" content="{{ page.twitter_card.image1 }}">
+      <meta name="twitter:image2" content="{{ page.twitter_card.image2 }}">
+      <meta name="twitter:image3" content="{{ page.twitter_card.image3 }}">
+    {% else %}
+      <meta name="twitter:image:src" content="{{ page.twitter_card.image }}">
+      {% if page.twitter_card.type == 'photo' %}
+        {% if page.twitter_card.width %}<meta name="twitter:image:width" content="{{ page.twitter_card.width }}">{% endif %}
+        {% if page.twitter_card.height %}<meta name="twitter:image:height" content="{{ page.twitter_card.height }}">{% endif %}
+      {% endif %}
+    {% endif %}
+  {% elsif site.twitter_image %}
+    <meta name="twitter:image:src" content="{{ site.twitter_image }}">
+  {% endif %}
+
+  {% include fonts.html %}
+  {% include google_analytics.html %}
+</head>