.TH LOCALE::PO4A::VIMHELP.3PM 3pm 2025-11-22 "perl v5.42.0" "مستندات ماژول‌های پرل پارچ لینوکس"
.if n .ad l
.nh
.SH "نام (NAME)"
Locale::Po4a::VimHelp \- تبدیل فایل‌های راهنمای ویم به و از فایل‌های PO
.SH "توضیحات (DESCRIPTION)"
هدف پروژه po4a (PO for anything) تسهیل فرآیند ترجمه و نگهداری ترجمه‌ها با استفاده از ابزارهای gettext در حوزه‌هایی است که معمولاً از آن‌ها استفاده نمی‌شده است، مانند مستندات و راهنماها.
.PP
ماژول
.B Locale::Po4a::VimHelp
برای کمک به ترجمه فایل‌های راهنمای Vim طراحی شده است. برای مشاهده نحو و ساختار این فایل‌ها، به راهنمای نگارش فایل‌های راهنما در
<https://vimhelp.org/helphelp.txt.html#help-writing>
مراجعه فرمایید.
.SH "وضعیت ماژول (STATUS OF THIS MODULE)"
این ماژول در مراحل اولیه توسعه قرار دارد. این ابزار با موفقیت بر روی فایل‌های ساده مانند
.B helphelp.txt
آزمایش شده است. با این حال، هنوز روی تمام فایل‌های راهنمای کامل آزمایش نشده و نحوه تجزیه و پارس آن‌ها ممکن است برای اصلاحات و بهبودها، به خصوص در بخش شکستن خطوط پاراگراف‌ها، تغییر کند.
.SH "توسعه (DEVELOPING)"
تجزیه و تحلیل فایل‌های راهنمای Vim برای po4a با چالش‌هایی همراه است. در اینجا به برخی از موانع حین توسعه این ماژول اشاره می‌شود. اگر ایده بهتری دارید، پیشنهاد وصله (به همراه آزمون‌های تکمیلی) مورد استقبال قرار می‌گیرد.
.IP "\f(CW1. foo\fR شبیه به یک لیست مرتب به نظر می‌رسد" 4
الزاماً چنین نیست. پاراگراف زیر را در نظر بگیرید:
.PP
.nf
There are 2 wandering tanukis, not
1. He's using his cloning technique.
.fi
.PP
به همین دلیل، مواردی که شبیه عنوان (مانند \f(CW1.1 bar\fR) یا لیست نامرتب (مانند \f(CWo baz\fR) هستند را نمی‌توان به سادگی و به طور خودکار تشخیص داد.
.IP "تگ‌های تراز راست باید از هدف ترجمه خارج شوند" 4
این موضوع نیز دشوار است زیرا به تفاوت‌های ساختار زبانی در بومی‌سازی مربوط می‌شود.
مثال زیر را در نظر بگیرید:
.PP
.nf
Such a common and short concept in some languages *tags*
.fi
.PP
که ممکن است به شکل زیر ترجمه شود:
.PP
.nf
They are unfamiliar, there are no corresponding concepts and *tags*
it takes a longer sentence to express them in this language
.fi
.PP
هنگامی که این اتفاق می‌افتد، باید تصمیم بگیرید که در چه نقطه‌ای می‌خواهید یک تگ را به زیبایی اضافه کنید. این کار ساده نیست زیرا فایل راهنمای Vim دارای فرمت شکسته‌شده سخت (hard wrapped) است، حتی برای بخش‌هایی که بلوک کد نیستند.
همین مسئله برای مراجع تگ مانند \f(CW|ref|\fR نیز صدق می‌کند.
.IP "بهره‌گیری از \f(CW\-\-wrapcol\fR برای پایش عرض متن" 4
استفاده از گزینه \f(CW\-\-wrapcol\fR برای صدور هشدار هنگام عبور عرض متن از حدود مشخص‌شده، رویکردی منطقی به نظر می‌رسد. فایل‌های راهنمای رسمی Vim دارای یک خط حالت (modeline) مانند \f(CWvim:tw=78:ts=8:noet:ft=help:norl:\fR هستند که در
\f(CWruntime/doc/if_perl.txt\fR (<https://github.com/vim/vim/blob/04cc8975930b7b2c5d6753d3eddf57dab2816518/runtime/doc/if_perl.txt#L307>)
مشاهده می‌شود. با این حال، چالش‌هایی وجود دارد:
.RS 4
.IP "رفتار تجزیه فایل" 4
اگر این گزینه پیاده‌سازی شود، ایده‌آل این است که ابتدا کل فایل خوانده شود، وجود خط حالت بررسی شده و بخش‌های تحت تأثیر مشخص گردند.
.IP "مقادیر پیش‌فرض در برابر سفارشی" 4
مقدار پیش‌فرض عمومی گزینه \f(CW\-\-wrapcol\fR برابر ۷۶ است، در حالی که فایل‌های راهنمای Vim معمولاً از ۷۸ استفاده می‌کنند.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.BR Locale::Po4a::TransTractor (3pm),
.BR po4a (7)
.SH "نویسندگان (AUTHORS)"
gemmaro <gemmaro.dev@gmail.com>
.SH "کپی‌رایت و مجوز (COPYRIGHT AND LICENSE)"
Copyright © 2024, 2025 gemmaro.
.PP
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز GPL نسخه ۲.۰ یا بالاتر بازتوزیع کرده یا تغییر دهید.