mirror of
https://github.com/chubin/wttr.in
synced 2024-12-25 03:13:06 +00:00
Added some documentation for the one-line mode (#174)
This commit is contained in:
parent
e92a41f9c8
commit
f0fffd9299
1 changed files with 45 additions and 5 deletions
50
README.md
50
README.md
|
@ -118,17 +118,57 @@ For one-line output format, specify additional URL parameter `format`:
|
|||
|
||||
```
|
||||
$ curl wttr.in/Nuremberg?format=3
|
||||
Nuremberg: 🌦 +5⁰C
|
||||
Nuremberg: 🌦 +11⁰C
|
||||
```
|
||||
|
||||
Available preconfigured formats: 1, 2, 3, 4 and custom format using a percent notation.
|
||||
Available preconfigured formats: 1, 2, 3, 4 and the custom format using the percent notation (see below).
|
||||
|
||||
Use `:` separated lists for multiple locations (for repeating queries):
|
||||
You can sepcify multiple locations separated with `:` (for repeating queries):
|
||||
|
||||
```
|
||||
$ curl wttr.in/Nuremberg:Hamburg:Berlin?format=
|
||||
Nuremberg: 🌦 +5⁰C
|
||||
$ curl wttr.in/Nuremberg:Hamburg:Berlin?format=3
|
||||
Nuremberg: 🌦 +11⁰C
|
||||
```
|
||||
Or to process all this queries at once:
|
||||
|
||||
```
|
||||
$ curl 'wttr.in/{Nuremberg,Hamburg,Berlin}?format=3'
|
||||
Nuremberg: 🌦 +11⁰C
|
||||
Hamburg: 🌦 +8⁰C
|
||||
Berlin: 🌦 +8⁰C
|
||||
```
|
||||
|
||||
To specify your own custom output format, use the special `%`-notation:
|
||||
|
||||
```
|
||||
c Weather condition,
|
||||
t Temperature,
|
||||
w Wind,
|
||||
l Location,
|
||||
m Moonphase 🌑🌒🌓🌔🌕🌖🌗🌘,
|
||||
M Moonday,
|
||||
```
|
||||
|
||||
So, these two calls are the same:
|
||||
|
||||
```
|
||||
$ curl wttr.in/London?format=3
|
||||
London: ⛅️ +7⁰C
|
||||
$ curl wttr.in/London?format="%l:+%c+%t"
|
||||
London: ⛅️ +7⁰C
|
||||
```
|
||||
Keep in mind, that when using in `tmux.conf`, you have to escape `%` with `%`, i.e. write there `%%` instead of `%`.
|
||||
|
||||
In progams, that are querying the service automatically (such as tmux),it is better to use some reasonable update interval. In tmux, you can configure it with `status-interval`.
|
||||
|
||||
If several, `:` separated locations, are specified in the query, specify update period
|
||||
as an additional query parameter `period=`:
|
||||
```
|
||||
set -g status-interval 60
|
||||
WEATHER='#(curl -s wttr.in/London:Stockholm:Moscow\?format\="%%l:+%%c%%20%%t%%60%%w&period=60")'
|
||||
set -g status-right "$WEATHER ..."
|
||||
```
|
||||
![wttr.in in tmux status bar](https://wttr.in/files/example-tmux-status-line.png)
|
||||
|
||||
## Moon phases
|
||||
|
||||
|
|
Loading…
Reference in a new issue