https://clementgodbarge.com/fa/tag/viaf/VIAFHugoBlox Kit (https://hugoblox.com)faFri, 28 Mar 2025 00:00:00 +0000https://clementgodbarge.com/media/icon_hu_64a6c3bec25b3d7b.pnghttps://clementgodbarge.com/fa/tag/viaf/https://clementgodbarge.com/fa/code/persnamer/Fri, 28 Mar 2025 00:00:00 +0000https://clementgodbarge.com/fa/code/persnamer/<h2 id="persnamer-پیوند-tei-به-virtual-international-authority-file">persNamer: پیوند TEI به Virtual International Authority File</h2> <p> </p> <p>persNamer ابزار تخصصی پایتونی است که وارد کردن داده‌های مستند اشخاص از VIAF (Virtual International Authority File) به اسناد TEI XML را ساده می‌کند. persNamer با تبدیل شناسه‌های VIAF به نشانه‌گذاری آمادهٔ TEI، کار دستیِ ساختن مدخل‌های ساخت‌یافتهٔ اشخاص برای نسخه‌های علمی دیجیتال را به‌طور چشمگیری کاهش می‌دهد.</p> <h2 id="چالش-کنترل-مستندات-در-tei">چالش کنترل مستندات در TEI</h2> <p>نسخه‌های علمی دیجیتال اغلب به شناسایی دقیق اشخاص تاریخی، از جمله نام استاندارد و تاریخ تولد و مرگشان، نیاز دارند. حفظ کنترل مستندات یکدست در سراسر یک پروژه مستلزم این‌هاست:</p> <ol> <li>شناسایی اشخاص در متون تاریخی</li> <li>یافتن داده‌های مستند درباره‌شان</li> <li>ساختن مدخل‌های TEI با قالب درست</li> <li>تضمین یکدستی ارجاع‌ها در سراسر پروژه</li> </ol> <p>این گام‌ها معمولاً دستی، وقت‌گیر و مستعد ناهماهنگی‌اند.</p> <h2 id="persnamer-چگونه-کار-میکند">persNamer چگونه کار می‌کند</h2> <p>persNamer این گردش کار را چنین خودکار می‌کند:</p> <ol> <li><strong>دریافت داده‌های VIAF</strong>: با گرفتن یک شناسهٔ VIAF، ابزار داده‌های RDF را از طریق مذاکرهٔ محتوای HTTP بازیابی می‌کند</li> <li><strong>استخراج اطلاعات کلیدی</strong>: RDF را تجزیه می‌کند تا نام ترجیحی، تاریخ تولد و تاریخ مرگ را بیرون بکشد</li> <li><strong>تولید نشانه‌گذاری TEI</strong>: دو قطعهٔ XML اساسی می‌سازد: <ul> <li>یک <strong>مدخل فایل مستندات</strong> (عنصر <code>&lt;person&gt;</code> با یک <code>xml:id</code> تولیدشده، <code>&lt;persName&gt;</code>، <code>&lt;birth&gt;</code>، <code>&lt;death&gt;</code> و <code>&lt;idno type=&quot;VIAF&quot;&gt;</code>)</li> <li>یک <strong>برچسب حاشیه‌نویسی</strong> جداگانه (<code>&lt;persName&gt;</code> با صفت <code>ref</code> که به مدخل مستندات ارجاع می‌دهد)</li> </ul> </li> </ol> <p>این خروجی دوگانه به مصححان امکان می‌دهد فایل مستندات متمرکزی نگه دارند و در عین حال برچسب‌های حاشیه‌نویسی را به‌آسانی در متون TEI خود بگنجانند.</p> <h2 id="ویژگیهای-کلیدی">ویژگی‌های کلیدی</h2> <ul> <li><strong>تولید شناسهٔ استاندارد</strong>: شناسه‌های XML یکدستی در قالب <code>pers-[familyname]-[givenname initial]</code> می‌سازد (مثلاً <code>pers-deteligny-c</code>)</li> <li><strong>تجزیهٔ RDF</strong>: با <code>rdflib</code> اطلاعات را از ویژگی‌های گوناگون RDF (مثلاً <code>rdfs:label</code>، <code>schema:name</code>، <code>viaf:mainHead</code>) استخراج می‌کند</li> <li><strong>رابط خط فرمان</strong>: اجرای ساده، با شمارهٔ VIAF به‌عنوان تنها آرگومان الزامی</li> <li><strong>خروجی مشروح</strong>: در کنار خروجی نهایی XML، اطلاعات تفصیلی پردازش را نیز نشان می‌دهد</li> </ul> <h2 id="نمونه-کاربرد">نمونهٔ کاربرد</h2> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">python persNamer.py <span class="m">314802260</span> </span></span></code></pre></div><p>این فرمان چنین خروجی‌ای می‌دهد:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-xml" data-lang="xml"><span class="line"><span class="cl"><span class="nt">&lt;person</span> <span class="na">xml:id=</span><span class="s">&#34;pers-deteligny-c&#34;</span><span class="nt">&gt;</span> </span></span><span class="line"><span class="cl"> <span class="nt">&lt;persName&gt;</span>Charles deTéligny<span class="nt">&lt;/persName&gt;</span> </span></span><span class="line"><span class="cl"> <span class="nt">&lt;birth&gt;</span>1535<span class="nt">&lt;/birth&gt;</span> </span></span><span class="line"><span class="cl"> <span class="nt">&lt;death&gt;</span>1572-08-24<span class="nt">&lt;/death&gt;</span> </span></span><span class="line"><span class="cl"> <span class="nt">&lt;idno</span> <span class="na">type=</span><span class="s">&#34;VIAF&#34;</span><span class="nt">&gt;</span>314802260<span class="nt">&lt;/idno&gt;</span> </span></span><span class="line"><span class="cl"><span class="nt">&lt;/person&gt;</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="nt">&lt;persName</span> <span class="na">ref=</span><span class="s">&#34;#pers-deteligny-c&#34;</span><span class="nt">&gt;</span>Charles deTéligny<span class="nt">&lt;/persName&gt;</span> </span></span></code></pre></div><h2 id="کاربرد-در-علوم-انسانی-دیجیتال">کاربرد در علوم انسانی دیجیتال</h2> <p>persNamer به‌ویژه برای این‌ها ارزشمند است:</p> <ul> <li>نسخه‌های علمی دیجیتال که به کنترل مستندات نیاز دارند</li> <li>پروژه‌های رمزگذاری TEI که با شخصیت‌های تاریخی سروکار دارند</li> <li>ابتکارهای داده‌های پیوندی که اسناد را به رکوردهای مستند وصل می‌کنند</li> <li>تضمین یکدستی در پیکره‌های بزرگ TEI</li> <li>آموزش مفاهیم کنترل مستندات در درس‌های علوم انسانی دیجیتال</li> </ul> <h2 id="پیادهسازی">پیاده‌سازی</h2> <p>persNamer به Python نوشته شده و به این‌ها وابسته است:</p> <ul> <li><code>requests</code> برای درخواست‌های HTTP</li> <li><code>rdflib</code> برای تجزیهٔ RDF</li> <li><code>lxml</code> برای کار با XML</li> </ul> <p>کد منبع و مستندات را در بیابید.</p>