• تمرین عملی | مفهوم Comment و Markdown در جوپیتر نوت بوک
در جلسه یازدهم از فصل دوّم دوره صفر تا قهرمانی پایتون، به طور عملی وارد محیط جوپیتر نوت‌بوک شدیم و مفاهیم مربوط به Comment و Markdown را به صورت عملی بررسی کردیم.
🔸 تعریف کامنت (Comment)
امّا کامنت چیست؟ کامنت‌ها در برنامه‌نویسی خط‌هایی از کُدنویسی هستند که توسط مفسّر پایتون (interpreter) خوانده نمی‌شود و نتیجتاً اجراء نخواهدشد. در زبان برنامه‌نویسی پایتون با قراردادنِ نماد هشتگ (#) پیش از شروع هر خطی از کُد، آن خط تبدیل به کامنت می‌گردد.
امّا اگر این خط‌ها اجراء نمی‌شوند پس چه استفاده یا کاربردی دارند؟! ما به‌عنوان برنامه‌نویس معمولاً به دو هدف از کامنت‌گذاری استفاده می‌نماییم.
• ارائه توضیحِ مناسب برای بخش‌هایی از کُد که نیازمند توضیح هستند.
• غیرفعال‌کردن موقتی بخشی از کُد غالباً به‌هدف پروسه رفع خطا یا دیباگینگ (debugging)
در تصویر بالا؛ کامنت‌های قرارداده‌شده هیچ تاثیری در خروجی کُد نداشتند. درواقع این خطوط توضیحاتی هستند که فَردِ برنامه‌نویس در کُد خود لحاظ کرده‌است. کامنت‌گذاری مناسب (نه بیش از اندازه) یک رفتار بسیار خوب برنامه‌نویسی است و تمامی توسعه‌دهندگان بخش‌هایی از کُد خود را که نیاز به توضیح دارند را کامنت‌گذاری می‌کنند. اجازه دهید تا یک مثال دیگر را نیز بررسی کنیم. در قطعه کُد زیر در حلقه for (در فصل‌های آتی مفصل راجع‌به حلقه‌ها صحبت خواهیم کرد) متغیّر counter وظیفه شمارش تعداد اعضای موجود در لیست (my_list) را بر عهده دارد و هم‌چنین متغیّر total نیز به‌منظور محاسبه‌ی مجموعِ تمامی آیتم‌های موجود در my_list ایجاد شده‌است. با اجراء‌شدن نتیجه به‌صورت زیر خواهدبود.
در قطعه کُد بالا، فرض کنید که به‌هر دلیلی نیاز داریم تا فقط در پنجره خروجی مقدار متغیّر total در هر بار تکرارِ حلقه for نمایش داده‌شود. بدین ترتیب با غیرفعّال‌کردن خط 10 و تبدیل آن به کامنت به‌طور موقتی این خط را از دایره اجراء‌شدن خارج می‌نماییم. درنتیجه خروجی به‌صورت زیر به‌دست می‌آید.
همان‌طور که از تصویر بالا مشخص است، با کامنت‌کردنِ خط 10 این خط اجراء نمی‌شود و در پنجره خروجی دیگر اثری از متغیّر counter وجود ندارد.
