Git Product home page Git Product logo

home's Introduction

Typing Jekyll Template

Typing Jekyll Template, is a template for Jekyll built especially for those who want to have a blog and pages quickly and lightly. Keep It Simple, my friend!

Typing Jekyll Template

Table of Contents

Introduction

Its interface is part of the "Keep It Simple" philosophy, precisely to have a high performance in all types of browsers and mobile devices.

You already have a template page for ‘Blog’, ‘Projects’, ‘Search’, ‘Contact’, ‘Tags’ and ‘Resume’, but you can leave as you want, modifying strings.

The 'resume' page, you can print using the browser's Ctrl + P shortcut or the push button. Printing will eliminate useless parts, such as the sidebar. You'll also have a template for post (welcome-tot-jekyll), and you'll have to follow that template header.

The contact page uses the Formspree{: target="_blank"} feature, you will need to have an account in the service and add your e-mail to the _data/data.yml file. In addition, the entire contents of the _data/dbase.yml file should be changed as needed.

Feature

  • Google Analytics
  • Google Fonts
  • Jekyll Search on Blog Page
  • Print page resume
  • Avatar on sidebar
  • 404 Error Page
  • Disqus [Accountant and Comments]
  • Social buttons

Used plugins:

  • Vendors:
    • jekyll-coffeescript
    • jekyll-jsminify
    • jekyll-paginate
    • jekyll-gist
    • jekyll-youtube
    • jekyll-tagging
    • jemoji
    • jekyll-email-protect
    • jektify
  • From the project itself:
    • Readingtime [Estimated reading time]
    • Imager [Responsive Images]
    • DateLang [Complete dates in each languages]
    • Label [Add labels]
    • Endpost [Creates a horizontal line]

Requeriments

Requerid How to check How to install
Git git --version Git
Ruby ruby -v Ruby
Gem gem -v Ruby contains Gem
Python python --version Python
Bundler bundler -v gem install bundler

Usage

1 - Cloning and entering the folder:

$ git clone https://github.com/williamcanin/typing-jekyll-template.git "my-site"
$ cd "my-site"

2 - Downloading Gems and Jekyll dependencies for Typing:

$ bundle install

3 - Compiling project for deploy:

$ JEKYLL_ENV=production bundle exec jekyll b

4 - Starting Jekyll serve:

$ JEKYLL_ENV=development bundle exec jekyll s

O.S Unix

If you use a Unix O.S, you can perform from step 2, all action through the init.sh file. Type it:

$ bash init.sh help

Structure

Home pages

Now the home page is in the "index.md" file in the project root folder. Write a good opening.

Pages Blog / Tags / Search / Sent

The description of the Blog, Tags and Search pages are in their respective folders in the "index.md" file:

  • blog/index.md
  • blog/tags/index.md
  • blog/search/index.md

Edit the values of the properties as desired.

The same goes for the contact sending page.

  • contact/send/index.md

Custom

Resources

In the file "_config.yml" contains a session where you can activate and deactivate some features of the template. By the way , everything to remove from the template, is in this file and what is related to appearance, is in the file "_data/data.yml".

Disqus

To have the comments feature, you must inform your Disqus user in file "_data/data.yml":

userdata:
  disqus:
    username: "myname"

NOTE: Only the comment feature will appear, if the Jekyll environment is production, not development, that is, when executing the command "bundle exec jekyll b".

Appearance

You can change the colors of the Typing Jekyll Template with a simple line changes. In the "_data/data.yml" file, change the "website => theme" property as listed the themes available in the comment. Example:

website:
  theme: "whiteglass"

If you want to customize the theme, choose "custom" and customize the style sheet "_sass/theme/custom.scss" to your liking.

Currently, there are 4(four) that Typing supports:

  • typing (default)
  • hacking
  • whiteglass
  • littlegirl

Feel free to configure as you want. :)

Post and Page

You can create posts and page headers with only one line in the terminal.

post:

$ bundle exec rake post TITLE="My title"

page:

$ bundle exec rake page TITLE="My title"

If you use unix / darwin, you can use the script "init.sh help".

Deploy

Your site will be generated in the _site folder. Deploy these files to your hosting server.

Note: Before deploying to the server, you have to edit the Variables: url and baseurl in the _config.yml file according to url Where your site is crooked. You can get more information on how to set up at: Jekyll Configuration

Deploy GitHub

After doing all the configuration, compile the project with the command "bundle exec jekyll b" and your project can already be sender to your hosting server.

O.S Unix

If you use a UNIX-based operating system, you can deploy the source code and compiled site very simply with the "init.sh" script. You must first configure the "deploy.conf" file for your repository settings.

I) After performing the project clone, empty the factory settings with the "reset" command:

[NOTE IMPORTANT]: Be careful when using this option because it deletes everything that has already been configured. If you do this after you have set up the Git repository (.git), you may need to manually reconcile the GIT commands with pull and fetch. The "init.sh" script does not resolve this issue.

$ bash init.sh reset

II - deploy.conf

[GENERAL]

  • remoteURL - Put here the git's remote URL.
  • commit - Customize the first commit message. By default, you will add the committee date and time.
  • pull - If left with the value of "yes", the pull will be performed before the push.

[ BRANCH CONFIG NAMES ]

  • source - Put the branch where the project source code file will be.
  • built - Put the compiled website branch.

[ BEFORE RAISING THE SITE ]

  • compile - Before deploying the compiled site, it will compile the project. Leave it as "yes" if you want to do this.

III - Commands:

  1. Deploy source files:
$ bash init.sh deploy:source
  1. Deploy the built site:
$ bash init.sh deploy:site

Demo

If you want to see the project in action, go here > Demo

Questions

Make your opinions on Typing Jekyll Template, in: Typing Jekyll Template - Issues

Versions

You can download the versions without making a clone with Git. Go to Releases

License and Copyrights

License: MIT License (MIT)

Copyrights: William C. Canin | Copyright © 2017-2018

You can change the structure of Typing Jekyll Template as you wish, as long as you do not manipulate the copyrights of William C.Canin in the project

Credits

home's People

Contributors

36xreo avatar

Watchers

 avatar

Forkers

manoj585

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.