Use glamour and termev to render/colorize content (#181)
Merge branch 'master' into use-glamour select Glamour Theme based on BackgroundColor Merge branch 'master' into use-glamour Merge branch 'master' into use-glamour update termev update go.mod label color colorate use glamour for issue content Vendor: Add glamour Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com> Co-authored-by: 6543 <6543@obermui.de> Reviewed-on: https://gitea.com/gitea/tea/pulls/181 Reviewed-by: techknowlogick <techknowlogick@gitea.io> Reviewed-by: Lunny Xiao <xiaolunwen@gmail.com>
This commit is contained in:
72
vendor/github.com/charmbracelet/glamour/README.md
generated
vendored
Normal file
72
vendor/github.com/charmbracelet/glamour/README.md
generated
vendored
Normal file
@@ -0,0 +1,72 @@
|
||||
# Glamour
|
||||
|
||||
[](https://github.com/charmbracelet/glamour/releases)
|
||||
[](https://pkg.go.dev/github.com/charmbracelet/glamour?tab=doc)
|
||||
[](https://github.com/charmbracelet/glamour/actions)
|
||||
[](https://coveralls.io/github/charmbracelet/glamour?branch=master)
|
||||
[](http://goreportcard.com/report/charmbracelet/glamour)
|
||||
|
||||
Write handsome command-line tools with *glamour*!
|
||||
|
||||
`glamour` lets you render [markdown](https://en.wikipedia.org/wiki/Markdown)
|
||||
documents & templates on [ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code)
|
||||
compatible terminals. You can create your own stylesheet or use one of our
|
||||
glamourous default themes.
|
||||
|
||||
|
||||
## Usage
|
||||
|
||||
```go
|
||||
import "github.com/charmbracelet/glamour"
|
||||
|
||||
in := `# Hello World
|
||||
|
||||
This is a simple example of glamour!
|
||||
Check out the [other examples](https://github.com/charmbracelet/glamour/tree/master/examples).
|
||||
|
||||
Bye!
|
||||
`
|
||||
|
||||
out, err := glamour.Render(in, "dark")
|
||||
fmt.Print(out)
|
||||
```
|
||||
|
||||

|
||||
|
||||
### Custom Renderer
|
||||
|
||||
```go
|
||||
import "github.com/charmbracelet/glamour"
|
||||
|
||||
r, _ := glamour.NewTermRenderer(
|
||||
// detect background color and pick either the default dark or light theme
|
||||
glamour.WithAutoStyle(),
|
||||
// wrap output at specific width
|
||||
glamour.WithWordWrap(40),
|
||||
)
|
||||
|
||||
out, err := r.Render(in)
|
||||
fmt.Print(out)
|
||||
```
|
||||
|
||||
|
||||
## Styles
|
||||
|
||||
You can find all available default styles in our [gallery](https://github.com/charmbracelet/glamour/tree/master/styles/gallery).
|
||||
Want to create your own style? [Learn how!](https://github.com/charmbracelet/glamour/tree/master/styles)
|
||||
|
||||
There are a few options for using a custom style:
|
||||
1. Call `glamour.Render(inputText, "desiredStyle")`
|
||||
1. Set the `GLAMOUR_STYLE` environment variable to your desired default style or a file location for a style and call `glamour.RenderWithEnvironmentConfig(inputText)`
|
||||
1. Set the `GLAMOUR_STYLE` environment variable and pass `glamour.WithEnvironmentConfig()` to your custom renderer
|
||||
|
||||
|
||||
## Glamourous Projects
|
||||
|
||||
Check out [Glow](https://github.com/charmbracelet/glow), a markdown renderer for
|
||||
the command-line, which uses `glamour`.
|
||||
|
||||
|
||||
## License
|
||||
|
||||
[MIT](https://github.com/charmbracelet/glamour/raw/master/LICENSE)
|
||||
Reference in New Issue
Block a user