Tk-Yupana Files

*****************************************************************************
			     TK-YUPANA rev. 0.7

				      by

				   kunturweb

			http://kunturweb.altervista.org

			   kunturweb@altervista.org
*****************************************************************************

INDEX

	1 - ABOUT		What is tk-yupana?
	2 - GET IT		Where tk-yupana can be downloaded
	3 - FILES		Content of the directory
	4 - REQUIREMENTS	Minimum requirements
	5 - RUN TK-YUPANA	How to run tk-yupana
	6 - LOCALIZATION	How to change language
	7 - HELP		How to help with translations
	8 - LICENSE		Gnu GPL v3 License
	9 - COPYRIGHT		Copyright of the author

	
1 - ABOUT

tk-yupana is a simple program which shows some theories about the Incan 
Abacus (or the Yupana).

Implemented Theories:
	- Theories based upon an additive numeration system
		- Additive System in base 10 by Cinzia Florio (2009)
	- Theories based upon a positional numeration System
		- Positional System in base 10 by H. Wassen (1931)
		- Positional System in base 10 by C. Radicati di Primeglio (1979)
		- Positional System in base 10 by Eng. W. Burns Glynn (1981)
		- Positional System in base 40 by Eng. De Pasquale (2001)
		- Positional System in base 10 by A. Chirinos Rivera (2008)

tk-yupana is written in Tcl/Tk

2 - GET IT

tk-yupana is available for free download from:

	* KUNTURWEB:	http://kunturweb.altervista.org/pag/en/tk-yupana.html

	* SOURCEFORGE:	http://sourceforge.net/projects/tk-yupana


3 - FILES

tk-yupana comes as archive (tar.gz or zip) and debian package (.deb). 
This means that You need
	1) a proper program to explode the archive
	or 
	2) a linux debian/ubuntu system with the program dpkg to install the
	   package.

In the first case, once you have opened the archive you'll get a 
directory with the following content:

  - tk-yupana-0.x/----- LICENSE.txt		 GNU-GPL-V3 License file
		  ----- doc/  	        	 Documents directory
		        |--- README-EN.txt	 This README file (english)
		        |--- README-ES.txt	 This README file (spanish)
		        |--- README-IT.txt	 This README file (italian)
			|--- tk-yupana-EN.pdf	 User Manual (english) *** BETA ***
			|--- tk-yupana-ES.pdf	 User Manual (spanish) *** BETA ***
			|--- tk-yupana-IT.pdf	 User Manual (italian)
		  ----- img/		         Generic images directory
		  	|___ beans/		 Beans images directory
			     |_40/		 40x40 resolution
			     |_20/		 20x20 resolution
		  ----- locale/	        	 Translations directory
		   	     |___ it.msg	 Italian translation
		    	     |___ en.msg	 English translation (beta)
		    	     |___ es.msg	 Spanish translation (beta)
		    	     |___ de.msg	 German translation (alpha)
		    	     |___ fr.msg	 French translation (alpha)
		    	     |___ jp.msg	 Japanese translation (alpha)
		    	     |___ pt.msg	 Portuguese translation (alpha)
		    	     |___ ru.msg	 Russian translation (alpha)
		    	     |___ qu.msg	 Quechua translation (alpha)
			     |___ example.msg	 Example file for translations
			     |___ default.txt	 Default message
		    	     it/
				|___ help-xxx.txt    Italian quick help
				|___ ....	     Italian quick help
				|___ credits-it.txt Italian credits file
			     en/
				|___ help-xxx.txt    English quick help (beta)
				|___ ....            English quick help (beta)
				|___ credits-en.txt English credits file (beta)
			     es/
				|___ help-xxx.txt    Spanish quick help (beta)
				|___ ....	     Spanish quick help (beta)
				|___ credits-es.txt Spanish credits file (beta)
			     qu/
				|___ help-xxx.txt    Quechua quick help (beta)
				|___ ....	     Quechua quick help (beta)
				|___ credits-es.txt  Quechua credits file (beta)
		  ----- tk-yupana.tcl		 Program tk-yupana

4 - REQUIREMENTS

tk-yupana is a tcl/tk script. You need to install tcl and tk packages 
for your system in order to run the program.

	LINUX
		Depending on your distribution, you should install
		tcl-8.4 and tk-8.4 (or greater versions).

		For instance, under Debian (or Ubuntu), you need to type 
		# sudo apt-get install tcl tk

	MINDOMS
		install http://www.activestate.com/activetcl/downloads
		Double click on  tk-yupana.tcl

5 - RUN TK-YUPANA

From here on, I suppose you have ALREADY installed TCL and TK on your system
(please, see chapter 4 for details)

	LINUX (debian, ubuntu, ecc.)
		Open a terminal and execute the following command:

		# sudo dpkg -i tk-yupana_<rev>_all.deb

		To run tk-yupana, simply tape:

		# tk-yupana

		Click on the Condor Icon to access menu; there you'll
		find a quick-help text.

	LINUX
		Open a terminal and change the directory to tk-yupana-r0.x/

		# cd tk-yupana-r0.x

		Type:

		# ./tk-yupana.tcl

		Click on the Condor Icon to access menu; there you'll
		find a quick-help text.
		
	MINDOMS
		Open the explorer window and navigate to the tk-yupana-r0.x/

		Double click on the icon tk-yupana.tcl

		Click on the Condor Icon to access the menu; there you'll
		find a help text.

	You can find more exhaustive instructions in the User Manual
	located in the doc/ directory.

6 - LOCALIZATION

	tk-yupana has been translated into: Italian, Spanish and English. 
	The default language is Italian.

	The GUI labels have been also transalted into other languages 
	(german, french, portuguese, russian, japanese, filipino) to
	check the graphic rendering of different characters, but
	these translations are not 100% reliable. Besides the help-files 
	are missing for these languages. (See also Chapter 7 of this manual).

	LINUX
		if tk-yupana starts in another language than yours, You 
		should set up correctly the environment variable LANG to 
		have it	translated into your language; i.e. launch tk-yupana 
		in the following way:

		# LANG=es ./tk-yupana.tcl	(for spanish)

		or

		# LANG=en ./tk-yupana.tcl	(for english)


	WINDOWS
		??? Dunno! ???


7 - HELP ME!

	If you want to collaborate with the project and translate tk-yupana
	into your language, please contact kunturweb@altervista.org.

	Have you any idea about how to localize a tcl/tk application with
	msgcat under Windows? Write me, and I will add the infos you provide
	here! Thanx.

	If you don't know how, but you would like to help, it's not so 
	difficult! Please, rite me: kunturweb@altervista.org

8 - LICENSE

	tk-yupana is free software: you can redistribute it and/or modify
	it under the terms of the GNU General Public License as published by
	the Free Software Foundation, either version 3 of the License, or
	(at your option) any later version.

	tk-yupana is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	GNU General Public License for more details.

	You should have received a copy of the GNU General Public License
	along with tk-yupana.  If not, see <http://www.gnu.org/licenses/>.


9 - COPYRIGHT

	(c) 2012-2014 by Kunturweb (http://kunturweb.altervista.org)