all repos — nimisewi_c @ 58a402d36d5014c6dd06b8c8845671b85f0d1916

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
21by default it will compile also `nimisewi.cgi` and `nimisewi_gemini.cgi` and
22if you wish, you can throw them into your cgi-bin folder and serve them using
23whatever cgi thing you want. also they are statically linked, so you don't
24need to worry if your web server is chrooted.
25
26see examples here:
27
28- [http](https://aaoth.xyz/nimisewi)
29- [gemini](gemini://aaoth.xyz/cgi-bin/nimisewi)
30
31## usage
32
33```terminal
34$ nimisewi
35
36poka sutopatikuna pi open sama
37```
38
39## adding new words
40
41to add new words, edit `nimitoki.txt` file. add one word per line.
42
43then, just clean everything and recompile the program.
44
45```terminal
46$ vim nimitoki.txt
47$ make distclean
48$ ./configure
49$ make
50  ...
51```
52
53## bugs
54
55i am pretty much beginner in c, so it is possible that the code contains some
56odd things.
57
58if you have found something wrong or weird,
59send me an email to `aaoth_at_aaoth_dot_xyz`.
60
61## license
62
63all code that makes up `nimisewi`, `nimisewi.cgi`, `nimisewi_gemini.cgi` and
64`makenimitoki` programs is licensed under ISC license
65(see [LICENSE](/file?name=LICENSE&ci=tip)).
66
67`nimitoki.txt` is in public domain.
68
69GNU Autotools (in autotools directory) are licensed under GPLv3 license
70(see [autotools/LICENSE.txt](/file?name=autotools/LICENSE.txt&ci=tip)).