PELICAN-THEMES(1)                   PELICAN                  PELICAN-THEMES(1)

نام (NAME)
       pelican-themes - ابزار مدیریت پوسته برای پلیکان

توضیحات (DESCRIPTION)
       pelican-themes یک ابزار خط فرمان برای مدیریت پوسته‌های پلیکان (Pelican)
       است. برای تنظیمات مرتبط با پوسته‌ها، بخش <#settings-themes> Themes را
       مشاهده کنید.

   کاربرد (Usage)
       pelican-themes [-h] [-l] [-i theme path [theme path ...]]
         [-r theme name [theme name ...]]
         [-s theme path [theme path ...]] [-v] [--version]


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

       -h, --help
              نمایش پیام راهنما و خروج

       -l, --list
              نمایش پوسته‌های نصب‌شده

       -i theme_path, --install theme_path
              یک یا چند مسیر پوسته برای نصب

       -r theme_name, --remove theme_name
              یک یا چند نام پوسته برای حذف

       -s theme_path, --symlink theme_path
              مشابه --install، اما به‌جای کپی کردن پوسته، یک پیوند نمادین
              (سیم‌لینک) ایجاد می‌کند.  مفید برای توسعه و ویرایش پوسته

       -v, --verbose
              خروجی پرجزئیات

       --version
              چاپ نسخه اسکریپت

مثال‌ها (EXAMPLES)
   فهرست کردن پوسته‌های نصب‌شده (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 جایگزین
       می‌شود.

نویسنده (AUTHOR)
       Mickaël Raybaud

حق نشر (COPYRIGHT)
       2010–2025

4                              December 25, 2025             PELICAN-THEMES(1)