mirrors/sablier

Fork 0

mirror of https://github.com/sablierapp/sablier.git synced 2026-01-03 03:27:28 +01:00

Files

semantic-release-bot 2515771ce1

Build / Build (push) Has been cancelled

Docker / Build Sablier Docker image (linux/amd64) (push) Has been cancelled

Docker / Build Sablier Docker image (linux/arm/v7) (push) Has been cancelled

Docker / Build Sablier Docker image (linux/arm64) (push) Has been cancelled

Build Sablier plugins / Build Sablier docker image once and share it to E2E jobs (push) Has been cancelled

Build Sablier plugins / Build Traefik Sablier Plugin (push) Has been cancelled

Build Sablier plugins / Build Caddy Sablier Plugin (push) Has been cancelled

Build Sablier plugins / Build Caddy docker image once and share it to Caddy E2E jobs (push) Has been cancelled

Build Sablier plugins / Build ProxyWasm Plugin once and share it to ProxyWasm E2E jobs (push) Has been cancelled

Release / Release (push) Has been cancelled

Docker / Merge and Publish multiarch (push) Has been cancelled

Build Sablier plugins / Run Sablier E2E tests for Traefik middleware (docker) (push) Has been cancelled

Build Sablier plugins / Run Sablier E2E tests for Traefik middleware (docker_swarm) (push) Has been cancelled

Build Sablier plugins / Run Sablier E2E tests for Traefik middleware (kubernetes) (push) Has been cancelled

Build Sablier plugins / Run Sablier E2E tests for Nginx NJS module with Sablier (docker) (push) Has been cancelled

Build Sablier plugins / Run Sablier E2E tests for Nginx NJS module with Sablier (docker_swarm) (push) Has been cancelled

Build Sablier plugins / Run Sablier E2E tests for Caddy middleware (docker) (push) Has been cancelled

Build Sablier plugins / Run Sablier E2E tests for Caddy middleware (docker_swarm) (push) Has been cancelled

Build Sablier plugins / Run Sablier E2E tests for Proxywasm middleware on Apache APISIX (docker) (push) Has been cancelled

Build Sablier plugins / Run Sablier E2E tests for Proxywasm middleware on Envoy (docker) (push) Has been cancelled

Build Sablier plugins / Run Sablier E2E tests for Proxywasm middleware on Nginx (docker) (push) Has been cancelled

Close stale issues and PRs / stale (push) Has been cancelled

docs(release): update doc version from 1.8.1 to 1.8.2

2025-01-14 22:09:16 +00:00

5.7 KiB

Raw Blame History

Themes

Sablier comes with a set of default theme that you can use.

You can also extend the themes by providing your own and they will be templated as Go Templates.

The embedded themes

Name	Preview
`ghost`
`shuffle`
`hacker-terminal`
`matrix`

Custom themes locations

You can use the argument --strategy.dynamic.custom-themes to define the location to search upon starting.

By default, the docker image looks for themes located inside the /etc/sablier/themes folder.

services:
  sablier:
    image: sablierapp/sablier:1.8.2
    volumes:
      - '/var/run/docker.sock:/var/run/docker.sock'
      - '/path/to/my/themes:/etc/sablier/themes'

It will look recursively for themes with the .html extension.

You cannot load new themes added in the folder without restarting
You can modify the existing themes files

Create a custom theme

Themes are served using Go Templates.

Available Go Template Values

Template Key	Template Value	Go Template Usage
`.DisplayName`	The display name configured for the session	`{{ .DisplayName }}`
`.InstanceStates`	An array of `RenderOptionsInstanceState` that represents the state of each required instances	`{{- range $i, $instance := .InstanceStates }}{{ end -}}`
`.SessionDuration`	The humanized session duration from a time.Duration	`{{ .SessionDuration }}`
`.RefreshFrequency`	The refresh frequency for the page. See The `<meta http-equiv="refresh" />` tag	`<meta http-equiv="refresh" content="{{ .RefreshFrequency }}" />`
`.Version`	Sablier version as a string	`{{ .Version }}`
`$RenderOptionsInstanceState.Name`	The name of the instance loading	`{{- range $i, $instance := .InstanceStates }}{{ $instance.Name }}{{ end -}}`
`$RenderOptionsInstanceState.CurrentReplicas`	The number of current replicas of the instance loading	`{{- range $i, $instance := .InstanceStates }}{{ $instance.CurrentReplicas }}{{ end -}}`
`$RenderOptionsInstanceState.DesiredReplicas`	The number of desired replicas of the instance loading	`{{- range $i, $instance := .InstanceStates }}{{ $instance.DesiredReplicas }}{{ end -}}`
`$RenderOptionsInstanceState.Status`	The status of the instance loading, `ready` or `not-ready`	`{{- range $i, $instance := .InstanceStates }}{{ $instance.Status }}{{ end -}}`
`$RenderOptionsInstanceState.Error`	The error trigger by this instance which won't be able to load	`{{- range $i, $instance := .InstanceStates }}{{ $instance.Error }}{{ end -}}`

The `<meta http-equiv="refresh" />` tag

The auto refresh is done using the HTML http-equiv Attribute.

Defines a time interval for the document to refresh itself.

So the first step to create your own theme is to include the HTML <meta> http-equiv Attribute as follows:

<head>
  ...
  <meta http-equiv="refresh" content="{{ .RefreshFrequency }}" />
  ...
</head>

The `showDetails` option

If showDetails is set to false then the .InstanceStates will be an empty array.

How to load my custom theme

You can load themes by specifying their name and their relative path from the --strategy.dynamic.custom-themes-path value.

/my/custom/themes/
├── custom1.html      # custom1
├── custom2.html      # custom2
└── special
    └── secret.html   # special/secret

Such as

curl 'http://localhost:10000/api/strategies/dynamic?session_duration=1m&names=nginx&theme=custom1'

See the available themes from the API

curl 'http://localhost:10000/api/strategies/dynamic/themes'

{
  "custom": [
    "custom"
  ],
  "embedded": [
    "ghost",
    "hacker-terminal",
    "matrix",
    "shuffle"
  ]
}

5.7 KiB Raw Blame History