Beruflich Dokumente
Kultur Dokumente
” de Dspace
Consejos y trucos para la realización de tareas comunes en
Dspace.
Authors / Contributors
(alphabetically by last name)
Tim Donohue
Scott Phillips
Dorothea Salo
Traducido por:
Luis Tijera Castro
Universidad de León
Antes de comenzar
Hay que tener en cuenta que diferentes partes de Dspace residen en distintas zonas en
el servidor de Dspace. Como cada administrador de Dspace determina donde residen
algunas partes de este y además los sistemas operativos tienen diferentes conceptos
sobre donde residen otras partes, utilizaremos letra cursiva para señalar rutas de fichero
indefinidas. Algunos directorios, cuya localización precisa varía entre sistemas,
requieren especial atención:
● [dspace-source] – Directorio en el cual el administrador de Dspace descomprime el
Tips de metadatos
● Añadir un esquema de metadatos
personalizado [15]
● Añadir un nuevo campo al metadato
[17]
● Mover un campo del metadato [18]
● Cambiar la visualización del metadato
de un ítem [36]
● Usar vocabularios controlados [33]
Tips de envío
● Modificar los formularios de envío [28]
● Cambiar un valor de un formulario [31]
● Usar vocabularios controlados [33]
Recompilar DSpace
Directorios:
● [dspace-source]
● [dspace-source]/build/
● [Tomcat]/webapps/ (Mac OSX Server: /library/jboss/3.2/deploy)
○ Nota: JBOSS viene pre instalado con el servidor Mac OS X. No obstante, para
ambas ediciones, servidor y escritorio, se puede usar Tomcat como con otras
plataformas.
Recompilar DSpace
(continuación)
● (Mac OS X Server) cp build/*.war /library/jboss/3.2/deploy
6. Probar los cambios en Dspace
Recompilación completa:
1. Conectarse al servidor donde esta ejecutándose dspace (vía ssh, por ejemplo).
Asegurarse que se ha iniciado la sesión con el usuario que instalo Dspace
inicialmente.
2. Abrir un terminal (si no tiene uno ya), y teclear cd [dspace-source]
3. ant clean (elimina el código compilado antiguo)
4. ant update (recompila todo el código de Dspace y reinstala los archivos JAR
externos)
5. Parar Tomcat (ADVERTENCIA: esto deshabilitará el sitio web)
(Linux / OS X / Solaris) [Tomcat]/bin/shutdown.sh
Instrucciones:
1. Abrir Messages.properties y buscar el texto que queremos cambiar.
• Nota: Messages.properties contiene pares clave-valor. Por ejemplo:
jsp.home.search1 = Search
En términos generales, la clave se refiere a la ubicación del JSP en el cual el
texto reside (por ejemplo, jsp.home.search1 es el texto “search-related”
mostrado en [dspace-source]/jsp/home.jsp)
2. Si Messages.properties contiene ese texto en más de un lugar, abrir el pertinente
JSP y encontrar el atributo key del elemento <fmt:message> oportuno. Por
ejemplo:
Notas:
1. Cuando añadimos o modificamos texto en Messages.properties, el “word-wrap”
automático de nuestro editor de texto debe estar desactivado. La clave y su
correspondiente valor deben estar siempre en la misma línea dentro del
Messages.properties
a. (Ejemplo) Esto no es una entrada válida en Messages.properties:
Instrucciones:
1. Abrir el JSP pertinente y añadir un nuevo elemento <fmt:message> donde se
quiera que el nuevo texto aparezca, hay que asegurarse de que el valor del
atributo key es único. Por ejemplo:
<fmt:message key=”jsp.home.mynewkey” />
2. Abrir el Message.properties y encontrar la lista de claves-valor para el JSP que se
quiere modificar. Añadimos una nueva línea correspondiente a la nueva clave.
jsp.home.mynewkey = Text of my new key
3. Nota: Messages.properties contiene pares clave-valor. Por ejemplo:
jsp.home.search1 = Search
Notas:
● Se puede, añadir texto directamente al JSP, pero será más fácil mantener texto en
nuestra instalación de Dspace si esta todo ello guardado en el
Messages.properties.
● Hay que tener en cuente que cuando se añade o modifica texto en el
Messages.properties, el “word-wrap” automático del editor de texto debe estar
desactivado.
Fijar un ???some.key.name???
Archivos:
● [dspace-source]/config/language-packs/Messages.properties
● [dspace-source]/jsp/local/(JSP que produce el texto de un ???some.key.name???)
Instrucciones:
1. Buscar la cadena de dentro de las interrogaciones en el archivo
Messages.properties.
2. Buscar la misma cadena dentro del JSP; debe ser el valor de un atributo key de
un elemento <fmt:message> Si tanto en el JSP como en el Messages.properties
aparece la cadena, comprobar si la cadena es exactamente la misma.
3. Si el Messages.properties no contiene la cadena, añadírsela:
some.key.name=Text that should appear
4. Efectuar los pasos de Recompilar DSpace.
Instrucciones:
1. Cambiar el HTML en header-default.jsp (cabecera por defecto), footer-default.jsp
(pie de página por defecto), location-bar.jsp(barra que muestra la ubicación),
navbar.jsp (barra de navegación por defecto) y navbar-admin.jsp (barra de
navegación del administrador).
2. Cambiar el CSS en styles.css.jsp.
3. Efectuar los pasos de Recompilar DSpace.
Notas:
● Hay que tener cuidado al mover el formulario de búsqueda (en la barra de
navegación) en la página. Esto podría romper el selector de usuario en la interfaz
de usuario de administración. Consultar el FAQ técnico de Dspace
(http://wiki.dspace.org/TechnicalFaq) para ver posibles posicionamientos.
Instrucciones:
1. Encontrar la siguiente etiqueta cerca de la parte superior del JSP:
<dspace:layout … >
2. Pasar a esta etiqueta alguno de los siguientes atributos, para personalizar la
apariencia del JSP:
• style – especifica el estilo de la cabecera/pie mostrado para este JSP
o Por ejemplo, style=”myStyle” significa que header-myStyle .jsp y
footer-myStyle.jsp serán usados para este JSP.
o Si no se especifica un style, se usará header-default.jsp y footer-
Instrucciones:
1. Entrar como administrador de dspace y visitar la página de administrador de
Dspace (http://web-address-to-my-dspace/dspace-admin)
2. Pulsar en “Registro de metadatos” para visualizar los esquemas disponibles
dentro de Dspace. Por defecto, sólo está el esquema Dublin Core (dc)
3. En la parte inferior de la página, se introduce el “namespace” del nuevo esquema
y le ponemos también un “nombre”. (No es requisito que el “namespace” sea
resoluble. Es aconsejable que el “nombre” tenga pocos caracteres, ya que servirá
también de prefijo para el esquema). Pulsar “Guardar”.
4. El nuevo esquema de metadatos se añade a la base de datos subyacente. Para
añadir un nuevo campo al metadato hay que seguir las instrucciones descritas
en Añadir un nuevo campo al metadato. También es posible mover un campo
de metadato de un esquema a otro, para ello hay que seguir las instrucciones
descritas en Mover un campo del metadato.
© 2006-2007 by all Authors/Contributors listed
This work is licensed under Creative Commons Attribution-Noncommercial-Share Alike 3.0 License.
15
Cómo... [Personalizando DSpace, Versión 1.4.2]
Archivos:
Instrucciones:
1. Entrar como administrador de dspace y visitar la página de administrador de
Dspace (http://web-address-to-my-dspace/dspace-admin)
2. Hacer click en “Registro de metadatos” con el fin de observar los actuales
esquemas de metadato dentro de Dspace. Luego hacer clic en el “namespace” del
esquema al que se quiera añadir un nuevo campo.
3. En la parte inferior de la página se encuentra el formulario “Añadir un campo de
metadato”, en el cual se puede especificar el “Elemento”, el “Cualificador” y la
“nota de alcance” para el nuevo campo del metadato. Solamente el apartado
“Elemento” es requerido. Hacer clic en “Añadir” para añadir el nuevo campo.
4. El nuevo campo de metadato se añadirá ahora a la base de datos subyacente
como miembro del actual esquema de metadatos. Si se desea, se puede convertir
el campo en una opción de búsqueda (véase Modificar los campos de búsqueda),
se puede añadir el campo a los formularios de envío(véase Modificar los
formularios de envío), y/o se puede mostrar este campo en la visualización de
ítems (véase Cambiar la visualización del metadato de un ítem).
Archivos:
● http://web-address-to-my-dspace/dspace-admin (Requiere sesión de administrador)
Instrucciones:
Notas:
● Mover un campo también lo eliminará de su esquema de origen. No obstante,
algunos ítems que previamente usaron este campo serán actualizados
automáticamente (es decir, ningún metadato existente debería perderse).
Instrucciones:
1. Buscar la siguiente línea en el fichero dspace.cfg:
##### Fields to Index for Search #####
2. Debajo se pueden observar varias líneas como estas:
search.index.1 = author:dc.contributor.*
search.index.2 = author:dc.creator.*
Notas:
• En Dspace, el concepto más confuso respecto a las opciones de búsqueda es la
búsqueda por palabra clave.
o En la caja de búsqueda básica (como la que se muestra abajo) algunos
términos introducidos se buscan para alguna parte dentro de algún índice
de búsqueda (por ejemplo, alguno de los campos search.index.# en
Instrucciones:
1. Se puede personalizar el operador booleano de búsqueda que se usa por defecto.
El motor de búsqueda de Dspace usa por defecto el operador OR (requiere que al
menos un termino de búsqueda este presente) cuando se introducen múltiples
términos. No obstante, si se desea, se puede especificar que se use el operador
AND (requiere que todos los términos estén presentes), para ello hay que
modificar la siguiente linea en el archivo dspace.cfg:
search.operator = OR
El operador de búsqueda especificado sera el operador por defecto usado cuando
alguien introduzca múltiples términos en la caja de búsqueda principal
Reindexar DSpace
Archivos:
● [dspace]/bin/index-all
Instrucciones:
1. Iniciar sesión en la máquina donde se ejecuta Dspace.
2. Cambiar al directorio [dspace]/bin.
3. Ejecutar el script de reindexación
● (Linux or Mac OSX) ./index-all
● (Windows) ejecutar desde el prompt de comandos
./dsrun org.dspace.browse.InitializeBrowse
./dsrun org.dspace.search.DSIndexer
4. Parar y reanudar el servidor Tomcat (véase Reinicio rápido en Recompilar
DSpace).
Instrucciones:
1. En Dspace, los “media filters” son los que controlan la indexación a texto
completo y la creación automática de thumbnails de imágenes. Ambos se
pueden programar llamando al script filter-media (que sucesivamente llama a
la clase org.dspace.app.mediafilter.MediaFilterManager).
2. La lista de todos los “media filters” activados está disponible en el archivo de
configuración dspace.cfg en la sección etiquetada como sigue:
#### Media Filter plugins (through PluginManager) ####
Notas:
● Abajo se muestra una lista de los “media filter” disponibles y se explica que
hacen realmente:
○ HTMLFilter – extrae todo el texto de documentos HTML para la indexación
a texto completo.
○ JPEGFilter – crea thumbnails de las imágenes de los archivos GIF, JPEG y
PNG
○ BrandedPreviewJPEGFilter – crea una vista previa de las imágenes de los
archivos GIF, JPEG y PNG (desactivado por defecto)
○ PDFFilter – extrae todo el texto de documentos Adobe PDF (sólo si esta
basado en texto o OCRed) para la indexación a texto completo.
Instrucciones:
1. Primero, hay que seguir la instrucciones descritas en Configurar los “media
filters”, ya que la indexación a texto completo es llevada a cabo por esos “media
filters” (concretamente HTMLFilter, PDFFilter, y WordFilter)
2. Se puede modificar el campo search.maxfieldlength en el archivo de
configuración dspace.cfg. Este campo especifica el máximo número de palabras a
indexar para cada documento y por defecto el valor es las 10000 primeras
palabras. (hay que asignar el valor -1,si se quiere indexar un numero ilimitado
de palabras)
Notas:
● La indexación a texto completo sólo esta disponible para los siguientes formatos
al mismo tiempo:
○ Adobe PDF (sólo si está basado en texto o OCRed)
○ Microsoft Word
○ Plain Text
○ HTML
● La búsqueda a texto completo en Dspace ocurre cuando el usuario busca a través
de la caja de búsqueda por defecto (véase a continuación), o cuando el usuario
selecciona la opción “Palabra clave” de la pantalla de búsqueda avanzada.
Instrucciones:
1. En dspace.cfg, se pueden descomentar las siguientes lineas para especificar que
campos del metadato van a ser navegables , interfaz “Navegar por Fecha”,
interfaz “Navegar por Autores”, interfaz “Navegar por Titulos” y interfaz “
Navegar por Temas”, respectivamente:
# webui.browse.index.date = dc.date.issued
# webui.browse.index.author = dc.contributor.*
# webui.browse.index.title = dc.title
# webui.browse.index.subject = dc.subject.*
Notas:
● También se puede personalizar que campos del metadato se muestran cuando se
navega por una lista (a través de algún interfaz de navegación). Para hacerlo,
hay que consultar la sección titulada como Cambiar el esquema de navegación.
Cambiar el esquema de
navegación
Archivos:
Instrucciones:
1. En dspace.cfg, se pueden cambiar los campos del metadato que se muestran para
cada ítem en la lista de ítems. Para hacerlo, hay que buscar la siguiente línea en
el archivo dspace.cfg y descomentarla:
#webui.itemlist.columns = dc.date.issued(date),
dc.title, dc.contributor.*
2. Por defecto, cuando se visualiza una lista de ítems, se ven las columnas Fecha,
Titulo y Autor(es) en ese orden. No obstante, se puede usar la anterior opción de
configuración para cambiar de sitio las columnas o cambiar las columnas que se
quieren mostrar. Aunque no se requiere, se pueden asignar estas columnas a sus
específicos índices de navegación (véase Modificar los campos de navegación).
3. Habitualmente, especificando un solo cualificador (por ejemplo, issued en
dc.date) o no especificando ninguno (por ejemplo dc.title) se mostrarán
valores de esos campos específicos del metadato. No obstante, si se pone un
asterisco (*) como cualificador se mostrarán todos los campos para ese elemento
(tenga o no cualificador). Así, especificando dc.contributor.* todos o algunos
de los siguientes campos se mostraran en esa columna: dc.contributor,
dc.contributor.author, dc.contributor.editer, etc.
4. Parar y reiniciar Tomcat (Véase Reinicio rápido en Recompilar DSpace).
© 2006-2007 by all Authors/Contributors listed
This work is licensed under Creative Commons Attribution-Noncommercial-Share Alike 3.0 License.
27
Cómo... [Personalizando DSpace, Versión 1.4.2]
Archivos:
● [dspace]/config/input-forms.xml
Instrucciones:
Cambiar un valor de un
formulario
Instrucciones:
1. Buscar el elemento <form-value-pairs> en el input-forms.xml.
2. Buscar el elemento <value-pairs> para el elemento Dublin Core cuyo valor
queremos cambiar.
3. Añadir un elemento <pair>, donde el elemento <displayed-value> contiene
lo que el usuario ve en la caja “dropdown” y el elemento <stored-value>
contiene lo que Dspace debe almacenar como etiqueta de información:
<pair>
<displayed-value>Gov't Doc #</displayed-value>
<stored-value>govdoc</stored-value>
</pair>
4. Parar y reiniciar Tomcat (Véase Reinicio rápido en Recompilar DSpace).
Notas:
● Este conjunto de instrucciones cambia las posibilidades existentes que hay
cuando Dspace muestra una caja de opciones o un menú “dropdown”, como con
Cambiar un valor de un
formulario
(continuación)
los elementos “type” y “language” del Dublin Core. Esto no añade un widget de
envío a la interfaz de usuario; para hacer eso, véase Modificar los formularios de
envío.
Archivos:
● [dspace]/config/controlled-vocabularies/*
● [dspace]/config/dspace.cfg
Instrucciones:
1. Por defecto, la funcionalidad vocabularios controlados esta deshabilitada ya que
no es compatible con WAI Guidelines. Para habilitarlo, hay descomentar la
siguiente línea en dspace.cfg:
Instrucciones:
1. Para cambiar la visualización del metadato, modificar el orden de los elementos
del Dublin Core después del elemento webui.itemdisplay.default (en
Dspace.cfg), o añadir nuevos elementos:
webui.itemdisplay.default = dc.title, dc.title.alternative,
dc.contributor.*, dc.subject, dc.date.issued(date),
dc.publisher
2. Para cambiar el nombre del campo de metadato mostrado, buscar su nombre
clave (que comenzara por metadata.) en Message.properties y cambiarlo:
metadata.dc.title.alternative = Title (French)
3. Efectuar los pasos descritos en Recompilar DSpace.
Archivos:
[dspace]/bin/stat-* (es decir, todos lo archivos que comienzan por “stat-”)
● [dspace]/config/dspace.cfg
● [dspace]/config/dstat.cfg and dstat.map
● http://web-address-to-my-dspace/statistics (URL de la página de estadisticas
de DSpace)
Instrucciones:
1. DSpace viene con un paquete muy básico de estadísticas web que se puede usar
para reunir información de la visualización de las paginas (que no es lo mismo que
la descarga de archivos) y de actividades generales realizadas dentro de DSpace
(por ejemplo, búsquedas realizadas, logins, errores y advertencias). Este paquete
analizará los antiguos logs de DSpace (en [dspace]/log) para generar un informe
de estadísticas HTML. Consiste en un conjunto de scripts Perl que comienzan
con “stat-” en tu [dspace]/bin/ directory. (Nota: Para utilizar estos scripts, hay
que tener instalado Perl!)
2. Hay dos opciones básicas en dspace.cfg que permiten especificar si los informes
de estadísticas serán o no accesibles públicamente (report.public), y donde se
almacenarán los informes (report.dir). Es muy probable que se quieran
cambiar esas opciones. No obstante, si se cambia cualquier opción, hay que
reiniciar Tomcat (Véase Reinicio rápido en Recompilar DSpace)
report.public = false
30 1 * * * [dspace]/bin/stat-report-monthly
35 1 * * * [dspace]/bin/stat-report-general
(La entrada cron de arriba programaría los scripts para que se ejecuten todas las
noches. stat-monthly y stat-general estarían programados para las 12:30am
y 12:35am respectivamente. Mientras sus correspondientes scripts de informes
se ejecutarían a la 1:30am y 1:35am respectivamente. Nota: hay que cambiar
[dspace] por la ruta absoluta del directorio de instalación de tu DSpace.)
10. Para Windows, hay que usar las tareas programadas de Windows para
programar algunos comandos a una hora apropiada del día. Recuerda que los
script stat-monthly y stat-general se tienen que ejecutar antes que sus
correspondientes scripts de informes (similar al ejemplo de Linux/Mac OSX).
Ademas, necesitas llamar a Perl explicitamente (por ejemplo, perl stat-
monthly)
11. Tras ejecutar todos los scripts de estadísticas, el sitio de informes de estadísticas
estará disponible inmediatamente en http://web-address-to-my-
dspace/statistics
Instrucciones:
1. Cuando se recompila (véase Recompilar DSpace), el interfaz OAI-PMH
(http://www.openarchives.org/pmh/) se recompila automáticamente en
dspace-oai.war. Para habilitar el interfaz OAI-PMH, solo hay que copiar el
archivo dspace-oai.war en el directorio [Tomcat]/webapps/. (Es probable que ya
este si se siguieron completamente los pasos de instalación).
2. Si nunca antes se ha usado OAI-PMH, hay un tutorial para principiantes en:
http://www.oaforum.org/tutorial/
3. Abajo se muestran los “verbs” básicos del OAI-PMH (es decir, los comandos)
para familiarizarte con ellos ( todos los ejemplos de URLs deben ir en una misma
línea):
Instrucciones:
1. Todas las opciones del RSS están disponibles en dspace.cfg bajo la sección de
cabecera:
#### Syndication Feed Settings ######
2. Para habilitar el “RSS feed” para un ítem nuevo/actualizado en la instalación de
DSpace , se necesita asignar a la siguiente variable valor true:
webui.feed.enable = false
3. Se puede modificar el número máximo de ítems mostrados en tu “RSS feed”:
webui.feed.items = 4
4. Para ayudar al rendimiento, puede elegir el número de “feed” en cache (size) y
Configurar el “checksum
checker”
Archivos:
● [dspace]/bin/checker
● [dspace]/config/dspace.cfg
Instrucciones:
1. DSpace ahora viene con el script “Checksum Checker” ([dspace]/bin/checker)
que puede programar la verificación del checksum de todos los ítems dentro de
DSpace. Ya que DSpace calcula y registra el checksum de todos los archivos
enviados, este script es capaz de determinar si el archivo a sido o no cambiado
(ya sea manualmente o por algún tipo de corrupción o virus). La idea es que
entre más pronto se pueda identificar que el archivo a cambiado, mas
probabilidades se tienen de recuperarlo (asumiendo que no se quiere que
cambie).
Configurar el “checksum
checker”
(continuación)
3. Se puedes especificar cualquier periodo de tiempo para cualquiera de las
opciones. Los periodos de tiempo válidos son: segundos (s), minutos (m),
horas (h), dias (d), semanas (w), años (y)
4. Hay que tener en cuenta que estos ajustes de retención solamente se usarán si
se especifica la opción -p para el checker (véase a continuación). De lo
contrario, serán ignorados!
4. Si se modifica alguna opción en dspace.cfg, es necesario reiniciar Tomcat (Véase
Reinicio rápido en Recompilar DSpace) para que los cambios hagan efecto.
5. El script Checksum Checker ([dspace]/bin/checker) también tiene varias
opciones de la línea de comandos, a saber:
1. -c 10 = Modo Limited Count (-c). Esto limita al check a solo los 10
Configurar el “checksum
checker”
(continuación)
ignorados y la tabla de la base de datos puede crecer demasiado!
6. Se debe programar el Checksum Checker para que se ejecute automáticamente,
basándose en la frecuencia de copias de seguridad en tu instancia de Dspace. El
tamaño de tu repositorio también es un factor. Para repositorios muy grandes, se
necesitara programar la ejecución para una hora (por ejemplo, opción -d 1h)
cada noche.
1. Para Linux o Mac OSX, se puede programar añadiendo una entrada cron
similar a la siguiente para crontab del usuario que instal DSpace:
0 4 * * 0 [dspace]/bin/checker -d2h -p
(La entrada cron anterior programa la ejecución del scritp cada Domingo a las
4am por 2 horas. Nota: hay que cambiar [dspace] por la ruta absoluta del directorio
Configurar el “checksum
checker”
(continuación)
○ -c = solo un informe con los bitstreams cuyos checksums han cambiado
○ -u = solo un informe con los bitstreams no comprobados
○ También puedes combinas opciones ( -m -c) para obtener informes
combinados
2. Para Linux o Mac OSX, puedes añadir otra entrada cron similar a la
siguiente para el crontab del usuarios que instalo DSpace:
0 8 * * 0 [dspace]/bin/dsrun
org.dspace.checker.DailyReportEmailer -a
(La entrada cron de arriba progrmara el envío del email para las 8am cada
Domingo, informando de todos los resultados. El comando de arriba debe
aparecer en una sola linea.)
Sitios web:
● FAQ técnico de DSpace: http://wiki.dspace.org/TechnicalFaq
● Página de DSpace en Sourceforge:
http://sourceforge.net/projects/dspace/
● Buscar en la lista de correo dspace-tech:
http://sourceforge.net/mailarchive/forum.php?forum=dspace-tech
Instrucciones:
Recompilar Manakin
Directorios:
● [dspace-source]
● [manakin-source]
● [Tomcat]/webapps/ (Mac OS X Server: /library/jboss/3.2/deploy)
○ Nota: JBOSS viene preinstalado con el servidor Mac OS X. No obstante, para
ambas ediciones, servidor y escritorio, se puede usar Tomcat como con otras
plataformas.
Recompilar Manakin
(continuación)
Recompilación completa: (recompilación completa de todo manakin)
1. Conectarse al servidor donde esta ejecutándose dspace / manakin (vía ssh, por
ejemplo). Asegurarse que se ha iniciado la sesión con el usuario que instalo
Dspace / manakin inicialmente
2. Abrir un terminal (si no tiene uno ya), y teclear cd [manakin-source]
3. ant clean (elimina el código compilado anteriormente)
4. ant -Ddspace=[dspace-source] build_wars (recompila todo el código de
manakin y crea un nuevo archivo .war)
5. Parar Tomcat (ADVERTENCIA: esto deshabilitara el sitio web)
● (Linux / OS X / Solaris) [Tomcat]/bin/shutdown.sh
● (Mac OS X Server) Usar el administrador de servidores para parar tomcat
(Windows) Usar el monitor de servicio de tomcat (en el área de notificación)
Instalar un tema
Archivos:
● [new-theme-source] (Directorio donde se encuentra el codigo del nuevo tema)
● [manakin-source]/themes/[theme-dir] (Nueva localización para el código del
tema)
● [dspace]/config/xmlui.xconf
Instrucciones:
1. Si se va a instalar un tema completamente nuevo que no se distribuye con
Manakin, hay que realizar las siguientes operaciones, si el tema se distribuye con
Manakin, este paso se puede saltar.
cp [new-theme-source] [manakin-source]/themes/[theme-dir]
2. Abrir el archivo de configuración de Manakin, [dspace]/config/xmlui.xconf, ir a
la parte inferior y localizar el elemento <themes>.
3. Añadir una nueva etiqueta <theme> dentro del elemento <themes> como
Notas:
● Los temas se evalúan por el orden de aparición en el archivo xmlui.xconf. Así, si
el tema por defecto se define antes que otros temas, esos otros temas no se
usarán.
Instrucciones:
1. En primer lugar hay que determinar un nombre de directorio para el nuevo tema
dentro del directorio [manakin-source]/themes. En estas instrucciones, se hace
referencia a este directorio con [theme-dir] .
2. En vez de empezar el nuevo tema desde cero, se hace una copia de la plantilla
del tema estándar en el nuevo directorio, [theme-dir] .
● cd [manakin-source]/themes
● cp -R template [theme-dir]
Instrucciones:
1. Si no se tiene ya, se necesita Crear un nuevo tema
2. Para modificar la cabecera, localizar la plantilla denominada “buildHeader”
dentro del archivo structural.xsl. Copiar esta plantilla dentro del template.xsl de
tu tema y modificar el XSLT según las necesidades.
<xsl:template name="buildHeader">
....
</xsl:template>
3. Para modificar el pie, localizar la plantilla denominada “buildFooter” dentro del
archivo structural.xsl. Copiar esta plantilla dentro del template.xsl de tu tema y
Instrucciones:
1. Si no se tiene ya, se necesita Crear un nuevo tema
2. Localizamos la plantilla denominada “itemSummaryView_DS-METS-1.0-DIM”
dentro del DIM (DSpace Intermediate Metadata) handler base. Esta es la
plantilla que se utiliza cuando se visualiza un ítem directamente (Se utiliza otra
plantilla cuando el usuario pulsa en “show full item record”).
<xsl:template name="itemSummaryView_DS-METS-1.0-DIM">
....
Instrucciones:
1. Si no se tiene ya, se necesita Crear un nuevo tema
2. Localizar la plantilla denominada “itemSummaryList_DS-METS-1.0-DIM”
dentro del DIM (DSpace Intermediate Metadata) handler base. Esta es la plantilla
que se usa para mostrar un ítem individual con una lista amplia, como en la
navegación por páginas o los resultados de búsqueda.
<xsl:template name="itemSummaryList_DS-METS-1.0-DIM">
<img class=”item-logo”>
<xsl:choose>
<xsl:when test="$data/dim:field[@element='type']='image'">
<xsl:attribute name="src">
<xsl:value-of select="$theme-path"/>
<xsl:text>/images/image.jpg</xsl:text>
</xsl:attribute>
</xsl:when>
Instrucciones:
1. Abrir la plantilla XSL del tema y modificar las plantillas apropiadas (es decir, la
plantilla de la cabecera o del pie) añadiendo un elemento <i18n:text> donde se
quiera que el nuevo texto aparezca. Asegurarse de que el valor de la clave es
única, por ejemplo:
<i18n:text> xmlui.yourtheme.mynewkey </i18n:text>
2. Abrir el catálogo de mensajes, config/i18n/messages.xml, y encuentra los
valores de clave que comiencen con el mismo prefijo de tu nueva clave. Añade
una nueva línea correspondiente a tu nueva clave:
<message key="xmlui.yourtheme.mynewkey">
Notas:
● i18n = internacionalización
● Se puede añadir texto directamente en el XSL, pero será mas fácil de encontrarlo,
para traducirlo a otros idiomas, si se usa el catálogo i18n.
● Hay que tener en cuenta que cuando añadimos o modificamos texto en el
catálogo messages.xml hay qie asegurase de usar las “XML escaping rules”,
como sigue:
& se convierte en &
” se convierte en "e;
' se convierte en '
< se convierte en <
> se convierte en >
Instalar un Aspecto
Archivos:
● [new-aspect-source] (Directorio donde se encuentra el código del nuevo
aspecto)
● [manakin-source]/aspects/[aspect-dir]
(Nueva localización para el código del aspecto)
● [dspace]/config/xmlui.xconf
Instrucciones:
1. Si se va a instalar un aspecto completamente nuevo que no se distribuye con
Manakin, hay que realiza las siguientes operaciones, si el tema se distribuye con
Manakin, este paso se puede saltar.
cp [new-aspect-source] [manakin-source]/aspects/[aspect-
dir]
(el anterior comando de copia debe ir en una sola línea)
2. Abrir el archivo de configuración de Manakin, [dspace]/config/xmlui.xconf, ir a
Sitios web:
● Web de Manakin: http://di.tamu.edu/projects/xmlui/
● Buscador de la lista de correo dspace-manakin:
http://sourceforge.net/mailarchive/forum.php?forum=dspace-manakin
Instrucciones:
1. Si la información esperada simplemente no aparece, mostrando una pantalla
blanca en el navegador, entonces el problema, probablemente estará en la
configuración de Tomcat. El mensaje de error debería estar en [Tomcat]/logs/