https://clementgodbarge.com/ar/tag/xml/XMLHugoBlox Kit (https://hugoblox.com)arSun, 15 Mar 2026 00:00:00 +0000https://clementgodbarge.com/media/icon_hu_64a6c3bec25b3d7b.pnghttps://clementgodbarge.com/ar/tag/xml/https://clementgodbarge.com/ar/code/tei-mcp/Sun, 15 Mar 2026 00:00:00 +0000https://clementgodbarge.com/ar/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> عن أي عنصر أو صنف أو ماكرو أو وحدة (module) بالاسم، مع مطابقة لا تفرّق بين حالتي الأحرف واقتراحات لتصويب الأخطاء الإملائية</li> <li><strong>حل السمات</strong> عبر التسلسل الهرمي الكامل لأصناف TEI (المحلية والموروثة معًا)</li> <li><strong>بسط نماذج المحتوى</strong> في أشجار مهيكلة مع حل الأصناف والماكروات</li> <li><strong>التحقق من التداخل</strong> — علاقة الأصل بالفرع مباشرةً، أو إمكانية البلوغ تعاوديًّا مع تتبع المسار</li> <li><strong>التحقق من صحة الوثائق</strong> وفق TEI P5: نماذج المحتوى، والسمات، وقوائم القيم المغلقة، وسلامة الإحالات، وتحذيرات الإهمال (deprecation)</li> <li><strong>التحقق من صحة عنصر مفرد</strong> لمن يحرّر خطوةً خطوة</li> <li><strong>تحميل تخصيصات ODD</strong> لحصر المخطط في مجموعة فرعية خاصة بمشروع بعينه</li> <li><strong>البحث</strong> في أنواع الكيانات كافة بالتعابير النمطية</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/ar/code/multi-saxon/Fri, 28 Mar 2025 00:00:00 +0000https://clementgodbarge.com/ar/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). وقد صُمّم خصيصًا للمجموعات الكبيرة من وثائق 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 الصادرة عن مبادرة ترميز النصوص (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 العقبتين معًا: إذ يستثمر قدرات Saxon المتقدمة في XSLT، ويوزّع المعالجة على أنوية عدة، فيكسب في الأداء كسبًا كبيرًا.</p> <h2 id="التنفيذ">التنفيذ</h2> <p>يزاوج Multi-Saxon بين Python ومعالج Saxon المكتوب بلغة Java ليبني خط تحويل عالي الأداء:</p> <ul> <li>يستخدم مكتبة Saxon الخاصة بـJava لمعالجة XSLT 2.0/3.0 معالجة متينة</li> <li>يعتمد المعالجة المتعددة (multiprocessing) لتوزيع التحويلات على ما يتاح من أنوية المعالج</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>يتيح Multi-Saxon لمشاريع الإنسانيات الرقمية التي تعالج مجموعات كبيرة من وثائق TEI:</p> <ul> <li>تحويلات معقدة على نطاق المدونة كلها ما كانت لتتأتى مع LXML</li> <li>أزمنة معالجة أقصر بكثير (غالبًا بمعامل 5 إلى 10 أضعاف على الأنظمة متعددة الأنوية)</li> <li>تحليلًا أرقى بفضل الميزات المتقدمة في XSLT 2.0/3.0</li> <li>سير عمل أبسط لمعالجة مجموعات الوثائق بأكملها</li> </ul> <p>تجدون الشيفرة المصدرية والتوثيق في .</p>https://clementgodbarge.com/ar/code/persnamer/Fri, 28 Mar 2025 00:00:00 +0000https://clementgodbarge.com/ar/code/persnamer/<h2 id="persnamer-وصل-tei-بالملف-الاستنادي-الدولي-الافتراضي">persNamer: وصل TEI بالملف الاستنادي الدولي الافتراضي</h2> <p> </p> <p>persNamer أداة متخصصة بلغة Python تيسّر إدماج بيانات الأشخاص الاستنادية من VIAF (الملف الاستنادي الدولي الافتراضي) في وثائق TEI XML. فهي تحوّل معرّفات 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>