📝 docs(_new): update pages

This commit is contained in:
Eshan Roy
2024-12-05 13:57:08 +05:30
parent c32f0f2c1f
commit ba03dc78f5
10 changed files with 473 additions and 16 deletions

View File

@@ -1,7 +1,7 @@
{ {
"id": "post_installation/customization", "id": "post_installation/customization",
"title": "Customize Snigdha OS", "title": "Customize Snigdha OS",
"description": "", "description": "🖌️ Guide to Customizing Snigdha OS",
"source": "@site/docs/post_installation/customization.md", "source": "@site/docs/post_installation/customization.md",
"sourceDirName": "post_installation", "sourceDirName": "post_installation",
"slug": "/post_installation/customization", "slug": "/post_installation/customization",

View File

@@ -1,7 +1,7 @@
{ {
"id": "post_installation/install_packages", "id": "post_installation/install_packages",
"title": "Install Packages", "title": "Install Packages",
"description": "", "description": "📦 How to Install a Package on Snigdha OS",
"source": "@site/docs/post_installation/install_packages.md", "source": "@site/docs/post_installation/install_packages.md",
"sourceDirName": "post_installation", "sourceDirName": "post_installation",
"slug": "/post_installation/install_packages", "slug": "/post_installation/install_packages",

View File

@@ -1,7 +1,7 @@
{ {
"id": "post_installation/language", "id": "post_installation/language",
"title": "Language", "title": "Language",
"description": "", "description": "🌐 Installing Language Packs and Google Fonts on Arch/Snigdha OS",
"source": "@site/docs/post_installation/language.md", "source": "@site/docs/post_installation/language.md",
"sourceDirName": "post_installation", "sourceDirName": "post_installation",
"slug": "/post_installation/language", "slug": "/post_installation/language",

View File

@@ -1,7 +1,7 @@
{ {
"id": "post_installation/update", "id": "post_installation/update",
"title": "Update Snigdha OS", "title": "Update Snigdha OS",
"description": "", "description": "🔄 How to Update Snigdha OS",
"source": "@site/docs/post_installation/update.md", "source": "@site/docs/post_installation/update.md",
"sourceDirName": "post_installation", "sourceDirName": "post_installation",
"slug": "/post_installation/update", "slug": "/post_installation/update",

View File

@@ -531,25 +531,25 @@
"post_installation/customization": { "post_installation/customization": {
"id": "post_installation/customization", "id": "post_installation/customization",
"title": "Customize Snigdha OS", "title": "Customize Snigdha OS",
"description": "", "description": "🖌️ Guide to Customizing Snigdha OS",
"sidebar": "tutorialSidebar" "sidebar": "tutorialSidebar"
}, },
"post_installation/install_packages": { "post_installation/install_packages": {
"id": "post_installation/install_packages", "id": "post_installation/install_packages",
"title": "Install Packages", "title": "Install Packages",
"description": "", "description": "📦 How to Install a Package on Snigdha OS",
"sidebar": "tutorialSidebar" "sidebar": "tutorialSidebar"
}, },
"post_installation/language": { "post_installation/language": {
"id": "post_installation/language", "id": "post_installation/language",
"title": "Language", "title": "Language",
"description": "", "description": "🌐 Installing Language Packs and Google Fonts on Arch/Snigdha OS",
"sidebar": "tutorialSidebar" "sidebar": "tutorialSidebar"
}, },
"post_installation/update": { "post_installation/update": {
"id": "post_installation/update", "id": "post_installation/update",
"title": "Update Snigdha OS", "title": "Update Snigdha OS",
"description": "", "description": "🔄 How to Update Snigdha OS",
"sidebar": "tutorialSidebar" "sidebar": "tutorialSidebar"
}, },
"tools/aircrack-ng": { "tools/aircrack-ng": {

View File

@@ -752,7 +752,7 @@
{ {
"id": "post_installation/customization", "id": "post_installation/customization",
"title": "Customize Snigdha OS", "title": "Customize Snigdha OS",
"description": "", "description": "🖌️ Guide to Customizing Snigdha OS",
"source": "@site/docs/post_installation/customization.md", "source": "@site/docs/post_installation/customization.md",
"sourceDirName": "post_installation", "sourceDirName": "post_installation",
"slug": "/post_installation/customization", "slug": "/post_installation/customization",
@@ -779,7 +779,7 @@
{ {
"id": "post_installation/install_packages", "id": "post_installation/install_packages",
"title": "Install Packages", "title": "Install Packages",
"description": "", "description": "📦 How to Install a Package on Snigdha OS",
"source": "@site/docs/post_installation/install_packages.md", "source": "@site/docs/post_installation/install_packages.md",
"sourceDirName": "post_installation", "sourceDirName": "post_installation",
"slug": "/post_installation/install_packages", "slug": "/post_installation/install_packages",
@@ -806,7 +806,7 @@
{ {
"id": "post_installation/language", "id": "post_installation/language",
"title": "Language", "title": "Language",
"description": "", "description": "🌐 Installing Language Packs and Google Fonts on Arch/Snigdha OS",
"source": "@site/docs/post_installation/language.md", "source": "@site/docs/post_installation/language.md",
"sourceDirName": "post_installation", "sourceDirName": "post_installation",
"slug": "/post_installation/language", "slug": "/post_installation/language",
@@ -833,7 +833,7 @@
{ {
"id": "post_installation/update", "id": "post_installation/update",
"title": "Update Snigdha OS", "title": "Update Snigdha OS",
"description": "", "description": "🔄 How to Update Snigdha OS",
"source": "@site/docs/post_installation/update.md", "source": "@site/docs/post_installation/update.md",
"sourceDirName": "post_installation", "sourceDirName": "post_installation",
"slug": "/post_installation/update", "slug": "/post_installation/update",

View File

@@ -2,3 +2,173 @@
sidebar_position: 3 sidebar_position: 3
--- ---
# Customize Snigdha OS # Customize Snigdha OS
### 🖌️ **Guide to Customizing Snigdha OS**
Snigdha OS, with its polished look and powerful tools, is highly customizable. Whether you want to tweak the desktop environment, improve system performance, or add your personal touch, this guide will walk you through the steps to make Snigdha OS your own.
---
### ⚙️ **Step 1: Select Your Desktop Environment (DE)**
Snigdha OS comes with several desktop environments, such as KDE Plasma, GNOME, XFCE, i3, and more. Customization options depend on your DE.
- **KDE Plasma**: Highly customizable with themes, widgets, and layouts.
- **GNOME**: Simplistic and clean with extensions.
- **XFCE**: Lightweight and minimalistic with theming options.
#### To install additional DEs:
```bash
sudo pacman -S xfce4 gnome
```
---
### 🎨 **Step 2: Change Themes**
Snigdha OS includes **Snigdha OS Settings Manager** for managing themes, icons, and cursors.
#### Using Snigdha OS Settings Manager:
1. Open **Snigdha OS Settings Manager** from the application menu.
2. Navigate to the **Appearance** or **Desktop Theme** section.
3. Select and apply a **theme**, **icon pack**, or **cursor**.
#### For KDE Plasma:
1. Go to **System Settings → Appearance**.
2. Customize:
- **Global Theme**: Change the entire desktop look.
- **Plasma Style**: Adjust panel and widget styles.
- **Icons**: Pick a new icon set.
- **Application Style**: Change the window and button styles.
#### Installing New Themes:
1. Open **System Settings → Appearance → Get New Themes**.
2. Browse and install themes, icons, or cursors.
3. Apply them from the same menu.
---
### 📂 **Step 3: Customize Widgets and Panels**
Widgets and panels enhance functionality and aesthetics.
#### For KDE Plasma:
- Right-click on the desktop or panel and select **Add Widgets**.
- Drag and drop widgets to the desired location.
- Adjust panel size, position, and contents by right-clicking the panel and selecting **Edit Panel**.
---
### 🖼️ **Step 4: Change Wallpapers**
Snigdha OS comes with stunning default wallpapers, but you can easily add your own.
#### Steps:
1. Right-click on the desktop and select **Configure Desktop** (KDE) or **Change Background** (GNOME).
2. Select a wallpaper from the list or **Add Image** to upload your own.
#### Online Wallpapers:
Install dynamic wallpaper applications like **Komorebi** or use online wallpaper tools.
---
### 🖥️ **Step 5: Modify the GRUB Bootloader**
Customize the GRUB bootloader for a personal touch.
#### Install a GRUB Theme:
1. Install `grub-customizer`:
```bash
sudo pacman -S grub-customizer
```
2. Open GRUB Customizer and select a theme.
3. Save and reboot to see the changes.
---
### 💡 **Step 6: Add Extensions and Plugins**
Extensions add extra functionality to your desktop environment.
#### For GNOME:
1. Install `gnome-shell-extensions`:
```bash
sudo pacman -S gnome-shell-extensions
```
2. Use the **GNOME Extensions** website ([extensions.gnome.org](https://extensions.gnome.org)) to enable and manage extensions.
#### For KDE:
Use the **KDE Store** to download and manage plugins, scripts, and widgets.
---
### 🔧 **Step 7: Adjust Performance Settings**
Snigdha OS includes tools for optimizing performance.
#### Using Snigdha OS Assistant:
1. Open **Snigdha OS Assistant**.
2. Enable performance tweaks like **ZRAM**, **CPU governor**, or **RAM optimization**.
3. Use **System Cleaner** to remove unnecessary files.
#### Manage Startup Applications:
Disable unnecessary startup applications to improve boot time:
1. Open **Startup and Shutdown** in **System Settings**.
2. Uncheck apps you dont need at startup.
---
### 🔍 **Step 8: Install Useful Applications**
Snigdha OS includes essential applications, but you can add more tools to suit your workflow.
#### Example Commands:
- **Install a Web Browser**:
```bash
sudo pacman -S firefox
```
- **Install a Terminal Emulator**:
```bash
sudo pacman -S alacritty
```
- **Install AUR Packages** (e.g., Google Chrome):
```bash
yay -S google-chrome
```
---
### 🖥️ **Step 9: Configure Keybindings**
Set custom keyboard shortcuts for frequently used actions.
#### KDE Plasma:
1. Open **System Settings → Shortcuts**.
2. Customize global shortcuts for applications and system actions.
#### GNOME:
1. Open **Settings → Keyboard → Custom Shortcuts**.
2. Add and modify shortcuts for specific commands or actions.
---
### 🎵 **Step 10: Customize Sounds**
You can change system sounds to add a unique auditory flair.
#### KDE Plasma:
1. Open **System Settings → Audio → Event Sounds**.
2. Choose and apply custom sound themes.
---
### 🛡️ **Step 11: Enable Gaming Tweaks**
Snigdha OS has a **Gaming Edition** optimized for gaming, but you can also add tweaks manually.
#### Install Gaming Tools:
1. Install **Lutris** for managing game libraries:
```bash
sudo pacman -S lutris
```
2. Install **Steam**:
```bash
sudo pacman -S steam
```
3. Enable **GameMode** for performance:
```bash
sudo pacman -S gamemode
```
---
### 🚀 **Conclusion**
Snigdha OS is one of the most customizable Linux distributions, offering endless possibilities to tailor your desktop. From themes to performance tweaks, you can make it your perfect operating system. Dive in, experiment, and enjoy your personalized Linux experience! 🎉

View File

@@ -2,3 +2,109 @@
sidebar_position: 4 sidebar_position: 4
--- ---
# Install Packages # Install Packages
### 📦 **How to Install a Package on Snigdha OS**
Installing packages on Snigdha OS primarily involves using the **Pacman** package manager or an **AUR helper** for community-contributed software. Here's a step-by-step guide:
---
### 🛠️ **Step 1: Update Your System**
Before installing a package, ensure your system is up-to-date to avoid dependency issues:
```bash
sudo pacman -Syu
```
---
### 📂 **Step 2: Search for a Package**
To find the package you want to install, use the following command:
```bash
pacman -Ss package-name
```
#### Example:
Search for the Firefox browser:
```bash
pacman -Ss firefox
```
This command displays available packages with "firefox" in their name or description.
---
### ✅ **Step 3: Install the Package**
Once you know the exact package name, install it using:
```bash
sudo pacman -S package-name
```
#### Example:
Install Firefox:
```bash
sudo pacman -S firefox
```
---
### 📦 **Step 4: Verify Installation**
To check if a package is installed:
```bash
pacman -Q package-name
```
#### Example:
Verify Firefox installation:
```bash
pacman -Q firefox
```
---
### 🔍 **Step 5: Explore Package Details**
View information about an installed package:
```bash
pacman -Qi package-name
```
#### Example:
```bash
pacman -Qi firefox
```
---
### 🌐 **Installing AUR Packages**
If the package you want is not in the official repositories but is available in the **Arch User Repository (AUR)**, use an AUR helper like `yay` or `paru`.
#### Install a Package from AUR
```bash
yay -S package-name
```
#### Example:
Install Google Chrome from AUR:
```bash
yay -S google-chrome
```
---
### 🧹 **Clean Up After Installation**
After installing a package, clean up unused dependencies (optional):
```bash
sudo pacman -Rns $(pacman -Qdtq)
```
---
### ⚠️ **Tips**
1. **Enable Parallel Downloads**: To speed up installation, enable parallel downloads in `/etc/pacman.conf` by adding:
```
ParallelDownloads = 5
```
2. **Use Trusted Sources**: Only install AUR packages from trusted sources and review the `PKGBUILD` file before installation.
---
### 🎉 **Conclusion**
Installing packages on Snigdha OS is straightforward with `pacman`. For additional software, AUR helpers like `yay` expand the possibilities. With these tools, you can access a vast array of software tailored to your needs! 🚀

View File

@@ -2,3 +2,82 @@
sidebar_position: 1 sidebar_position: 1
--- ---
# Language # Language
### 🌐 **Installing Language Packs and Google Fonts on Arch/Snigdha OS**
Heres how you can install language packs for better localization support and Google Fonts for enhanced typography.
---
### 🌏 **Step 1: Install Language Packs**
#### **Step 1.1: Install System Language Pack**
Language packs are provided by the desktop environment or specific applications. For example:
- **KDE Plasma**:
```bash
sudo pacman -S plasma-desktop kde-l10n
```
- **GNOME**:
```bash
sudo pacman -S gnome-shell gnome-getting-started-docs
```
#### **Step 1.2: Enable Your Preferred Language**
1. Open **System Settings** → **Regional Settings** or **Language**.
2. Select and add your desired language.
3. Apply the changes and reboot if necessary.
#### **Step 1.3: Install Additional Fonts for Localization**
To display text correctly in specific languages (e.g., CJK, Arabic):
```bash
sudo pacman -S noto-fonts noto-fonts-cjk noto-fonts-emoji noto-fonts-extra
```
---
### ✍️ **Step 2: Install Google Fonts**
Google Fonts can be installed to enhance the typography for web design, office applications, or general use.
#### **Option 1: Install via Pacman**
Arch Linux provides a package for Google Fonts:
```bash
sudo pacman -S ttf-google-fonts
```
#### **Option 2: Install via AUR**
For the latest collection of Google Fonts, use an AUR helper like `yay`:
```bash
yay -S ttf-google-fonts-git
```
#### **Option 3: Manual Installation**
1. Download the fonts:
- Visit the [Google Fonts](https://fonts.google.com/) website.
- Select and download your desired font(s).
2. Extract and install:
```bash
mkdir -p ~/.local/share/fonts
unzip /path/to/downloaded-fonts.zip -d ~/.local/share/fonts
```
3. Refresh the font cache:
```bash
fc-cache -fv
```
---
### 🧹 **Step 3: Verify Installation**
- **Check Available Fonts**:
```bash
fc-list | grep "font-name"
```
- Test the fonts in applications like LibreOffice, GIMP, or your web browser.
---
### 🎉 **Conclusion**
With language packs and Google Fonts installed, your system will be well-suited for multilingual usage and professional-grade typography. Enjoy customizing your experience! 🚀

View File

@@ -2,3 +2,105 @@
sidebar_position: 2 sidebar_position: 2
--- ---
# Update Snigdha OS # Update Snigdha OS
### 🔄 **How to Update Snigdha OS**
Snigdha OS, based on Arch Linux, uses a **rolling release model**, meaning you always have access to the latest updates. Keeping your system up-to-date ensures stability, security, and access to the latest features.
Follow these steps to safely and effectively update your Snigdha OS system:
---
### 🔧 **Step 1: Open the Terminal**
Press `Ctrl + Alt + T` to open the terminal or use the **Konsole** or any terminal emulator installed on your system.
---
### 🔄 **Step 2: Update the System**
Run the following commands to update your Snigdha OS system:
#### **Basic Update Command**
Use **Pacman** (the default package manager) to synchronize and upgrade packages:
```bash
sudo pacman -Syu
```
#### **Snigdha OS Assistant (Optional)**
Snigdha OS provides a GUI tool called **Snigdha OS Assistant** for system management, including updates.
- Open **Snigdha OS Assistant** from the application menu.
- Click on **Update System** and follow the prompts.
#### **With AUR Packages (Using an AUR Helper)**
If you use AUR packages, update them alongside system packages with a tool like `yay` or `paru`:
```bash
yay -Syu
```
---
### 🛠️ **Step 3: Rebuild Outdated Configurations**
After major updates, especially those involving the kernel or critical system components, rebuild configurations to avoid issues. Snigdha OS makes this easy with:
```bash
sudo pacman -S linux-headers
```
If you use the **ZRAM** feature or **custom kernels**, ensure they're updated and aligned with the current system kernel.
---
### 🧹 **Step 4: Clean Up Unused Packages**
Remove unused or orphaned packages to free up space:
```bash
sudo pacman -Rns $(pacman -Qdtq)
```
Clear the package cache to save disk space (Snigdha OS already does this automatically with **paccache**):
```bash
sudo paccache -r
```
---
### 🚀 **Step 5: Reboot Your System**
If a kernel or other core system components were updated, reboot your system to apply the changes:
```bash
reboot
```
---
### 🌟 **Tips for Safe Updates**
1. **Use Snigdha OS's Snapshot Feature**:
- Snigdha OS uses **Btrfs** snapshots via **Timeshift**. If something goes wrong during an update, you can roll back to a previous working state.
- Before updating, create a manual snapshot:
```bash
sudo timeshift --create
```
2. **Check for Arch News**:
Before major updates, check the **Arch Linux News** page for important announcements:
- [Arch Linux News](https://archlinux.org/news/)
3. **Run Updates Regularly**:
Snigdha OS is a rolling release, so it's important to update frequently to avoid large, time-consuming updates and potential conflicts.
---
### 💻 **Example Commands**
Heres a single command for a complete update, including AUR packages and cleaning up:
```bash
sudo pacman -Syu && yay -Syu && sudo pacman -Rns $(pacman -Qdtq)
```
---
### 🎉 **Conclusion**
Keeping Snigdha OS updated is straightforward and ensures you always have the latest features and security patches. With tools like **Snigdha OS Assistant**, **Pacman**, and **Timeshift**, managing updates is efficient and safe. 🚀