( This README.md document is well formatted in: https://github.com/ttm/tokipona )
This repository holds both:
They might be used and installed independently, although:
$ cd article/acm/
comment tipa package loading. Swap line on pronunciation.
$ zip -r arxiv.zip sample-acmlarge.tex sample-acmlarge.bbl samplebody-journals.tex pos.tex syls.tex vowels.tex acmart.cls ACM-Reference-Format.bst figs/
upload arxiv.zip.
Items / Sections / Headers:
For the Python package and the Vim plugin.
This package contains routines to:
Such facilities are implemented in accordance with the Toki Pona article, of which the Latex and PDF files are in the article/ directory of this repository (ttm/tokipona).
Install with:
$ pip install tokipona
or
$ python setup.py tokipona
For customization ease, hacking and debugging, clone the repository and install with 'pip3 install -e':
$ git clone https://github.com/ttm/tokipona.git
$ pip3 install -e <path_to_repo>
This install method is especially useful when reloading the modified module in subsequent runs.
# to import changes made in local package files,
# e.g. if installed with pip3 install -e ~/repos/tokipona/
import sys
keys=tuple(sys.modules.keys())
for key in keys:
if "tokipona" in key:
del sys.modules[key]
### Basic usage
import tokipona as t
### the main functionalities are:
# 1 - make a syntax highlighting file for Vim
sh = t.syntax()
# 2 - analyze the official Toki Pona vocabulary
st = t.stats()
# 3 - obtain (very preliminary) Toki Pona wordnet synsets
wn = t.wordnet()
# 4 - synthesize texts in Toki Pona
sy = t.synthesis()
print( sy.createParagraph() )
print( sy.createPhrase() )
print( sy.createPoem() )
print( sy.createSentence() )
# sh, st, wn, sy have objects related to each of the
# functions as further described in this README.
# 5 - further routines and variables in utils:
v, c = t.utils.vowels, t.utils.consonants
str_ = "TP vowels are: {}; TP consonants are: {}".format(v, c)
print(str_)
possible_words = t.utils.allTokiPonaPossibleWords(n=2)
print("all possible words with two syllables given the TP rules are {}".format(possible_words))
##############################################
### check files in tokipona/
# for many other functionalities and convenient variables.
# Tweak at will.
##############################################
To avoid redundancy upkeep, please visit the Toki Pona Vim plugin page for an overview of the implemented facilities.
To install it by hand, one might copy:
or clone the repository to a directory in your :echo &runtimepath. For example:
$ git clone https://github.com/ttm/tokipona ~/.vim/
If you change the syntax file, a file with highlighted text (in Toki Pona) will have the highlighting updated upon reload (:e in Vim). For more information in using the plugin, see the vim.org page for the Toki Pona Vim plugin.
Also, check the Toki Pona article because it is a carefully built document that contextualizes and describes the routines available in this repository.
A simple text:
Some texts with another color scheme:
And yet in another color scheme:
And an HTML export (through :TOhtml Vim command) of the syntax coloring:
This package іs delivered by running: $ python3 setup.py sdist $ python3 setup.py bdist_wheel $ twine upload dist/
Maybe use "python setup.py sdist upload -r pypi" ?
For making the Vimball for sharing this plugins and derivatives, check the instructions in file ./tokiponaVimballInfo.txt
For now:
This Python package is intended to help in answering these (types of) questions:
This work is sponsored by FAPESP (project 2017/05838-3) in a project lead by Profa. Dra. Maria Cristina Ferreira de Oliveira at VICG/ICMC/USP, São Carlos, Brazil.