all repos — nimisewi_c @ d77bd77ed102dd8d6b24f9c45e2a5128d6d859d5

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$ ./configure
17$ make
18$ doas make install
19```
20
21if you want to use nimisewi as cgi script, you can compile it with:
22
23```terminal
24$ make distclean
25$ ./configure --static # if your cgi will be served from chroot
26$ make nimisewi.cgi
27```
28
29or if you want a cgi script for gemini protocol, run:
30
31```terminal
32$ make distclean
33$ configure --static # if your cgi will be served from chroot
34$ make nimisewi_gemini.cgi
35```
36
37now throw that `nimisewi.cgi` or `nimisewi_gemini.cgi` into your cgi-bin folder and serve it as you wish.
38
39see examples here:
40
41- [http](https://aaoth.xyz/nimisewi)
42- [gemini](gemini://aaoth.xyz/cgi-bin/nimisewi)
43
44## usage
45
46```terminal
47$ nimisewi
48
49poka sutopatikuna pi open sama
50```
51
52## adding new words
53
54to add new words, edit `nimitoki.txt` file. add one word per line.
55
56then, just clean everything and recompile the program.
57
58```terminal
59$ vim nimitoki.txt
60$ make distclean
61$ ./configure
62$ make
63  ...
64```
65
66## bugs
67
68i am pretty much beginner in c, so it is possible that the code contains some
69odd things.
70
71if you have found something wrong or weird,
72send me an email to `aaoth_at_aaoth_dot_xyz`.
73
74## license
75
76all code that makes up `nimisewi`, `nimisewi.cgi`, `nimisewi_gemini.cgi` and
77`makenimitoki` programs is licensed under ISC license
78(see [LICENSE](/file?name=LICENSE&ci=tip)).
79
80`nimitoki.txt` is in public domain.
81
82GNU Autotools (in autotools directory) are licensed under GPLv3 license
83(see [autotools/LICENSE.txt](/file?name=autotools/LICENSE.txt&ci=tip)).