> ## Documentation Index
> Fetch the complete documentation index at: https://docs.publica.la/llms.txt
> Use this file to discover all available pages before exploring further.

# Smart Zoom Articles

## How does it work?

The system will continuously search for any structured data file (in XML format) with the proper naming convention, to create SmartZoom articles. These articles are a special feature that allows you to give your users a more detailed view of a certain page of your publication.

### Naming convention

The files must be named as follows in order to be identified as Smart Zoom articles:

`prefix-XML-yymmdd`

_Where:_

- **_prefix:_** it is the name of an edition or some short name to identify a group of the uploaded publications. Example: diario-dia
- **_XML:_** It is the format of the file.
- **_yymmdd:_** Same date indicated in the folder. It is the date in which the publication is uploaded. Example: 220824.

_Example:_

`diario-dia-XML-220824`

## Data

The structure/scheme of the file, follows the next example:

```xml
<?xml version="1.0" encoding="UTF-8"?>

        </PLANILLO>
        
                
                </TITULO>
                
                </BAJADA>
                
                </AUTOR>
                
                    
                </TEXTO>
                
                
            </ARTICULO>
        </SECCION>
    </PUBLICACION>
</TIPOPUBLICACION>
```

| Field                  | Required | Description                                                                     |
| ---------------------- | -------- | ------------------------------------------------------------------------------- |
| PAGINA                 | Yes      | Refers to the "Home Page" field in the publication's SmartZoom edit window.     |
| ANTETITULO             | No       | Refers to the "Pretitle" field in the publication's SmartZoom edit window.      |
| TITULO                 | Yes      | Refers to the "Title" field in the publication's SmartZoom edit window.         |
| BAJADA                 | No       | Refers to the "Bajada" field in the publication's SmartZoom edit window.        |
| AUTOR                  | No       | Refers to the "Author" field in the publication's SmartZoom edit window.        |
| TEXTO                  | Yes      | Refers to the largest field in the publication's SmartZoom edit window.         |
| FOTO_PRINCIPAL         | No       | Refers to the "Upload Image" option in the publication's SmartZoom edit window. |
| LECTURA_FOTO_PRINCIPAL | No       | Refers to the "Epigraph" option in the publication's SmartZoom edit window.     |