به نام خدا
آماده‌سازی اولیه‌ی بلاگ
در این پست می‌خواهم در مورد نحوه‌ی ساخت یک صفحه‌ی گیتهاب (Github Pages) با استفاده از Sandra.Snow بنویسم. همین وبلاگی که الان مشاهده می‌کنید با استفاده از این سیستم ساخته شده. چنین سایت‌هایی به صفحات ایستا (Static Webpages) مشهور هستند. در این نوع سایت‌ها، بجز نمایش صفحات، از سمت سرور هیچ عمل خاصی انجام نمی‌گیرد. به همین دلیل هم میزبانی این نوع صفحات بسیار آسان است و به راحتی می‌توان محتوای خوبی با استفاده از این نوع صفحات ایجاد کرد. البته همین ایستا بودن صفحات باعث ایجاد محدودیت‌هایی هم می‌شود ولی می‌توان بعضی از این محدودیت‌ها را با استفاده از امکانات سمت کاربر (Client-side) برطرف کرد. یک نمونه از این امکانات، نظرگذاری در پست‌ها می‌باشد. یکی از راه‌های پیاده‌سازی نظرگذاری در بسیاری از سایت‌ها، ایجاد یک پایگاه‌داده در سمت سرور و مدیریت این نظرات توسط سرور می‌باشد. راه‌حلی که برای سایت‌های ایستا ایجاد شده است، استفاده از سرویس‌هایی همچون Disqus می‌باشد. سرویس‌هایی اینچنین امکان نظر گذاشتن بر روی صفحات ایستا را فراهم می‌سازند. برای فعال‌سازی این نوع نظرات فقط کافی است یک حساب کاربری در این سایت ایجاد نمایید و شناسه‌ی سایت خود را دریافت کنید. با قراردادن این شناسه در فایل تنظیمات، این امکان در صفحات ایستا ایجاد می‌شود. امکانات دیگری نیز وجود دارد که تقریباً همه‌ی آنها وابسته به جاوااسکریپت بوده و سمت کاربر هستند. پس به راحتی می‌توان با پیدا کردن کتابخانه‌های جاوااسکریپت، امکانات بیشتری را به صفحات ایستا افزود. البته باید مسئله‌ی حجم صفحات را نیز در نظر گرفت و از سنگین کردن بیش از حد این صفحات جلوگیری کرد. مثلاً یکی از کتابخانه‌های جاوااسکریپت که در این بلاگ استفاده شده، کتابخانه‌ی MathJax برای نمایش فرمول‌های ریاضی هست. حالا اگر بخواییم خلاصه‌ای از مراحل ایجاد این بلاگ را بگیم به این صورت خواهد بود: اول لازمه که پروژه‌ی زیر رو از گیتهاب بر روی کامپیوتر خودتون clone کنید:
git clone https://github.com/Sandra/Sandra.Snow.git
مرحله‌ی بعد این هست که فایل پروژه با نام Sandra.Snow.sln که در پوشه‌ی src قرار دارد را باز کنید. برای اینکار بر روی ویندوز به نرم‌افزار ویژوال‌استودیو نیاز دارید. البته بر روی همه‌ی سیستم‌های عامل می‌توانید از Xamarin Studio استفاده کنید. در اینجا برای ساخت بلاگ، فقط به پروژه‌ای با نام Snow نیاز داریم. در تنظیمات این پروژه، در قسمت debug در قسمت مربوط به Command line arguments اطلاعات زیر رو وارد کنید:
config="path/to/Snow/" server=true debug=true
path/to/Snow/ آدرس پوشه‌ی Snow هست که فایل‌های سایت در اون قرار داره. در این پوشه فایل‌های مربوط به تنظیمات صفحات، تنظیمات ظاهر صفحه و همچنین فایل‌های جاوااسکریپت و CSS و عکس‌ها قرار دارند. برای یک نمونه از این نوع پوشه که برای شروع کار آماده است می‌توانید از نمونه‌ای که در این آدرس قرار دارد استفاده کنید. همچنین نمونه‌ی تغییر یافته برای بلاگ‌های فارسی در این آدرس قرار دارد. شما فقط به پوشه‌ی Snow این فایل‌ها نیاز دارید.
در نهایت فقط کافی است تنظیمات مربوط به فایل snow.config و در صورت نیاز، فایل‌های *.cshtml موجود در پوشه‌ی themes/snowbytepersian و themes/snowbytepersian/_layouts را تغییر دهید. در این میان مهم‌ترین فایل، فایل default.cshtml می‌باشد. با تغییر این فایل، بسیاری از تنظیمات شما برقرار می‌شوند.
در فایل‌های موجود در تِمِ snowbytepersian تنظیمات مربوط به جهت درست نمایش متون و همچنین نمایش فرمول‌های ریاضی درج شده‌اند. با بررسی فایل‌های ذکر شده می‌توانید تنظیمات دلخواه خود را اعمال کنید.
در نهایت بعد از کامپایل کردن پروژه‌ی ذکر شده در ابتدای پست، در صورتی که آدرس پوشه‌ی Snow را به درستی داده باشید، سایت شما ایجاد شده و یک سرور برای نمایش محلی شما ایجاد می‌شود. بعد از اینکه کار ساخت فایل‌های سایت شما به اتمام رسید، می‌تواند با push کردن در پروژه‌ی صفحه‌ی گیتهاب بر روی گیتهاب، سایت خود را آماده کنید.
در مورد صفحه‌ی گیتهاب
برای داشتن یک صفحه‌ی گیتهاب در سایت Github لازم است یک پروژه با نام <username>.github.io در گیتهاب ایجاد نمایید. <username> نام کاربری شما در گیتهاب می‌باشد. در نهایت با push کردن فایل‌های ایستای بلاگتان در این پروژه، بلاگ ایستای شما در آدرسی به نام پروژه‌تان ایجاد خواهد شد.
git push -u origin master