# 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
$ ./configure
$ 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 nimisewi.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 nimisewi_gemini.cgi
```

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

see examples here:

- [http](https://aaoth.xyz/nimisewi)
- [gemini](gemini://aaoth.xyz/cgi-bin/nimisewi)

## usage

```terminal
$ nimisewi

poka sutopatikuna pi open sama
```

## adding new words

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

then, just clean everything and recompile the program.

```terminal
$ vim nimitoki.txt
$ make distclean
$ ./configure
$ 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

all code that makes up `nimisewi`, `nimisewi.cgi`, `nimisewi_gemini.cgi` and
`makenimitoki` programs is licensed under ISC license
(see [LICENSE](/file?name=LICENSE&ci=tip)).

`nimitoki.txt` is in public domain.

GNU Autotools (in autotools directory) are licensed under GPLv3 license
(see [autotools/LICENSE.txt](/file?name=autotools/LICENSE.txt&ci=tip)).