An open API service indexing awesome lists of open source software.

https://github.com/jenkinsci/oss-symbols-api-plugin

Dev tools symbols API plugin. Provide to other plugin symbols of common Dev tools
https://github.com/jenkinsci/oss-symbols-api-plugin

symbols ui ux

Last synced: 5 months ago
JSON representation

Dev tools symbols API plugin. Provide to other plugin symbols of common Dev tools

Awesome Lists containing this project

README

        

# Dev Tools Symbols API Plugin

Jenkins API Plugin that provide logo of common Dev tools also known as "symbols", for your Jenkins plugins.

[![Build Status](https://ci.jenkins.io/buildStatus/icon?job=Plugins/oss-symbols-api-plugin/main)](https://ci.jenkins.io/job/plugins/job/oss-symbols-api-plugin/)
[![Jenkins Plugin](https://img.shields.io/jenkins/plugin/v/oss-symbols-api.svg)](https://plugins.jenkins.io/oss-symbols-api/)
[![GitHub release](https://img.shields.io/github/release/jenkinsci/oss-symbols-api-plugin.svg?label=changelog)](https://github.com/jenkinsci/oss-symbols-api-plugin/releases/latest)
[![Symbols](https://img.shields.io/github/directory-file-count/jenkinsci/oss-symbols-api-plugin%2Fsrc%2Fmain%2Fresources%2Fimages%2Fsymbols?type=file&style=flat&label=tools)](src/main/resources/images/symbols)

[![Contributors](https://img.shields.io/github/contributors/jenkinsci/oss-symbols-api-plugin.svg)](https://github.com/jenkinsci/oss-symbols-api-plugin/graphs/contributors)

## Usage

This plugin provides some tools logo of common Dev tools also known as "symbols", for your Jenkins plugins.

Source of the SVG are from

- https://github.com/cdfoundation/artwork
- https://github.com/cncf/artwork
- https://github.com/ossf/artwork
- https://github.com/sigstore/community
- https://github.com/openrewrite
- https://www.openid.net
- https://testcontainers.com
- https://www.wiremock.io
- https://mariadb.com
- https://www.postgresql.org
- https://github.com/opencontainers/opencontainers.org
- https://www.pulumi.com/brand/
- https://github.com/devicons/devicon
- https://brand.hashicorp.com
- https://www.rancher.com/brand-guidelines
- https://www.sonatype.com/newsroom
- https://github.com/hadolint/hadolint
- https://bitnami.com/logos
- https://www.svgrepo.com

All icons are trademarks of their respective owners. The use of these trademarks does not indicate endorsement of the trademark holder, nor vice versa.

Refer to the previous list for the trademark policy of each organization.

Add the oss-symbols-api as dependency to your `pom.xml`:

To use a symbol, reference the icon as following:

### Jelly
```xml

```

### Groovy
```groovy
l.icon(src:"symbol-symbolName plugin-oss-symbols-api")
```

### Java

```java
@Override
public String getIconClassName() {
return "symbol-symbolName plugin-oss-symbols-api";
}
```

One example is the usage with the badge plugin:

```groovy
node {
addBadge(icon: "symbol-prometheus-icon-solid plugin-oss-symbols-api")
}
```

See https://plugins.jenkins.io/badge/ for more details.

Symbol supports standard and dark theme for solid icon

![](docs/badge.png)
![](docs/badge2.png)

Color is also supported

Other example include the `custom-folder-icon` and `customizable-header` plugins.

![](docs/folder_icon.png)
![](docs/header.png)

## LICENSE

Licensed under MIT, see [LICENSE](LICENSE.md)