Жақсы жасалған құжат - Well-formed document

A дұрыс жасалған құжат жылы XML Бұл құжат бұл «ұстануға синтаксис көрсетілген ережелер XML 1.0 физикалық және логикалық құрылымдарды қанағаттандыруы керек сипаттама ».[1]

Талаптар

Негізделген деңгейде дұрыс жасалған құжаттар мыналарды талап етеді:

  • Мазмұны анықталды.
  • Мазмұн басы мен соңы тегімен бөлінеді
  • Мазмұн дұрыс орналастырылған болуы керек (ата-ана тамырында, балалар ата-анада)

Жақсы құрылған құжат болу үшін, ұйымдарды декларациялау мен қарау туралы ережелер белгіленуі керек. Тегтер болып табылады регистрге сезгіш, атрибуттар тырнақшамен бөлінген. Бос элементтерде белгіленген ережелер бар. Қабаттасқан тегтер құжатты жарамсыз етеді. Ең дұрысы, жақсы жасалған құжат XML дизайн мақсаттарына сәйкес келеді. Техникалық сипаттамада келтірілген басқа синтаксистік ережелерге мыналар кіреді:

  • Онда тек дұрыс кодталған заңды Юникод таңбалары бар.
  • Сияқты арнайы синтаксистік символдардың ешқайсысы жоқ < және & олардың белгілеу-бөлу рөлдерін орындау жағдайларын қоспағанда пайда болады.
  • Элементтерді бөлетін басталу, аяқталу және бос элементтер тегтері дұрыс орналастырылған, бірде-біреуі жоқ және бір-біріне сәйкес келмейді.
  • Элементтердің тегтері регистрді ескереді; басы мен соңы тегтері дәл сәйкес келуі керек. Тег атауларында таңбалардың ешқайсысы болмауы керек !"#$%&'()*+,/;<=>?@[\]^`{|}~, бос кеңістіктің таңбасы емес, және басталуы мүмкін емес -, .немесе сандық цифр.
  • Барлық басқа элементтерді қамтитын жалғыз «тамыр» элементі бар.

Жарамды XML құжаты XML спецификациясында дұрыс құрылған XML құжаты ретінде анықталады, ол сонымен қатар ережелеріне сәйкес келеді Құжат түрін анықтау (DTD). JavaCommerce.com XML оқулығына сәйкес «Жақсы құрылған XML құжаттары жай суреттейтін тегтермен парақтарды белгілейді. Сіз бұл тегтердің нені білдіретінін сипаттап немесе түсіндіріп алудың қажеті жоқ. Басқаша айтқанда, жақсы жасалған XML құжатына DTD қажет емес, бірақ ол XML синтаксис ережелеріне сәйкес келуі керек. Егер құжаттағы барлық тегтер дұрыс құрастырылса және XML нұсқауларын сақтаса, онда құжат сонымен қатар қалыптасқан болып саналады. «[2][3]

Жақсы қалыптасқан ережелердің бұзылуына тап болатын XML процессоры осындай қателер туралы есеп беруі және қалыпты өңдеуді тоқтату үшін қажет. Бұл саясат кейде деп аталады дракондық,[4] өңделетін бағдарламалардың мінез-құлқынан айтарлықтай ерекшеленеді HTML, олар қате түзету қателері болған жағдайда да тиімді нәтиже беруге арналған[5] рухында Постель заңы («Жіберген нәрсеңізде консервативті болыңыз; қабылдағаныңызда либералды болыңыз»).[6][4]

Маңыздылығы

Жақсы құрылған құжат тұжырымдамасы XML-дің іргелі құрылысын жақсы түсінуге мүмкіндік береді. Бұл XML-ді оның мағынасынан тыс түсіндіруге көмектеседі. Мысалы, көптеген XML Құжат түрінің анықтамалары сол және оң жақ бұрыштық жақшаларды мазмұнды бөлгіштер ретінде қолданыңыз, бұл қатаң түрде қажет емес (бөлгіш өте қысқа және қысқаша болуы керек). Сол және оң жақ бұрыштық кронштейн кодтары абсолютті талап емес, нақты және ерекше болғанымен шартты болып табылады.

Жақсы құрылған құжат тұжырымдамасы сонымен қатар XML дерексіз табиғатын түсінуге мүмкіндік береді. Шындығында, XML деген ұғым жоқ.[дәйексөз қажет ] Керісінше, XML - бұл мінез-құлық пен тәжірибе жиынтығын бейнелейтін принцип. Құжат түрін анықтау (DTD) аясында көрсетілген XML түрлерін талқылауға болады.

Жақсы құрастырылған құжаттар дұрыс және дұрыс XML мәселесін де басты назарға алады. W3 Ұйымының пікірі бойынша жарамды құжаттар - бұл DTD-ге қарсы қолданылатын құжаттар. Ережелері жарамдылық құжат DTD-де көрсетілген шектеулерге сәйкес келетіндігін білдіреді. Осылайша, тегтер немесе нысандар DTD шеңберінде орнатылған ережелер мен қатынастарға сәйкес келуі керек. Алайда тегтің немесе нысанның дұрыс екендігіне бақылау жоқ. Осылайша, бірінші деңгейдің бас тегі екінші деңгейдің бас объектісіне қолданылуы мүмкін және дұрыс, ал дұрыс емес болуы мүмкін.

Жақсы қалыптастырылған құжаттарға баса назар аудару шеңберінде дамыды баспа ісі сол және оң жақ бұрыштық кронштейнді шектелген ақпаратты қолдану проблемаға айналған сала.[дәйексөз қажет ] Жақсы құрылған құжатқа баса назар аудару анықтауға, бөлуге және ұя салу XML емес жеке бағдарламалардың ішінде басқарылатын, бірақ жақсы қалыптасуының сипаттамалары мен әлеуетін көрсететін мазмұн.

Тексеру құралдары

Берілген XML құжатының дұрыс қалыптасқанын анықтайтын бірнеше құралдар бар. Бір мысал:

Сондай-ақ қараңыз

Әдебиеттер тізімі

  1. ^ «XML: құжат». Ұлыбританияның веб-дизайн компаниясы. Алынған 11 тамыз 2013.[өлі сілтеме ]
  2. ^ «Жақсы құрылған XML құжаттары». JCommerce Dev Network. Архивтелген түпнұсқа 2009 жылғы 22 тамызда.
  3. ^ «Постель заңынан ерекшеліктер жоқ». Маркқа сүңгі. Интернет мұрағаты. Архивтелген түпнұсқа 2013 жылғы 10 мамырда. Алынған 11 тамыз 2013.
  4. ^ а б «Дракон және Постел», 2003/08/19, Тим Брэй
  5. ^ «XML-де қателіктерді өңдеу тарихы». Маркқа сүңгі. Интернет мұрағаты. Архивтелген түпнұсқа 2013 жылғы 18 тамызда. Алынған 11 тамыз 2013.
  6. ^ «Postel Заңының ерекшеліктері жоқ», 18 тамыз 2003 ж. Аарон Сварц