.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "NEWSGROUPS 5" .TH NEWSGROUPS 5 2025-03-29 "INN 2.7.4" "InterNetNews Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" newsgroups \- فایل توصیف گروه‌های خبری فعال یوزنت در INN .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" پرونده \fIpathdb\fR/newsgroups شامل فهرستی از گروه‌های خبری است که توضیحات کوتاهی برای آن‌ها در دسترس است. این پرونده عموماً توسط controlchan(8) هر زمان که یک پیام کنترلی دریافت شود به‌روزرسانی می‌شود؛ این پرونده توسط \&\fBnnrpd\fR در پاسخ به LIST NEWSGROUPS استفاده شده و صرفاً با هدف ارائه اطلاعات به کاربران در نظر گرفته شده است. برنامه‌های خبرخوان (News readers) اغلب فهرست گروه‌های خبری موجود را همراه با این توضیحات نمایش می‌دهند. .PP الزامی نیست که همه گروه‌های موجود روی سرور خبر (یعنی تمام گروه‌های فهرست‌شده در پرونده \fIactive\fR) در پرونده \fInewsgroups\fR نیز فهرست شوند. همچنین نیازی نیست که تمام گروه‌های فهرست‌شده در پرونده \fInewsgroups\fR توسط سرور خبر میزبانی گردند. با این وجود، مسلماً بهتر است که پرونده‌های \fIactive\fR و \fInewsgroups\fR دقیقاً شامل همان گروه‌های خبری یکسان باشند. .PP اگر از \f(CW\*(C`ctlinnd newgroup\*(C'\fR برای ایجاد دستی یک گروه استفاده کنید، تنها پرونده \&\fIactive\fR به‌روزرسانی می‌شود. در این صورت باید پرونده \fInewsgroups\fR را ویرایش نمایید تا توضیحات کوتاهی برای گروه ایجادشده بیفزایید. همین امر برای حذف دستی یا تغییر وضعیت یک گروه خبری نیز صدق می‌کند. .PP هر خط از پرونده \fInewsgroups\fR شامل دو فیلد است که با حداقل یک نویسه تب از یکدیگر جدا شده‌اند: .PP .Vb 1 \& \et .Ve .PP فیلد اول نام گروه خبری است. فیلد دوم توضیحات مربوط به آن است. .PP می‌توانید پرونده \fInewsgroups\fR یک سرور NNTP دیگر را با دستور getlist(1) دریافت کنید. .SH "قالب ترجیحی برای توضیحات تک‌خطی گروه خبری (PREFERRED FORMAT FOR A ONE-LINE NEWSGROUP DESCRIPTION)" .IX Header "PREFERRED FORMAT FOR A ONE-LINE NEWSGROUP DESCRIPTION" تا جایی که به قالب پرونده \fInewsgroups\fR مربوط می‌شود، یک قالب ترجیحی برای هر خط وجود دارد. از آنجا که مدیران سرور خبر عموماً زمان کافی برای اصلاح خطوطی که به صورت خودکار از پیام‌های newgroup یا checkgroups وارد می‌شوند ندارند، این اطلاعات ارائه شده است تا فرستندگان پیام‌های کنترلی بتوانند پیام‌های بهتری ایجاد کنند. همچنین این اطلاعات برای مدیران خبر مفید خواهد بود تا بدانند چگونه توضیحات گروه‌های خبری محلی خود را قالب‌بندی نمایند. .PP باید حداقل یک نویسه تب سخت (با فواصل پرش تب ۸ ستونی) میان نام گروه و توضیحات قرار گیرد. اگر نام گروه حداقل ۱۶ کاراکتر باشد، باید با یک تب دنبال شود. اگر نام گروه حداقل ۸ کاراکتر باشد، باید با دو تب همراه باشد. و در صورتی که طول نام گروه کمتر از ۸ کاراکتر باشد، باید با سه تب دنبال گردد. به عنوان مثال: .PP .Vb 3 \& misc.transport.rail.europe Railroads & railways in all of Europe. \& news.admin.nocem NoCeM protocol policy issues and information. \& news.groups Discussions and lists of newsgroups. .Ve .PP طول کل خط باید حداکثر ۷۹ ستون باشد. توضیحات باید با یک حرف بزرگ آغاز شده و طول آن بیش از ۵۵ کاراکتر (۲۴ \- ۷۹) نباشد. اگر نام گروه طولانی‌تر از ۲۴ کاراکتر باشد، طول توضیحات باید به همان نسبت کوتاه‌تر شود. اگر گروه مدیریت‌شده (Moderated) باشد، باید عبارت \f(CW\*(C` (Moderated)\*(C'\fR (به فاصله قبل از پرانتز باز دقت کنید) دقیقاً در انتهای توضیحات قرار گیرد و به عنوان بخشی از طول توضیحات محاسبه نمی‌شود. این متن باید دقیقاً و بدون هیچ تغییری به همین شکل درج شود، زیرا نرم‌افزارهای خبر از آن برای شناسایی گروه‌های مدیریت‌شده استفاده می‌کنند. .PP در اینجا مثالی از یک گروه خبری مدیریت‌شده آورده شده است: .PP .Vb 1 \& news.lists.misc News\-related statistics and lists. (Moderated) .Ve .PP به طور سنتی، تمام توضیحات گروه‌های خبری با یک نقطه به پایان می‌رسیدند، اما این کار ضروری نیست و یک کاراکتر را هدر می‌دهد که گهگاه برای ارائه توضیحات بهتر کاربرد دارد. .PP برخی از توضیحات بیش‌ازحد طولانی را می‌توان با حذف عبارت‌های بیهوده‌ای مانند \f(CW\*(C`Discussion of\*(C'\fR که نقش معنایی مهمی در توضیح ندارند، به آسانی در محدودیت طول گنجاند. رساندن سایر موارد به کمتر از ستون هشتاد نیز معمولاً بسیار ساده است، مگر زمانی که نام گروه‌ها بیش از اندازه طولانی شود؛ که در این صورت امید می‌رود خود نام گروه حاوی بخش عمده‌ای از توضیحات باشد. .PP در برخی موارد، توضیحات طولانی‌تر واقعاً ضروری خواهند بود؛ البته می‌توان از آن‌ها در پرونده \fInewsgroups\fR استفاده کرد. با این حال، این توضیحات احتمالاً برای برخی از کاربران یوزنت کمتر خوانا و کم‌فایده‌تر خواهند بود. .PP توضیحات نباید شامل هیچ نویسه کنترلی (بایت‌های میان 0x00 و 0x1F) باشند. .SH "کدگذاری توضیحات (ENCODING OF THE DESCRIPTIONS)" .IX Header "ENCODING OF THE DESCRIPTIONS" در حال حاضر، هیچ سازوکار مناسبی برای مدیریت مجموعه نویسه‌های توضیحات گروه‌های خبری وجود ندارد. بسیاری از سلسله‌مراتب‌های غیرانگلیسی، توضیحات گروه‌های خبری را به زبان بومی خود درج می‌کنند؛ چراکه برای کاربرانشان مفیدتر است و این موارد عِیناً در پرونده \&\fInewsgroups\fR قرار می‌گیرند. این موضوع متأسفانه به این معنی است که خطوط مختلف پرونده برای خوانده شدن درست، نیازمند تنظیمات متفاوتی از مجموعه‌های نویسه خواهند بود و این مجموعه‌های نویسه در پرونده مستند نشده‌اند. امید است که استانداردی در آینده راهکاری برای این مشکل فراهم کند؛ در این میان، استفاده از UTF\-8 برای نویسه‌های غیر ASCII توصیه می‌شود. .SH "حداقل پرونده گروه‌های خبری (MINIMAL NEWSGROUPS FILE)" .IX Header "MINIMAL NEWSGROUPS FILE" حداقل پرونده \fInewsgroups\fR ارائه‌شده به همراه INN عبارت است از: .PP .Vb 6 \& control Various control messages (no posting). \& control.cancel Cancel messages (no posting). \& control.checkgroups Hierarchy check control messages (no posting). \& control.newgroup Newsgroup creation control messages (no posting). \& control.rmgroup Newsgroup removal control messages (no posting). \& junk Unfiled articles (no posting). .Ve .PP این خطوط \fIباید\fR با تب از یکدیگر جدا شوند (Tab-delimited)، بنابراین در صورتی که آن‌ها را از بالا کپی و جای‌گذاری می‌کنید، لطفاً دقت فرمایید. .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" توسط Julien Elie برای InterNetNews نوشته شده است. قالب ترجیحی برای توضیحات تک‌خطی گروه‌های خبری بر اساس سیاست‌هایی است که پرونده \fInewsgroups\fR در بر پایه آن‌ها نگهداری می‌شود؛ این سیاست‌ها در ابتدا توسط David Lawrence نگاشته شد و توسط Russ Allbery به‌روزرسانی گردید. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" active(5), controlchan(8), ctlinnd(8), getlist(1), nnrpd(8).