.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.3 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "PELICAN-THEMES" "1" "Dec 25, 2025" "4" "PELICAN"
.SH "نام (NAME)"
pelican\-themes \- ابزار مدیریت پوسته برای پلیکان
.SH "توضیحات (DESCRIPTION)"
.sp
\fBpelican\-themes\fP یک ابزار خط فرمان برای مدیریت پوسته‌های پلیکان (Pelican) است. برای تنظیمات مرتبط با پوسته‌ها، بخش
\%<#\:settings-themes> Themes
را مشاهده کنید.
.SS "کاربرد (Usage)"
.nf
pelican\-themes [\-h] [\-l] [\-i theme path [theme path ...]]
.in +2
[\-r theme name [theme name ...]]
[\-s theme path [theme path ...]] [\-v] [\-\-version]
.in -2
.fi
.sp
.SS "گزینه‌های اختیاری (Optional arguments)"
.INDENT 0.0
.TP
.B  \-h\fP,\fB  \-\-help
نمایش پیام راهنما و خروج
.TP
.B  \-l\fP,\fB  \-\-list
نمایش پوسته‌های نصب‌شده
.TP
.BI \-i \ theme_path\fR,\fB \ \-\-install \ theme_path
یک یا چند مسیر پوسته برای نصب
.TP
.BI \-r \ theme_name\fR,\fB \ \-\-remove \ theme_name
یک یا چند نام پوسته برای حذف
.TP
.BI \-s \ theme_path\fR,\fB \ \-\-symlink \ theme_path
مشابه \fB\-\-install\fP، اما به‌جای کپی کردن پوسته، یک پیوند نمادین (سیم‌لینک) ایجاد می‌کند.
مفید برای توسعه و ویرایش پوسته
.TP
.B  \-v\fP,\fB  \-\-verbose
خروجی پرجزئیات
.TP
.B  \-\-version
چاپ نسخه اسکریپت
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.SS "فهرست کردن پوسته‌های نصب‌شده (Listing the installed themes)"
.sp
با \fBpelican\-themes\fP، می‌توانید پوسته‌های موجود را با استفاده از گزینه
.B \-l
یا
.B \-\-list
مشاهده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ pelican\-themes \-l
notmyidea
two\-column@
simple
$ pelican\-themes \-\-list
notmyidea
two\-column@
simple
.EE
.UNINDENT
.UNINDENT
.sp
در این مثال، سه پوسته موجود دیده می‌شوند: \fBnotmyidea\fP،
\fBsimple\fP و \fBtwo\-column\fP\&.
.sp
علامت \fB@\fP در انتهای \fBtwo\-column\fP به این دلیل است که این پوسته در مسیر پوسته‌های پلیکان کپی نشده است، بلکه فقط به آن پیوند داده شده است (برای جزئیات درباره پیوند نمادین، بخش ایجاد پیوند نمادین را ببینید).
.sp
توجه داشته باشید که می‌توانید گزینه \fB\-\-list\fP را با گزینه \fB\-v\fP یا
\fB\-\-verbose\fP ترکیب کنید تا خروجی پرجزئیات‌تری مانند زیر دریافت کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ 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 \(ga/home/skami/Dev/Python/pelican\-themes/two\-column\(aq)
/usr/local/lib/python2.6/dist\-packages/pelican\-2.6.0\-py2.6.egg/pelican/themes/simple
.EE
.UNINDENT
.UNINDENT
.SS "نصب پوسته‌ها (Installing themes)"
.sp
می‌توانید با استفاده از گزینه \fB\-i\fP یا \fB\-\-install\fP یک یا چند پوسته را نصب کنید.
این گزینه مسیر پوسته یا پوسته‌های مدنظر برای نصب را به‌عنوان آرگومان می‌گیرد،
و می‌تواند با گزینه \fB\-\-verbose\fP ترکیب شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pelican\-themes \-\-install ~/Dev/Python/pelican\-themes/notmyidea\-cms \-\-verbose
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pelican\-themes \-\-install ~/Dev/Python/pelican\-themes/notmyidea\-cms\e
                           ~/Dev/Python/pelican\-themes/martyalchin \e
                           \-\-verbose
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pelican\-themes \-vi ~/Dev/Python/pelican\-themes/two\-column
.EE
.UNINDENT
.UNINDENT
.SS "حذف پوسته‌ها (Removing themes)"
.sp
دستور \fBpelican\-themes\fP همچنین می‌تواند پوسته‌ها را از مسیر پوسته‌های پلیکان حذف کند.
گزینه \fB\-r\fP یا \fB\-\-remove\fP نام پوسته یا پوسته‌های مدنظر برای حذف را به‌عنوان آرگومان می‌گیرد، و می‌تواند با گزینه \fB\-\-verbose\fP ترکیب شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pelican\-themes \-\-remove two\-column
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pelican\-themes \-r martyachin notmyidea\-cmd \-v
.EE
.UNINDENT
.UNINDENT
.SS "ایجاد پیوندهای نمادین (Creating symbolic links)"
.sp
دستور \fBpelican\-themes\fP می‌تواند به‌جای کپی کردن تمام فایل‌های پوسته در مسیر پوسته‌های پلیکان، با ایجاد پیوند نمادین نیز پوسته‌ها را نصب کند.
.sp
برای ایجاد پیوند نمادین یک پوسته، می‌توانید از \fB\-s\fP یا \fB\-\-symlink\fP استفاده کنید که دقیقا مانند گزینه \fB\-\-install\fP کار می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pelican\-themes \-\-symlink ~/Dev/Python/pelican\-themes/two\-column
.EE
.UNINDENT
.UNINDENT
.sp
در این مثال، پوسته \fBtwo\-column\fP اکنون به مسیر پوسته‌های پلیکان پیوند نمادین داده شده است؛ بنابراین هم می‌توانیم از آن استفاده کنیم و هم می‌توانیم بدون نیاز به نصب مجدد پس از هر تغییر، آن را مستقیماً ویرایش کنیم.
.sp
این قابلیت برای توسعه و ساخت پوسته مفید است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ 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
.EE
.UNINDENT
.UNINDENT
.SS "انجام همزمان چندین عملیات (Doing several things at once)"
.sp
گزینه‌های \fB\-\-install\fP، \fB\-\-remove\fP و \fB\-\-symlink\fP مانعة‌الجمع نیستند؛ بنابراین می‌توانید آن‌ها را در یک خط فرمان با هم ترکیب کنید تا چند عملیات را همزمان انجام دهید، مانند این:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pelican\-themes \-\-remove notmyidea\-cms two\-column \e
                 \-\-install ~/Dev/Python/pelican\-themes/notmyidea\-cms\-fr \e
                 \-\-symlink ~/Dev/Python/pelican\-themes/two\-column \e
                 \-\-verbose
.EE
.UNINDENT
.UNINDENT
.sp
در این مثال، پوسته \fBnotmyidea\-cms\fP با پوسته \fBnotmyidea\-cms\-fr\fP جایگزین می‌شود.
.SH "نویسنده (AUTHOR)"
Mickaël Raybaud
.SH "حق نشر (COPYRIGHT)"
2010–2025
.\" End of generated man page.