Linux Essentials Terminal Commands Tutorial 🐧

An interactive, bilingual tutorial application for learning essential Linux terminal commands in both English and Persian (فارسی).

🌟 Features

• 🌐 Bilingual Interface: Switch seamlessly between English and Persian languages
• 📚 Comprehensive Tutorials: Covers essential Linux commands with detailed explanations
• 🎯 Interactive Learning: Hands-on examples and practical use cases
• ⚡ Fast Development: Built with Vite for optimal performance
• 📱 Responsive Design: Works perfectly on all devices
• 🎯 Beginner-Friendly: Perfect for Linux newcomers
• 📖 Quick Reference: Handy command cheat sheet included

🚀 Live Demo

Visit the live application: Live Demo

📖 What You'll Learn

Essential Commands Covered:

• Navigation Commands: pwd, ls, cd, mkdir, rmdir
• File Operations: touch, cp, mv, rm, cat, nano
• System Information: whoami, uname, df, free, top
• Permission Management: chmod, chown, sudo
• Process Management: ps, kill, bg, fg
• Network Commands: ping, ifconfig, ssh, wget
• And many more!

🛠️ Installation & Setup

Prerequisites

• Node.js (version 16 or higher)
• npm or yarn

Step-by-Step Installation

1. Clone the repository

   git clone https://github.com/mehdikiani/linux-essentials.git
   cd linux-essentials

2. Install dependencies

   npm install
   # or
   yarn install

3. Run the development server

   npm run dev
   # or
   yarn dev

4. Open your browser Navigate to http://localhost:5173 (or the port shown in terminal)

Building for Production

npm run build
# or
yarn build

Preview Production Build

npm run preview
# or
yarn preview

🎮 How to Use

1. Select Your Language: Click the language switcher in the top right corner
2. Browse Categories: Explore commands by category (Navigation, Files, System, etc.)
3. Learn Commands: Click on any command to see detailed explanations
4. View Examples: Each command includes practical usage examples
5. Use Quick Reference: Access the handy command cheat sheet
6. Practice: Try commands in your own terminal as you learn

📁 Project Structure

linux-essentials/
├── src/
│   ├── components/
│   │   ├── CommandCard.tsx    # Individual command display component
│   │   ├── QuickRef.tsx       # Quick reference/cheat sheet component
│   │   └── Sidebar.tsx        # Navigation sidebar component
│   ├── App.tsx                # Main application component
│   ├── data.ts               # Command data (English & Persian)
│   ├── index.tsx             # Application entry point
│   ├── types.ts              # TypeScript type definitions
│   └── metadata.json         # Application metadata
├── public/                   # Static assets
├── index.html               # HTML template
├── vite.config.ts           # Vite configuration
├── tsconfig.json            # TypeScript configuration
├── package.json             # Dependencies and scripts
└── README.md                # This file

🧩 Technologies Used

• React 18: Frontend library
• TypeScript: Type-safe JavaScript
• Vite: Fast build tool and dev server
• CSS Modules: Component-scoped styling
• React Icons: Icon library

🌍 Contributing

We welcome contributions from the community! Here's how you can help:

Ways to Contribute:

1. Add New Commands: Expand our command database
2. Improve Translations: Help with Persian translations or add new languages
3. Fix Bugs: Report or fix issues
4. Enhance UI/UX: Improve the user interface
5. Write Documentation: Improve guides and tutorials

Contribution Process:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Mehdi Kiani

• 📧 Email: mkiani3000@gmail.com
• 🌐 Website: https://mkiani.ir
• 💼 GitHub: @mehdikiani

🤝 Support

If you find this project helpful, please consider:

⭐ Starring the repository - It helps others discover this resource and motivates continued development!

📢 Sharing with friends - Spread the word to help more people learn Linux

🐛 Reporting issues - Help improve the project by reporting bugs

💡 Suggesting features - Tell us what you'd like to see next

🙏 Acknowledgments

• Inspired by the Linux community and open-source ethos
• Thanks to all contributors who help improve this project
• Special thanks to everyone who stars and shares this repository

---

Happy Learning! 🎉 Start your Linux journey today with this interactive tutorial. Whether you're a complete beginner or looking to refresh your skills, this tool will help you master essential terminal commands in both English and Persian.

---

⭐ Don't forget to star this repository if you find it useful! ⭐

---

آموزش دستورات ترمینال لینوکس 🐧

یک برنامه آموزشی تعاملی و دو زبانه برای یادگیری دستورات ضروری ترمینال لینوکس به زبان‌های انگلیسی و فارسی.

🌟 ویژگی‌ها

• 🌐 رابط دو زبانه: تغییر آسان بین زبان‌های انگلیسی و فارسی
• 📚 آموزش جامع: پوشش دستورات ضروری لینوکس با توضیحات مفصل
• 🎯 یادگیری تعاملی: مثال‌های عملی و موارد کاربردی
• ⚡ توسعه سریع: ساخته شده با Vite برای عملکرد بهینه
• 📱 طراحی واکنش‌گرا: کارایی عالی در تمام دستگاه‌ها
• 🎯 مناسب برای تازه‌کاران: ایده‌آل برای تازه واردان به لینوکس
• 📖 مرجع سریع: شامل برگه تقلب دستورات

🚀 نسخه آنلاین

از نسخه زنده برنامه دیدن کنید: نسخه آنلاین

📖 چه چیزهایی یاد می‌گیرید

دستورات ضروری پوشش داده شده:

• دستورات ناوبری: pwd, ls, cd, mkdir, rmdir
• عملیات فایل: touch, cp, mv, rm, cat, nano
• اطلاعات سیستم: whoami, uname, df, free, top
• مدیریت دسترسی‌ها: chmod, chown, sudo
• مدیریت فرآیندها: ps, kill, bg, fg
• دستورات شبکه: ping, ifconfig, ssh, wget
• و بسیاری دیگر!

🛠️ نصب و راه‌اندازی

پیش‌نیازها

• Node.js (نسخه ۱۶ یا بالاتر)
• npm یا yarn

نصب گام به گام

1. کلون کردن مخزن

   git clone https://github.com/mehdikiani/linux-essentials.git
   cd linux-essentials

2. نصب وابستگی‌ها

   npm install
   # یا
   yarn install

3. راه‌اندازی سرور توسعه

   npm run dev
   # یا
   yarn dev

4. باز کردن مرورگر به آدرس http://localhost:5173 مراجعه کنید (یا پورتی که در ترمینال نمایش داده می‌شود)

ساخت نسخه تولید

npm run build
# یا
yarn build

پیش‌نمایش نسخه تولید

npm run preview
# یا
yarn preview

🎮 نحوه استفاده

1. انتخاب زبان: روی تغییردهنده زبان در گوشه بالا سمت راست کلیک کنید
2. مرور دسته‌بندی‌ها: دستورات را بر اساس دسته‌بندی (ناوبری، فایل‌ها، سیستم و غیره) بررسی کنید
3. یادگیری دستورات: روی هر دستور کلیک کنید تا توضیحات مفصل را ببینید
4. مشاهده مثال‌ها: هر دستور شامل مثال‌های کاربردی است
5. استفاده از مرجع سریع: به برگه تقلب دستورات دسترسی پیدا کنید
6. تمرین: دستورات را در ترمینال خود امتحان کنید

📁 ساختار پروژه

linux-essentials/
├── src/
│   ├── components/
│   │   ├── CommandCard.tsx    # کامپوننت نمایش تک دستور
│   │   ├── QuickRef.tsx       # کامپوننت مرجع سریع
│   │   └── Sidebar.tsx        # کامپوننت نوار کناری ناوبری
│   ├── App.tsx                # کامپوننت اصلی برنامه
│   ├── data.ts               # داده‌های دستورات (انگلیسی و فارسی)
│   ├── index.tsx             # نقطه ورود برنامه
│   ├── types.ts              # تعاریف TypeScript
│   └── metadata.json         # ابرداده‌های برنامه
├── public/                   # فایل‌های استاتیک
├── index.html               # قالب HTML
├── vite.config.ts           # پیکربندی Vite
├── tsconfig.json            # پیکربندی TypeScript
├── package.json             # وابستگی‌ها و اسکریپت‌ها
└── README.md                # این فایل

🧩 تکنولوژی‌های استفاده شده

• React 18: کتابخانه فرانت‌اند
• TypeScript: جاوااسکریپت نوع‌ایمن
• Vite: ابزار ساخت سریع و سرور توسعه
• CSS Modules: استایل‌دهی محدود به کامپوننت
• React Icons: کتابخانه آیکون

🌍 مشارکت

ما از مشارکت جامعه استقبال می‌کنیم! در اینجا نحوه کمک شما آورده شده است:

راه‌های مشارکت:

1. افزودن دستورات جدید: پایگاه داده دستورات را گسترش دهید
2. بهبود ترجمه‌ها: به ترجمه فارسی کمک کنید یا زبان‌های جدید اضافه کنید
3. رفع اشکالات: گزارش یا رفع مشکلات
4. بهبود UI/UX: رابط کاربری را بهبود دهید
5. نوشتن مستندات: راهنماها و آموزش‌ها را بهبود دهید

فرآیند مشارکت:

1. فورک کردن مخزن
2. ایجاد یک شاخه ویژگی (git checkout -b feature/ویژگی‌عالی)
3. کامیت تغییرات (git commit -m 'افزودن ویژگی عالی')
4. فشار دادن به شاخه (git push origin feature/ویژگی‌عالی)
5. باز کردن یک Pull Request

📄 مجوز

این پروژه تحت مجوز MIT منتشر شده است - برای جزئیات به فایل LICENSE مراجعه کنید.

👨‍💻 نویسنده

مهدی کیانی

• 📧 ایمیل: mkiani3000@gmail.com
• 🌐 وبسایت: https://mkiani.ir
• 💼 گیت‌هاب: @mehdikiani

🤝 حمایت

اگر این پروژه برای شما مفید بود، لطفاً در نظر بگیرید:

⭐ ستاره دادن به مخزن - به دیگران کمک می‌کند این منبع را کشف کنند و انگیزه توسعه ادامه‌دار را ایجاد می‌کند!

📢 اشتراک‌گذاری با دوستان - کلمه را پخش کنید تا به افراد بیشتری در یادگیری لینوکس کمک کنید

🐛 گزارش مشکلات - با گزارش اشکالات به بهبود پروژه کمک کنید

💡 پیشنهاد ویژگی‌ها - به ما بگویید دوست دارید چه چیزی را بعداً ببینید

🙏 قدردانی

• الهام گرفته از جامعه لینوکس و اخلاق متن‌باز
• تشکر از همه مشارکت‌کنندگانی که به بهبود این پروژه کمک می‌کنند
• تشکر ویژه از همه کسانی که به این مخزن ستاره می‌دهند و آن را به اشتراک می‌گذارند

---

یادگیری مبارک! 🎉 امروز سفر لینوکس خود را با این آموزش تعاملی آغاز کنید. چه یک تازه‌کار کامل باشید یا بخواهید مهارت‌های خود را تازه کنید، این ابزار به شما کمک می‌کد دستورات ضروری ترمینال را به هر دو زبان انگلیسی و فارسی تسلط پیدا کنید.

---

⭐ اگر این مخزن را مفید می‌دانید، فراموش نکنید که به آن ستاره بدهید! ⭐