README.md update
This commit is contained in:
parent
1cc245af07
commit
7fd9f313ee
40
README.md
40
README.md
|
@ -4,44 +4,14 @@ RollTables is a python library for generating tables suitable for selecting rand
|
||||||
|
|
||||||
## Quick Start
|
## Quick Start
|
||||||
|
|
||||||
|
Clone the repo and install the virtual env:
|
||||||
```
|
```
|
||||||
# example.yaml
|
% git clone https://github.com/evilchili/dnd-rolltable
|
||||||
|
% cd dnd-rolltable
|
||||||
# metadata is optional
|
% poetry install
|
||||||
metadata:
|
|
||||||
# headers are optional
|
|
||||||
headers:
|
|
||||||
# The first column header always applies to the frequency label;
|
|
||||||
# you can hide this (or any other column) by setting the header to null
|
|
||||||
- Rarity
|
|
||||||
- Color
|
|
||||||
- Notes
|
|
||||||
# frequencies are optional; by default distribution will be uniform
|
|
||||||
frequencies:
|
|
||||||
# multiple distributions may be specified besides 'default'
|
|
||||||
default:
|
|
||||||
- common: 0.5
|
|
||||||
- uncommon: 0.3
|
|
||||||
- rare: 0.15
|
|
||||||
- wondrous: 0.05
|
|
||||||
# 'common' is the text label for the frequency distribution
|
|
||||||
common:
|
|
||||||
# each time a 'common' value is selected for the table, it will be
|
|
||||||
# chosen at random from the following values
|
|
||||||
- red
|
|
||||||
- orange
|
|
||||||
- yellow
|
|
||||||
uncommon:
|
|
||||||
- green
|
|
||||||
- blue
|
|
||||||
rare:
|
|
||||||
- indigo
|
|
||||||
- violet
|
|
||||||
wondrous:
|
|
||||||
# choices can be definitions; both key and the value will be added as columns
|
|
||||||
- octarine: the color of magic
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Invoke the CLI:
|
||||||
```
|
```
|
||||||
% poetry run roll-table example.yaml
|
% poetry run roll-table example.yaml
|
||||||
┏━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┓
|
┏━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┓
|
||||||
|
|
Loading…
Reference in New Issue
Block a user