فضاهای نامی در XML 1.1 (ویرایش دوم)

1.1 یادداشتی در نشانه گذاری و کاربرد

جایی که تاکید شده، کلید واژه های MUST, MUST NOT, REQUIRED, SHOULD, SHOULD NOT, MAY در این سند بگونه ای که در [Keywords] توصیف شده، تعبیر شده اند.

آن نکته ای که بسیاری از غیر پایانی ها در این مشخصه نه اینجا بلکه در مشخصه XML تعیین شده اند [XML]. هنگامی که غیر پایانی های تعیین شده در اینجا نامهای یکسانی بعنوان غیر پایانی های تعیین شده در مشخصه ی XML دارند، تولیدات اینجا در تمام موارد سازگار یک زیر مجموعه از رشته ها توسط یکاهای قرینه ی آنجا هماهنگ شده اند.

در این تولیدات سند، NSC یک "محدودیت فضای نامی است"، یکی از قواعدی که اسناد مطابق با این خصوصیات می بایستی ادامه دهند.

2.1 مفاهیم بنیادی

[تعریف: یک فضای نامی XML توسط یک مرجع IRI آی آر آی [RFC3987] شناسایی شده است؛ نامهای ویژگی و عنصر می توانند در یک فضای نامی کاربردی XML سازوکار توصیف شده در این خصوصیات را بکار بر ند.]

[تعریف: یک نام توسعه یافته جفتی شامل یک نام فضای نامی و یک نام محلی است. ] [تعریف: برای یک نام  N در یک فضای نامی شناخته شده توسط یک IRI I, نام فضای نامی است I. برای یک نام  N که در یک فضای نامی نیست، نام فضای نامی مقدار ندارد.] [تعریف: در هر صورت نام محلی هست  N. ] که این ترکیبی از فضای نامی IRI اداره شده بطور کلی با نامهای محلی فهرست لغاتی است که در پیشگیری از تلاقی نام موثر است.

مراجع IRI می توانند حاوی کاراکترهای غیر مجاز در نامها باشند، و غالب اوقات بطور نامناسبی بلندند، بنابراین نامهای توسعه یافته مستقیما جهت عناصر نام و ویژگیها در اسناد XML استفاده نشده اند. در عوض نامهای مناسب بکار برده شده اند. [تعریف: یک نام مناسب نامی در رابطه با تفسیر فضای نامی است.] در انطباق اسناد با این خصوصیات، نامهای ویژگی و عنصر بصورت نامهای واجد شرایط ظاهر می شوند. از نظر نگارش، آنها هر یک از نامهای پیشوندی یا نامهای غیر پیشوندی هستند. یک اعلان نحوی مبنی بر ویژگی است به شرط آنکه پیشوندها جهت نامهای فضای نامی و جهت فضای نامی پیش فرض که جهت نامهای عنصر غیر پیشوندی درخواست شده مقید شده باشند؛ این اعلانها توسط عناصری که روی آنها ظاهر می شوند محدود می گردند برای اینکه مقید سازی های متفاوت ممکن است در قسمتهای مختلف یک سند اعمال گردند. انطباق پردازنده ها به این خصوصیات  بایستی تصدیق شده و روی این اعلانها و پیشوندها اعمال شوند.

2.2 کاربرد IRI ها بعنوان نامهای فضای نامی

رشته ی خالی، در هر صورت یک مرجع مجاز IRI است، نمی تواند بعنوان یک نام فضای نامی استفاده شود.

کاربرد مراجع مربوطه ی IRI، شامل مراجع سند یکسان، در اعلانهای فضای نامی ناپسند شمرده می شود.

2.3 مقایسه ی مراجع IRI

مراجع IRI تعیین کننده ی فضاهای نامی مقایسه شده می باشند هنگامی که تصمیم می گیرند که یک نام متعلق به یک فضای نامی معین و چه دو نام مرتبط با فضای نام یکسان باشد. [تعریف: دو IRI بعنوان رشته ها مورد عمل قرار گرفته اند، و آنها یکسان هستند اگر و تنها اگر رشته ها همانند هم می باشند، آن است که گفته شود، در صورتی که رشته کاراکترهای یکسانی دارند. ] مقایسه نسبت به بزرگ یا کوچک بودن حروف حساس است و بدون %-escaping انجام شده یا ناتمام مانده است.

یک نتیجه ی این آن است که مراجع IRI که در این مفهوم یکسان نیستند می توانند حل کننده ی منابع همانند باشند. مثالها شامل مراجع IRI هستند که تنها در مورد یا %-escaping یا در موجودیتهای خارجی متفاوتند که URI های پایه ی مختلفی دارند (اما توجه داشته باشید که IRI های خویشاوند به گونه ی نامهای فضای نام بد دانسته شده اند).

در یک اعلان فضای نامی، مرجع IRI  مقدار معمولی از ویژگی، بعنوان جانشین کاراکتر XML و مراجع موجود است که قبل از هر مقایسه ای انجام داده شده است.

مثالها:

مراجع IRI ذیل همگی برای مفاهیم فضاهای نامی معین متفاوتند، چون آنها در صورت فرق دارند:

• http://www.example.org/wine

• http://www.Example.org/wine

• http://www.example.org/Wine

مراجع IRI ذیل نیز همگی برای مفاهیم فضاهای نامی معین تفاوت دارند:

• http://www.example.org/rosé

• http://www.example.org/ros%c3%a9

• http://www.example.org/ros%c3%A9

• http://www.example.org/ros%C3%a9

• http://www.example.org/ros%C3%A9

به گونه ای که اینها هستند:

• http://www.example.org/~wilbur

• http://www.example.org/%7ewilbur

• http://www.example.org/%7Ewilbur

اگر eacute جهت é تعیین شده، تگهای شروعی ذیل همگی محتوی اعلانهای فضای نامی اتصالی پیشوندی p جهت مرجع IRI یکسان اند، http://example.org/rosé.

• <p:foo xmlns:p="http://example.org/rosé">

• <p:foo xmlns:p="http://example.org/ros&#xe9;">

• <p:foo xmlns:p="http://example.org/ros&#xE9;">

• <p:foo xmlns:p="http://example.org/ros&#233;">

• <p:foo xmlns:p="http://example.org/ros&eacute;">

بدین دلیل ریسک بی نظمی میان IRI ها که خواستار برابری هستند اگر مراجعه ای نشده، کاربرد کاراکترهای %-escaped در نامهای فضای نامی شدیدا کاسته شده است.

6.1 محدوده ی فضای نامی

محدوده ی یک اعلان فضای نامی اعلان کننده ی یک پیشوند توسعه یافته ها مطابق آغاز تگ شروع چنان بنظر می رسد که تا انتهای مشابه تگ پایان، به استثنای محدوده ی هر اعلان داخلی با قسمت NSAttName یکسان باشد. در مورد یک تگ خالی،  محدوده خود تگ است.

چنین اعلان فضای نامی ای جهت تمام نامهای ویژگی و عنصر درون محدوده اش که مربوط به سازگاریهای پیشوندی تعیین شده ی آن در اعلان می باشد، بکار می رود.

نام بسط یافته مطابق با یک نام ویژگی یا عنصر پیشوند شده IRI ای را داراست که پیشوند بصورت نام فضای نامی خودش، و قسمت محلی بصورت نام محلی اش محدود شده است.

<?xml version="1.1"?>

<html:html xmlns:html='http://www.w3.org/1999/xhtml'>

  <html:head><html:title>Frobnostication</html:title></html:head>
  <html:body><html:p>Moved to 
    <html:a href='http://frob.example.com'>here.</html:a></html:p></html:body>

</html:html>

چندین پیشوند فضای نامی می توانند بصورت ویژگیهای یک عنصر واحد، همچون در این نمونه نشان داده شوند:

<?xml version="1.1"?>
<!-- both namespace prefixes are available throughout -->
<bk:book xmlns:bk='urn:loc.gov:books'
         xmlns:isbn='urn:ISBN:0-395-36341-6'>
    <bk:title>Cheaper by the Dozen</bk:title>
    <isbn:number>1568491379</isbn:number>

</bk:book>

مقدار ویژگی در یک اعلان فضای نامی برای یک پیشوند می تواند تهی باشد. این اثر را در محدوده ی اعلان، از رفع هر نوع پیوند پیشوند با یک نام فضای نامی دارا است. بیشتر اعلانها می توانند دوباره پیشوند را از نو اعلان نمایند:

<?xml version="1.1"?>
<x xmlns:n1="http://www.w3.org">
    <n1:a/>               <!-- legal; the prefix n1 is bound to http://www.w3.org -->

    <x xmlns:n1="">
        <n1:a/>           <!-- illegal; the prefix n1 is not bound here -->
	<x xmlns:n1="http://www.w3.org">
            <n1:a/>       <!-- legal; the prefix n1 is bound again -->
        </x>

    </x>
</x>

6.2 پیش فرضی فضای نامی

محدوده ی یک اعلان فضای نامی پیش فرض بواسطه ی آغاز تگ  شروعی که در آن تا انتهای مشابه تگ پایانی ظاهر می شود، بجز محدوده ی هر یک از اعلانهای فضای نامی پیش فرض درونی، توسعه می یابد. در مورد یک تگ خالی، محدوده خود تگ است.

یک اعلان فضای نامی پیش فرض تمامی نامهای عنصر غیر پیشوندی درون محدوده اش را درخواست می کند. اعلانهای فضای نامی پیش فرض مستقیما نامهای ویژگی را درخواست نمی نمایند؛ تفسیر ویژگیهای غیر پیشوندی توسط عنصر که بر روی آنها ظاهر می شود، قطعی است.

اگر در آنجا یک اعلان فضای نامی پیش فرض در محدوده است، نام بسط یافته مطابق با یک نام عنصر پیشوندی دارای IRI از فضای نامی پیش فرض بصورت نام فضای نامی است. اگر در آنجا اعلان فضای نامی پیش فرض در محدوده نیست، نام فضای نامی بدون مقدار است. نام فضای نامی همواره برای یک نام ویژگی غیر پیشوندی بدون مقدار است. در تمام موارد، نام محلی   قسمت محلی است (که البته بصورت نام غیر پیشوندی خودش مشابه است).

<?xml version="1.1"?>

<!-- elements are in the HTML namespace, in this case by default -->
<html xmlns='http://www.w3.org/1999/xhtml'>
  <head><title>Frobnostication</title></head>
  <body><p>Moved to 
    <a href='http://frob.example.com'>here</a>.</p></body>

</html>

<?xml version="1.1"?>
<!-- unprefixed element types are from "books" -->
<book xmlns='urn:loc.gov:books'
      xmlns:isbn='urn:ISBN:0-395-36341-6'>
    <title>Cheaper by the Dozen</title>
    <isbn:number>1568491379</isbn:number>

</book>

مثالی کامل تر از نقل فضای نامی:

<?xml version="1.1"?>
<!-- initially, the default namespace is "books" -->
<book xmlns='urn:loc.gov:books'
      xmlns:isbn='urn:ISBN:0-395-36341-6'>
    <title>Cheaper by the Dozen</title>
    <isbn:number>1568491379</isbn:number>

    <notes>
      <!-- make HTML the default namespace for some commentary -->
      <p xmlns='http://www.w3.org/1999/xhtml'>
          This is a <i>funny</i> book!
      </p>

    </notes>
</book>

مقدار ویژگی در یک اعلان فضای نامی پیش فرض می تواند تهی باشد. این اثر یکسانی دارد، درون محدوده ی اعلان از آنجا فضای نامی پیش فرض موجود نیست.

<?xml version='1.1'?>
<Beers>
  <!-- the default namespace inside tables is that of HTML -->

  <table xmlns='http://www.w3.org/1999/xhtml'>
   <th><td>Name</td><td>Origin</td><td>Description</td></th>

   <tr> 
     <!-- no default namespace inside table cells -->
     <td><brandName xmlns="">Huntsman</brandName></td>
     <td><origin xmlns="">Bath, UK</origin></td>

     <td>
       <details xmlns=""><class>Bitter</class><hop>Fuggles</hop>
         <pro>Wonderful hop, light alcohol, good summer beer</pro>

         <con>Fragile; excessive variance pub to pub</con>
         </details>
        </td>
      </tr>
    </table>

  </Beers>

6.3 یگانگی ویژگیها

در انطباق اسناد XML با این خصوصیات، هیچ تگی نمی تواند دربرگیرنده ی دو ویژگی باشد که:

1. نامهای یکسان دارد یا

2. دارای نامهای واجد شرایط با قسمت محلی یکسان با پیشوندها است که مقید به نامهای فضای نامی بوده اند که همانند هستند.

این محدودیت برابر با تقاضای آن بدون عنصر دارای دو ویژگی با نام بسط یافته ی یکسان است.

برای مثال، هر یک از تگهای عنصر تهی bad در ذیل غیر مجازند:

<!-- http://www.w3.org is bound to n1 and n2 -->
<x xmlns:n1="http://www.w3.org" 
   xmlns:n2="http://www.w3.org" >
  <bad a="1"     a="2" />
  <bad n1:a="1"  n2:a="2" />

</x>

بهرحال، هر یک از تگهای ذیل مجازند، دوما برای اینکه نامهای پیش فرض نمی توانند به نامهای ویژگی اشاره نمایند:

<!-- http://www.w3.org is bound to n1 and is the default -->
<x xmlns:n1="http://www.w3.org" 
   xmlns="http://www.w3.org" >
  <good a="1"     b="2" />
  <good a="1"     n1:a="2" />
</x>