کاربرد (Usage)

pelican-themes [-h] [-l] [-i theme path [theme path ...]]
[-r theme name [theme name ...]]
[-s theme path [theme path ...]] [-v] [--version]

گزینه‌های اختیاری (Optional arguments)

فهرست کردن پوسته‌های نصب‌شده (Listing the installed themes)

با pelican-themes، می‌توانید پوسته‌های موجود را با استفاده از گزینه -l یا --list مشاهده کنید:

$ pelican-themes -l
notmyidea
two-column@
simple
$ pelican-themes --list
notmyidea
two-column@
simple

در این مثال، سه پوسته موجود دیده می‌شوند: notmyidea، simple و two-column.

علامت @ در انتهای two-column به این دلیل است که این پوسته در مسیر پوسته‌های پلیکان کپی نشده است، بلکه فقط به آن پیوند داده شده است (برای جزئیات درباره پیوند نمادین، بخش ایجاد پیوند نمادین را ببینید).

توجه داشته باشید که می‌توانید گزینه --list را با گزینه -v یا --verbose ترکیب کنید تا خروجی پرجزئیات‌تری مانند زیر دریافت کنید:

$ pelican-themes -v -l
/usr/local/lib/python2.6/dist-packages/pelican-2.6.0-py2.6.egg/pelican/themes/notmyidea
/usr/local/lib/python2.6/dist-packages/pelican-2.6.0-py2.6.egg/pelican/themes/two-column (symbolic link to `/home/skami/Dev/Python/pelican-themes/two-column')
/usr/local/lib/python2.6/dist-packages/pelican-2.6.0-py2.6.egg/pelican/themes/simple

نصب پوسته‌ها (Installing themes)

می‌توانید با استفاده از گزینه -i یا --install یک یا چند پوسته را نصب کنید. این گزینه مسیر پوسته یا پوسته‌های مدنظر برای نصب را به‌عنوان آرگومان می‌گیرد، و می‌تواند با گزینه --verbose ترکیب شود:

# pelican-themes --install ~/Dev/Python/pelican-themes/notmyidea-cms --verbose

# pelican-themes --install ~/Dev/Python/pelican-themes/notmyidea-cms\
                           ~/Dev/Python/pelican-themes/martyalchin \
                           --verbose

# pelican-themes -vi ~/Dev/Python/pelican-themes/two-column

حذف پوسته‌ها (Removing themes)

دستور pelican-themes همچنین می‌تواند پوسته‌ها را از مسیر پوسته‌های پلیکان حذف کند. گزینه -r یا --remove نام پوسته یا پوسته‌های مدنظر برای حذف را به‌عنوان آرگومان می‌گیرد، و می‌تواند با گزینه --verbose ترکیب شود.

# pelican-themes --remove two-column

# pelican-themes -r martyachin notmyidea-cmd -v

ایجاد پیوندهای نمادین (Creating symbolic links)

دستور pelican-themes می‌تواند به‌جای کپی کردن تمام فایل‌های پوسته در مسیر پوسته‌های پلیکان، با ایجاد پیوند نمادین نیز پوسته‌ها را نصب کند.

برای ایجاد پیوند نمادین یک پوسته، می‌توانید از -s یا --symlink استفاده کنید که دقیقا مانند گزینه --install کار می‌کند:

# pelican-themes --symlink ~/Dev/Python/pelican-themes/two-column

در این مثال، پوسته two-column اکنون به مسیر پوسته‌های پلیکان پیوند نمادین داده شده است؛ بنابراین هم می‌توانیم از آن استفاده کنیم و هم می‌توانیم بدون نیاز به نصب مجدد پس از هر تغییر، آن را مستقیماً ویرایش کنیم.

این قابلیت برای توسعه و ساخت پوسته مفید است:

$ sudo pelican-themes -s ~/Dev/Python/pelican-themes/two-column
$ pelican ~/Blog/content -o /tmp/out -t two-column
$ firefox /tmp/out/index.html
$ vim ~/Dev/Pelican/pelican-themes/two-column/static/css/main.css
$ pelican ~/Blog/content -o /tmp/out -t two-column
$ cp /tmp/bg.png ~/Dev/Pelican/pelican-themes/two-column/static/img/bg.png
$ pelican ~/Blog/content -o /tmp/out -t two-column
$ vim ~/Dev/Pelican/pelican-themes/two-column/templates/index.html
$ pelican ~/Blog/content -o /tmp/out -t two-column

انجام همزمان چندین عملیات (Doing several things at once)

گزینه‌های --install، --remove و --symlink مانعة‌الجمع نیستند؛ بنابراین می‌توانید آن‌ها را در یک خط فرمان با هم ترکیب کنید تا چند عملیات را همزمان انجام دهید، مانند این:

# pelican-themes --remove notmyidea-cms two-column \
                 --install ~/Dev/Python/pelican-themes/notmyidea-cms-fr \
                 --symlink ~/Dev/Python/pelican-themes/two-column \
                 --verbose

در این مثال، پوسته notmyidea-cms با پوسته notmyidea-cms-fr جایگزین می‌شود.