Differences

This shows you the differences between two versions of the page.

--- howto:learn:1_install [2021/07/19 18:30]
gerardnico [Tabli]
+++ — (current)
@@ Line 1: / Line 1: @@
-====== Learning Tabulify - Step 1 - Installation ======
-===== Tabli =====
-To learn ''Tabulify'', you need to install it in order to have access to the [[tabli:tabli|Tabli command line tool]].
-This pages will guide you through the installation steps.
-===== Steps =====
-==== Prerequisites ====
-''Tabulify'' relies on ''Java'' version ''1.8''
-You should have therefore already a ''java'' installation from and above ''1.8''
-You can check it by calling the below command
-<code>
-java -version
-</code>
-<console>
-java version "1.8.0_251"
-Java(TM) SE Runtime Environment (build 1.8.0_251-b08)
-Java HotSpot(TM) 64-Bit Server VM (build 25.251-b08, mixed mode)
-</console>
-<note>
-If this is not the case, you can download it and install it at the [[https://www.oracle.com/java/technologies/javase-downloads.html|Java download page]]
-</note>
-==== Installation Directory ====
-Create a directory called the [[tabli:home|Tabulify Home]] where you will unzip the content of the installation file. <inote>A path without space is recommended</inote>
-  * Windows
-<code dos>
-:: Below c:\tabulify is the Tabulify Home.
-mkdir c:\tabulify
-</code>
-  * Linux / Mac
-<code bash>
-# Below /opt/tabulify is the Tabulify Home.
-mkdir /opt/tabulify
-</code>
-==== Download ====
-You need to [[https://tabulify.com/tabulify.zip]] download the zipped file for your operating system.
-''Tabulify'' is distributed for different operation system.
-==== Unzip ====
-Unzip the downloaded file into the [[tabli:home|Tabulify Home]]
-At the command line:
-  * Windows
-<code dos>
-unzip tabulify.zip -d c:\tabulify
-</code>
-  * Linux
-<code bash>
-unzip tabulify.zip -d /opt/tabulify
-</code>
-==== Symlink ====
-  * Optionally, create a symlink into your bin directory to be able to call [[tabli:tabli|Tabulify]] from everywhere.
-<code dos>
-mklink c:\tabulify\tabli.cmd %USERPROFILE%\bin\tabli.cmd
-</code>
-  * This local ''bin'' directory should be added to the ''PATH'' environment variable.
-<code dos>
-setx PATH=%PATH%,%USERPROFILE%\bin
-</code>
-===== Tabli =====
-If you can call the ''tabli'' command line, your installation is validated.
-[[tabli:tabli|Tabli]] is the command line tool of ''Tabulify'' and is composed of [[tabli:module|module]] that regroups [[tabli:command|command]] where each command can be customized with ''argument'' and [[tabli:option|options]].
-  * Open a console
-  * Call [[tabli:tabli|tabli]] with the ''help'' option
-<unit>
-<code dos>
-tabli --help
-:: or if you didn't have the directory in your PATH environment variable
-:: TABULIFY_HOME\tabli.cmd --help
-:: in our installation documentation
-:: c:\tabulify\tabli.cmd
-</code>
-  * The [[tabli:help|help]] should shows up.
-<console>
-Tabli
-=====
-Tabli, the tabulify command line data processing tool
-Example
--------
-- To load a csv file into the sqlite database, you would type:
-    tabli data transfer data.csv @sqlite
-Syntax
-------
-    tabli <command> [-h,--help]
-where:
-  Commands:
-    conf          Management and configuration of the tabli environment.
-    connection    Management and configuration of the connections to systems.
-    data          Data operations against data resources (table, file, ...).
-    vault         Encrypt and decrypt sensitive information
-  Option:
-    -h,--help     Print this help
-</console>
-</unit>
-===== Optional =====
-==== Terminal Width Size ====
-Set the width size of you terminal to a big enough number. We recommend 9000.
-When [[tabli:conf:list|listing some configuration]], you may get a lengthy output (such as a list of a path) and the output will then not render nicely.
-To avoid this inconvenient, our advice is to increase the width size of your terminal.
-Example with ''cmd'':
-  * Top-Left corner > Properties > Layout
-{{:operation:terminal_width_size.png|}}
-===== Next Step =====
-In ''Tabulify'', all data are uniformly called ''data resources''. All [[op:op|data operations]] are made on ''data resource''. You drop, select, create, ... etc ''data resources''.
-<btn>
-[[2_data_resource|What's a Data Resource ?]]
-</btn>