Departamento de Gobernanza Pública y Autogobierno

Conceptos básicos

A continuación explicamos algunos conceptos utilizados a lo largo de este manual:

Portal
Un portal es un conjunto de páginas con una arquitectura de navegación alojada en un servidor web bajo un dominio. Con el gestor de portales puedes crear portales para internet (la nomenclatura de su código es webXXX99) y portales para intranet (la nomenclatura de su código es intraXXX99)
Página
Una página es un documento HTML completo que se compone de pequeñas piezas con diferentes funcionalidades como una galería de imágenes, un menú, un contenedor de contenido, etc. Una vez que se ha generado el HTML de una página, los estilos y secuencias de comandos de sus piezas se insertan en sus archivos de estilos y secuencias de comandos, sin interferir entre sí.
Subpágina
Una subpágina es un documento HTML incompleto (ya que no tiene ni cabecera ni cuerpo) que se compone de pequeñas piezas con diferentes funcionalidades como un menú, una imagen, etc. Por tanto, una subpágina se puede incluir dentro de una página como si fuera una pieza más. Las subpáginas a menudo contienen HTML que se reutiliza como parte de varias páginas diferentes, como la cabecera o el pie de página de las páginas del portal.
Área Visual
Un área visual (o VA) es esa porción de HTML con una funcionalidad específica. En el nuevo Gestor de Portales se han identificado 8 tipos de áreas visuales que permiten configurar cualquier pieza necesaria en una página del portal. Un aspecto muy importante a tener en cuenta es que los estilos y scripts asociados a cada área visual tienen que ser introducidos en la 'edición' de la propia área visual, ya que estos se enmarcan dentro de la misma. Se explican en detalle en la sección denominada Catálogo de Áreas Visuales.
Framework
Un framework js es un tipo especial de librería de clases que agiliza el desarrollo de un sitio web al incorporar características y estilos ya definidos de manera ágil. En el Gestor de Portales es posible hacer uso de estos marcos, para lo cual deben cargarse en los recursos asociados al portal.
Estilos / css
Los archivos de estilos o css incorporan características visuales a los elementos de la web. Los estilos generales del Portal, como tipo de letra, colores,... deben estar incluidos en la 'edición' del portal. Los estilos particulares de cada Área Visual deben estar incluidos en la 'edición' de la Área Visual.
SaSS Vars
Las variables Sass permiten asignar un valor a un nombre que comienza con $, y posteriromente es posible hacer referencia a ese nombre en lugar del valor en sí. Las variables Sass permiten reducir la repetición y la complejidad de los estilos. En el Gestor de Portales las variables Sass están centralizadas y su definición se realiza en la edición del portal. De esta forma, por ejemplo, si se quiere cambiar la fuente en toda la web, simplemente habría que cambiarla en la variable Sass definida a nivel del portal.
Javascript / js
Los archivos javascript o js incorporan características funcionales a los elementos de la web. El javascript general del portal, en caso de ser necesario, deberá incluirse en la 'edición' del portal. El javascript particular de cada Área Visual debe incluirse en la 'edición' del área visual.
JSON
JSON (acrónimo de "Notación de objetos de JavaScript") es un formato de texto simple para intercambiar datos. En un área visual, además de la apariencia y funcionamiento, es necesario configurar los datos. Por ejemplo, en una AV de tipo "r01-link", que se incluye para diseñar un menú, hay que indicar cuál es el texto, el enlace, el texto alternativo, la URL de destino, etc. En el Gestor de Portales estos datos se almacenan en una estructura de datos JSON y están disponibles desde el área de edición para que el desarrollador web pueda verificar el estilo (css), la operación (js) y el marcado (html) de ese área visual .
HTML
HTML, que significa HyperText Markup Language, se refiere al lenguaje de marcado utilizado para crear páginas web. Tanto para las páginas como para las áreas visuales, el desarrollador web debe especificar el marcado HTML (que verifica los estándares de accesibilidad WCAG) en el área de edición.
Handlebars
Handlebars es un lenguaje simple de plantillas. Utiliza una plantilla y un objeto de entrada para generar HTML u otros formatos de texto. Las plantillas de Handlebars están compuestas de texto con expresiones incrustadas de Handlebars. En el caso de las áreas visuales del Gestor de Portales, se utiliza Handlebars.js para incorporar los valores almacenados en la estructura de datos JSON en el HTML . Para obtener más información, puedes visitar: Guía de handlebars
Log
Cualquier operación de guardado que se realice tanto en el portal, como en una página, o en una Área Visual, queda registrada en el sistema y genera un archivo de log, que se puede consultar desde las áreas de edición. Este archivo de log es de gran ayuda cuando se realiza una operación y el resultado no es el esperado: probablemente haya un error en los datos proporcionados por el desarrollador web al editar el componente y este error se verá reflejado en este archivo de log.
r01-subpage

Cada tipo de área visual se identifica con su propia expresión. Así, si se quiere incluir una subpágina como parte de una página, será necesario especificar el siguiente elemento: r01-subpage.

También es obligatorio que cualquier área visual se incluya en una sección r01, de la siguiente manera:

<r01-section id="upper_zone">
<r01-subpage id="header"> </r01-subpage>
</r01-section>

Esta regla es aplicable a cualquier área visual:

<r01-section id="lower_zone">
<r01-link id="menu"> </r01-link>
<r01-image id="image-gallery"> </r01-image>
</r01-section>
Configurar
En el Gestor de Portales una página y un área visual disponen de dos formularios de entrada de datos. El primero lo denominamos "Configurar", y es donde se encuentran los datos básicos de la página o área visual: nombre, descripción y datos funcionales (título, texto, imagen, etc.). Este formulario de entrada de datos es editable por todos los perfiles de usuario de la herramienta.
Editar
En el Gestor de Portales una página y un área visual disponen de dos formularios de entrada de datos. El segundo lo denominamos "Editar", y es donde se encuentra el código fuente necesario para el diseño y desarrollo web, además de la plantilla de renderizado de handlebars, los archivos de estilo y javascripts. Este código se ingresa usando un componente denominado "CodeMirror". Además, también se muestran los datos introducidos en el formulario de configuración en formato JSON no editable. El código de la sección de "Editar" solo es editable por los usuarios con rol de propietario o desarrollador web del portal.
Publicar
Cuando una página está finalizada en el Gestor de Portales, se debe transferir a la web (a euskadi.eus). A esta transferencia le denominamos publicación. Puedes solicitar que la publicación se ejecute en el momento (inmediata) o indicar cuándo quieres ejecutarla (programada).
Catalogar
Es posible añadir a una página etiquetas de catalogación de algunos ejes estandarizados (y normalmente requeridos por el sistema antes de su publicación). Esta catalogación permitirá obtener esas páginas como resultado de determinadas búsquedas en euskadi.eus.
Propietario
El propietario de un portal puede realizar cualquier operación en dicho portal. También puede autorizar la gestión de su portal asignando permisos de propietario, desarrollador web o funcional a otros usuarios.
Desarrollador web / Web developer
Los usuarios con perfil de desarrollador web en un portal pueden realizar cualquier operación en dicho portal. Su función principal es diseñar, maquetar, desarrollar y entregar la web en funcionamiento.
Usuario funcional
Los usuarios con el perfil funcional pueden introducir los datos básicos de las páginas y las áreas visuales en los formularios de configuración de datos del Gestor de Portales. Su función principal es mantener los textos y elementos de las áreas visuales de las páginas, tales como imágenes, textos de enlaces, url-s de enlaces, etc. Estos usuarios no modifican el diseño web. Por tanto, pueden accceder al formulario de edición y entrada de datos, pero solo para ver el código, no para editarlo.