Syntax highlighting, from running github-markup locally?

[deftclaw]

Got github/markup converting *.md to *.html nicely, using custom CSS to make swanky notes --> documentation editor. That part is great. I wanted to add syntax-highlighting for code blocks and the github-markup repository seemed to indicate that this was where to look.

All the docs here seem to just be listing how much of which languages are in a repo. That's great in it's own right, but it does not seem to be what the github/markup readme implied.

How can I utilize this tool to perform syntax highlighting with github/markup locally?
From the README the only use of this tool I can grasp is stats of included code, but there seems to be plenty of discussion about highlighting going on...

cannot find 'syntax' or 'highlig' in the docs
so if you're going to 'RTFM' me, please add what manual I ought FR?

Please help... am I being as stupid as I feel?
Thanks in advance!

require 'github/markup'
require 'linguist'

page_name  = file.gsub(/\.md/, '.html')
conversion = GitHub::Markup.render(file, File.read(file))

# This is to test code highlighting

```ruby
def ducktales
  puts "woohoo!"
end
``\`

[lildude]

How can I utilize this tool to perform syntax highlighting with github/markup locally?

You can't 😁 Linguist doesn't do the syntax highlighting, it only collects the grammars which are passed to the syntax highlighting engine (that's the linguist-grammars.tar.gz file attached to each release).

This highlighting engine GitHub uses is not open source and is not available for use outside GitHub but if you want local syntax highlighting you'll need to look at something else like rouge which Jekyll uses (Ruby) or chroma which Hugo uses (Go). Both are static site generators that convert markdown to HTML, potentially saving you from reinventing the wheel.

There are others but that should get you going.

[deftclaw]

Thanks so much! I'll checkout rouge