https://clementgodbarge.com/fa/tag/xml/XMLHugoBlox Kit (https://hugoblox.com)faSun, 15 Mar 2026 00:00:00 +0000https://clementgodbarge.com/media/icon_hu_64a6c3bec25b3d7b.pnghttps://clementgodbarge.com/fa/tag/xml/https://clementgodbarge.com/fa/code/tei-mcp/Sun, 15 Mar 2026 00:00:00 +0000https://clementgodbarge.com/fa/code/tei-mcp/<h2 id="tei-mcp-استاندارد-tei-p5-برای-عاملهای-هوش-مصنوعی">tei-mcp: استاندارد TEI P5 برای عامل‌های هوش مصنوعی</h2> <p>tei-mcp سرور متن‌بازی است که به دستیارهای برنامه‌نویسی هوش مصنوعی دسترسی مستقیم به مشخصات می‌دهد. هوش مصنوعی به جای تکیه بر داده‌های آموزشی به‌خاطرسپرده — که اغلب نشانه‌گذاری موجه‌نما اما نادرست تولید می‌کند — می‌تواند مشخصات را در لحظه پرس‌وجو کند.</p> <h2 id="امکانات">امکانات</h2> <p>سرور ODD استاندارد TEI P5 را تجزیه می‌کند و 16 ابزار در اختیار می‌گذارد:</p> <ul> <li><strong>جست‌وجوی</strong> هر عنصر، کلاس، ماکرو یا پیمانه با نام، بدون حساسیت به حروف بزرگ و کوچک و با پیشنهاد اصلاح غلط‌های تایپی</li> <li><strong>تعیین صفت‌ها</strong> در سراسر سلسله‌مراتب کلاس‌های TEI (محلی + به‌ارث‌رسیده)</li> <li><strong>بسط مدل‌های محتوا</strong> به درخت‌های ساخت‌یافته با تعیین کلاس‌ها و ماکروها</li> <li><strong>اعتبارسنجی تودرتویی</strong> — رابطهٔ مستقیم والد–فرزند یا دسترس‌پذیری بازگشتی با ردیابی مسیر</li> <li><strong>اعتبارسنجی اسناد</strong> در برابر TEI P5: مدل‌های محتوا، صفت‌ها، فهرست‌های بستهٔ مقادیر، یکپارچگی ارجاع‌ها و هشدارهای منسوخ‌شدگی</li> <li><strong>اعتبارسنجی تک‌عنصرها</strong> برای گردش‌های کاری ویرایش تدریجی</li> <li><strong>بارگذاری سفارشی‌سازی‌های ODD</strong> برای محدود کردن شِما به زیرمجموعهٔ خاص یک پروژه</li> <li><strong>جست‌وجو</strong> در همهٔ انواع موجودیت‌ها با الگوهای regex</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">pip install tei-mcp </span></span></code></pre></div><p>یا اجرای مستقیم با:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">uvx tei-mcp </span></span></code></pre></div><h2 id="کاربرد">کاربرد</h2> <p>به هر کلاینت سازگار با MCP (Claude، Cursor، Windsurf و جز آن) بیفزایید:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-json" data-lang="json"><span class="line"><span class="cl"><span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;mcpServers&#34;</span><span class="p">:</span> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;tei&#34;</span><span class="p">:</span> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;command&#34;</span><span class="p">:</span> <span class="s2">&#34;uvx&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;args&#34;</span><span class="p">:</span> <span class="p">[</span><span class="s2">&#34;tei-mcp&#34;</span><span class="p">]</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"><span class="p">}</span> </span></span></code></pre></div><p>کد منبع و مستندات را در بیابید.</p>https://clementgodbarge.com/fa/code/multi-saxon/Fri, 28 Mar 2025 00:00:00 +0000https://clementgodbarge.com/fa/code/multi-saxon/<h2 id="multi-saxon-پردازش-موازی-xslt-برای-پیکرههای-بزرگ-tei">Multi-Saxon: پردازش موازی XSLT برای پیکره‌های بزرگ TEI</h2> <p>Multi-Saxon خلأ مهمی را در ابزارهای پردازش XML پر می‌کند: اجرای موازی تبدیل‌های XSLT 2.0 و 3.0 که LXML (کتابخانهٔ پرکاربرد XML در Python) از عهده‌شان برنمی‌آید. Multi-Saxon که به‌طور خاص برای مجموعه‌های بزرگ اسناد XML TEI طراحی شده، با اجرای موازیِ بهینه زمان پردازش را به‌طور چشمگیری کوتاه می‌کند.</p> <h2 id="ویژگیهای-کلیدی">ویژگی‌های کلیدی</h2> <ul> <li><strong>پشتیبانی پیشرفتهٔ XSLT</strong>: تبدیل‌های XSLT 2.0 و 3.0 را فراتر از توانایی‌های LXML پردازش می‌کند</li> <li><strong>پردازش موازی</strong>: زمان تبدیل مجموعه‌های بزرگ اسناد را با موازی‌سازی به‌شدت کاهش می‌دهد</li> <li><strong>بهینه برای TEI</strong>: به‌طور خاص برای اسناد XML استاندارد Text Encoding Initiative (TEI) مهندسی شده است</li> <li><strong>کارایی مقیاس‌پذیر</strong>: پیکره‌هایی از صدها تا هزاران سند را به‌خوبی مدیریت می‌کند</li> <li><strong>چندسکویی</strong>: در سیستم‌عامل‌ها و محیط‌های گوناگون کار می‌کند</li> </ul> <h2 id="مشکلی-که-multi-saxon-حل-میکند">مشکلی که Multi-Saxon حل می‌کند</h2> <p>پژوهشگران علوم انسانی دیجیتال که با TEI کار می‌کنند اغلب با دو چالش جدی روبه‌رویند:</p> <ol> <li>LXML (کتابخانهٔ رایج پردازش XML در Python) تنها از XSLT 1.0 پشتیبانی می‌کند و استفاده از امکانات پیشرفته‌تر XSLT 2.0/3.0 را ناممکن می‌سازد</li> <li>پردازش ترتیبی پیکره‌های بزرگ اسناد TEI می‌تواند به‌طرزی بازدارنده زمان‌بر باشد</li> </ol> <p>Multi-Saxon هر دو مشکل را حل می‌کند: از توانایی‌های پیشرفتهٔ XSLT در Saxon بهره می‌گیرد و پردازش را میان چند هسته توزیع می‌کند تا کارایی به‌طور چشمگیری بالا رود.</p> <h2 id="پیادهسازی">پیاده‌سازی</h2> <p>Multi-Saxon، Python را با پردازشگر Saxon جاوا ترکیب می‌کند تا خط لولهٔ تبدیلی پرکارایی بسازد:</p> <ul> <li>از کتابخانهٔ Saxon جاوا برای پردازش استوار XSLT 2.0/3.0 استفاده می‌کند</li> <li>با چندپردازشی، تبدیل‌ها را میان هسته‌های CPU در دسترس توزیع می‌کند</li> <li>استخرهای پردازشگر را به‌طور بهینه مدیریت می‌کند تا توان عملیاتی به بیشینه برسد</li> <li>رابطی ساده برای پردازش دسته‌ای اسناد TEI فراهم می‌کند</li> </ul> <h2 id="نمونه-کاربرد">نمونهٔ کاربرد</h2> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"><span class="line"><span class="cl"><span class="kn">from</span> <span class="nn">multi_saxon</span> <span class="kn">import</span> <span class="n">MultiSaxon</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Initialize with your XSLT stylesheet</span> </span></span><span class="line"><span class="cl"><span class="n">transformer</span> <span class="o">=</span> <span class="n">MultiSaxon</span><span class="p">(</span><span class="s2">&#34;transform.xsl&#34;</span><span class="p">)</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Transform a single document</span> </span></span><span class="line"><span class="cl"><span class="n">transformer</span><span class="o">.</span><span class="n">transform</span><span class="p">(</span><span class="s2">&#34;input.xml&#34;</span><span class="p">,</span> <span class="s2">&#34;output.xml&#34;</span><span class="p">)</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Transform an entire directory in parallel</span> </span></span><span class="line"><span class="cl"><span class="n">transformer</span><span class="o">.</span><span class="n">transform_directory</span><span class="p">(</span><span class="s2">&#34;input_dir&#34;</span><span class="p">,</span> <span class="s2">&#34;output_dir&#34;</span><span class="p">)</span> </span></span></code></pre></div><h2 id="اهمیت-آن-برای-علوم-انسانی-دیجیتال">اهمیت آن برای علوم انسانی دیجیتال</h2> <p>برای پروژه‌های علوم انسانی دیجیتال که با مجموعه‌های بزرگ اسناد TEI سروکار دارند، Multi-Saxon این‌ها را ممکن می‌کند:</p> <ul> <li>تبدیل‌های پیچیده در سطح کل پیکره که با LXML ناممکن است</li> <li>کاهش چشمگیر زمان پردازش (اغلب 5 تا 10 برابر روی سیستم‌های چندهسته‌ای)</li> <li>تحلیل پیشرفته‌تر به کمک امکانات پیشرفتهٔ XSLT 2.0/3.0</li> <li>گردش کار ساده‌تر برای پردازش کل مجموعه‌های اسناد</li> </ul> <p>کد منبع و مستندات را در بیابید.</p>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>