highlights

WebJar for highlights

License	MIT
GroupId	org.webjars.npm
ArtifactId	highlights
Last Version	3.2.0-candidate.1
Release Date	Jun 25, 2018
Type	jar
Description	highlights WebJar for highlights
Project URL	http://webjars.org
Source Code Management	https://github.com/atom/highlights

Download highlights

Filename	Size
highlights-3.2.0-candidate.1.pom
highlights-3.2.0-candidate.1.jar	177 KB
highlights-3.2.0-candidate.1-sources.jar	22 bytes
highlights-3.2.0-candidate.1-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/highlights/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>highlights</artifactId>
    <version>3.2.0-candidate.1</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/highlights/
implementation 'org.webjars.npm:highlights:3.2.0-candidate.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/highlights/
implementation ("org.webjars.npm:highlights:3.2.0-candidate.1")

Apache Buildr

'org.webjars.npm:highlights:jar:3.2.0-candidate.1'

Apache Ivy

<dependency org="org.webjars.npm" name="highlights" rev="3.2.0-candidate.1">
  <artifact name="highlights" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='highlights', version='3.2.0-candidate.1')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "highlights" % "3.2.0-candidate.1"

Leiningen

[org.webjars.npm/highlights "3.2.0-candidate.1"]

Dependencies

compile (7)

Group / Artifact	Type	Version
org.webjars.npm : first-mate-select-grammar	jar	[1.0.1,2)
org.webjars.npm : fs-plus	jar	[3.0.1,4)
org.webjars.npm : once	jar	[1.3.2,2)
org.webjars.npm : season	jar	[6.0.0,7)
org.webjars.npm : underscore-plus	jar	[1.5.1,2)
org.webjars.npm : first-mate	jar	[6.3.0,7)
org.webjars.npm : yargs	jar	[4.7.1,5)

Project Modules

There are no modules declared in this project.

Reads in code, writes out HTML with CSS classes based on the tokens in the code.

See it in action here.

Installing

npm install highlights

Using

Run highlights -h for full details about the supported options.

To convert a source file to tokenized HTML run the following:

highlights file.coffee -o file.html

Now you have a file.html file that has a big <pre> tag with a <div> for each line with <span> elements for each token.

Then you can compile an existing Atom theme into a stylesheet with the following:

git clone https://github.com/atom/atom-dark-syntax
cd atom-dark-syntax
npm install -g less
lessc --include-path=styles index.less atom-dark-syntax.css

Now you have an atom-dark-syntax.css stylesheet that be combined with the file.html file to generate some nice looking code.

Check out the examples to see it in action.

Check out atom.io to find more themes.

Some popular themes:

• atom-dark-syntax
• atom-light-syntax
• solarized-dark-syntax
• solarized-light-syntax

Using in code

Highlights = require 'highlights'
highlighter = new Highlights()
html = highlighter.highlightSync
  fileContents: 'var hello = "world";'
  scopeName: 'source.js'

console.log html

Outputs:

<pre class="editor editor-colors">
  <div class="line">
    <span class="source js">
      <span class="storage modifier js"><span>var</span></span>
      <span>&nbsp;hello&nbsp;</span>
      <span class="keyword operator js"><span>=</span></span>
      <span>&nbsp;</span>
      <span class="string quoted double js">
        <span class="punctuation definition string begin js"><span>&quot;</span></span>
        <span>world</span>
        <span class="punctuation definition string end js"><span>&quot;</span></span>
      </span>
      <span class="punctuation terminator statement js"><span>;</span></span>
    </span>
  </div>
</pre>

Loading Grammars From Modules

highlights exposes the method requireGrammarsSync, for loading grammars from npm modules. The usage is as follows:

npm install atom-language-clojure

Highlights = require 'highlights'
highlighter = new Highlights()
highlighter.requireGrammarsSync
  modulePath: require.resolve('atom-language-clojure/package.json')

Developing

• Clone this repository git clone https://github.com/atom/highlights
• Update the submodules by running git submodule update --init --recursive
• Run npm install to install the dependencies, compile the CoffeeScript, and build the grammars
• Run npm test to run the specs

💚 Pull requests are greatly appreciated and welcomed.

Atom

Free and open source text editor, brought to you by GitHub

Versions

Version
3.2.0-candidate.1 Jun 25, 2018