GitHubMirror/go-highlite
1
0
Fork 0
mirror of https://github.com/rwinkhart/go-highlite.git synced 2026-09-05 08:27:19 -04:00
Code Issues Packages Projects Releases Wiki Activity

More README stuff..

Browse Source
This commit is contained in:
Jesse Portnoy
2023-07-17 16:03:45 +01:00
parent 9cad29d17b
commit 3a3e164991
1 changed files with 8 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+8 -12
View File
@@ -3,13 +3,11 @@
[![GoDoc](https://godoc.org/github.com/jessp01/highlight?status.svg)](http://godoc.org/github.com/jessp01/highlight) [![GoDoc](https://godoc.org/github.com/jessp01/highlight?status.svg)](http://godoc.org/github.com/jessp01/highlight)
[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/jessp01/highlight/blob/master/LICENSE) [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/jessp01/highlight/blob/master/LICENSE)
This is a package for syntax highlighting a large number of different languages. To see the list of `highlight` is a syntax highlighter of programming languages, config formats and UNIX commands.
languages currently supported, see the [`syntax_files`](./syntax_files) directory. It allows you to pass in a string and get back all the information you need to properly highlight it..
This repo includes over a 100 different lexers and contributions are most welcome:)
Highlight allows you to pass in a string and get back all the information you need to syntax highlight See [Revising and adding new lexers](#Revising and adding new lexers) for more info.
that string well.
This project is still a work in progress and more features and documentation will be coming later.
## A note about this repo ## A note about this repo
@@ -29,13 +27,14 @@ Below is a recap of the main changes made since:
go get github.com/jessp01/highlight go get github.com/jessp01/highlight
``` ```
Be sure to point your code to the correct path of `syntax_files`.
## Basic Usage ## Basic Usage
Below is a simple example for highlighting a string (a Go snippet in this case). Below is a simple example for highlighting a string (a Go snippet in this case).
It uses `github.com/fatih/color` to actually colorize the output to the console. It uses `github.com/fatih/color` to actually colorize the output to the console.
A more comprehensive example is [zaje](https://github.com/jessp01/zaje); a Syntax highlighter to cover all your shell needs (it can replace `cat` and `tail`). **NOTE: A more comprehensive example is [zaje](https://github.com/jessp01/zaje); a Syntax highlighter to cover all your shell needs (it can replace `cat` and `tail`).**
```go ```go
package main package main
@@ -152,14 +151,11 @@ fmt.Println("Filetype is", def.FileType)
## Revising and adding new lexers ## Revising and adding new lexers
Lexers are YML files that live under the [syntax\_files](./syntax_files) dir. Lexers are YML files that live under the [syntax\_files](./syntax_files) dir.
They can be loaded individually:
They can be loaded individually:
```go ```go
syntaxFile, lerr := ioutil.ReadFile("highlight/syntax_files/go.yaml") syntaxFile, lerr := ioutil.ReadFile("highlight/syntax_files/go.yaml")
syntaxDef, err := highlight.ParseDef(syntaxFile) syntaxDef, err := highlight.ParseDef(syntaxFile)
``` ```
Or, you can scan the dir and load them all using the `highlight.ParseSyntaxFiles(syn_dir, &defs)()` helper function. Or, you can scan the dir and load them all using the `highlight.ParseSyntaxFiles(syn_dir, &defs)()` helper function.
This repo includes over a 100 different lexers and contributions are most welcome:)