Atributs reservats XML

L’especificació XML defineix un conjunt d’atributs especials amb el prefix xml: que tenen un significat estàndard per a qualsevol parser. Aquests atributs no cal declarar-los en un DTD o esquema perquè formen part de l’espai de noms XML reservat.

Els tres principals atributs reservats són:

xml:lang

#

L’atribut xml:lang especifica l’idioma del contingut d’un element i dels seus descendents. El valor segueix l’estàndard BCP 47 (Best Current Practice 47), que inclou els codis ISO 639.

La sintaxi és la següent:

<element xml:lang="codi-idioma">contingut</element>

I aquests són alguns exemples de codis i els seus idiomes equivalents:

A continuació es presenta un document XML d’exemple, on es fa ús de diversos idiomes:

<?xml version="1.0" encoding="UTF-8"?>
<manual xml:lang="ca">
    <titol>Guia d'Instal·lació</titol>
    <seccio>
        <paragraf>Seguiu aquests passos per instal·lar el programari.</paragraf>
        
        <!-- Cita en anglès dins d'un document en català -->
        <cita xml:lang="en">The installation was successful.</cita>
        
        <paragraf>El missatge anterior confirma que tot ha anat bé.</paragraf>
    </seccio>
    
    <!-- Secció traduïda al castellà -->
    <seccio xml:lang="es">
        <titol>Guía de Instalación</titol>
        <paragraf>Siga estos pasos para instalar el software.</paragraf>
    </seccio>
</manual>

L’atribut xml:lang s’hereta als elements descendents fins que es redefineix:

<!-- Tot el document en català -->
<document xml:lang="ca">
    <capitol>

        <!-- Hereta xml:lang="ca" -->
        <titol>Capítol 1</titol>

        <!-- Canvi a anglès -->
        <text xml:lang="en">

            <!-- Hereta xml:lang="en" -->
            <paragraf>Hello</paragraf>
        </text>

        <!-- Torna a heretar xml:lang="ca" -->
        <text>Text en català</text>
    </capitol>
</document>

Utilitats d’aquest atribut reservat:

• Processadors de text: Apliquen regles de guionatge i ortografia correctes.
• Sintetitzadors de veu: Pronuncien el text amb l’accent adequat.
• Cercadors: Indexen el contingut segons l’idioma.
• CSS: Permet estilitzar segons l’idioma amb el selector :lang().

xml:space

#

L’atribut xml:space indica com s’han de tractar els espais en blanc (espais, tabuladors, salts de línia) dins d’un element.

Valors possibles:

A continuació es presenta un document XML d’exemple:

<?xml version="1.0" encoding="UTF-8"?>
<document>
    <!-- Espais tractats segons el comportament per defecte -->
    <paragraf>
        Aquest   text   té   espais   múltiples.
    </paragraf>
    
    <!-- Espais preservats literalment -->
    <codi xml:space="preserve">
def hola():
    print("Hola món")
    if True:
        return 42
    </codi>
</document>

Amb xml:space="preserve", la indentació del codi Python es manté exactament com està escrita, incloent-hi els espais al principi de cada línia.

Quant a l’herència, igual que xml:lang, l’atribut xml:space s’hereta als elements descendents:

<pre xml:space="preserve">
    <linia>Primera línia amb    espais</linia>
    
    <!-- També preserva espais -->
    <linia>Segona línia</linia>
</pre>

Casos d’ús típics d’aquest atribut reservat:

• Codi font: Preservar la indentació és essencial.
• Poesia: Els espais i salts de línia formen part del format.
• Art ASCII: Els espais són part del dibuix.
• Dades tabulars en text pla: L’alineació depèn dels espais.

Cal tenir en compte que l’atribut xml:space és una indicació per a l’aplicació que processa l’XML, no una ordre obligatòria. Alguns processadors poden ignorar-lo. Per garantir la preservació d’espais, sovint es combina amb seccions CDATA o es processa amb eines que respecten aquest atribut.

xml:base

#

L’atribut xml:base defineix una URI base per resoldre les referències relatives dins d’un element i els seus descendents. Està definit a l’especificació XML Base (RFC 3986).

La sintaxi és la següent:

<element xml:base="uri-base">
    <!-- Les URIs relatives es resolen respecte a uri-base -->
</element>

A continuació es presenta un document XML d’exemple:

<?xml version="1.0" encoding="UTF-8"?>
<recursos xml:base="https://cifpmoll.eu/asix/">

    <!-- https://cifpmoll.eu/asix/apunts/tema1.pdf -->
    <document href="apunts/tema1.pdf"/>

    <!-- https://cifpmoll.eu/asix/apunts/tema2.pdf -->
    <document href="apunts/tema2.pdf"/>
    
    <seccio xml:base="exercicis/">
        <!-- https://cifpmoll.eu/asix/exercicis/ex01.xml -->
        <fitxer href="ex01.xml"/>

        <!-- https://cifpmoll.eu/asix/exercicis/ex02.xml -->
        <fitxer href="ex02.xml"/>
    </seccio>
    
    <!-- URI absoluta, ignora xml:base -->
    <extern href="https://w3.org/XML/"/>
</recursos>

Les regles de resolució segueixen l’estàndard RFC 3986:

L’atribut xml:base s’acumula en elements imbricats:

<a xml:base="https://exemple.com/">
    <b xml:base="docs/">
        <c xml:base="2025/">
            <enllaç href="gener.html"/>
            <!-- Resultat: https://exemple.com/docs/2025/gener.html -->
        </c>
    </b>
</a>

Casos d’ús típics d’aquest atribut reservat:

• Documents amb molts enllaços: Evita repetir el prefix comú.
• Contingut reubicable: Canviant només xml:base, tots els enllaços s’actualitzen.
• Fragments XML inclosos: Cada fragment pot definir la seva base.
• XInclude¹ i XLink²: dues especificacions que extenen les capacitats natives d’XML utilitzen xml:base per resoldre referències.

Aplicació a l’exemple

#

Podem enriquir el document XML de l’institut amb aquests atributs reservats:

<?xml version="1.0" encoding="UTF-8"?>
<institut xml:lang="ca" xml:base="https://cifpmoll.eu/asix/">
    <nom>CIFP Francesc de Borja Moll</nom>
    <codi>08012345</codi>
    <any-academic>2025-26</any-academic>
    
    <curs id="ASIX" nom="Administració de Sistemes Informàtics en Xarxa">
        <assignatures>
            <assignatura codi="LLM">
                <nom>Llenguatges de Marques i Sistemes de Gestió d'Informació</nom>
                <nom xml:lang="es">Lenguajes de Marcas y Sistemas de Gestión de Información</nom>
                <nom xml:lang="en">Markup Languages and Information Management Systems</nom>
                <hores>128</hores>
                <material href="materials/llm/temari.pdf"/>
            </assignatura>
            <!-- ... -->
        </assignatures>
        
        <alumnes>
            <alumne id="A001">
                <nom>Maria</nom>
                <cognoms>García López</cognoms>
                <bio xml:space="preserve">Estudiant de segon any.
Interessada en:
    - Ciberseguretat
    - Administració de xarxes
    - Cloud computing</bio>
            </alumne>
            <!-- ... -->
        </alumnes>
    </curs>
</institut>

Resum

#

Aquests atributs són opcionals però molt útils per crear documents XML més expressius i fàcils de processar correctament per diferents aplicacions.

Exercicis pràctics

#

Es proposen tres exercicis pràctics per facilitar l’aprenentatge progressiu.

Exercici 1

#

Document multilingüe

Crea un document XML per a un fullet turístic d’un monument o lloc d’interès de les Illes Balears (o del teu lloc d’origen). El fullet ha d’estar disponible en tres idiomes.

Requisits:

1. L’idioma principal del document ha de ser el català (xml:lang="ca" a l’element arrel).
2. Ha de contenir almenys les seccions següents, cadascuna amb contingut en els tres idiomes (català, castellà i anglès):
   • Nom del monument.
   • Descripció breu (2-3 frases).
   • Horari de visites.
   • Informació pràctica (preu, accessibilitat, etc.).
3. Usa l’herència de xml:lang de manera eficient: no repeteixis l’atribut si ja s’hereta del pare.
4. Inclou almenys una cita o frase cèlebre relacionada amb el lloc en el seu idioma original (per exemple, una cita en llatí, àrab o un altre idioma).

Estructura suggerida:

<?xml version="1.0" encoding="UTF-8"?>
<fullet xml:lang="ca">
    <monument>
        <nom>Catedral de Mallorca</nom>
        <nom xml:lang="es">Catedral de Mallorca</nom>
        <nom xml:lang="en">Mallorca Cathedral</nom>
        
        <descripcio>
            <text>La Seu és un dels temples gòtics...</text>
            <text xml:lang="es">La Seu es uno de los templos góticos...</text>
            <text xml:lang="en">La Seu is one of the Gothic temples...</text>
        </descripcio>
        
        <!-- Continua amb horaris, informació pràctica, etc. -->
    </monument>
</fullet>

Validació: Comprova que el document és ben format amb xmllint o XML Validation.

Exercici 2

#

Preservació d’espais en blanc

Crea un document XML per a un recull de poemes o cançons tradicionals. El document ha de demostrar l’ús correcte de xml:space="preserve".

Requisits:

1. Inclou almenys 3 poemes o fragments de cançons.
2. Cada poema ha de mantenir el seu format original (versos, estrofes, indentació si n’hi ha).
3. Indica l’idioma de cada poema amb xml:lang.
4. Afegeix metadades per a cada poema: títol, autor, any (si es coneix), i origen/tipus (popular, culte, etc.).

Repte addicional: Inclou un poema visual o cal·ligrama on la disposició dels espais sigui essencial per al significat.

Estructura suggerida:

<?xml version="1.0" encoding="UTF-8"?>
<recull xml:lang="ca">
    <poema id="P001">
        <titol>La Balanguera</titol>
        <autor>Joan Alcover</autor>
        <any>1903</any>
        <tipus>Himne</tipus>
        <text xml:space="preserve">
La Balanguera misteriosa
com una aranya d'art subtil,
buida que buida sa filosa,
de nostra vida treu lo fil.
        </text>
    </poema>
    
    <!-- Més poemes... -->
</recull>

Pregunta de reflexió: Per què és important usar xml:space="preserve" en aquest context i no simplement confiar en el comportament per defecte del parser?

Exercici 3

#

Repositori de recursos amb URIs

Crea un document XML per a un repositori de recursos educatius d’un mòdul formatiu. El document ha de fer un ús eficient de xml:base per evitar repetir URIs.

Requisits:

1. Defineix una URI base a l’element arrel (pot ser fictícia, com https://cifpmoll.eu/asix/llm/).
2. Organitza els recursos en categories (apunts, exercicis, exemples, eines).
3. Cada categoria pot tenir la seva pròpia sub-base relativa.
4. Inclou almenys 10 recursos amb els atributs:
   • href: URI relativa al recurs.
   • tipus: Tipus de fitxer (pdf, xml, html, zip…).
   • mida: Mida aproximada (opcional).
5. Inclou almenys 2 recursos externs amb URI absoluta (que ignorin xml:base).

Estructura suggerida:

<?xml version="1.0" encoding="UTF-8"?>
<repositori xml:base="https://cifpmoll.eu/asix/llm/" xml:lang="ca">
    <modul nom="Llenguatges de Marques">
    
        <categoria nom="Apunts" xml:base="apunts/">
            <recurs href="tema1-introduccio.pdf" tipus="pdf" mida="2.5MB">
                <titol>Tema 1: Introducció a XML</titol>
            </recurs>
            <!-- La URI completa seria: https://cifpmoll.eu/asix/llm/apunts/tema1-introduccio.pdf -->
            
            <!-- Més recursos... -->
        </categoria>
        
        <categoria nom="Exercicis" xml:base="exercicis/">
            <!-- Recursos d'exercicis... -->
        </categoria>
        
        <categoria nom="Eines externes">
            <!-- Aquests usen URI absoluta -->
            <recurs href="https://jsonlint.com/" tipus="web">
                <titol>JSONLint - Validador JSON online</titol>
            </recurs>
        </categoria>
        
    </modul>
</repositori>

Tasca addicional: Afegeix una taula al final del document, com a comentari XML, que mostri la URI completa resultant de cada recurs, seguint les regles de resolució de xml:base.

Validació: Comprova que el document és ben format amb xmllint o XML Validation.