راهنمای استفاده از کارپ

مدتي بود براي نشان دادن فيدهاي سايتهاي خبري از نرم‌افزارZfeederاستفاده مي‌کردم. مزاياي بسيار زيادي دارد.

1- نرم‌افزار گونه است. يعني يک محيط کاربري مستقل دارد.
2- توانايي کنترل و ثبت آدرس‌هاي feed را به طور جداگانه و کاملاً دسته‌بندي شده دارد.
3- برنامه‌اي براي يافتن فيد به صورت اتوماتيک دارد. (مثلاً آدرس www.domain.com‌ را مي‌دهيد و اگر فيد داشته باشد آدرسش را در مي‌آورد.
4- حجم زيادي ندارد.
5- فيدها را کش (cache) مي‌کند و سپس نمايش مي‌دهد. (مدت زمان رفرش فيد دستي است)
6- انواع صفحات مقصد را پشتيباني مي‌کند. قالبهاي گرافيکي متناسب با div‌ و table  رو داره و انعطاف‌پذيري خوبي داره.
و …

اما در چند روز گذشته و با لطف آقاي فرشاد عزيز به نرم‌افزارCaRP رسيدم که عرضمي‌کنم خدمتتون.

الف)برنامه رو ازاينجا دريافت مي‌کنيد.
ب)پوشه رو به هوست خودتان منتقل کنيد. (هم مي‌توانيد بهPublic_html انتقال بديد و هم جاي ديگه. ولي بهتر به قبل از شاخه‌ي عمومي سايت انتقال بديد تا دردسر هک و اينها هم نداشته باشه مثلاً به آدرس home/yourname/carp . مجوز دسترسي (permission) اين شاخه بايد0777‌باشه.
ج)حالا يک فايل به نام carpsetup.php رو که در شاخه نصب برنامه است به public_html منتقل کنيد (move).
د)مسير اون فايل setup رو در بروزر تايپ کنيد و اجراش کنيد. (www.yoursite.com/carpsetup.php).
هـ)اين برنامه نصب کارش ايجاد شاخه‌هاي کش است و ممکنه چند تا پيام در مورد”اجازه دسترسي” به شما بده که ازتون ميخواد مثلاً اجازه دسترسي شاخه‌ي carp‌ رو به 0711 تغيير بدهيد. يکم پيام ارورش رو مطالعه بکنيد حله.
و)در پايان يک صفحه به شما ميده که کد نهايي مورد استفاده رو توش توليد کرده. به اين صورت

<?php
require_once ‘/home/yourname/carp/carp.php’;
// Add any desired configuration settings below this line using “CarpConf”
and other functions
CarpCacheShow(’http://www.bbc.co.uk/persian/iran/index.xml’);
?>

خب کار نصب برنامه اگر تا اينجا پيشرفتيد تمومه. از اين بهبعد به تنظيم نشان دادن فيد مربوط ميشه.

الف) يک جايي رو در صفحه‌مون براي نشان دادن فيد انتخاب مي‌کنيم. (مثلاً ستون دست چپ بنده)
ب)فرض ما استفاده از css است. به اين صورت که يک کلاس براي فيد ها تعريف مي‌کنيم:

#feed {
direction: rtl;
padding: 5px;
color: #bbb;
font-family: tahoma, sans-serif;
font-size: 9px;
text-align: right;
}

#feed a {
text-decoration: none;
font-size: 11px;
}

اين کدها بايد به جايي مابين <style> و<style/> اون بالابالاهاي قالب اصليتون اضافه بشه. کهاصولاً مثلاً در MovableType فايلStyle-sheet.css اينکار رو ميکنه. پس اگر از ام‌تي استفاده مي‌کنيد بايدکدهاي بالا رو به فايل css اضافه کنيد.
در کلاس css بالا ما تعريف کرديم که سايز لينک دو واحداز سايز توضيحش بزرگتر باشه. رنگ توضيحش کم رنگ باشه. متن ما فارسي باشه (از راستبه چپ، يعني اگر بخواهيد يک فيد انگليسي زبان را نشان دهيد بايد خصيصه‌يRTL‌ رو به LTR تبديل بکنيد)و غيره.

در نظر داشته‌باشيد که رنگ لينکها به پيش‌فرض صفحه حواله شد. اندازه‌ و عرضستون رو تعيين نکرديم و مثلاً اگر شما اين قسمت رو در سايدبار وارد مي‌کنيد تنظيماتاونجا رو به خودش خواهدگرفت.

خب حالا بايد کدها رو به قالب اصلي اضافه کنيم. براي اينکار اول فيد اون سايت مبداء رو پيدا بکنيد. مثلاً فید دودردو اینه http://doxdo.com/feed یا از طریق فیدبرنر.

 

اصولاً وقتي سايتي فيد خروجي rss توليد بکنه لينکش جايي در متاتگهاي (meta) اون صفحه نوشته ميشه. (براي ديدن اون آدرس از View Source استفاده کنيد همون اوايلش بايد يک عبارتي بايد وجود داشته باشه که يک فايلي با پسوند Xml يا Rdf يا تو همين مايه‌ها رو لينک کرده  پيدا بکنيد. کپي کنيد تو بروزر (FireFox يا Avant Browser بهتر جواب ميده) و اگر ارور نداد و شما يکسري نوشته‌هاي مفهوم رو توش ديديد يعني درسته. همون فايله.

شما فيد رو پيدا کرديد. حالا، قالب اصليتون رو باز کنيد. يادتون باشه که پسوند صفحه حتما php‌ بايد باشه يا عوضش کنيد. جايي رو که مي‌خواهيد فيدها رو در اون وارد کنيد انتخاب کنيد. کدهايي رو نرم‌افزار CaRP‌ بهتون داده به اين ترتيب وارد کنيد:

<div id=”feed”>
<?php
require_once ‘/home/yourname/carp/carp.php’;
*محل قرار گرفتن تنظيمات*
CarpCacheShow(’آدرس فيد مورد نظر رو مانند مثال بالا’);
 ?>
</div>

البته شما عين عبارت بالا رو کپي پيست نمي‌کنيد! ها! چون من دارم باFrontPage تايپ مي‌کنم کدها رو تغيير داده. شما به روشيکه ميبيند کدهاي اصلي خودتون رو اديت مي‌کنيد.

* در محل قرار گرفتن تنظيمات ميتوانيد تنظميات خاصي رو مدنظر قرار بدهيد. مثلاً اينکه تعداد مطلب اين فيد خاص با ديگر فيدهاي فرق بکند.تعداد کلمات توضيحاتش چقدر باشد و غيره. اين دستورات رو در فايل carp.phpخواهيد ديد. مثلاً maxitems تعداد حداکثر مطالب اون فيداست. که با اين فرمت در کدها قرار خواهد گرفت:

CarpConf(’maxitems’,'5′);
CarpConf(’جواب دستور’,'دستور مربوط به فيد’);

مثلاً ما ميخواهيد بگوييم که توضيح لينکها فرضاً طوسي رنگباشد. دو تا دستور بايد بسازيم، يکي براي قبل از توضيحات و يکي براي بعد ازتوضيحات. به اين صورت:

CarpConf(’bidesc’,'<span style=”color: #ddd;”>’);
CarpConf(’aidesc’,'</span>’);

که در دستور اول b مخفف Before و i مخفف itemو desc مخفف description است و دستور دوم هم After item desc است… اين مخففات در تمام کارپ به همين صورتانجام شده. و رمز‌گذاري ساده‌اي دارد که مي‌توانيد پيدا بکنيد… (اگر مي‌خواهيد بههر فيد تنظيمات خاص خودش را بدهيد بهتر است در خود فايل carp.phpدقت کنيد (پاراگراف بعد)  تا اون دستورات ثانويه با پيش‌فرضها تناقض نداشتهباشند که در آن صورت دستورات ثانويه کار نخواهندکرد.

CaRP اصولا پوليه. ولي ما از رايگانش استفاده مي‌کنيم. در حالت پيشفرض نرم‌افزار ما مياد بالاي مطالب “نام سايت مبداء” لينکشو لوگوش و کپي‌رايتش رو هم درج مي‌کنه. پائينش هم مينويسه که کارپ اينها روتوليد مي‌کنه. براي اديت اين نمايشات هم آورده و يک سري Tagهاي مخصوص خودش ساخته که لازم نيست به نظر من استفاده بکنيد. عوضش فايلcarp.php رو که در شاخه‌ي کارپ وجود داره با يک اديتور باز کنيد:

سطر 53 نوشته که image,link.desc که به ترتيب لوگو و لينک و توضيحات فيد وارد شده‌است. (من هر سه رو برداشتم و دو تا کوتيشنخالي مي‌مونه)

سطر 66 و 100 اون فايل حداکثر حروف تيتر يک لينک هست (200توصيه ميشود بهجاي 80)

سطرهاي 121 و 122 رو هر دو رو UTF-8‌ بکنيد که انکودينگ خروجي و وروديه.

سطر 139 و 140 همون کپيرايت کارپ هست. که خودش توضيح داده اگر برش داريدبايد يک جايي از صفحه‌تون به کارپ لينک بدهيد. تصميم باشماست.

بقيه‌ش ديگه فکر نکنم به سواد من قد بده. فايل رو saveکنيد و به جاي فايلي که روي هوست آپلود کنيد.

قالبها رو به سايت منتقل کنيد و Rebiuld کنيد واميدوام که کار بکنه. اگر نکرد مراحل رو دوباره چک بکنيد. راهنماي خود برنامه رو هممطالعه بکنيد. بعد که مطمئن شديد مشکل از روش نصب نيست من در خدمتم. از همين کامنتاستفاده بکنيد تا اگر دوست ديگري هم مشکل داشت شايد اينجا پيدايش بکند.

در پايان لازمه از فرشاد عزيز مجدد تشکرکنم. آهان يادم رفت بگم که چرا اين کارپ به zfeeder‌ارجحيت داره. والا اگر شما هر دو رو امتحان بکنيد شايد بگيد زدفيدر بهتره. ولي چون
من چيزهاي ساده‌تر و جمله‌هاي يک خطي رو بيشتر دوست دارم و کارپ اينطوريه اين روپسنديدم. ولي انتخاب باشماست.

کارپ يک ضعفي هم داره و اون آنلاين بودنشه. يعني وقتي تقاضاي ديدار صفحه‌يشما به بروزر داده ميشه کارپ ميره و فيد سايت مبداء رو ميخونه و به بيننده‌نشون ميده که اگر سايت مبداء دچار خواب‌آلودگي باشه بيننده‌ي شما کمي معطلميشه. (ولي زد فيدر ميره کش ميکنه و در سرور شما يک فايل ميسازه و به بينندهنشون ميده)حسن کارپ هم اينه که ميتونه فيد رو به صورت جاوا اسپکريپت دربياره و درصفحات html هم نمايشش بده.

–
توضیحات مربوط به ورژن.
در لحظه این توشیح، کارپ انواع جدیدی ارائه داده که اغلب پولی هستند، ولی نسخه رایگان هم وجود داره. اصول کلی کار نصب و اجرا همونه ولی ممکنه در شماره سطرها یا امکانات کارپ تغییراتی مشاهده بشه.