From c32f0f2c1f09aec4188f9bb6c46c5c97736a04d1 Mon Sep 17 00:00:00 2001 From: Eshan Roy Date: Thu, 5 Dec 2024 13:46:52 +0530 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20docs(=5Fnew):=20update=20documen?= =?UTF-8?q?tation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../site-docs-user-guide-aur-md-d68.json | 2 +- .../version-current-metadata-prop-751.json | 2 +- .../docusaurus-debug-all-content-673.json | 2 +- docs/user_guide/aur.md | 113 +++++++++++++++++- 4 files changed, 115 insertions(+), 4 deletions(-) diff --git a/.docusaurus/docusaurus-plugin-content-docs/default/site-docs-user-guide-aur-md-d68.json b/.docusaurus/docusaurus-plugin-content-docs/default/site-docs-user-guide-aur-md-d68.json index d1279b2d..c512eab4 100644 --- a/.docusaurus/docusaurus-plugin-content-docs/default/site-docs-user-guide-aur-md-d68.json +++ b/.docusaurus/docusaurus-plugin-content-docs/default/site-docs-user-guide-aur-md-d68.json @@ -1,7 +1,7 @@ { "id": "user_guide/aur", "title": "Installing with AUR", - "description": "", + "description": "🌟 Installing Packages with an AUR Helper on Snigdha OS", "source": "@site/docs/user_guide/aur.md", "sourceDirName": "user_guide", "slug": "/user_guide/aur", diff --git a/.docusaurus/docusaurus-plugin-content-docs/default/version-current-metadata-prop-751.json b/.docusaurus/docusaurus-plugin-content-docs/default/version-current-metadata-prop-751.json index be71e94f..f3c93e95 100644 --- a/.docusaurus/docusaurus-plugin-content-docs/default/version-current-metadata-prop-751.json +++ b/.docusaurus/docusaurus-plugin-content-docs/default/version-current-metadata-prop-751.json @@ -591,7 +591,7 @@ "user_guide/aur": { "id": "user_guide/aur", "title": "Installing with AUR", - "description": "", + "description": "🌟 Installing Packages with an AUR Helper on Snigdha OS", "sidebar": "tutorialSidebar" }, "user_guide/cheetsheet": { diff --git a/.docusaurus/docusaurus-plugin-debug/default/docusaurus-debug-all-content-673.json b/.docusaurus/docusaurus-plugin-debug/default/docusaurus-debug-all-content-673.json index fe171ecf..f82daf7b 100644 --- a/.docusaurus/docusaurus-plugin-debug/default/docusaurus-debug-all-content-673.json +++ b/.docusaurus/docusaurus-plugin-debug/default/docusaurus-debug-all-content-673.json @@ -1018,7 +1018,7 @@ { "id": "user_guide/aur", "title": "Installing with AUR", - "description": "", + "description": "🌟 Installing Packages with an AUR Helper on Snigdha OS", "source": "@site/docs/user_guide/aur.md", "sourceDirName": "user_guide", "slug": "/user_guide/aur", diff --git a/docs/user_guide/aur.md b/docs/user_guide/aur.md index 2da358fe..64768080 100644 --- a/docs/user_guide/aur.md +++ b/docs/user_guide/aur.md @@ -1,4 +1,115 @@ --- sidebar_position: 2 --- -# Installing with AUR \ No newline at end of file +# 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. + - 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. + - 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. | +| `yay -Ss package-name` | Search for a package in AUR. | +| `paru -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). | +| `yay -R package-name` | Remove a package. | +| `paru -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` or `paru` streamlines the process of installing and managing AUR packages, making Snigdha OS even more powerful and user-friendly. Happy exploring! 😄 \ No newline at end of file