Agregar-atributo-al-Layout-de-DSpace-en-JSPUI.md

@@ -12,7 +12,34 @@ Por lo tanto, debería ser posible cambiar drásticamente el aspecto de DSpace,
 El _layout_ de cada página, es decir, los banners superior e inferior y la barra de navegación, están determinados por las JSP `/layout/header-*.jsp` y `/layout/footer-*.jsp`. Puede proporcionar versiones modificadas de estos (en `[DSpace-dir]/dspace/modules/jspui/src/main/webapp/layout`), o definir más estilos y aplicarlos a las páginas utilizando el atributo "style" del tag dspace:layout.
 
 Para definir un nuevo atributo para este layout es necesario modificar los siguientes archivos:
-* dspace-jspui/src/main/java/org/dspace/app/webui/jsptag/LayoutTag.java
-* dspace-jspui/src/main/webapp/WEB-INF/dspace-tags.tld
+* `dspace-jspui/src/main/java/org/dspace/app/webui/jsptag/LayoutTag.java`: Servlet de creación del layout.
+* `dspace-jspui/src/main/webapp/WEB-INF/dspace-tags.tld`: definiciones de todos los tags del layout.
 
 > Acordarse de copiar los archivos al modulo de jspui correspondiente. De esta forma, las modificaciones se encontrarían de forma "local".
+
+### Ejemplo práctico
+
+Supongamos que queremos agregar un jumbotron en el `header-default.jsp`. Dichi jumbotron contendrá el título de la página actual y un posible subtítulo (opcional). Actualmente, el archivo `dspace-tags.tld` no contiene la definición para el subtítulo del elemento.
+
+1. Agregamos el atributo subtitle al archivo `dspace-tags.tld`. De esta forma, ya estará declarado y no nos aparecerá ninguna advertencia o error al incluirlo posteriormente en el tag dspace:layout.
+
+```xml
+...
+<tag>
+    <name>layout</name>
+    <tagclass>org.dspace.app.webui.jsptag.LayoutTag</tagclass>
+    <info>Lays out an HTML page</info>
+
+    ...
+
+    <attribute>
+      <name>subtitle</name>
+      <required>false</required>
+      <rtexprvalue>true</rtexprvalue>
+    </attribute>
+    
+    ...
+
+</tag>
+...
+```
\ No newline at end of file