TeXt is a succinct theme for blogging. Similar to iOS 11 style, it has large and prominent titles and round buttons & cards.
- Responsive
- Paginate (jekyll-paginate)
- Table of contents (TOC)
- Tag
- Reading quantity (LeanCloud)
- Emoji (Jemoji)
- Comment (Disqus)
- Google Analytics
- Contact information (Email, Facebook, Twitter, Linkedin, Weibo, Zhihu, etc)
- Semantic HTML
- Icon automation tool (gulp-svg2png, gulp-to-ico)
- Color Theme
- Mathematical formula (MathJax)
- RSS(jekyll-feed)
- Multi-language support(English | Simplified Chinese | Traditional Chinese)
The easiest way is making a fork of the repository and rename it to <username>.github.io
, then you can clone it to local, commit your changes and push.
And also, you can get the source code of the theme at the release page.
Add your information in the ./_config.yml file, such as your name, contact, title of the site and so on.
Write your brief introduction in the ./about.md file.
To create a new post, all you need to do is create a file in the ./_posts directory. the blog post files need to be named as the format YEAR-MONTH-DAY-title.MARKUP
, for example 2011-12-31-new-years-eve-is-awesome.md
. You can find more info at Jekyll: Writing Posts.
There are two excerpt types: TEXT type and HTML type. You can change it by setting the value of excerpt_type
in the ./_config.yml file.
excerpt_type | type | description |
---|---|---|
text | TEXT | the excerpt are plain text that filters out all non-text elements (such as title, link, list, table, picture, etc.) and only show 350 characters most. |
html | HTML | the excerpt are HTML document just like the content of the article, This will show all the content by default, except adding <!--more--> in the article Markdown file, You can find more info at Jekyll: Post#post-excerpts. |
Find more info at Jekyll: Installation.
if you Installed Node.js, you can start a development server by running npm run dev
at the root path of the repository.
if not, just run:
bundle exec jekyll serve -H 0.0.0.0
after the command finished, you can visit http://localhost:4000/ to see the page.
You can find more info at Jekyll: Usage.
default |
dark |
forest |
ocean |
---|---|---|---|
This theme comes with a "ginkgo leaf" icon, you can replace it with your own icon. The site's icons are located in the ./favicon.ico and ./assets/images/logo directories. You can see the logo directory has a lot of png files and a svg vector file. Those png images are actually images of different sizes generated from svg vector images that may used in some scenes, such as pinned to the screen in OS and Android and tiles in Windows 10.
This theme provides an automated script for automatically generating favicon and png files from svg vector graphics. What you have to do is:
-
Install Node.js
-
Run
npm i
command at the root directory. -
Replacing the logo.svg file in the ./assets/images/logo directory.
-
Run
npm run artwork
command. after it finished, the favicon and png files will be replaced by the new logo.svg generated files.
In addition to Jekyll's front matters, the theme adds some unique front matters.
variable | option values | description |
---|---|---|
key | ||
picture_frame | shadow | |
modify_date | ||
comment | true/false | |
mathjax | true/false |