.\" Copyright 2011-2025 David Robillard .\" SPDX-License-Identifier: ISC .Dd January 30, 2025 .Dt SERDI 1 .Os .Sh "نام (NAME)" .Nm serdi .Nd خواندن و نوشتن نحو RDF .Sh "خلاصه دستور (SYNOPSIS)" .Nm serdi .Op Fl abefhlqv .Op Fl c Ar prefix .Op Fl i Ar syntax .Op Fl o Ar syntax .Op Fl p Ar prefix .Op Fl r Ar root .Op Fl s Ar string .Ar input .Op Ar base_uri .Sh "توضیحات (DESCRIPTION)" .Nm یک ابزار سریع خط فرمان برای پردازش و جریان‌سازی (streaming) داده‌های RDF است. این ابزار یک سند RDF را می‌خواند و داده‌ها را، احتمالاً تبدیل‌یافته و/یا با نحوی متفاوت، در خروجی استاندارد (stdout) می‌نویسد. به‌طور پیش‌فرض، نحو ورودی از روی پسوند فایل حدس زده می‌شود، و خروجی در قالب NTriples یا NQuads نوشته می‌شود. .Pp .Nm می‌تواند برای بررسی خطاهای نحوی، تبدیل از یک نحو به نحو دیگر، زیبانویسی اسناد، یا تبدیل URIها و شناسه‌های گره‌های ناشناس (blank node IDs) استفاده شود. .Pp گزینه‌ها به شرح زیر هستند: .Bl -tag -width 3n .It Fl a نوشتن خروجی ASCII. اگر این گزینه فعال باشد، تمام نویسه‌های غیر ASCII کدگذاری (escape) می‌شوند، حتی اگر نحو خروجی اجازه نوشتن آن‌ها را در UTF-8 بدهد. .It Fl b نوشتن خروجی به صورت دسته‌ای (bulk). اگر این گزینه فعال باشد، خروجی به جای بایت‌به‌بایت، صفحه‌به‌صفحه نوشته خواهد شد. .It Fl c Ar prefix حذف .Ar prefix از شناسه‌های تطبیق‌یافته‌ی گره‌های ناشناس (blank node IDs). این گزینه معمولاً برای معکوس کردن اثرات .Fl p به کار می‌رود. برای نمونه، با .Ar prefix .Dq doc01 ، گره ناشناس .Li _:doc01b42 به صورت .Li _:b42 صادر خواهد شد. .It Fl e خواندن ورودی به صورت نویسه‌به‌نویسه، به جای حالت پیش‌فرض که صفحه‌به‌صفحه است. این قابلیت هنگام خواندن از یک لوله (pipe) مفید است، چرا که خروجی به محض رسیدن ورودی تولید می‌شود و منتظر رسیدن یک صفحه کامل از ورودی نمی‌ماند. با این گزینه، serdi یک صفحه حافظه کمتری مصرف می‌کند، اما به احتمال زیاد به طور قابل توجهی کندتر خواهد بود. .It Fl f حالت سریع و آزاد برای URI: حفظ کامل URIها (بدون واجد شرایط کردن یا نسبی ساختن)، و عبور دادن نام‌های پیشونددار دقیقاً به همان صورت موجود. .It Fl h چاپ گزینه‌های خط فرمان. .It Fl i Ar syntax خواندن ورودی با نحو .Ar syntax . بزرگی و کوچکی حروف نادیده گرفته می‌شود؛ مقادیر معتبر عبارتند از: .Dq NQuads ، .Dq NTriples ، .Dq TriG ، .Dq Turtle . .It Fl l تجزیه با سهل‌گیری (غیرسخت‌گیرانه). اگر فعال باشد، برای خطاهای نحوی قابل جبران یک هشدار چاپ می‌شود، اما در صورت امکان تجزیه از عبارت بعدی ادامه می‌یابد. توجه داشته باشید که هنگام استفاده از این گزینه ممکن است داده‌ها از دست بروند. .It Fl o Ar syntax نوشتن خروجی با نحو .Ar syntax . بزرگی و کوچکی حروف نادیده گرفته می‌شود؛ مقادیر معتبر عبارتند از: .Dq NQuads ، .Dq NTriples ، .Dq TriG ، .Dq Turtle . .It Fl p Ar prefix افزودن .Ar prefix به شناسه‌های گره‌های ناشناس (blank node IDs). این گزینه می‌تواند برای جلوگیری از تداخل بین شناسه گره‌های ناشناس در اسناد ورودی استفاده شود. اثرات آن را می‌توان در اجرای بعدی با .Fl c معکوس کرد. برای نمونه، با .Ar prefix .Dq doc01 ، گره ناشناس .Li _:b42 به صورت .Li _:doc01b42 صادر خواهد شد. .It Fl q نادیده گرفتن و فرونشاندن تمام خروجی‌ها به‌جز داده‌ها. .It Fl r Ar root نگه‌داشتن URIهای نسبی درون یک .Ar root URI. این کار از ایجاد هرگونه ارجاع URI نسبی با بخش‌های آغازین مسیر مانند .Pa ../ که وارد والدی از .Ar root می‌شوند، جلوگیری می‌کند. .Pp برای نمونه، اگر .Pa /home/you/file.ttl با استفاده از URI پایه مقصد در فایل .Pa /home/me/output.ttl نوشته شود، می‌تواند به صورت .Li <../you/file.ttl> نوشته شود. تنظیم .Fl r Li file:///home/me/ از .Dq فرار کردن این‌گونه ارجاعات جلوگیری می‌کند، بنابراین مورد بالا در عوض به صورت .Li نوشته خواهد شد، چرا که نمی‌تواند به طور نسبی نسبت به URI ریشه بیان شود. .Pp این گزینه برای نگه‌داشتن ارجاعات نسبی درون یک دایرکتوری مشخص مفید است. .It Fl s Ar string تجزیه ورودی .Ar string به جای یک فایل (به گزینه‌ها خاتمه می‌دهد). .It Fl v نمایش اطلاعات نسخه و خروج. .El .Sh "وضعیت خروج (EXIT STATUS)" .Nm در صورت موفقیت با وضعیت 0 و در صورت بروز خطا با مقداری غیر صفر خارج می‌شود. .Sh "مثال‌ها (EXAMPLES)" .Bl -tag -width 3n .It زیبانویسی یک سند: .Nm Fl o .Ar turtle .Pa file.ttl > .Pa out.ttl .It چاپ هرگونه خطا: .Nm Pa file.ttl > .Pa /dev/null .El .Sh "همچنین ببینید (SEE ALSO)" .Bl -item -compact .It .Lk http://drobilla.net/software/serd .It .Lk http://gitlab.com/drobilla/serd .El .Sh "استانداردها (STANDARDS)" .Bl -item .It .Rs .%A W3C .%T RDF 1.1 NQuads .%D February 2014 .Re .Lk https://www.w3.org/TR/n-quads .It .Rs .%A W3C .%D February 2014 .%T RDF 1.1 NTriples .Re .Lk https://www.w3.org/TR/n-triples .It .Rs .%A W3C .%T RDF 1.1 TriG .%D February 2014 .Re .Lk https://www.w3.org/TR/trig .It .Rs .%A W3C .%D February 2014 .%T RDF 1.1 Turtle .Re .Lk https://www.w3.org/TR/turtle .El .Sh "نویسندگان (AUTHORS)" .Nm بخشی از serd است که توسط .An David Robillard .Aq Mt d@drobilla.net نوشته شده است.