mirror of
https://github.com/Snigdha-OS/snigdhaos-calamares-config.git
synced 2025-09-05 21:46:46 +02:00
📝 docs(_massive): upgrade v2.1 && detailed readme
This commit is contained in:
123
README.md
123
README.md
@@ -1 +1,122 @@
|
|||||||
# snigdhaos-calamares-config
|
|
||||||
|
# 🛠️ Snigdha OS Calamares Configuration
|
||||||
|
|
||||||
|
This repository contains the **Calamares Configuration** files tailored for **Snigdha OS**, enabling a seamless and user-friendly installation experience. Calamares is a powerful, adaptable, and customizable installer framework widely used in Linux distributions.
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<img src="https://github.com/user-attachments/assets/01e5b94f-354d-4e9c-a894-af222d0b24cf" alt="Snigdha OS Logo" width="300">
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<div align="center">
|
||||||
|
<img alt="MIT License" src="https://img.shields.io/badge/license-MIT-754ffe?style=for-the-badge&logo=book&logoColor=92fe9d">
|
||||||
|
<img alt="Calamares Version" src="https://img.shields.io/badge/calamares-3.x-754ffe?style=for-the-badge&logo=linux&logoColor=92fe9d">
|
||||||
|
</div>
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📜 Overview
|
||||||
|
|
||||||
|
This configuration is specifically optimized for the **Snigdha OS Arctic V** release, ensuring:
|
||||||
|
- **Simplified Installation Process** with an intuitive UI.
|
||||||
|
- **Support for Custom Partitioning** to suit diverse user needs.
|
||||||
|
- **Preloaded Setup Scripts** for environment initialization and optimization.
|
||||||
|
- **Snigdha OS Branding** for a cohesive and professional look.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📁 Repository Structure
|
||||||
|
|
||||||
|
```plaintext
|
||||||
|
.
|
||||||
|
├── branding/
|
||||||
|
│ ├── logo.png # Snigdha OS branding assets
|
||||||
|
│ ├── stylesheet.qss # Custom styles for the installer UI
|
||||||
|
│ └── translations/ # Language translations for installer
|
||||||
|
├── modules/
|
||||||
|
│ ├── partition.conf # Partitioning configuration
|
||||||
|
│ ├── locale.conf # Localization and language settings
|
||||||
|
│ ├── users.conf # User setup configurations
|
||||||
|
│ └── shellprocess/ # Custom post-install scripts
|
||||||
|
├── settings.conf # Main configuration file for Calamares
|
||||||
|
└── README.md # Documentation
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚙️ Features
|
||||||
|
|
||||||
|
- **🖼️ Custom Branding**: The installer features Snigdha OS logos, colors, and themes for a unified experience.
|
||||||
|
- **🌍 Localization Support**: Multilingual installer with pre-configured translations.
|
||||||
|
- **📦 Package Installation**: Automated installation of essential packages.
|
||||||
|
- **🔒 Secure Defaults**: Implements secure partitioning and configuration options by default.
|
||||||
|
- **🛠️ Post-Install Scripts**: Runs post-installation scripts to finalize the setup, applying system optimizations and branding.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🛠️ How to Use
|
||||||
|
|
||||||
|
### Prerequisites:
|
||||||
|
- Ensure **Calamares** is installed on the target system.
|
||||||
|
- Clone this repository:
|
||||||
|
```bash
|
||||||
|
git clone https://github.com/Snigdha-OS/snigdhaos-calamares-config.git
|
||||||
|
```
|
||||||
|
- Install dependencies for Calamares:
|
||||||
|
```bash
|
||||||
|
sudo pacman -S calamares qt5-base
|
||||||
|
```
|
||||||
|
|
||||||
|
### Steps:
|
||||||
|
1. **Configure Calamares:**
|
||||||
|
Copy the contents of this repository to your Calamares configuration directory:
|
||||||
|
```bash
|
||||||
|
sudo cp -r snigdhaos-calamares-config/* /etc/calamares/
|
||||||
|
```
|
||||||
|
2. **Edit Settings:**
|
||||||
|
Modify the `settings.conf` file to reflect your installation preferences if needed.
|
||||||
|
3. **Run Calamares Installer:**
|
||||||
|
Launch Calamares with the custom configuration:
|
||||||
|
```bash
|
||||||
|
sudo calamares
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📦 Development
|
||||||
|
|
||||||
|
### Customizing Branding:
|
||||||
|
- Update the **branding/logo.png** and **stylesheet.qss** files to adjust the UI.
|
||||||
|
- Add additional translations under the `branding/translations/` folder.
|
||||||
|
|
||||||
|
### Adding Modules:
|
||||||
|
- New modules can be added to the `modules/` directory. Refer to the [Calamares Documentation](https://calamares.io/docs/modules/) for more details.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🛡️ License
|
||||||
|
|
||||||
|
This project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for more details.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 👨💻 Contributors
|
||||||
|
|
||||||
|
| Contributor | Role | Contact |
|
||||||
|
|-------------------|---------------------------|----------------------------------------------------------------------------------------------|
|
||||||
|
| **@eshanized** | Lead Developer | [GitHub](https://github.com/eshanized) |
|
||||||
|
| **@alokified** | Web Infrastructure | [GitHub](https://github.com/alokified) |
|
||||||
|
| **@utkrshift** | UI/UX Designer | [GitHub](https://github.com/utkrshift) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🌟 Acknowledgments
|
||||||
|
|
||||||
|
Special thanks to the **Snigdha OS Team** and our sponsors **Tonmoy Infrastructure** and **IXH International Co.** for their support in creating a modern and efficient Linux experience.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔗 Useful Links
|
||||||
|
|
||||||
|
- [Snigdha OS Official Website](https://snigdhaos.org)
|
||||||
|
- [Calamares Documentation](https://calamares.io/docs/)
|
||||||
|
- [Snigdha OS Arctic Repository](https://github.com/Snigdha-OS/snigdhaos-arctic)
|
||||||
|
98
push.sh
98
push.sh
@@ -1,32 +1,86 @@
|
|||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
|
||||||
# Author : Eshan Roy
|
# Author : ESHAN ROY
|
||||||
# URI : https://eshanized.github.io
|
# Author URI : https://eshanized.github.io
|
||||||
|
|
||||||
# NOTE: If you are on Snigdha OS,
|
# Define the conventional commit types with new emojis
|
||||||
# you can install commitizen-go with `sudo pacman -S commitizen-go`
|
TYPES=("🚀 feat" "🐛 fix" "📝 docs" "✨ style" "🛠 refactor" "⚡️ perf" "🔬 test" "🔧 build" "🤖 ci" "🧹 chore" "⏪ revert")
|
||||||
# or `s commitizen-go`. Else you need to install `yay` or `yay-bin`
|
|
||||||
# to install commitizen. I have written this script only for *Arch Linux.
|
|
||||||
|
|
||||||
# Function to check if Commitizen is installed
|
# Function to display an error and exit and
|
||||||
check_commitizen() {
|
error_exit() {
|
||||||
if ! pacman -Qq commitizen-go &> /dev/null; then
|
echo -e "\033[1;31m[ERROR]\033[0m $1"
|
||||||
echo "Commitizen is not installed. Please install it using 'yay -S commitizen-go'." >&2
|
|
||||||
exit 1
|
exit 1
|
||||||
|
}
|
||||||
|
|
||||||
|
# Ensure the script is run in a Git repository
|
||||||
|
git rev-parse --is-inside-work-tree > /dev/null 2>&1 || error_exit "This is not a Git repository."
|
||||||
|
|
||||||
|
# Get the current branch name
|
||||||
|
branch=$(git rev-parse --abbrev-ref HEAD)
|
||||||
|
|
||||||
|
# Pull the latest changes from the remote repository
|
||||||
|
echo "Pulling latest changes from remote branch '$branch'..."
|
||||||
|
git pull origin "$branch" || error_exit "Failed to pull changes from the remote repository. Please resolve any conflicts manually."
|
||||||
|
|
||||||
|
# Prompt the user to select a commit type
|
||||||
|
echo "Select a commit type:"
|
||||||
|
select type in "${TYPES[@]}"; do
|
||||||
|
if [[ -n "$type" ]]; then
|
||||||
|
break
|
||||||
|
else
|
||||||
|
echo "Invalid selection. Please try again."
|
||||||
fi
|
fi
|
||||||
}
|
done
|
||||||
|
|
||||||
# Function to stage, commit, and push changes
|
# Extract the commit type and emoji from the selection
|
||||||
push_to_github() {
|
type_emoji=${type}
|
||||||
|
type=${type_emoji#* }
|
||||||
|
emoji=${type_emoji% *}
|
||||||
|
|
||||||
|
# Prompt the user to enter a scope (optional)
|
||||||
|
read -p "Enter a scope (optional): " scope
|
||||||
|
scope_part=""
|
||||||
|
if [ -n "$scope" ]; then
|
||||||
|
scope_part="($scope)"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Prompt the user to enter a short description
|
||||||
|
read -p "Enter a short description: " desc
|
||||||
|
if [ -z "$desc" ]; then
|
||||||
|
error_exit "A short description is required!"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Prompt the user to enter a longer description (optional)
|
||||||
|
read -p "Enter a longer description (optional): " long_desc
|
||||||
|
|
||||||
|
# Create the commit message
|
||||||
|
commit_msg="$emoji $type$scope_part: $desc"
|
||||||
|
|
||||||
|
# If a longer description was provided, add it to the commit message
|
||||||
|
if [ -n "$long_desc" ]; then
|
||||||
|
commit_msg+="
|
||||||
|
|
||||||
|
$long_desc"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Print the commit message to the console
|
||||||
|
echo -e "\nCommit message:"
|
||||||
|
echo -e "\033[1;36m$commit_msg\033[0m"
|
||||||
|
|
||||||
|
# Stage all changes
|
||||||
git add .
|
git add .
|
||||||
git cz
|
|
||||||
git push origin master
|
|
||||||
}
|
|
||||||
|
|
||||||
# Main Function
|
# Commit the changes with the conventional commit message
|
||||||
main() {
|
if git commit -m "$commit_msg"; then
|
||||||
check_commitizen
|
echo -e "\033[1;32mCommit successful!\033[0m"
|
||||||
push_to_github
|
else
|
||||||
}
|
error_exit "Commit failed."
|
||||||
|
fi
|
||||||
|
|
||||||
main
|
# Push the changes to the remote repository
|
||||||
|
echo "Pushing changes to remote branch '$branch'..."
|
||||||
|
if git push origin "$branch"; then
|
||||||
|
echo -e "\033[1;32mChanges pushed to remote branch '$branch'.\033[0m"
|
||||||
|
else
|
||||||
|
error_exit "Push failed. Please check your connection or branch permissions."
|
||||||
|
fi
|
Reference in New Issue
Block a user