aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: ba63e6834a3535796f37acdb59aa40deb8124a7a (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
# nimisewi

nimisewi is a small program that outputs random toki pona phrase.
[toki pona](https://tokipona.org) is a small conlang created by sonja lang.

[first implementation](https://fsl.aaoth.xyz/nimisewi.py)
was created using python, but then i decided to create more portable version.

## installation

installation is very straightforward:

```terminal
$ fsl clone https://fsl.aaoth.xyz/nimisewi.c
$ cd nimisewi
$ make
$ doas make install
```

if you want to use nimisewi as cgi script, you can compile it with:

```terminal
$ make distclean
$ configure --static # if your cgi will be served from chroot
$ make cgi
```

or if you want a cgi script for gemini protocol, run:

```terminal
$ make distclean
$ configure --static # if your cgi will be served from chroot
$ make cgi_gemini
```

now throw that `nimisewi.cgi` into your cgi-bin folder and serve it as you wish.

## usage

```
$ nimisewi

nanpa apeja pi sin len
```

## adding new words

to add new words, edit `nimitoki.txt` file. add one word per line.

then, rebuild `nimitoki.c` and `nimitoki.h` and then relink the whole program.

```terminal
$ vim nimitoki.txt
$ make distclean
$ make
  ...
```

## bugs

i am pretty much beginner in c, so it is possible that the code contains some
odd things.

if you have found something wrong or weird,
send me an email to `aaoth_at_aaoth_dot_xyz`.

## license

isc. see [LICENSE](/LICENSE).