This document covers building and managing my pages with Jekyll. There are two main sections my blogging info setup and general info.
- Technická část for technical background.
- Správa příspěvků for posts progress.
The master (main) branch reflects current public state of web page. There are some helpers/setups for speed up blogging.
- aplikace, miniaplikace, webové služby
- úvahy
- návody, pokročilejší návody, vývojářské návody
- tipy, pokročilejší tipy, vývojářské tipy
- seznámení, pokročilejší seznámení, vývojářské seznámení
- Windows, Ubuntu (linux), web
- Internet Explorer, Chrome, Chromium, Firefox, Opera
The default options are saved in _config.yml.
| option | available | default / [R]equired | description |
|---|---|---|---|
| layout | all | default | See _layouts |
| -||- | posts | post | -||- |
| in_menu | pages | null | The name of item to show in page side menu/list |
| excerpt_separator | posts | <!--more--> |
|
| permalink | all | [R] | |
| -||- | posts | /blog/:year-:month/:title/ | |
| title | all | [R] | Page/Post name |
| category | all | "" | See blog – mainly (non)dev; Empty by default → listed in both categories |
| tags | posts | List of tags, eg. [tag_1] |
|
| show_toc | all | 0 | Headline level deep to generating TOC, see _includes/show_toc.html |
| reference | posts | See _includes/references_list.html | |
| redirect_from | all | See jekyll/jekyll-redirect-from: Seamlessly specify multiple redirections URLs for your pages and posts. | |
| noindex | all | null | See robots.txt and sitemap.xml |
| date | all | based on filename | In form YYYY-MM-DD HH:MM:SS |
| updated | posts | In form YYYY-MM-DD |
|
| MathJax | all | null | Use MathJax for processing page including mathematics, see _inclused/i/molecule_scriptsBody.html |
My partials/data for simplify creating posts.
In general {% include file ...options %} with standarized options
code,imgand similar tags supproted by Markdown (the idea is to extend these, but still at least particually be able see that in.md). So, example:{% include image.html img=''.href,srcfor links/images/…title,altfor links/images/…captionfor description (eg.<figcaption>)files- Important note: It isn't supported to neste
includecomponents- Instead of:
{% include textBox.html text="{% include kbd.html keys='Ctrl A' %}" %} - Use workaround:
{% capture tmp_kbd %}{% include kbd.html keys='Ctrl A' %}{% endcapture %}{% include textBox.html text=tmp_kbd %}
- Instead of:
{{ site.data.abbr.* }}for using abbreviation<embed src="soubor.pdf" type="application/pdf" width="100%" height="500px" />– see | MDN; it is also possible append tosrc(separated by#) combination ofpage,chapter,zoom,view, …
See Schedule to Publish Future Posts.
Jekyll is a static site generator that's perfect for GitHub hosted blogs (Jekyll Repository). The Build A Blog With Jekyll And GitHub Pages article can be good accsess point for those interested in using it for their own blog.
- Prerequisite, see Installation | Jekyll • Simple, blog-aware, static sites.
- Install Jekyll and plug-ins in one fell swoop.
gem install github-pagesThis mirrors the plug-ins used by GitHub Pages on your local machine including Jekyll, Sass, etc. - Clone down your fork
git clone https://github.com/yourusername/yourusername.github.io.git - Serve the site and watch for markup/sass changes
jekyll serve - View your website at http://127.0.0.1:4000/
- Commit any changes and push everything to the master branch of your GitHub user repository. GitHub Pages will then rebuild and serve your website.