speech-helpers-jinja

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

speech-helpers-jinja

★ 10 Open GitHub ↗

Jinja custom template speech helpers for Home Assistant

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Jinja Speech Helper Templates
Speech helper template macros for Home Assistant
## plural(word, qty, show_qty)
Pluralize a word when required.
- **word** - word to pluralize *[string]*
- **qty** -  quantity *[number]*
- **show_qty** - preceed the word with the quantity *[boolean]*
### Usage
    {% from 'speech_helpers.jinja' import plural %}
    You need to leave for work in {{ plural('minute', 10, true) }}!
#### Output
You need to leave for work in 10 minutes!
## plural_verb(qty)
Display proper verb for given quantity.
- **qty** -  quantity *[number]*
### Usage
    {% from 'speech_helpers.jinja' import plural_verb %}
    {% from 'speech_helpers.jinja' import plural %}
    {% set qty_apple = 5 %}
    {% set qty_orange = 1 %}
    There {{ plural_verb(qty_apple) }} {{ plural('apple', qty_apple, true) }}.
    The {{ plural('orange', qty_orange, false) }} {{ plural_verb(qty_orange) }} yummy.
#### Output
There are 5 apples.

The orange is yummy.
## array_to_clist(arr, title)
Convert an array of items to a comma separated list.
- **arr** - array of items *[list]*
- **title** - list items with title case *[boolean]*
### Usage
    {% from 'speech_helpers.jinja' import array_to_clist %}
    {% set active_types = ['garbage', 'recycle', 'yard waste'] %}
    Don't forget to take out the {{ array_to_clist(active_types, false) }} today!
#### Output
Don't forget to take out the garbage, recycle, and yard waste today!
## iarticle(word)
Add the apropriate indefinate article (a, an) before a word.   values will automatically be coverted to the text equivelent.
- **word** - word to preceed with an indefinate article *[string]*
### Usage
    {% from 'speech_helpers.jinja' import iarticle %}
    There is {{ iarticle(50) }} percent chance of rain today.
    There is {{ iarticle(85) }} kilometer difference in the commute.
    That was {{ iarticle('honourable') }} thing to do.
#### Output
There is a fifty percent chance of rain today.

There is an eighty five kilometer difference in the commute.

That was an honourable thing to do.
## ordinal_number(number)
Convert a  value to it's ordinal value.
- **number** - a  value *[integer]*
### Usage
    {% from 'speech_helpers.jinja' import ordinal_number %}
    {{ ordinal_number(1) }}
    {{ ordinal_number(2) }}
    {{ ordinal_number(3) }}
#### Output
1st

2nd

3rd
## number_words(number)
Convert a  value to it's text equivelent.  Accepts numbers with comma separators and decimals.
- **number** - a numberical value *[float]*
### Usage
    {% from 'speech_helpers.jinja' import number_words %}
    {{ number_words(123456789) }}
#### Output
one hundred twenty three million four hundred fifty six thousand seven hundred eighty nine
## cardinal_direction(bearing)
Convert a  compass bearing to cardinal direction short form. (eg. NNW)
- **bearing** - a numberical bearing value (0-360) *[integer]*
### Usage
    {% from 'speech_helpers.jinja' import cardinal_direction %}
    {{ cardinal_direction(250) }}
#### Output
WSW
## full_cardinal_direction(bearing)
Convert a  compass bearing to cardinal direction long form. (eg. North-Northwest)
- **bearing** - a numberical bearing value (0-360) *[integer]*
### Usage
    {% from 'speech_helpers.jinja' import full_cardinal_direction %}
    {{ full_cardinal_direction(250) }}
#### Output
West-Southwest

speech-helpers-jinja

Today's picks

Was this content helpful?

Recent Feedback

speech-helpers-jinja

Today's picks

Was this content helpful?

Recent Feedback

Download README