The customization options in AOKP ROM are just insane. Please take a deep breath before reading the list below.
Nightly builds can be a bit unstable, but then they are nightly builds. However, for some people this can be a deal breaker
If after reading the above post, you are still confused, I would suggest you to simply try out both the ROMs. Also, keep in mind that the pros of one ROM automatically becomes the cons of another, and vice-versa. There is no difference in battery life between both the ROMs, since both the ROMs are generally based on a slightly modified stock kernel.
However, users may slight performance difference between both the ROMs on the same device. Ideally, there should not really be any performance difference between both the ROMs, since AOKP is based on CyanogenMod’s device tree. From the above comparison, it should be quite clear that the CyanogenMod team is no longer in the race to offer the most customizable custom ROM.
Instead, their goal is now to offer a ROM that behaves and looks like stock, but comes with some basic customization options. On the other hand, one of main goals of AOKP ROM is to offer its users the ability to customize each and every aspect of the Android OS running on their device.
固态硬盘（Solid State Disk、Solid State Drive，简称 SSD）是一种以存储器作为永久性存储器的计算机存储设备。 虽然 SSD 已不是使用“碟”来记存数据，而是使用 NAND Flash，但是人们依照命名习惯，仍然称为固态硬盘（Solid-State Disk）或固态驱动器（Solid-State Drive）。当然，SSD 内也没有用来驱动（Drive）旋转的马达。
由于固态硬盘技术与传统硬盘技术不同，所以产生了不少新兴的存储器厂商。厂商只需使用闪存（NAND），再配合适当的控制芯片，就可以制造固态硬盘了。新一代的固态硬盘普遍采用 SATA-3 接口. 1
SSD 固态硬盘价格更高，容量相对普通硬盘要低，相同容量的 SSD 比 HDD 的要贵一倍不止，但是读取速度要比 HDD 的快，抗震性能强，而且体积比 HDD 硬盘要小，发热量也要小的多，节能省电也是 SSD 的优势。
4K 对齐是一种高级硬盘使用技术，用特殊方法将文件系统格式与硬盘物理层上进行契合，为提高硬盘寿命与高效率使用硬盘空间提供解决方案。因该技术将物理扇区与文件系统的每簇 4096 字节对齐而得名。2
4K 对齐教程：http://diybbs.zol.com.cn/1/34028_1553.html
SATA 是 Serial ATA 的缩写，即串行 ATA。看维基知道,SATA 接口是用来取代 IDE 接口的.SATA 接口目前有三代 3
非官方民间称呼 SATA2,SATA3,看维基百科上面还有一代 Express 版本的.
mSATA (mini-SATA)是迷你版本 SATA 接口
Bash 使用过程中一些非常小的技巧，记录一下。
在习惯了 less +F /var/log/syslog 之后可以完全抛弃 tailf .
按下 Alt + . 会在命令行中插入上一个命令的参数，非常适合参数比较复杂时直接插入参数。
当你发现在命令行中输入太多内容了，那么尝试一下 Ctrl + x + Ctrl + e ，Bash 会打开 $EDITOR 然后编辑你的命令，一旦输入保存退出，那么 Bash 会立即执行该命令。
Google 每年愚人节都会弄一系列的愚人游戏，去年整理的在这里，http://www.einverne.tk/2012/04/2012-april-fool-day-google.html
##Google Nose Google 灵鼻子 Google Nose 是一款能够告诉你气味的产品，在 Google 搜索中搜索关键词，在右边就会显示出闻一闻
搜索中新增气味查询功能
气味扑鼻：在打字、说话和触摸的基础上，新增一种感官体验。 您的互联网侍酒师：专家精心设计的知识面板，配有图片、说明和气味介绍。 左闻右嗅：Google 百味库由超过 1500 万个气味字节组成。 不闻不问：如果您不希望查询中出现某些内容，请启用安全搜索功能。
那是什么气味？
Google 灵鼻子 Beta 将新技术与现有技术相结合，可提供最敏锐的嗅觉体验： 街味嗅闻汽车已经嗅遍了数百万英里的空气，并将它们编入了索引。 Android 周边气味检测工具可通过全世界最敏感的移动操作系统收集气味。 SMELLCD™ 1.8+ 具有很高的分辨率，能精确地控制气味并将气味散播开来。
##Google Maps 藏宝图 Google 的街景拍摄团队在拍摄时偶然在海底发现一箱藏宝图
##Gmail Blue Everything is Blue
https://www.gmail.com/mail/help/intl/en/promos/blue/
##Google+Photo Emotion
https://plus.google.com/+ErikMurphyChutorian/posts/6cbXigttnUL
##YouTube 寻找全球最佳视频
##Google Schmick
##Google Fiber Poles
##Google Apps 提供 Levity Algorithm
##Google Analytics 提供来自国际空间站的访客信息
##Google 日语输入法发布
##Google Wallet Mobile ATM Google Wallet Mobile ATM 帮你随时随地从手机里获得现金 Link
要了解 WiFi 那么则先要分清楚这几个名词，WiFi，WLAN:
在 WLAN 中有几个常见的名词，比如：
如果稍微留意一下家用路由器的设置后台就会发现，除了网络名称，加密方式之外还有无线模式，和信道之别。大部分家用路由器是无法设置信道的，但是如果用 OpenWrt 或者刷了其他固件可能会有调整设置。而这里的信道就是指的在 2.4GHz 或者 5GHz 下不同的频率的传输通道，2.4 GHz 频段频率范围为 2.400—2.4835GHz，下面划分了 14 个信道。现在的家用网络环境越来越复杂，所以导致相同频率之间的设备可能会有干扰，所以手动先观察周围的信道 (Android 下可以使用开源的 WiFiAnalyzer)，再选择一个不干扰的信道可以优化一下家用网络环境。
802.11 划分了四个独立频段，2.4 GHz、3.6 GHz、4.9 GHz 和 5.8 GHz 1
2.4 GHz 频段频率范围为 2.400—2.4835GHz，共 83.5M 带宽，在 2.4 GHz 下又划分了 14 个信道，每个子信道宽度为 22MHz，相邻信道的中心频点间隔 5MHz。观察信道的频率重合就能发现，信道 1,2,3,4,5 频率有重叠，整个 2.4 GHz 频段内只有 1,6,11 互不干扰。
IEEE 802.11b 是无线局域网的一个标准，载波的频率为 2.4GHz，传送速度为 11Mbit/s . IEEE 802.11b 的后继标准是 IEEE 802.11g，其传送速度为 54Mbit/s。所以我们日常提及的 2.4G 和 5GHz 的区别就在与路由器发射频率的区别，实现的 802.11 协议的区别。当我们距离路由器相同距离，5G 信号相比于 2.4G 信号较弱，这是由于电磁波的物理特性决定，波越长衰减越少，更容易绕过障碍物传播。5G 信号频率高，波长短，所以 5G 信号绕过障碍物衰减更多。但是信号衰减并不代表影响网络速度，网络速度还与信道相关，上文提及 2.4G 下互不干扰的信道只有 3 个，但是 5G 下有 20 多个，并且 5G 可以支持更高的网络传输速率。所以如果追求更加稳定不受干扰的信号就用 5GHz。
IEEE 802.11n 是 802.11a 和 802.11g 改良，改进的地方：
常见的 WiFi 加密方式有：WPA 、WPA2、WPA/WPA2、WEP、802.1x(EAP)
WPA 是 Wi-Fi Protected Access(WiFi 安全存取）, 有 WPA 和 WPA2 两个标准，WPA 继承了 WEP 基本原理，同时加强了生成密钥的算法，追加了防止数据中途被篡改的功能。
完整的 WPA 实现复杂，一般家用采用的是 WPA 的简化版本：WPA-PSK（预共享密钥）。
WPA 加密方式有四种认证方式：WPA，WPA-PSK，WPA2，WPA2-PSK。
WPA2 是 WPA 的增强型版本，WPA2 新增了对 AES 的加密方式的支持。
WPA-PSK 适用于个人或普通家庭网络，使用预先共享密钥，支持 TKIP 和 AES 两种加密方式。
WEP 全称是 Wired Equivalent Privacy（有线等效保密），是对两台设备间无线传输的数据加密的一种。WEP 是一种加密方法，安全性没有 WPA 高。
Android 下有款 APP 叫做 WiFiAnalyzer 可以扫描周围 WiFi 占用的信道，以便于调整路由器信道。
802.11 协议规定，不同的无线网络可以具有相同的网络名称（也就是 SSID/ESSID)，但是必须对应一个唯一的 BSSID 地址。非法入侵者可以通过建立具有相同的 SSID/ESSID 的无线网络的方法，使得网络中的 STA 联接到非法的 AP 上，从而造成网络的泄密。通过 BSSID 地址绑定的方式，可以防止 STA 接入到非法的网络，从而提高无线网络的安全性。
https://zh.wikipedia.org/wiki/WLAN%E4%BF%A1%E9%81%93%E5%88%97%E8%A1%A8 ↩
在执行 Linux 命令时，我们可以把输出重定向到文件中，比如 ls > a.txt，这时我们就不能看到输出了，如果我们既想把输出保存到文件中，又想在屏幕上看到输出内容，就可以使用 tee 命令了。tee 命令读取标准输入，把这些内容同时输出到标准输出和（多个）文件中（read from standard input and write to standard output and files. Copy standard input to each FILE, and also to standard output. If a FILE is -, copy again to standard output.）。
在 tee 中说道：tee 命令可以重定向标准输出到多个文件（tee': Redirect output to multiple files. The tee’ command copies standard input to standard output and also to any files given as arguments. This is useful when you want not only to send some data down a pipe, but also to save a copy.）。要注意的是：在使用管道时，前一个命令的标准错误输出不会被 tee 读取。
格式：
tee file
输出到标准输出的同时，保存到文件 file 中。如果文件不存在，则创建；如果已经存在，则覆盖之。当使用 -a 参数时不会覆盖，而是附加。
格式：
tee -a file
输出到标准输出的同时，追加到文件 file 中。如果文件不存在，则创建；如果已经存在，就在末尾追加内容，而不是覆盖。
格式：
tee -
输出到标准输出两次。（A FILE of -' causes tee’ to send another copy of input to standard output, but this is typically not that useful as the copies are interleaved.）
格式：
tee file1 file2 -
输出到标准输出两次，同时保存到 file1 和 file2 中。
使用 tee 命令重复输出字符串
echo 12345 | tee
12345
echo 12345 | tee -
12345
12345
echo 12345 | tee - -
12345
12345
12345
使用 tee 命令把标准错误输出也保存到文件，默认情况下 tee 是不会将标准错误内容也保存到文件的，这个时候需要使用 2>$1
ls "*" 2>&1 | tee ls.txt
文件中就是
ls: cannot access '*': No such file or directory
ss 命令可以用来获取 socket 信息，可以用来显示和 netstat 类似的信息，但 ss 能够显示更多 TCP 和状态的信息，包括 PACKET，TCP，UDP，DCCP，RAW，和 Unix domain sockes 等等。
通过 ss ，可以获取当前机器如何和外界通信非常详细的信息，包括网络连接信息，网络协议，Linux socket 连接状态等等。通过这些信息，可以非常轻松和方便的定位网络问题。当服务器 Socket 连接数量比较大时，netstat 可能就罢工了，这个时候 ss 还是能够应付的，ss 使用了 TCP 协议栈中的 tcp_diag，tcp_diag 是一个用于分析统计的模块。
ss [options] [ FILTER ]
当没有选项使用时，ss 会显示一组已经建立 open non-listening sockets (TCP/UNIX/UDP) 连接的 sockets。
选项
-h, --help 帮助信息
-V, --version 程序版本信息
-n, --numeric 不解析服务名称
-r, --resolve 解析主机名
-a, --all 显示所有套接字（sockets）
-l, --listening 显示监听状态的套接字（sockets）
-o, --options 显示计时器信息
-e, --extended 显示详细的套接字（sockets）信息
-m, --memory 显示套接字（socket）的内存使用情况
-p, --processes 显示使用套接字（socket）的进程
-i, --info 显示 TCP 内部信息
-s, --summary 显示套接字（socket）使用概况
-4, --ipv4 仅显示 IPv4 的套接字（sockets）
-6, --ipv6 仅显示 IPv6 的套接字（sockets）
-0, --packet 显示 PACKET 套接字（socket）
-t, --tcp 仅显示 TCP 套接字（sockets）
-u, --udp 仅显示 UCP 套接字（sockets）
-d, --dccp 仅显示 DCCP 套接字（sockets）
-w, --raw 仅显示 RAW 套接字（sockets）
-x, --unix 仅显示 Unix 套接字（sockets）
-f, --family=FAMILY 显示 FAMILY 类型的套接字（sockets），FAMILY 可选，支持 unix, inet, inet6, link, netlink
-A, --query=QUERY, --socket=QUERY
QUERY := {all|inet|tcp|udp|raw|unix|packet|netlink}[,QUERY]
-D, --diag=FILE 将原始 TCP 套接字（sockets）信息转储到文件
-F, --filter=FILE 从文件中都去过滤器信息
FILTER := [ state TCP-STATE ] [ EXPRESSION ]
ss -u -a
ss -t
ss -x
ss -s
列出当前的 established, closed, orphaned and waiting TCP sockets
命令
ss -lp
说明：
-l 参数显示当前正在监听的 socket在结果中可以过滤出端口占用的进程
ss -lp | grep 80
ss 命令能够通过 TCP states 来过滤，状态列表
ss 命令能够识别的其他状态
对于 tcp ipv4
ss -4 state FILTER
ss -4 state listening
对于 ipv6
ss -6 state FILTER
显示所有状态为 established 的 SMTP 连接
ss -o state established '( dport = :smtp or sport = :smtp )'
显示所有状态为 Established 的 HTTP 连接
ss -o state established '( dport = :http or sport = :http )'
这里一定要注意引号中的写法，该有的空格一定要有。
ss 另外一个非常便利的功能就是可以查看特定 IP 地址的连接情况，比如想要查看多少连接从 IP 192.168.1.130 连接到本机，则可以
ss dst 192.168.1.130
对于本地连接同理
ss src 192.168.1.200
ss src 192.168.1.200:80
ss src 192.168.1.200:http
ss src 192.168.1.200:smtp
Linux 中的 kill 命令用来终止指定的进程（terminate a process）的运行，是 Linux 下进程管理的常用命令。通常，终止一个前台进程可以使用 Ctrl+C 键，但是，对于一个后台进程就须用 kill 命令来终止。此时就需要先使用 ps/pidof/pstree/top 等工具获取进程 PID，然后使用 kill 命令来杀掉该进程。
kill 命令是通过向进程发送指定的信号来结束相应进程的。在默认情况下，采用编号为 15 的 TERM 信号。TERM 信号将终止所有不能捕获该信号的进程。对于那些可以捕获该信号的进程就要用编号为 9 的 kill 信号，强行“杀掉”该进程。
kill [options] [PID]
发送指定的信号到相应进程。不指定将发送 SIGTERM（15）终止指定进程。如果仍然无法终止该程序可用 “-KILL” 参数，其发送的信号为 SIGKILL(9) ，将强制结束进程，使用 ps 命令或者 jobs 命令可以查看进程号。root 用户可以控制用户的进程，非 root 用户只能杀死自己的进程。
命令参数：
-l 信号，若果不加信号的编号参数，则使用“-l”参数会列出全部的信号名称
-a 当处理当前进程时，不限制命令名和进程号的对应关系
-p 指定 kill 命令只打印相关进程的进程号，而不发送任何信号
-s 指定发送信号
-u 指定用户
注意：
kill 命令可以带信号号码选项，也可以不带。如果没有信号号码，kill 命令就会发出终止信号 (15)，这个信号可以被进程捕获，使得进程在退出之前可以清理并释放资源。也可以用 kill 向进程发送特定的信号。例如：
kill -2 PID
它的效果等同于在前台运行 PID 的进程时按下 Ctrl+C 键。但是，普通用户只能使用不带 signal 参数的 kill 命令或最多使用 -9 信号。
kill 可以带有进程 ID 号作为参数。当用 kill 向这些进程发送信号时，必须是这些进程的所有者。如果试图撤销一个没有权限撤销的进程或撤销一个不存在的进程，就会得到一个错误信息。
可以向多个进程发信号或终止它们。
当 kill 成功地发送了信号后，shell 会在屏幕上显示出进程的终止信息。有时这个信息不会马上显示，只有当按下 Enter 键使 shell 的命令提示符再次出现时，才会显示出来。
应注意，信号使进程强行终止，这常会带来一些副作用，如数据丢失或者终端无法恢复到正常状态。发送信号时必须小心，只有在万不得已时，才用 kill 信号 9，因为进程不能首先捕获它。要撤销所有的后台作业，可以输入 kill 0。因为有些在后台运行的命令会启动多个进程，跟踪并找到所有要杀掉的进程的 PID 是件很麻烦的事。这时，使用 kill 0 来终止所有由当前 shell 启动的进程，是个有效的方法。
命令：
kill -l
输出：
HUP INT QUIT ILL TRAP ABRT BUS FPE KILL USR1 SEGV USR2 PIPE ALRM TERM STKFLT
CHLD CONT STOP TSTP TTIN TTOU URG XCPU XFSZ VTALRM PROF WINCH POLL PWR SYS
说明：
只有第 9 种信号 (SIGKILL) 才可以无条件终止进程，其他信号进程都有权利忽略。
下面是常用的信号：
HUP 1 终端断线
INT 2 中断（同 Ctrl + C）
QUIT 3 退出（同 Ctrl + \）
TERM 15 终止
KILL 9 强制终止
CONT 18 继续（与 STOP 相反， fg/bg 命令）
STOP 19 暂停（同 Ctrl + Z）
命令：
kill -l KILL
kill -l TERM
命令：
ps -ef | grep 'program'
kill PID
命令：
kill –9 PID
命令：
kill -9 $(ps -ef | grep username)
kill -u username
命令：
kill -9 1
说明：
init 是 Linux 系统操作中不可缺少的程序之一。所谓的 init 进程，它是一个由内核启动的用户级进程。内核自行启动（已经被载入内存，开始运行，并已初始化所有的设备驱动程序和数据结构等）之后，就通过启动一个用户级程序 init 的方式，完成引导进程。所以，init 始终是第一个进程（其进程编号始终为 1）。其它所有进程都是 init 进程的子进程，init 进程是无法杀死的。
This Jekyll introduction will outline specifically what Jekyll is and why you would want to use it. Directly following the intro we’ll learn exactly how Jekyll does what it does.
Jekyll is a parsing engine bundled as a ruby gem used to build static websites from dynamic components such as templates, partials, liquid code, markdown, etc. Jekyll is known as “a simple, blog aware, static site generator”.
This website is created with Jekyll. Other Jekyll websites.
Jekyll is a ruby gem you install on your local system.
Once there you can call jekyll --server on a directory and provided that directory
is setup in a way jekyll expects, it will do magic stuff like parse markdown/textile files,
compute categories, tags, permalinks, and construct your pages from layout templates and partials.
Once parsed, Jekyll stores the result in a self-contained static _site folder.
The intention here is that you can serve all contents in this folder statically from a plain static web-server.
You can think of Jekyll as a normalish dynamic blog but rather than parsing content, templates, and tags on each request, Jekyll does this once beforehand and caches the entire website in a folder for serving statically.
Jekyll is a parsing engine.
Jekyll does not come with any content nor does it have any templates or design elements. This is a common source of confusion when getting started. Jekyll does not come with anything you actually use or see on your website - you have to make it.
Jekyll is very minimalistic and very efficient. The most important thing to realize about Jekyll is that it creates a static representation of your website requiring only a static web-server. Traditional dynamic blogs like Wordpress require a database and server-side code. Heavily trafficked dynamic blogs must employ a caching layer that ultimately performs the same job Jekyll sets out to do; serve static content.
Therefore if you like to keep things simple and you prefer the command-line over an admin panel UI then give Jekyll a try.
Developers like Jekyll because we can write content like we write code:
The following is a complete but concise outline of exactly how Jekyll works.
Be aware that core concepts are introduced in rapid succession without code examples. This information is not intended to specifically teach you how to do anything, rather it is intended to give you the full picture relative to what is going on in Jekyll-world.
Learning these core concepts should help you avoid common frustrations and ultimately help you better understand the code examples contained throughout Jekyll-Bootstrap.
After installing jekyll you’ll need to format your website directory in a way jekyll expects. Jekyll-bootstrap conveniently provides the base directory format.
Jekyll expects your website directory to be laid out like so:
.
|-- _config.yml
|-- _includes
|-- _layouts
| |-- default.html
| |-- post.html
|-- _posts
| |-- 2011-10-25-open-source-is-good.markdown
| |-- 2011-04-26-hello-world.markdown
|-- _site
|-- index.html
|-- assets
|-- css
|-- style.css
|-- javascripts
_config.yml Stores configuration data.
_includes This folder is for partial views.
_layouts This folder is for the main templates your content will be inserted into. You can have different layouts for different pages or page sections.
_posts
This folder contains your dynamic content/posts.
the naming format is required to be @[email protected].
_site This is where the generated site will be placed once Jekyll is done transforming it.
assets This folder is not part of the standard jekyll structure. The assets folder represents any generic folder you happen to create in your root directory. Directories and files not properly formatted for jekyll will be left untouched for you to serve normally.
(read more: https://github.com/mojombo/jekyll/wiki/Usage)
Jekyll supports various configuration options that are fully outlined here: (https://github.com/mojombo/jekyll/wiki/Configuration)
Content in Jekyll is either a post or a page. These content “objects” get inserted into one or more templates to build the final output for its respective static-page.
Both posts and pages should be written in markdown, textile, or HTML and may also contain Liquid templating syntax. Both posts and pages can have meta-data assigned on a per-page basis such as title, url path, as well as arbitrary custom meta-data.
Creating a Post
Posts are created by properly formatting a file and placing it the _posts folder.
Formatting
A post must have a valid filename in the form YEAR-MONTH-DATE-title.MARKUP and be placed in the _posts directory.
If the data format is invalid Jekyll will not recognize the file as a post. The date and title are automatically parsed from the filename of the post file.
Additionally, each file must have YAML Front-Matter prepended to its content.
YAML Front-Matter is a valid YAML syntax specifying meta-data for the given file.
Order Ordering is an important part of Jekyll but it is hard to specify a custom ordering strategy. Only reverse chronological and chronological ordering is supported in Jekyll.
Since the date is hard-coded into the filename format, to change the order, you must change the dates in the filenames.
Tags Posts can have tags associated with them as part of their meta-data. Tags may be placed on posts by providing them in the post’s YAML front matter. You have access to the post-specific tags in the templates. These tags also get added to the sitewide collection.
Categories Posts may be categorized by providing one or more categories in the YAML front matter. Categories offer more significance over tags in that they can be reflected in the URL path to the given post. Note categories in Jekyll work in a specific way. If you define more than one category you are defining a category hierarchy “set”. Example:
---
title : Hello World
categories : [lessons, beginner]
---
This defines the category hierarchy “lessons/beginner”. Note this is one category node in Jekyll. You won’t find “lessons” and “beginner” as two separate categories unless you define them elsewhere as singular categories.
Creating a Page Pages are created by properly formatting a file and placing it anywhere in the root directory or subdirectories that do not start with an underscore.
Formatting
In order to register as a Jekyll page the file must contain YAML Front-Matter.
Registering a page means 1) that Jekyll will process the page and 2) that the page object will be available in the site.pages array for inclusion into your templates.
Categories and Tags Pages do not compute categories nor tags so defining them will have no effect.
Sub-Directories If pages are defined in sub-directories, the path to the page will be reflected in the url. Example:
.
|-- people
|-- bob
|-- essay.html
This page will be available at http://yourdomain.com/people/bob/essay.html
Recommended Pages
Templates are used to contain a page’s or post’s content.
All templates have access to a global site object variable: site as well as a page object variable: page.
The site variable holds all accessible content and metadata relative to the site.
The page variable holds accessible data for the given page or post being rendered at that point.
Create a Template
Templates are created by properly formatting a file and placing it in the _layouts directory.
Formatting Templates should be coded in HTML and contain YAML Front Matter. All templates can contain Liquid code to work with your site’s data.
Rending Page/Post Content in a Template
There is a special variable in all templates named : content.
The content variable holds the page/post content including any sub-template content previously defined.
Render the content variable wherever you want your main content to be injected into your template:
...
<body>
<div id="sidebar"> ... </div>
<div id="main">
{{content}}
</div>
</body>
...Sub-templates are exactly templates with the only difference being they define another “root” layout/template within their YAML Front Matter. This essentially means a template will render inside of another template.
In Jekyll you can define include files by placing them in the _includes folder.
Includes are NOT templates, rather they are just code snippets that get included into templates.
In this way, you can treat the code inside includes as if it was native to the parent template.
Any valid template code may be used in includes.
Templating is perhaps the most confusing and frustrating part of Jekyll. This is mainly due to the fact that Jekyll templates must use the Liquid Templating Language.
Liquid is a secure templating language developed by Shopify. Liquid is designed for end-users to be able to execute logic within template files without imposing any security risk on the hosting server.
Jekyll uses Liquid to generate the post content within the final page layout structure and as the primary interface for working with your site and post/page data.
GitHub uses Jekyll to power GitHub Pages. GitHub cannot afford to run arbitrary code on their servers so they lock developers down via Liquid.
The short story is liquid is not real code and its not intended to execute real code. The point being you can’t do jackshit in liquid that hasn’t been allowed explicitly by the implementation. What’s more you can only access data-structures that have been explicitly passed to the template.
In Jekyll’s case it is not possible to alter what is passed to Liquid without hacking the gem or running custom plugins. Both of which cannot be supported by GitHub Pages.
As a programmer - this is very frustrating.
But rather than look a gift horse in the mouth we are going to suck it up and view it as an opportunity to work around limitations and adopt client-side solutions when possible.
Aside My personal stance is to not invest time trying to hack liquid. It’s really unnecessary from a programmer’s perspective. That is to say if you have the ability to run custom plugins (i.e. run arbitrary ruby code) you are better off sticking with ruby. Toward that end I’ve built Mustache-with-Jekyll
Static assets are any file in the root or non-underscored subfolders that are not pages. That is they have no valid YAML Front Matter and are thus not treated as Jekyll Pages.
Static assets should be used for images, css, and javascript files.
Remember Jekyll is a processing engine. There are two main types of parsing in Jekyll.
And thus there are two main types of file formats needed for this parsing.
_layouts folder and contain your blogs templates. They should be made in HTML with the help of Liquid syntax.
Since include files are simply injected into templates they are essentially parsed as if they were native to the template.Arbitrary files and folders. Files that are not valid pages are treated as static content and pass through Jekyll untouched and reside on your blog in the exact structure and format they originally existed in.
We’ve outlined the need for valid formatting using YAML Front Matter. Templates, posts, and pages all need to provide valid YAML Front Matter even if the Matter is empty. This is the only way Jekyll knows you want the file processed.
YAML Front Matter must be prepended to the top of template/post/page files:
---
layout: post
category : pages
tags : [how-to, jekyll]
---
... contents ...
Three hyphens on a new line start the Front-Matter block and three hyphens on a new line end the block. The data inside the block must be valid YAML.
Configuration parameters for YAML Front-Matter is outlined here: A comprehensive explanation of YAML Front Matter
The layout parameter in the YAML Front Matter defines the template file for which the given post or template should be injected into.
If a template file specifies its own layout, it is effectively being used as a sub-template.
That is to say loading a post file into a template file that refers to another template file with work in the way you’d expect; as a nested sub-template.
Ultimately, Jekyll’s job is to generate a static representation of your website. The following is an outline of how that’s done:
Jekyll collects data. Jekyll scans the posts directory and collects all posts files as post objects. It then scans the layout assets and collects those and finally scans other directories in search of pages.
Jekyll computes data.
Jekyll takes these objects, computes metadata (permalinks, tags, categories, titles, dates) from them and constructs one
big site object that holds all the posts, pages, layouts, and respective metadata.
At this stage your site is one big computed ruby object.
Jekyll liquifies posts and templates. Next jekyll loops through each post file and converts (through markdown or textile) and liquifies the post inside of its respective layout(s). Once the post is parsed and liquified inside the the proper layout structure, the layout itself is “liquified”. Liquification is defined as follows: Jekyll initiates a Liquid template, and passes a simpler hash representation of the ruby site object as well as a simpler hash representation of the ruby post object. These simplified data structures are what you have access to in the templates.
Jekyll generates output. Finally the liquid templates are “rendered”, thereby processing any liquid syntax provided in the templates and saving the final, static representation of the file.
Notes.
Because Jekyll computes the entire site in one fell swoop, each template is given access to
a global site hash that contains useful data. It is this data that you’ll iterate through and format
using the Liquid tags and filters in order to render it onto a given page.
Remember, in Jekyll you are an end-user. Your API has only two components:
All the data objects available to you in the templates via Liquid are outlined in the API Section of Jekyll-Bootstrap. You can also read the original documentation here: https://github.com/mojombo/jekyll/wiki/Template-Data
I hope this paints a clearer picture of what Jekyll is doing and why it works the way it does. As noted, our main programming constraint is the fact that our API is limited to what is accessible via Liquid and Liquid only.
Jekyll-bootstrap is intended to provide helper methods and strategies aimed at making it more intuitive and easier to work with Jekyll =)
Thank you for reading this far.
Please take a look at or jump right into Usage if you’d like.