fixing pygments rouge dependencies

This commit is contained in:
Tom Johnson
2015-11-30 14:38:16 -08:00
parent f8b960225e
commit 28146a3d08
3 changed files with 21 additions and 24 deletions

View File

@ -1,2 +1,2 @@
source 'https://rubygems.org' source 'https://rubygems.org'
gem 'github-pages' gem 'github-pages'

View File

@ -1,21 +1,26 @@
# This is duplicated here from configs/mydoc/config_designers.yml so that Github Pages can read it. Github Pages requires this file for the build process. It can't read a configuration file stored in another location.
# project definitions # project definitions
project: mydoc_designers project: mydoc_designers
audience: designers audience: designers
product: doc product: doc
platform: all platform: all
version: all version: all
output: web
destination: ../doc_outputs/mydoc/designers destination: ../doc_outputs/mydoc/designers
topnav_title: Doc theme — designers topnav_title: Jekyll Documentation Theme
homepage_title: Jekyll doc theme for designers homepage_title: Jekyll doc theme for designers
site_title: Jekyll theme for designers site_title: Jekyll theme for designers
project_folder: doc project_folder: mydoc
company_name: Your company
footer_image_location: ../common_images/company_logo.png
github_editme_path: tomjohnson1492/documentation-theme-jekyll/edit/reviews
# variables # variables
sidebar_tagline: Designers sidebar_tagline: Designers
sidebar_version: Version 4.0 sidebar_version: Version 4.0
theme_file: theme-blue.css theme_file: theme-blue.css
project_file_name: doc pdf_file_name: mydoc_designers_pdf.pdf
port: 4009 port: 4009
@ -28,20 +33,17 @@ exclude:
# same for all # same for all
host: 127.0.0.1 host: 127.0.0.1
feedback_email: tomjohnson1492@gmail.com feedback_email: tomjohnson1492@gmail.com
sidebar_accordion: true
markdown: redcarpet
print: false
suffix: index.html markdown: redcarpet
redcarpet: redcarpet:
extensions: ["no_intra_emphasis", "fenced_code_blocks", "tables", "with_toc_data"] extensions: ["no_intra_emphasis", "fenced_code_blocks", "tables", "with_toc_data"]
highlighter: rouge highlighter: pygments
collections: collections:
tooltips: tooltips:
output: true output: false
defaults: defaults:
- -
@ -55,11 +57,10 @@ defaults:
- -
scope: scope:
path: "" path: ""
type: "posts" type: "tooltips"
values: values:
layout: "post" layout: "page"
comments: true comments: true
search: true search: true
tooltip: true
sass:
sass_dir: _sass

View File

@ -50,25 +50,21 @@ Before you start customizing the theme, make sure you can build the theme with t
Bundler looks at the gems (Ruby plugins) in a project's gemfile and then gets all of the gems that depend on those gems. This way you don't end up with incompatible gems. Bundler looks at the gems (Ruby plugins) in a project's gemfile and then gets all of the gems that depend on those gems. This way you don't end up with incompatible gems.
However, I'm publishing this project on Github Pages, and currently Github Pages only supports Jekyll 2.5.3, not Jekyll 3.0.1. Therefore you have to switch up something in the Gemfile to run the latest Jekyll. Since I'm publishing this project on Github Pages, there are some specific gem dependencies. The 2.5.3 github-pages gem has dependencies on jekyll 2.4.0, pygments.rb 0.6.3, and redcarpet 3.3.2 (you can see this after running `bundle install`). If you're not publishing on Github Pages and you want to run Jekyll 3.0.1 (the latest), browse to the jekyll-documentation-theme folder and type `open Gemfile`. Replace the contents of the Gemfile with the following:
4. In terminal, browse to the jekyll-documentation-theme folder and type `open Gemfile`. Replace the contents of the Gemfile with the following:
``` ```
source 'https://rubygems.org' source 'https://rubygems.org'
gem 'jekyll', '~> 3.0', '>= 3.0.1' gem 'jekyll', '~> 3.0'
gem 'redcarpet' gem 'redcarpet', '~> 3.3', '>= 3.3.3'
gem 'pygments.rb', '~> 0.6.3'
``` ```
5. Open the config files in the configs/mydoc folder and change the `highlighter` value from `pygments` to `rouge`.
I anticipate that Github Pages will soon start supporting rouge as well, but for now I keep getting error messages when trying to use the rouge highlighter with Jekyll 2.5.3, which is the latest version that Github Pages supports. If you're planning to publish on Github Pages, you can keep the highlighter set to `pygments`. The differences are hardly noticeable.
5. In a terminal, browse to the documentation-theme-jekyll directory and type the following: 5. In a terminal, browse to the documentation-theme-jekyll directory and type the following:
``` ```
bundle install bundle install
``` ```
6. Build the writer's output: 6. Build the writer's output:
``` ```