Jekyll-theme-space is my new Jekyll theme for my blog (in spanish)
This theme is lighwight and responsive, this last include tables, images, videos and iframe videos, like Youtube and Vimeo
Include support for jekyll-seo-tag, Google Analytics and Disqus for comments, and include links on any post for share on various social networks, WhatsApp and Telegram. And support too categories and tags.
Add this lines to your Jekyll site's Gemfile
:
gem "jekyll-theme-space"
gem "jekyll-paginator" # This line isn't necessary if you use github-pages
gem "jekyll-seo-tag" # If you can use this plugin
Add this lines to your Jekyll site's _config.yml
:
theme: jekyll-simple-dark
plugins:
- jekyll-paginate
- jekyll-seo-tag #if you use this.
paginate: 5 # Posts per page
paginate_path: "page:num/"
Rename index.md to index.html and change layout to home
For search create a new file on the site root foolder called search.json with this content:
---
---
[
{% for post in site.posts %}
{
"title" : "{{ post.title | strip_html | escape }}",
"url" : "{{ site.baseurl }}{{ post.url }}",
"category" : "{{post.categories | join: ', '}}",
"tags" : "{{ post.tags | join: ', ' }}",
"date" : "{{ post.date }}",
"description" : "{{post.description | strip_html | strip_newlines | escape }}"
} {% unless forloop.last %},{% endunless %}
{% endfor %}
]
Note: You can change post.description to post.content, but innsert description is much better, use post.content only create a big file and also inaccurate search result.
And then execute:
$ bundle
Or install it yourself as:
$ gem install jekyll-theme-space
For activate social links add these lines on your _config.yml:
social_links: true # If true show social links
rss: true # For add icon to link feed.xml
facebook:
github:
gplus:
instagram:
linkedin:
pinterest:
twitter:
vimeo:
youtube:
Just add the ones you're going to use.
Note: gplus is for Google+ link.
Insert the iframe code into a div whit the class video and remove width and height attributes, like this:
<div class="video">
<iframe src="https://www.youtube.com/embed/<videoID>" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
</div>
For use Google Analytics include this line on _config.yml and replace <code> for your Google Analytics code:
google-analytics: <code>
Where <code> is your Google Analytics code.
For use you only need add this plugin on the plugins array on _config.yml
Simple create a new file on the root and set categories as layout. Same for tags. For add simple add these variables on YAML head of post. For example:
category: Jekyll
tags:
- jekyll
- tutorial
If you do not want a page to appear in the menu, simply add this is the YAML header on the desired pages:
include this in _config.yml
related_post: true
onmenu: false
For add custom 404 page create a new page in your site root folder called 404.md or 404.html start width this yaml head:
---
layout: 404
permalink: /404.html
---
- normalize.css use for reset default styles on browsers.
- Fontello for make the icon font.
- Simple-Jekyll-Search for search. Thans to Webjeda for the tutorial.
- Exo as the default font.
- Monokai for highlight thakns to https://github.com/richleland/pygments-css
- Background image is donwload from here
Bug reports and pull requests are welcome on GitHub at https://github.com/sonlink/jekyll-theme-space. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
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
. 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.
When your theme is released, only the files in _layouts
, _includes
, _sass
and assets
tracked with Git will be bundled.
To add a custom directory to your theme-gem, please edit the regexp in jekyll-space.gemspec
accordingly.
The theme is available as open source under the terms of the MIT License.