all repos — nimisewi_c @ fe76f775bb0691663fc757f8b7aa49cedc9ddcf4

simple random toki pona phrase generator

README.md (view raw)

 1# nimisewi
 2
 3nimisewi is a small program that outputs random toki pona phrase.
 4[toki pona](https://tokipona.org) is a small conlang created by sonja lang.
 5
 6[first implementation](https://fsl.aaoth.xyz/nimisewi.py)
 7was created using python, but then i decided to create more portable version.
 8
 9## installation
10
11installation is very straightforward:
12
13```terminal
14$ fsl clone https://fsl.aaoth.xyz/nimisewi.c
15$ cd nimisewi
16$ make
17$ doas make install
18```
19
20if you want to use nimisewi as cgi script, you can compile it with:
21
22```terminal
23$ make distclean
24$ configure --static # if your cgi will be served from chroot
25$ make cgi
26```
27
28or if you want a cgi script for gemini protocol, run:
29
30```terminal
31$ make distclean
32$ configure --static # if your cgi will be served from chroot
33$ make cgi_gemini
34```
35
36now throw that `nimisewi.cgi` into your cgi-bin folder and serve it as you wish.
37
38see examples here:
39
40- [http](https://aaoth.xyz/nimisewi)
41- [gemini](gemini://aaoth.xyz/cgi-bin/nimisewi)
42
43## usage
44
45```
46$ nimisewi
47
48nanpa apeja pi sin len
49```
50
51## adding new words
52
53to add new words, edit `nimitoki.txt` file. add one word per line.
54
55then, rebuild `nimitoki.c` and `nimitoki.h` and then relink the whole program.
56
57```terminal
58$ vim nimitoki.txt
59$ make distclean
60$ make
61  ...
62```
63
64## bugs
65
66i am pretty much beginner in c, so it is possible that the code contains some
67odd things.
68
69if you have found something wrong or weird,
70send me an email to `aaoth_at_aaoth_dot_xyz`.
71
72## license
73
74isc. see LICENSE file in the directory.