دوستی از من درخواست کردن که آموزشی برای شروع کار با سیستم بلاگینگ استاتیک پلیکان رو تهیه کنم. این قسمت صفرم این آموزش هست و ادامه خواهد داشت.

نصب

پلیکان هم در پایتون ۲ کار می‌کنه و هم در پایتون ۳. نسخه‌ی پایتون ۲ توسعه داده نمی‌شه و تمرکز بر روی پایتون ۳ هست. پس، اول پایتون ۳ و پیپ رو اگر ندارید، نصب کنید:

$ sudo apt-get install python3 python3-pip

و خود پلیکان رو نصب کنید:

$ sudo pip3 install pelican

انتخاب قالب محتوای خام

پلیکان برای ورودی داده‌هایی که قراره به صورت یک صفحه‌ی مجزا ساخته بشن، دو قالب کلی رو پشتیبانی می‌کنه:

• reStructuredText
• Markdown

اگر شما تصمیم گرفتید که از قالب مارک‌داون استفاده کنید، باید markdown رو هم نصب کنید:

$ sudo pip3 install markdown

آماده‌سازی پوشه‌ی ریشه‌ی وبلاگ

پوشه‌ای درست می‌کنیم. این پوشه، ریشه‌ی وبلاگ ما خواهد بود: همه‌ی مطالب، مضمون‌ها، تنظیمات، سایت تولید شده و ... این‌جا قرار خواهند داشت.

$ mkdir -p MyBlog
$ cd MyBlog

پلیکان، پرونده‌های اولیه‌ی مورد نیاز رو ایجاد می‌کنه:

$ pelican-quickstart 
Welcome to pelican-quickstart.

This script will help you create a new Pelican-based website.

Please answer the following questions so this script can generate the files needed by Pelican.

تک تک سؤالاتی که می‌شوند را بررسی می‌کنیم:

Where do you want to create your new web site? [.] .

نشانی پوشه‌ای که قرار است پرونده‌ها در آن ایجاد شوند درخواست می‌شود. .، به پوشه‌ای که هم‌اکنون آن را درست کردیم اشاره می‌کند.

What will be the title of this web site?

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

Who will be the author of this web site?

نام نویسنده(معمولا شما). در صورتی که در ابرداده‌های مطلب‌ها نام نویسنده درج نشود، از این نام استفاده می‌شود.

What will be the default language of this web site? [en]

زبان پیش‌فرض وبلاگ. برای انتخاب زبان پارسی، fa را وارد کنید.

Do you want to specify a URL prefix? e.g., http://example.com   (Y/n)

می‌پرسد که می‌خواهید یک دامنه به این وبلاگ اختصاص دهم؟ این دامنه زمانی استفاده می‌شود که بخواهید از پیوندهای مطلق به جای نسبی استفاده کنید. توصیه می‌شود بله گفته و نشانی ریشه‌ی وبلاگ‌تان را وارد کنید. مثلا برای وبلاگ من:

http://mamins1376.github.io/weblog

نکته‌ای که باید مد نظر داشته باشید، این است که پایان عبارت به / ختم نشود زیرا هنگام تولید سایت، موجب می‌شود که دوتا / پشت هم قرار گیرند. پلیکان در صورت نیاز خودش / را قرار می‌دهد.

Do you want to enable article pagination? (Y/n)

می‌خواهید صفحه‌بندی ایجاد شود؟ در صورتی که به این پرسش نه بگویید، همه‌ی پست‌ها در صفحه‌ی اول وبلاگ قرار می‌گیرند. در غیر این صورت، به ازای هر ده پست، یک صفحه‌ی جدید ایجاد می‌شود.

How many articles per page do you want? [10]

بیش‌ترین تعداد مطلب‌هایی که در یک صفحه قرار خواهند داشت این‌جا مشخص می‌شود.

What is your time zone? [Europe/Paris]

منطقه‌ی زمانی نویسنده که تمام زمان‌بندی‌ها بر اساس آن تعیین می‌شود. برای تهران، عبارت Asia/Tehran را وارد کنید.

Do you want to generate a Fabfile/Makefile to automate generation and publishing? (Y/n)

Makefileها به ما کمک می‌کنند تا از نوشتن عبارت‌های طولانی پرهیز کنیم و خلاصه‌ای برای هر دستور در حالت‌های عمومی و خاص درست می‌کند.

در قسمت‌های بعدی، به ادامه‌ی این مجموعه می‌پردازم.