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!
- Introduction
- Feature
- Requeriments
- Usage
- Custom Appearance
- Deploy
- Demo
- Questions
- Versions
- License and Copyrights
- Credits
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.
- 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]
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 |
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
Now the home page is in the "index.md" file in the project root folder. Write a good opening.
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
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".
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. :)
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".
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
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:
- Deploy source files:
$ bash init.sh deploy:source
- Deploy the built site:
$ bash init.sh deploy:site
If you want to see the project in action, go here > Demo
Make your opinions on Typing Jekyll Template, in: Typing Jekyll Template - Issues
You can download the versions without making a clone with Git. Go to Releases
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
- Name: William C. Canin
- Country: Brazil - SP
- EMail: [email protected]
- GitHub: William Canin
- Home page: William Canin