MarCode

An interactive desktop app for learning Python, with lessons, a built-in code editor and challenges.

English · کوردی · فارسی

---

English

MarCode is a desktop application for learning Python from scratch. Each lesson comes with a short explanation, a code example you can edit, and a challenge. You write code, run it inside the app, and check your solution to earn points, so there is nothing else to set up.

Purpose

MarCode was built with a simple goal: to make learning Python approachable and practical. It is meant for two kinds of people: teachers and mentors who want a ready-made tool for teaching Python, and self-learners who want to study at their own pace.

Customizing the lessons

All lesson content lives in a single file, shared.py. Titles, explanations, example code, challenges, hints and translations are all defined there, so you can edit existing lessons or add your own without touching the application code in start.py. That makes MarCode easy to adapt to your own course, classroom or teaching style. Each lesson needs a unique id and its text in all three languages.

Features

• Built-in code editor with syntax highlighting
• Run your code and see the output right inside the app
• One challenge per lesson, checked automatically, with a score that adds up as you go
• Your progress and language choice are saved between sessions
• Interface available in English, Persian and Kurdish (Sorani)
• Dark interface built with CustomTkinter

Lessons

29 lessons in 7 sections:

1. Getting Started
2. Variables and Data
3. Conditions
4. Loops
5. Data Structures
6. Functions
7. Modules

Requirements

• Windows
• Python 3.8 or newer
• customtkinter

Installation

git clone https://github.com/RamyarHasanpour/marcode.git
cd marcode
pip install customtkinter
python start.py

On the first launch, the app creates a folder named MarcodeProject on one of your drives and stores your progress there.

Project structure

• start.py - the app window, the code editor and challenge checking
• shared.py - lesson content, translations and interface settings

---

کوردی

مارکۆد (MarCode) بەرنامەیەکی دێسکتۆپە بۆ فێربوونی پایتۆن لە سفرەوە. هەر وانەیەک شرۆڤەیەکی کورت، نموونەیەکی کۆد کە دەتوانیت دەستکاری بکەیت، و ئاڵنگارییەکی تێدایە. کۆدەکە دەنووسیت، لەناو بەرنامەکە جێبەجێی دەکەیت و بە چارەسەرکردنی ئاڵنگارییەکە خاڵ وەردەگریت؛ پێویستت بە هیچ بەرنامەیەکی تر نییە.

ئامانج

مارکۆد بە ئامانجێکی سادە دروستکراوە: ئاسان و کارامەکردنی فێربوونی پایتۆن. بۆ دوو جۆر کەس گونجاوە: مامۆستا و ڕێنمایکارەکان کە ئامرازێکی ئامادەیان پێویستە بۆ فێرکردنی پایتۆن، و ئەوانەی دەیانەوێت بە خۆیان و بە خێرایی خۆیان پایتۆن فێر ببن.

گۆڕینی وانەکان

هەموو ناوەڕۆکی وانەکان لە یەک فایلدایە: shared.py. ناونیشان، شرۆڤە، نموونەی کۆد، ئاڵنگاری، ڕێنمایی و وەرگێڕانەکان هەموویان لەوێ دیاریکراون، بۆیە دەتوانیت وانەکان دەستکاری بکەیت یان وانەی نوێ زیاد بکەیت بەبێ ئەوەی دەست بە کۆدی بەرنامەکە لە start.py بدەیت. ئەمە وا دەکات مارکۆد بە ئاسانی لەگەڵ کۆرس، پۆل یان شێوازی وانەوتنەوەی خۆتدا بگونجێت. هەر وانەیەک پێویستی بە idی تایبەت و دەقی هەر سێ زمانەکە هەیە.

تایبەتمەندییەکان

• ئیدیتۆری کۆدی ناوخۆیی لەگەڵ ڕەنگکردنی وشە سەرەکییەکانی پایتۆن
• جێبەجێکردنی کۆد و پیشاندانی دەرەنجام لەناو خودی بەرنامەکە
• ئاڵنگارییەک بۆ هەر وانەیەک کە بە شێوەی خۆکار دەپشکنرێت و خاڵەکانت زیاد دەکات
• هەڵگرتنی پێشکەوتن و زمانی هەڵبژێردراو لە نێوان جارەکانی کارپێکردندا
• ڕووکاری بەرنامەکە بە سێ زمان: ئینگلیزی، فارسی و کوردی
• ڕووکارێکی تاریک کە بە CustomTkinter دروستکراوە

وانەکان

٢٩ وانە لە ٧ بەشدا:

1. دەستپێکردن
2. گۆڕاوەکان و دراوەکان
3. پێکهاتە مەرجدارەکان
4. بازنەکانی دووبارەبوونەوە
5. پێکهاتەکانی دراوە
6. فانکشنەکان
7. مۆدیوڵەکان

پێداویستییەکان

• ویندۆز
• پایتۆنی ٣.٨ یان نوێتر
• کتێبخانەی customtkinter

دابەزاندن و کارپێکردن

git clone https://github.com/RamyarHasanpour/marcode.git
cd marcode
pip install customtkinter
python start.py

لە یەکەم جار کارپێکردندا، بەرنامەکە فۆڵدەرێک بە ناوی MarcodeProject لەسەر یەکێک لە درایڤەکانت دروست دەکات و پێشکەوتنەکانت لەوێ هەڵدەگرێت.

---

فارسی

مارکد (MarCode) یک برنامه دسکتاپ برای یادگیری پایتون از صفر است. هر درس شامل یک توضیح کوتاه، یک کد نمونه قابل ویرایش و یک چالش است. کد را می‌نویسید، همان‌جا اجرا می‌کنید و با حل چالش امتیاز می‌گیرید؛ نیازی به نصب هیچ محیط توسعه دیگری نیست.

هدف پروژه

مارکد با یک هدف ساده ساخته شده است: آسان و کاربردی کردن یادگیری پایتون. این برنامه برای دو گروه مناسب است: مدرس‌ها و مربی‌هایی که به ابزاری آماده برای آموزش پایتون نیاز دارند، و کسانی که می‌خواهند خودشان و با سرعت خودشان پایتون یاد بگیرند.

شخصی‌سازی درس‌ها

تمام محتوای درس‌ها در یک فایل قرار دارد: shared.py. عنوان، توضیح، کد نمونه، چالش، راهنمایی و ترجمه‌ها همه همان‌جا تعریف شده‌اند؛ بنابراین می‌توانید بدون دست زدن به کد اصلی برنامه در start.py، درس‌های موجود را ویرایش کنید یا درس جدید اضافه کنید. همین باعث می‌شود مارکد را بتوان به‌راحتی با دوره، کلاس یا سبک تدریس خودتان هماهنگ کرد. هر درس به یک id منحصربه‌فرد و متن هر سه زبان نیاز دارد.

امکانات

• ادیتور کد داخلی با رنگی شدن کلمات کلیدی پایتون
• اجرای کد و نمایش خروجی داخل خود برنامه
• یک چالش برای هر درس که به‌صورت خودکار بررسی می‌شود و امتیاز شما را بالا می‌برد
• ذخیره پیشرفت و زبان انتخاب‌شده بین دفعات اجرا
• رابط کاربری به سه زبان انگلیسی، فارسی و کوردی (سورانی)
• ظاهر تیره ساخته‌شده با CustomTkinter

سرفصل‌ها

۲۹ درس در ۷ بخش:

1. شروع کار
2. متغیرها و داده‌ها
3. ساختارهای شرطی
4. حلقه‌های تکرار
5. ساختارهای داده
6. توابع
7. ماژول‌ها

پیش‌نیازها

• ویندوز
• پایتون ۳.۸ یا جدیدتر
• کتابخانه customtkinter

نصب و اجرا

git clone https://github.com/RamyarHasanpour/marcode.git
cd marcode
pip install customtkinter
python start.py

در اولین اجرا، برنامه پوشه‌ای به نام MarcodeProject را روی یکی از درایوهای شما می‌سازد و پیشرفت شما را آنجا ذخیره می‌کند.