Seharake: draft

2021-03-26T12:04:34Z

draft

New page

You need to use the terminal emulator to use Gin offline.

There is the [https://gin.g-node.org web interface for Gin] that can be used to manage repositories online, but with some limitations (only up to 100 files with <1GB/file can be uploaded).

== Installation ==

https://gin.g-node.org/achilleas/gin-cli-builds/

=== Windows ===

# Download the version 1.12dev ZIP file (either "gin-cli-1.12dev-windows32.zip" or "gin-cli-1.12dev-windows64.zip", depending on your CPU architecture).
# Inspect the archive, and move the content of the archive to e.g. "C:\Programs\Gin".
# Double-click "C:\Programs\Gin\set-global.bat".

Now open your terminal emulator. Running "where gin" should show the path, e.g. "C:\Programs\Gin\gin.bat".

=== MacOS ===

# Download the "gin-cli-latest-macos.zip" and double click the downloaded file to extract the contents.
# Place the extracted contents under e.g. "/Users/<your name>/Gin". You will see the program file with the path "/Users/<your name>/Gin/gin".
# Add the parent directory (e.g. "/Users/<your name>/Gin") to PATH.

Now open your terminal emulator. Running "which gin" should show the path to the program file, e.g. "/Users/<your name>/Gin/gin".

=== Linux ===

Only Debian-based distributions (Raspberry Pi OS, Ubuntu, Linux Mint etc.) are supported.

# Download "gin-cli-latest.deb", and double click the ".deb" file.

Now open your terminal emulator. Running "which gin" should show the path to the gin program, e.g. "/usr/local/bin/gin".

== Making gin command-line client available for you ==

# Make sure that you have a Gin account online at https://gin.g-node.org
# Open your terminal emulator in your computer, and run `gin login`. It will ask you your login details (it will happen only once). After it says "successfully logged in", you can manage your repositories that you see online.

== Preparation of a local repository ==

=== Creating a repository online ===

The simplest way of creating a new repository is to do it online, using the web interface.

After logging in, click on the "+" button appearing at the top-right of the page.

- "New repository"
- "Import repository"

== Management of a repository ==

=== (Not recommended) the simplest way ===

Although the "simplest" way of using gin is as follows, it often results in a weird behavior which can ruin your repository very easily. So this way of using gin is not recommended...

- Checking in all the changes you have made so far: `gin commit`
- Reflecting your changes in the on-line copy: `gin upload`
- Locally reflecting the changes made in other computers: `gin download`

Using GIN - Revision history

Seharake: draft