Waxaan qoraynaa oon dib uhabeyn ku wadnaa docs oo af-soomaali ku qoran, ka qeybqaadasho raac lifaaqaan...Contribution guidelines

Installing Soplang

This guide will walk you through the process of installing Soplang on your system. Soplang is available for Windows, macOS, and Linux.

Prerequisites

Before installing Soplang, ensure your system meets the following requirements:

  • Windows 10 or later, macOS 10.15+, or a modern Linux distribution
  • 4GB RAM (minimum)
  • 500MB of free disk space

Windows Installation

Using the Installer (Recommended)

  1. 1
    Download the latest Windows installer (.msi file) from the downloads page.
  2. 2
    Run the installer by double-clicking the downloaded file.
  3. 3
    Follow the installation wizard instructions. We recommend keeping all default options.
  4. 4
    The installer will automatically add Soplang to your PATH environment variable.
  5. 5
    To verify the installation, open Command Prompt or PowerShell and run:
    terminal
    soplang --version

Using Chocolatey

If you use Chocolatey package manager, you can install Soplang with the following command:

terminal
choco install soplang

macOS Installation

Using the Installer Package

  1. 1
    Download the latest macOS installer (.pkg file) from the downloads page.
  2. 2
    Open the downloaded .pkg file.
  3. 3
    Follow the installation wizard instructions.
  4. 4
    To verify the installation, open Terminal and run:
    terminal
    soplang --version

Using Homebrew

If you use Homebrew package manager, you can install Soplang with the following command:

terminal
brew install soplang

Linux Installation

Debian/Ubuntu

terminal
sudo apt-get update sudo apt-get install soplang

Fedora

terminal
sudo dnf install soplang

Arch Linux

terminal
sudo pacman -S soplang

Using the Tarball

  1. Download the latest Linux tarball (.tar.gz file) from the downloads page.
  2. Extract the tarball:
    terminal
    tar -xzf soplang-1.2.0-linux-x86_64.tar.gz
  3. Navigate to the extracted directory:
    terminal
    cd soplang-1.2.0
  4. Run the installation script:
    terminal
    ./configure make sudo make install
  5. To verify the installation, run:
    terminal
    soplang --version

Using Docker

Soplang is also available as a Docker image. You can pull the latest image with:

terminal
docker pull soplang/soplang:latest

To run Soplang in a Docker container:

docker
docker run -it --rm soplang/soplang

Virtual Environments

It's recommended to use virtual environments for Soplang projects to manage dependencies and isolate your project environment.

Creating a Virtual Environment

terminal
soplang -m venv myenv

Activating the Virtual Environment

On Windows:

cmd.exe
myenv\Scripts\activate

On macOS and Linux:

bash
source myenv/bin/activate

Troubleshooting

Common Issues

Command not found error

If you get a "command not found" error when trying to run Soplang, ensure that the installation directory is in your PATH environment variable.

Permission denied error

On Linux and macOS, you might need to add execute permissions to theSoplang binary:

bash
chmod +x /path/to/soplang

Dependency issues

If you encounter dependency issues, try reinstalling Soplang or check the community forums for help.

Quick Start

Write your first Soplang program and learn the basics

Syntax Basics

Return to the fundamental syntax of Soplang