Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/volkovlabs/business-text
Dynamic, data-driven text for @grafana
https://github.com/volkovlabs/business-text
grafana handlebars markdown panel plugin
Last synced: about 10 hours ago
JSON representation
Dynamic, data-driven text for @grafana
- Host: GitHub
- URL: https://github.com/volkovlabs/business-text
- Owner: VolkovLabs
- License: apache-2.0
- Created: 2020-08-30T13:15:33.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-09-12T19:02:00.000Z (13 days ago)
- Last Synced: 2024-09-25T10:42:49.014Z (about 10 hours ago)
- Topics: grafana, handlebars, markdown, panel, plugin
- Language: TypeScript
- Homepage: https://docs.volkovlabs.io
- Size: 11.8 MB
- Stars: 80
- Watchers: 5
- Forks: 14
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Business Text for Grafana
[](https://codecov.io/gh/VolkovLabs/business-text)
[](https://github.com/VolkovLabs/business-text/actions/workflows/codeql-analysis.yml)
## Introduction
Business Text panel is a Grafana visualization plugin that converts plain text and table data into visually appealing, easy-to-read information cards.
The Business Text panel plugin allows you to construct a text visualization template from the values of a dataset returned by a data source query.
[](https://youtu.be/UVMysEjouNo)
## Requirements
- Business Text panel 5.X requires **Grafana 10** or **Grafana 11**.
- Dynamic Text panel 4.X requires **Grafana 9.2** or **Grafana 10**.
- Dynamic Text panel 2.X and 3.X require **Grafana 8.5** or **Grafana 9**.
- Dynamic Text panel 1.X requires **Grafana 7**.
## Getting Started
You can install the Business Text panel from the [Grafana Plugins catalog](https://grafana.com/grafana/plugins/marcusolsson-dynamictext-panel/) or use the Grafana command line tool.
For the latter, please use the following command:
```bash
grafana-cli plugins install marcusolsson-dynamictext-panel
```
## Highlights
- Uses Monaco Code Editor with automatic formatting supporting templates, JS code snippets, and CSS styling.
- Supports [Markdown](https://commonmark.org/help/) and [Handlebars](https://handlebarsjs.com/guide/expressions.html#basic-usage).
- Renders [markdown-it](https://github.com/markdown-it/markdown-it) into HTML elements.
- Supports the highlighting of code syntax using A11Y styles.
- Provides code sanitization:
- HTML inside templates is sanitized using [XSS](https://jsxss.com/en/index.html).
- Can be disabled in the Grafana configuration through the `disable_sanitize_html` parameter.
- Supports display of nested objects using the `{{json object}}` Handlebars helper.
- Supports display of time global variables (`__to` and `__from`) as seconds, ISO timestamps, or formatted using the `dayjs` library.
- Supports adding the Handlebars helpers and event handlers.
- Supports adding CSS styles.
- Supports internationalization using custom helpers.
## Documentation
| Section | Description |
| --------------------------------------------------------------------- | -------------------------------------------------------------- |
| [Content](https://volkovlabs.io/plugins/business-text/content/) | Explains how to create a visualization template for your data. |
| [Recipes](https://volkovlabs.io/plugins/business-text/recipes/) | Useful snippets that you can use in your templates. |
| [Features](https://volkovlabs.io/plugins/business-text/features/) | Demonstrates panel features.templates. |
| [Release Notes](https://volkovlabs.io/plugins/business-text/release/) | Stay up to date with the latest features and updates. |
## Business Suite for Grafana
The Business Suite is a collection of open source plugins created and actively maintained by Volkov Labs.
The collection aims to solve the most frequent business tasks by providing an intuitive interface with detailed written documentation, examples, and video tutorials.
[](https://volkovlabs.io/plugins/)
## Feedback
We're looking forward to hearing from you. You can use different ways to get in touch with us.
- Ask a question, request a new feature, or report an issue at [GitHub issues](https://github.com/volkovlabs/business-text/issues).
- Subscribe to our [YouTube Channel](https://www.youtube.com/@volkovlabs) and leave your comments.
- Sponsor our open-source plugins for Grafana at [GitHub Sponsor](https://github.com/sponsors/VolkovLabs).
- Support our project by starring the repository.
## License
Apache License Version 2.0, see [LICENSE](https://github.com/volkovlabs/business-text/blob/main/LICENSE).