Site Source
-Change the directory where Jekyll will read files
+Site Source
+Change the directory where Jekyll will read files
source: DIR
-s, --source DIR
Site Destination
-Change the directory where Jekyll will write files
+Site Destination
+Change the directory where Jekyll will write files
destination: DIR
-d, --destination DIR
Safe
-Disable custom plugins, and ignore symbolic links.
+Safe
+safe: BOOL
--safe
Exclude
+Exclude
Exclude directories and/or files from the conversion. These exclusions are relative to the site's source directory and cannot be outside the source directory.
exclude: [DIR, FILE, ...]
Include
+Include
Force inclusion of directories and/or files in the conversion.
.htaccess is a good example since dotfiles are excluded
by default.
include: [DIR, FILE, ...]
Time Zone
+Time Zone
Set the time zone for site generation. This sets the TZ
environment variable, which Ruby uses to handle time and date
@@ -99,13 +99,13 @@ class="flag">flags (specified on the command-line) that control them.
is the local time zone, as set by your operating system.
timezone: TIMEZONE
Encoding
+Encoding
Set the encoding of files by name. Only available for Ruby
1.9 or later).
@@ -116,7 +116,7 @@ class="flag">flags (specified on the command-line) that control them.
command ruby -e 'puts Encoding::list.join("\n")'.
encoding: ENCODING
Regeneration
-Enable auto-regeneration of the site when files are modified.
+Regeneration
+Enable auto-regeneration of the site when files are modified.
-w, --watch
Configuration
+Configuration
Specify config files instead of using _config.yml automatically. Settings in later files override settings in earlier files.
--config FILE1[,FILE2,...]
Drafts
+Drafts
Process and render draft posts.
--drafts
Future
+Future
Publish posts with a future date.
future: BOOL
--future
LSI
+LSI
Produce an index for related posts.
lsi: BOOL
--lsi
Limit Posts
+Limit Posts
Limit the number of posts to parse and publish.
limit_posts: NUM
--limit_posts NUM
Local Server Port
-Listen on the given port.
+Local Server Port
+Listen on the given port.
port: PORT
--port PORT
Local Server Hostname
-Listen at the given hostname.
+Local Server Hostname
+Listen at the given hostname.
host: HOSTNAME
--host HOSTNAME
Base URL
-Serve the website from the given base URL
+Base URL
+Serve the website from the given base URL
baseurl: URL
--baseurl URL
Detach
-Detach the server from the terminal
+Detach
+Detach the server from the terminal
detach: BOOL
Date to XML Schema
+Date to XML Schema
Convert a Date into XML Schema (ISO 8601) format.
- {% raw %}{{ site.time | date_to_xmlschema }}{% endraw %}
+ {% raw %}{{ site.time | date_to_xmlschema }}{% endraw %}
- 2008-11-07T13:07:54-08:00
+ 2008-11-07T13:07:54-08:00
Date to RFC-822 Format
+Date to RFC-822 Format
Convert a Date into the RFC-822 format used for RSS feeds.
- {% raw %}{{ site.time | date_to_rfc822 }}{% endraw %}
+ {% raw %}{{ site.time | date_to_rfc822 }}{% endraw %}
- Mon, 07 Nov 2008 13:07:54 -0800
+ Mon, 07 Nov 2008 13:07:54 -0800
Date to String
+Date to String
Convert a date to short format.
- {% raw %}{{ site.time | date_to_string }}{% endraw %}
+ {% raw %}{{ site.time | date_to_string }}{% endraw %}
- 07 Nov 2008
+ 07 Nov 2008
Date to Long String
+Date to Long String
Format a date to long format.
- {% raw %}{{ site.time | date_to_long_string }}{% endraw %}
+ {% raw %}{{ site.time | date_to_long_string }}{% endraw %}
- 07 November 2008
+ 07 November 2008
XML Escape
+XML Escape
Escape some text for use in XML.
- {% raw %}{{ page.content | xml_escape }}{% endraw %}
+ {% raw %}{{ page.content | xml_escape }}{% endraw %}
CGI Escape
+CGI Escape
CGI escape a string for use in a URL. Replaces any special characters with appropriate %XX replacements.
- {% raw %}{{ “foo,bar;baz?” | cgi_escape }}{% endraw %}
+ {% raw %}{{ “foo,bar;baz?” | cgi_escape }}{% endraw %}
- foo%2Cbar%3Bbaz%3F
+ foo%2Cbar%3Bbaz%3F
URI Escape
+URI Escape
URI escape a string.
- {% raw %}{{ “'foo, bar \\baz?'” | uri_escape }}{% endraw %}
+ {% raw %}{{ “'foo, bar \\baz?'” | uri_escape }}{% endraw %}
- foo,%20bar%20%5Cbaz?
+ foo,%20bar%20%5Cbaz?
Number of Words
+Number of Words
Count the number of words in some text.
- {% raw %}{{ page.content | number_of_words }}{% endraw %}
+ {% raw %}{{ page.content | number_of_words }}{% endraw %}
- 1337
+ 1337
Array to Sentence
+Array to Sentence
Convert an array into a sentence. Useful for listing tags.
- {% raw %}{{ page.tags | array_to_sentence_string }}{% endraw %}
+ {% raw %}{{ page.tags | array_to_sentence_string }}{% endraw %}
- foo, bar, and baz
+ foo, bar, and baz
Textilize
+Textilize
Convert a Textile-formatted string into HTML, formatted via RedCloth
- {% raw %}{{ page.excerpt | textilize }}{% endraw %}
+ {% raw %}{{ page.excerpt | textilize }}{% endraw %}
Markdownify
+Markdownify
Convert a Markdown-formatted string into HTML.
- {% raw %}{{ page.excerpt | markdownify }}{% endraw %}
+ {% raw %}{{ page.excerpt | markdownify }}{% endraw %}
Data To JSON
+Data To JSON
Convert Hash or Array to JSON.
- {% raw %}{{ site.data.projects | jsonify }}{% endraw %}
+ {% raw %}{{ site.data.projects | jsonify }}{% endraw %}