📝 docs: getting ready for Ukrainian translation

This commit is contained in:
eshanized
2025-01-11 19:08:14 +05:30
parent 1b6bca56b0
commit db2813dbe4
28 changed files with 3455 additions and 0 deletions

View File

@@ -0,0 +1,122 @@
---
sidebar_position: 3
---
# Installing with AUR
### 🌟 **Installing Packages with an AUR Helper on Snigdha OS**
Snigdha OS is known for its powerful **Arch User Repository (AUR)**, which provides access to user-contributed packages that are not included in the official repositories. To simplify the process of building and installing packages from the AUR, many users rely on **AUR helpers** like `yay`, `paru`, or `trizen`.
### 🔧 **Step 1: Install an AUR Helper**
#### **Popular AUR Helpers**
1. **Yay (Yet Another Yaourt)**
Lightweight and popular among Arch users.
- Install:
```bash
sudo pacman -S --needed git base-devel
git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si
```
2. **Paru**
A modern AUR helper written in Rust, which offers fast operations and is actively maintained.
- Install:
```bash
sudo pacman -S --needed git base-devel
git clone https://aur.archlinux.org/paru.git
cd paru
makepkg -si
```
3. **Trizen**
Another reliable AUR helper that integrates with pacman and supports clean builds.
- Install:
```bash
sudo pacman -S --needed git base-devel
git clone https://aur.archlinux.org/trizen.git
cd trizen
makepkg -si
```
### 🌟 **Step 2: Search and Install AUR Packages**
Once your AUR helper is installed, you can easily search for and install AUR packages.
#### **Basic Commands**
| **Command** | **Description** |
|----------------------------------|------------------------------------------|
| `yay -S package-name` | Install a package from AUR. |
| `paru -S package-name` | Install a package from AUR. |
| `trizen -S package-name` | Install a package from AUR. |
| `yay -Ss package-name` | Search for a package in AUR. |
| `paru -Ss package-name` | Search for a package in AUR. |
| `trizen -Ss package-name` | Search for a package in AUR. |
| `yay -Syu` | Update all installed packages (including AUR). |
| `paru -Syu` | Update all installed packages (including AUR). |
| `trizen -Syu` | Update all installed packages (including AUR). |
| `yay -R package-name` | Remove a package. |
| `paru -R package-name` | Remove a package. |
| `trizen -R package-name` | Remove a package. |
### 🌐 **Step 3: Example Installations**
1. **Install `visual-studio-code-bin` (AUR package)**:
```bash
yay -S visual-studio-code-bin
```
2. **Search for a package (e.g., Brave Browser)**:
```bash
paru -Ss brave
```
3. **Update All Packages**:
```bash
yay -Syu
```
4. **Remove a Package (e.g., Discord)**:
```bash
paru -R discord
```
### ⚠️ **Tips and Precautions**
1. **Enable Parallel Builds**: Speed up builds by editing `/etc/makepkg.conf` and setting:
```bash
MAKEFLAGS="-j$(nproc)"
```
This uses all available CPU cores for compiling.
2. **Check PKGBUILDs**: Always review the **PKGBUILD** file for security before installing a package:
```bash
yay -G package-name
cd package-name
cat PKGBUILD
```
3. **Use Trusted Helpers**: Stick to widely-used and actively maintained AUR helpers to minimize risks.
4. **Update Regularly**: Keep your system updated, as outdated packages can lead to dependency issues:
```bash
yay -Syu
```
---
### 🚀 **Conclusion**
Using an AUR helper like `yay`, `paru`, or `trizen` streamlines the process of installing and managing AUR packages, making Snigdha OS even more powerful and user-friendly. Happy exploring! 😄

View File

@@ -0,0 +1,89 @@
---
sidebar_position: 4
---
# Chaotic AUR
### 🔧 **What is Chaotic-AUR?**
Chaotic-AUR is an unofficial **AUR (Arch User Repository)** repository that provides pre-built packages for **Arch Linux**, **Snigdha OS**, and **Manjaro** users. It hosts packages that are not included in the official repositories or AUR, allowing for quicker and easier installation of a variety of applications. Chaotic-AUR makes it easier for users to access a wide range of packages without the need to manually compile them.
### 🌟 **Key Features**
1. **Pre-built Packages**: Chaotic-AUR hosts pre-built packages, saving you time on compiling.
2. **Extensive Package Selection**: It includes a vast range of packages from AUR, even those with complex build processes.
3. **Up-to-date**: The repository is continuously updated, so packages stay current with the latest versions available in the AUR.
4. **AUR-based**: It is based entirely on the AUR, so it contains packages contributed by the Arch community.
5. **Available for Arch Linux, Snigdha OS, and Manjaro**: Chaotic-AUR is suitable for **Arch Linux**, **Snigdha OS**, and **Manjaro** users, making it a versatile option for multiple Linux distributions.
### 🌐 **Official Installation Documentation for Chaotic-AUR**
Follow the official steps below to install Chaotic-AUR on **Arch Linux**, **Snigdha OS**, or **Manjaro**:
#### **Step 1: Import the Chaotic-AUR Keyring**
The first step is to import the GPG key used to sign packages from Chaotic-AUR. Run the following command:
```bash
pacman-key --recv-key 3056513887B78AEB --keyserver keyserver.ubuntu.com
pacman-key --lsign-key 3056513887B78AEB
pacman -U 'https://cdn-mirror.chaotic.cx/chaotic-aur/chaotic-keyring.pkg.tar.zst'
pacman -U 'https://cdn-mirror.chaotic.cx/chaotic-aur/chaotic-mirrorlist.pkg.tar.zst'
```
#### **Step 2: Add the Chaotic-AUR Repository to Your Pacman Configuration**
To enable Chaotic-AUR, you need to add the repository to the **pacman.conf** file.
1. Open **pacman.conf** using your favorite text editor (e.g., nano or vim):
```bash
sudo nano /etc/pacman.conf
```
2. Add the following lines at the end of the file:
```ini
[chaotic-aur]
Server = https://repo.archlinuxcn.org/$arch
```
3. Save the file and close the editor.
#### **Step 3: Update Package Database**
After adding the repository, update your package database to fetch the latest list of packages:
```bash
sudo pacman -Sy
```
#### **Step 4: Install Packages from Chaotic-AUR**
Now you can install packages from the Chaotic-AUR repository using **pacman**:
```bash
sudo pacman -S package-name
```
For example, to install **Google Chrome**:
```bash
sudo pacman -S google-chrome
```
### 🌐 **Advantages of Using Chaotic-AUR**
1. **Speed**: Pre-built binaries are much faster to install compared to building from source, especially for large or complex packages.
2. **Convenience**: It saves users the trouble of having to manually manage dependencies or deal with build failures.
3. **Large Package Selection**: Chaotic-AUR includes many packages that may not be available in the official Arch repositories.
4. **No Build Failures**: As the packages are pre-compiled, you dont need to worry about running into build issues.
### ⚠️ **Precautions**
1. **Trust**: Since Chaotic-AUR is an unofficial repository, some users may have security concerns about trusting the source. Always review the packages you install and consider the risks.
2. **Stability**: Although Chaotic-AUR is frequently updated, it's still unofficial, so there may be occasional issues with certain packages.
3. **Package Availability**: While Chaotic-AUR offers many AUR packages, not every package may be available, and some packages might be outdated compared to those in the official AUR.
### 🛠️ **Chaotic-AUR vs AUR Helpers**
- **AUR Helpers**: Tools like `yay`, `paru`, and `trizen` allow users to build and install AUR packages from source. This provides more control over the installation but can be slower and prone to build errors.
- **Chaotic-AUR**: Provides pre-built binaries for faster installation but lacks the customization and flexibility of building from source. It's an excellent option for users looking for speed and ease of use.
### 🚀 **Conclusion**
Chaotic-AUR is an excellent tool for **Arch Linux**, **Snigdha OS**, and **Manjaro** users who want the convenience of pre-built packages from the AUR without the hassle of compiling them. It provides faster installations and a vast selection of packages while being actively updated and maintained by the community. However, it's important to consider the potential security and stability trade-offs when using an unofficial repository.

View File

@@ -0,0 +1,303 @@
---
sidebar_position: 2
---
# Shortcut for Developers
### Git Commands & Aliases
Here are your Git aliases with explanations and emojis for easy reference:
- **`alias gs="git status"`** 📜:
Show the current status of the Git repository (modified files, untracked files, etc.).
- **`alias ga="git add"`** :
Stage changes for commit (adds a file to the staging area).
- **`alias gaa="git add --all"`** 📥:
Stage all modified, deleted, and untracked files for commit.
- **`alias gc="git commit"`** ✏️:
Commit the staged changes to the repository.
- **`alias gca="git commit --amend"`** 🔄✏️:
Amend the last commit (useful for correcting commit messages or adding more changes).
- **`alias gcm="git commit -m"`** 📝💬:
Commit changes with a specific commit message.
- **`alias gco="git checkout"`** 🔀:
Switch branches or restore working directory files.
- **`alias gbr="git branch"`** 🌿:
List, create, or delete Git branches.
- **`alias gb="git branch"`** 🌱:
List all branches in the repository.
- **`alias gl="git log"`** 📖:
View the commit history with details like author and message.
- **`alias glg="git log --oneline --graph --all"`** 🗂️📊:
View a visualized, condensed commit history (one-line format with a graph showing branching and merging).
- **`alias gst="git stash"`** 🗂️🔒:
Temporarily save changes that are not ready for commit.
- **`alias gpo="git push origin"`** 🚀🌍:
Push your local commits to the remote repository on the `origin` remote.
- **`alias gpl="git pull"`** 🔄🔃:
Pull changes from the remote repository (fetch and merge).
- **`alias gup="git pull --rebase"`** 🔄📅:
Pull changes from the remote repository but rebase your local commits on top of the remote branch.
- **`alias gd="git diff"`** 🔍📝:
Show changes between commits, working directory, and staged changes.
- **`alias gds="git diff --staged"`** 📑:
Show the differences between the staged changes and the last commit.
- **`alias gls="git ls-files"`** 🗃️:
List all files currently tracked by Git in the repository.
- **`alias gcl="git clone"`** 🛠️:
Clone a Git repository into a new directory.
- **`alias gtag="git tag"`** 🏷️:
Create, list, or delete tags in the Git repository.
These Git aliases provide quick access to common Git operations, making version control more efficient and saving you time while working with Git repositories.
Here are the explanations for your aliases across various tools, with some added emojis to make them more visually engaging:
### npm Aliases
- **`ni="npm install"`** 🛠️:
Install dependencies for the project.
- **`nis="npm install --save"`** 💾:
Install and save the package in the `dependencies` section of `package.json`.
- **`nisdev="npm install --save-dev"`** 🛠️🔧:
Install and save the package as a development dependency.
- **`nup="npm update"`** 🔄:
Update all installed npm packages to their latest versions.
- **`nstart="npm start"`** ▶️:
Start the application (runs the start script).
- **`nrun="npm run"`** ▶️💻:
Run any custom npm script defined in `package.json`.
- **`ntest="npm test"`** 🧪:
Run tests defined in the `test` script.
- **`nls="npm ls"`** 📜:
List all installed packages in the current project.
- **`nci="npm ci"`** ⚡:
Perform a clean install (faster and more predictable than `npm install`).
- **`nfund="npm fund"`** 💰:
Show the funding information for your project's dependencies.
- **`npublish="npm publish"`** 📦:
Publish your package to the npm registry.
- **`nversion="npm version"`** 🔢:
View and manage versioning for your project.
- **`nrm="npm run"`** 🔄:
Run a specific npm script.
- **`nout="npm outdated"`** ⏳:
Check for outdated packages in your project.
### pnpm Aliases
- **`pni="pnpm install"`** 🛠️:
Install dependencies using pnpm.
- **`pnis="pnpm install --save"`** 💾:
Install and save the package in `dependencies`.
- **`pnisdev="pnpm install --save-dev"`** 🛠️🔧:
Install and save the package as a development dependency.
- **`pnm="pnpm manager"`** ⚙️:
Use pnpm as the package manager.
- **`pnup="pnpm update"`** 🔄:
Update all installed pnpm packages.
- **`pnstart="pnpm start"`** ▶️:
Start the application with pnpm.
- **`pnrun="pnpm run"`** ▶️💻:
Run any script defined in `package.json` using pnpm.
- **`pntest="pnpm test"`** 🧪:
Run tests defined in the `test` script using pnpm.
- **`pnls="pnpm list"`** 📜:
List all installed pnpm packages.
- **`pnci="pnpm ci"`** ⚡:
Perform a clean install with pnpm.
- **`pnpublish="pnpm publish"`** 📦:
Publish a package to the pnpm registry.
- **`pnversion="pnpm version"`** 🔢:
View and manage versioning for your pnpm project.
- **`pnout="pnpm outdated"`** ⏳:
Check for outdated pnpm packages.
### Python Aliases
- **`py="python"`** 🐍:
Shortcut for the Python interpreter.
- **`py3="python3"`** 🐍3:
Shortcut for Python 3 interpreter.
- **`pip="pip3"`** 📦:
Use `pip3` to manage Python packages.
- **`pipup="pip install --upgrade"`** ⬆️📦:
Upgrade pip packages.
- **`pyvenv="python3 -m venv"`** 🐍🧳:
Create a Python virtual environment.
- **`pyactivate="source venv/bin/activate"`** 🔑:
Activate a Python virtual environment.
- **`pydeactivate="deactivate"`** ❌:
Deactivate the current Python virtual environment.
- **`pyrun="python"`** 🐍🏃‍♂️:
Run a Python script.
- **`pycheck="python -m py_compile"`** 🔍📝:
Check Python script syntax without running it.
- **`pytest="python -m pytest"`** 🧪:
Run tests with pytest.
- **`pydoc="python -m pydoc"`** 📚:
Launch Python documentation server.
- **`pylist="pip list"`** 📜:
List installed Python packages.
- **`pyfreeze="pip freeze"`** ❄️:
List installed packages in `requirements.txt` format.
- **`pyinstall="pip install"`** 📦:
Install Python packages.
- **`pyuninstall="pip uninstall"`** ❌📦:
Uninstall Python packages.
### C++ Aliases
- **`cpp-compile="g++ -std=c++17 -Wall -Wextra -o output"`** ⚙️📦:
Compile C++ code with standard C++17 features and output as `output`.
- **`cpp-run="g++ -std=c++17 -Wall -Wextra -o output && ./output"`** ▶️:
Compile and run a C++ program.
- **`cpp-compile-opt="g++ -std=c++17 -O2 -Wall -Wextra -o output"`** ⚙️🔧:
Compile C++ code with optimizations (`-O2`).
- **`cpp-clean="rm -f output"`** 🧹:
Remove the compiled output file.
- **`cpp-build-all="g++ -std=c++17 -Wall -Wextra *.cpp -o output"`** 🔨:
Compile all `.cpp` files in the directory.
- **`cpp-edit="nano"`** ✏️:
Open the code in the `nano` text editor.
- **`cpp-exec="./output"`** ▶️💻:
Execute the compiled output.
### C Aliases
- **`c-compile="gcc -std=c11 -Wall -Wextra -o output"`** ⚙️📦:
Compile C code with standard C11 features and output as `output`.
- **`c-run="gcc -std=c11 -Wall -Wextra -o output && ./output"`** ▶️:
Compile and run a C program.
- **`c-compile-opt="gcc -std=c11 -O2 -Wall -Wextra -o output"`** ⚙️🔧:
Compile C code with optimizations (`-O2`).
- **`c-clean="rm -f output"`** 🧹:
Remove the compiled output file.
- **`c-build-all="gcc -std=c11 -Wall -Wextra *.c -o output"`** 🔨:
Compile all `.c` files in the directory.
- **`c-edit="nano"`** ✏️:
Open the code in the `nano` text editor.
- **`c-exec="./output"`** ▶️💻:
Execute the compiled output.
### Rust Aliases
- **`rustc="rustc"`** ⚙️:
Compile Rust programs using the `rustc` compiler.
- **`rust-run="cargo run"`** ▶️📦:
Run the current Rust project.
- **`rust-build="cargo build"`** 🏗️:
Build the current Rust project.
- **`rust-build-rel="cargo build --release"`** 🏗️🚀:
Build the project in release mode for optimizations.
- **`rust-test="cargo test"`** 🧪:
Run tests for the current project.
- **`rust-clean="cargo clean"`** 🧹:
Clean the build directory.
- **`rust-fmt="cargo fmt"`** 🔧📐:
Format the Rust code.
- **`rust-clippy="cargo clippy"`** 🔍:
Run Clippy to check the code for potential issues.
- **`rust-doc="cargo doc --open"`** 📚:
Generate and open Rust documentation.
- **`rust-new="cargo new"`** 🛠️📦:
Create a new Rust project.
- **`rust-init="cargo init"`** ⚙️:
Initialize a new Rust project in an existing directory.
- **`rust-add="cargo add"`** :
Add a dependency to the Rust project.
- **`rust-upd="rustup update"`** 🔄:
Update the Rust toolchain.
- **`rust-ver="rustc --version"`** 📅:
Display the version of `rustc`.
- **`rust-watch="cargo watch -x run"`** 👀:
Watch for changes in the Rust project and run automatically.
- **`rust-deps="cargo tree"`** 🗂️:
Show the dependency tree of the Rust project.
- **`rust-check="cargo check"`** ✅:
Check the code for errors without building it.
- **`rust-ls="ls -alh --color=auto"`** 📂:
List the project directory contents with detailed info.
These aliases will help streamline your workflow in a variety of languages and package managers!

View File

@@ -0,0 +1,135 @@
---
sidebar_position: 1
---
# Introduction to Terminal
## Launch Terminal
Heres a list of common shortcuts to launch the terminal in various desktop environments and window managers on Snigdha OS, along with relevant emojis:
### 🌐 **Desktop Environments & Window Managers**
1. **KDE Plasma**
- Shortcut: `Ctrl + Alt + T`
2. **GNOME**
- Shortcut: `Super (Windows key) + T`
3. **XFCE**
- Shortcut: `Ctrl + Alt + T`
4. **LXQt**
- Shortcut: `Ctrl + Alt + T`
5. **Cinnamon**
- Shortcut: `Ctrl + Alt + T`
6. **MATE**
- Shortcut: `Ctrl + Alt + T`
7. **i3wm** (Tiling Window Manager)
- Shortcut: `Mod + Enter` (where "Mod" is usually the `Super` key or `Alt`)
8. **Sway** (Wayland-based i3-like WM)
- Shortcut: `Mod + Enter`
9. **Openbox**
- Shortcut: `Super + Enter` (or configure manually)
10. **AwesomeWM**
- Shortcut: `Mod + Return`
11. **Fluxbox**
- Shortcut: `Super + Return`
12. **Budgie**
- Shortcut: `Super + T`
13. **LXDE**
- Shortcut: `Ctrl + Alt + T`
14. **Herbstluftwm**
- Shortcut: `Mod + Return`
## Shortcodes(Regular)
Heres the explanation of your aliases with relevant emojis:
### System and Package Management
- **`alias ls='ls -l --color=auto'`** 🖥️🌈:
List files in long format (`-l`) and colorize the output for better readability (`--color=auto`).
- **`alias grep='grep --color=auto'`** 🔍🌈:
Highlight matching text in color when using `grep` for easier identification of search results.
- **`alias rs="sudo pacman -Rs"`** 🚫📦:
Remove a package and its dependencies (`pacman -Rs`) with `sudo`.
- **`alias s="sudo pacman -S"`** 📦✨:
Install a package with `pacman` using the shortcut `s`, which runs `sudo pacman -S`.
- **`alias sy="sudo pacman -Syy"`** 🔄📦:
Force sync the package databases (`-Syy`) to fetch the latest information from mirrors.
- **`alias syyu="sudo pacman -Syyu"`** ⬆️📦💻:
Perform a system update by forcing a database refresh (`-Syy`) and upgrading all packages (`-u`).
- **`alias lck="sudo rm /var/lib/pacman/db.lck"`** 🔒🗑️:
Remove the lock file (`db.lck`) that may block `pacman` from functioning properly.
- **`alias vm="sudo systemctl enable --now vmtoolsd.service"`** 🖥️⚙️:
Enable and start the VMware Tools service (`vmtoolsd.service`) in a virtual machine.
- **`alias rip="expac --timefmt='%Y-%m-%d %T' '%l\t%n %v' | sort | tail -200 | nl"`** 🕒📋:
List the most recent 200 installed packages, sorted by date, with numbered entries.
- **`alias ys="yay -S"`** 🚀📦:
Install packages from the AUR using `yay` with the `ys` shortcut.
- **`alias pas="paru -S"`** 🛠️📦:
Install packages from the AUR using `paru` with the `pas` shortcut.
- **`alias wget="wget -c"`** 🌐⬇️:
Resume interrupted downloads with the `-c` option for `wget`.
### Navigation
- **`alias ..="cd .."`** 🔼📁:
Move up one directory level using the shortcut `..` instead of typing `cd ..`.
- **`alias home="cd ~"`** 🏠💻:
Quickly go to your home directory with the `home` alias.
- **`alias docs="cd ~/Documents"`** 📂📝:
Navigate to your `Documents` folder with the `docs` alias.
- **`alias dl="cd ~/Downloads"`** 📥🗂️:
Go to the `Downloads` folder using the `dl` alias.
- **`alias music="cd ~/Music"`** 🎵🎶:
Navigate to your `Music` folder with the `music` alias.
- **`alias pics="cd ~/Pictures"`** 🖼️📸:
Quickly jump to the `Pictures` folder using the `pics` alias.
- **`alias vids="cd ~/Videos"`** 🎬📹:
Go to the `Videos` folder with the `vids` alias.
- **`alias desk="cd ~/Desktop"`** 🖥️💻:
Jump to the `Desktop` folder using the `desk` alias.
These aliases with emojis make it easy to remember their functions and provide a fun, visual way to enhance your terminal experience!