yard در روبی

در زبان‌های مختلف ابزارهای مختلفی برای تولید مستندات از داخل کدها وجود دارد.

در زبان روبی ابزاری که برای این‌کار استفاده می‌شود rdoc است. وقتی که یک کتابخانه یا یک gem را نصب می‌کنید، rdoc آن نیز نصب می‌شود.

ابزار پیش‌فرض برای دیدن مستندات rdoc، همان gem است که با دستور زیر می‌توانید به آدرس 127.0.0.1:8808 در مرورگر بروید و مستندات gemهای نصب شده را ببینید.

gem server

اما به دلیل خوش‌دست نبودن و مشکل جستجو در سرور پیش‌فرض مستندات gem، من پیشنهاد می‌کنم از yard استفاده کنید. برای نصب yard از دستور زیر استفاده کنید.

gem install yard

توجه کنید که yard یک تولیدکننده (generator) مستندات مثل rdoc است. اما نکتهٔ قابل توجه آن سازگار بودن با نحوه نوشتار rdoc است. در yard شما می‌توانید از markdown نیز استفاده کنید در صورتی که در rdoc نمی‌توان استفاده کرد.

yard از redcarpet برای parse کردن markdown استفاده می‌کند. بنابراین آن را نیز باید نصب کنید:

gem install redcarpet

در آخر اگر نیاز به تولید تمام rdocهای gemها بودید از دستور زیر استفاده کنید:

gem rdoc –all

برای استفاده از سرور yard از دستور زیر استفاده کنید و به‌مانند gem server برای دیدن مستندات به آدرس 127.0.0.1:8808 مرورگر خود بروید:

yard server –gems

بوت‌استرپ ۲.۲.۱ منتشر شد

قبلا در مورد بوت‌استرپ نوشته بودم اگر نمیدونید چیه این مطلب رو بخونید.

نسخهٔ ۲.۲.۱ بوت‌استرپ منتشر شد. در نسخه ۲.۲.۱ سه تا ویژگی جدید معرفی شده‌است:

۱- چهار قالب نمونهٔ جدید ایجاد شده‌است

۲- جزیی به نام «شی رسانه» اضافه شده‌است که برای قسمت‌هایی مثل دیدگاه‌های وبلاگ، اخبار و یا فهرست مقاله‌ها مناسب می‌باشد. این جزء را می‌توانید در اجزا پیدا کنید.

۳- برای گرافیک قلم از نسبت جدیدی استفاده شده‌است.

همچنین این نسخه چندین رفع خطا (باگ فیکس) داشته‌است که می‌توانید آن را در صفحهٔ تغییرات ببینید.

توسعه مبتنی بر تست

یکی از روش‌های تولید نرم‌افزار، تولید نرم‌افزار مبتنی بر تست است. قبل از این‌که دربارهٔ این روش توضیح بدم خیلی خوبه بدونیم تست چیه؟

تست چیه؟ یک قطعه کد است که تایید می‌کنه کد تولید یا محصول ما درست بوده‌است.

یک تست دو نتیجه دارد: الف) موفقیت ب) شکست

تولید نرم‌افزار مبتنی بر تست:

۱- یک تست بنویسید

۲- تست‌هایی که نوشته‌اید را اجرا کنید (نتیجه تست باید شکست باشد چون هنوز کد تولید یا محصول خود را ننوشته‌اید)

۳- کد مربوط به تست شکست را بنویسید

۴- دوباره به مرحله ۱ بازگردید

در شکل زیر که از ویکی‌پدیا گرفته شده‌است نیز این مراحل نمایش داده شده‌است:

بوت‌استرپ همراه با مستندات فارسی

بعد از چند هفته تلاش، بوت‌استرپ برای زبان‌های راست به چپ و مستندات فارسی آن آماده شد.

حتما می‌پرسید بوت استرپ چیه؟

بوت‌استرپ یک چارچوب برای ساخت صفحات وبه. خود چارچوب در واقع یک مجموعه کد است که برای آسان‌تر شدن کارها و همچنین انجام ندادن کارهای تکراری ساخته میشه.

در طراحی صفحات وب یکی از چیزهای تکراری، ساخت لایه‌ها است. به عنوان مثال شما باید تعیین کنید که محتویات اصلی، سایدبار، منوها و خیلی چیزهای دیگه کجا قرار بگیرند.

یکی از ابزار پایه‌ای بوت‌استرپ، لایه‌ها است. بوت‌استرپ کلی چیزی در اختیار طراح قرار میده حتی تا جایی پیش رفته که لایه‌های مختلف را برای اندازه‌های صفحهٔ مختلف به شما تحویل می‌دهد که این ویژگی‌ای به نام پاسخگو یا responsive است.

این پروژه توسط شرکتی که من در اونجا هستم ساخته شده و شما می‌تونید بوت‌استرپ فارسی رو از آدرس rbootstrap.ir دریافت کنید.

درضمن اگر به مشکلی برخورد کردید حتما آن را گزارش دهید. ممنون

پروژه جدید برای طراحان وب

این روزها درگیر یک پروژه وب هستم. این یک پروژهٔ آزاد و متن‌بازه که فکر می‌کنم خیلی به‌درد کسایی توسعه‌دهندهٔ وب هستند بخوره.

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

به نظر خودم پروژهٔ خیلی خوبیه!

خط فرمان – nohup

گاهی اوقات پیش میاد که می‌خواهید در خط فرمان یک دستور زمان‌بری  (مثلا ۴، ۵ ساعت) رو اجرا کنید. اگر به صورت عادی دستور را اجرا کنید وقتی که شل را ببندید سیگنالی به نام SIGHUP  به پروسه مربوطه فرستاده می‌شود که وقتی هر پروسه‌ای این سیگنال را دریافت کند، آن پروسه Stop می‌شود.

برای این‌که این اتفاق نیافتد چندین راه وجود دارد، که به نظر من بهترین راه، نخستین است:

۱- استفاده از دستور nohup: این دستور سیگنال HUP را نادیده می‌گیرد، بنابراین با بسته شدن شل، همچنان دستور (Job) شما اجرا می‌شود. این دستور در بسته GNU core utils وجود داره.

$ nohup your_command

۲- استفاده ازat: این دستور کار اصلیش زمان‌بندی Jobهای مختلفه. وقتی با این دستور Job مورد نظر خود را اجرا کنید به دلیل این‌که در محیط at دستور شما قرار می‌گیرد، دیگر با بستن شل اتفاقی نمی‌افتد.

$ echo command|at now

۳- استفاده از دستور start-stop-daemon: این دستور در توزیع‌های برپایه دبیان وجود داره و کارش اینه که یک Job رو تبدیل به daemon می‌کنه. من با این دستور کار نکردم، کسی اگه کار کرده در دیدگاه‌ها بگه.

دسته‌بندی فیلم‌های خود با IMDB

چند روز پیش به این فکر افتادم که بشینم روزی ۱ فیلم از فیلمایی که ندیدم (شاید بیشتر ۱۲۰ تا فیلم) رو ببینم. اما دوست نداشتم فیلمایی که ارزش دیدن ندارند رو ببینم. برای این کار باید می‌رفتم تو سایت IMDB و فیلم مورد نظرم رو جستجو می‌کردم و می‌دیدم چه امتیازی گرفته و چند نفر به اون رای دادن و خلاصه این‌که آیا ارزش دیدن رو داره یا نه؟

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

برای استفاده از این برنامه باید مراحل زیر رو انجام بدید:

•  وارد این وب‌سایت شوید.
• یک فایل متنی که هر خط اون اسم یک فیلم است رو آپلود کنید. (حجمش نباید از ۱.۵ کیلوبایت بیشتر شه)
• منتظر شوید!
• در این‌جا آخرین فایل‌های آپلود شده رو می‌ةوانید ببینید. فایل خود را پیدا کنید. پی‌دی‌اف یا HTML اون رو می‌تونید ببینید.

گاهی اوقات هم پیش اومده فضای دیسک کم آوردم و مجبور می‌شدم فیلم‌هایی که ندیدم رو پاک کنم، این نرم‌افزار می‌تونه کمک کنه فیلم‌هایی که امتیاز و رای پایین‌تری در IMDB آورده باشند رو پاک کنید.

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