From 4c76a9c08414bab3436ac96567875028619b5313 Mon Sep 17 00:00:00 2001 From: Tom Johnson Date: Tue, 8 Sep 2015 14:06:14 -0700 Subject: [PATCH] changing markdown processor back to redcarpet --- _config.yml | 5 ++++- configs/config_designers.yml | 5 ++++- configs/config_writers.yml | 5 ++++- doc_configuration_settings.md | 4 ++-- 4 files changed, 14 insertions(+), 5 deletions(-) diff --git a/_config.yml b/_config.yml index 0f67046..41197a5 100644 --- a/_config.yml +++ b/_config.yml @@ -29,12 +29,15 @@ exclude: host: 127.0.0.1 feedback_email: tomjohnson1492@gmail.com sidebar_accordion: true -markdown: kramdown +markdown: redcarpet print: false theme_file: theme-blue.css # only use suffix if you need to force index.html to display # suffix: index.html +redcarpet: + extensions: ["no_intra_emphasis", "fenced_code_blocks", "tables", "with_toc_data"] + highlighter: pygments collections: diff --git a/configs/config_designers.yml b/configs/config_designers.yml index 69346e3..f012ff8 100644 --- a/configs/config_designers.yml +++ b/configs/config_designers.yml @@ -29,7 +29,7 @@ exclude: host: 127.0.0.1 feedback_email: tomjohnson1492@gmail.com sidebar_accordion: true -markdown: kramdown +markdown: redcarpet print: false theme_file: theme-blue.css # only use suffix if you need to force index.html to display @@ -37,6 +37,9 @@ theme_file: theme-blue.css highlighter: pygments +redcarpet: + extensions: ["no_intra_emphasis", "fenced_code_blocks", "tables", "with_toc_data"] + collections: tooltips: output: true diff --git a/configs/config_writers.yml b/configs/config_writers.yml index ef9d55d..7db1d5c 100644 --- a/configs/config_writers.yml +++ b/configs/config_writers.yml @@ -30,7 +30,7 @@ exclude: host: 127.0.0.1 feedback_email: tomjohnson1492@gmail.com sidebar_accordion: true -markdown: kramdown +markdown: redcarpet print: false # only use suffix if you need to force index.html to display @@ -38,6 +38,9 @@ print: false highlighter: pygments +redcarpet: + extensions: ["no_intra_emphasis", "fenced_code_blocks", "tables", "with_toc_data"] + collections: tooltips: output: true diff --git a/doc_configuration_settings.md b/doc_configuration_settings.md index b72afe4..0cb0204 100644 --- a/doc_configuration_settings.md +++ b/doc_configuration_settings.md @@ -41,9 +41,9 @@ Note that you can define arbitrary key-value pairs in the configuration file, an | **feedback_email** | Gets configured as the email address in the Send Feedback button in the top navigation bar.| | **sidebar_accordion** | Optional | Boolean. The default value is true. Whether you want the navigation sidebar to use the accordion effect or not. The accordion effect means when you expand a section, the other sections automatically collapse. If you put `false`, then you can expand multiple sections at once. At the bottom of the navigation sidebar, two links will appear: Collapse All and Expand All. | | **disqus_shortname** | Optional | The disqus site shortname, which is used for comments. If you don't want comment forms via disqus, leave this blank or omit it altogether and Disqus won't appear. | -| **markdown** | Required | The processor to use for Markdown. This is a Jekyll-specific setting. | +| **markdown** | Required | The processor to use for Markdown. This is a Jekyll-specific setting. Use `redcarpet`. Another option is `kramdown`. However, my examples will follow redcarpet. | | **redcarpet** | Required | Extensions used with redcarpet. You can read more about them by searching for redcarpet extensions online. | -| **highlighter** | Optional | The syntax highlighter used. `rouge` is also an option. I think Pygments does a better job. You will need to [install Pygments](http://pygments.org/download/) on your machine or else you will see an error. | +| **highlighter** | Optional | The syntax highlighter used. Use `pygments` because it's required you're publishing on Github Pages. You will need to [install Pygments](http://pygments.org/download/) on your machine or else you will see an error. Pygments is based on Python. If you run into build errors and aren't publishing on Github Pages, `rouge` is also an option. | | **exclude** | Optional | A list of files and directories that you want excluded from the build. By default, all the content in your project is included in the output. | | **defaults** | Optional | Here you can set default values for frontmatter based on the content type (page, post, or collection). | | **collections** | Optional | Any specific collections (custom content types that extend beyond pages or posts) that you want to define. This theme defines a collection called tooltips. You access this collection by using site.tooltips instead of site.pages or site.posts. Put the tooltip content types inside a folder in your project called \_tooltips. |