MANUAL DE ADMINISTRACIÓN DEL ABCD-SITE

Transcripción

1 MANUAL DE ADMINISTRACIÓN DEL ABCD-SITE Versión Tabla de Contenido Objetivo del capítulo... 3 Introducción... 3 Características generales del sistema... 4 Acceso...4 Menú principal...5 Estructura...5 Componentes...5 Acceso...5 Funciones principales...5 Vista preliminar...6 Salida...6 Herramientas generales...6 Grabar...7 Añadir...7 Modificar...7 Eliminar...7 Salir...7 Lista de ítems...7 Subir...7 Bajar...7 Herramientas específicas:...7 Area de Identificación...8 Status...8 Modificar...8 Salir...8 Administración del área ESTRUCTURA... 9 ABCD Logotipo...9 Identificación Contacto Versiones Instituciones Metabúsqueda Institución Responsable Meta información del Sitio Textos Administración de archivos Componentes Tipos de Componentes Aviso Colección de Fuentes Comunidades Destacados Portales

2 Acerca de Tópicos HTML RSS Area de administración de COMPONENTES Metabúsqueda Configuración de parámetros para Metabúsqueda Parámetros para configurar las BASES de DATOS disponibles con iah Administración del área de ACCESO ABCD Site consejos y sugerencias BVS-Site y Google Analytics Activación de la función paso a paso ABCD-Site en múltiples idiomas Pasos para agregar un nuevo idioma al ABCD Site ABCD-Site: agregando sus propios javascripts

3 MANUAL DE ADMINISTRACIÓN DEL ABCD-SITE Objetivo del capítulo ABCD-Site es una versión parcial y modificada del editor BVS-Site producido y mantenido por BIREME. El paquete completo de BVS-Site puede descargarse de: Este manual ha sido escrito para suministrar información a los usuarios sobre la operación y configuración de ABCD-Site. El documento provee una descripción general de los componentes que conforman tanto la administración del sitio como el sitio público, prestando más atención a los detalles del primero, describiendo las operaciones que pueden realizarse al organizar temas en forma sistemática, manteniendo las mismas jerarquías en cada paso. Se asume que ABCD-Site ha sido instalado y configurado de acuerdo a lo que indica el archivo Léame de la instalación. El manual también incluye una sección sobe referencias bibliográficas de la metodología y un glosario del modelo ABCD, además de tres anexos con información adicional sobre Metabúsqueda, campos de consulta de acrónimos, y consejos para crear estrategias de consulta en bases de datos con la interfaz iah. Una Biblioteca Virtual es un modelo para la administración de información y conocimiento, que incluye la cooperación y convergencia entre instituciones, sistemas, redes, e iniciativas de productores, intermediarios, y usuarios en la operación de redes locales, nacionales, regionales y fuentes de información internacional, favoreciendo el acceso abierto y universal. ABCD-Site organiza la información en una estructura que integra e interconecta bases de datos referenciales, directorios de especialistas, eventos e instituciones, un catálogo de los recursos de información disponibles en Internet, y colecciones de textos completos. El espacio de ABCD es por lo tanto una red de fuentes de información dinámica y descentralizada basada en todo lo que sea posible recuperar y extraer de información y conocimiento para el apoyo de la toma de decisiones. Introducción ABCD-Site es una herramienta integral de fuentes de información que le permite crear, administrar y publicar su sitio. Fuente de información es una entidad que responde a una demanda del usuario por información. Estas fuentes de información son generadas, actualizadas, almacenadas y operadas en Internet o Intranet por productores de información, integradores e intermediarios, en una forma descentralizada de acuerdo a metodologías comunes para la integración en ABCD. Aspectos principales de ABCD-Site: Administración de estructuras y contenidos de ABCD Integración de ABCD con fuentes internas y externas. 3

4 El sitio público está configurado usando tecnologías CSS (Cascading Style Sheets) and XSL(T) (extreme Style Language Transformer) para la presentación de sus contenidos. Características generales del sistema Acceso El área de administración está disponible desde la dirección principal de ABCD-Site. Por lo tanto, si la dirección es todo lo que tiene que hacer es modificar la URL para ingresar al área de administración de ABCD de acuerdo al siguiente ejemplo: Pantalla inicial para el Sistema de Administración de ABCD-Site Figura 1 Para usar la herramienta de administración debe estar registrado como usuario y tener una clave de acceso. ABCD-Site actualmente tiene interfaces en cuatro idiomas y es posible trabajar en cualesquiera combinación de éstos. El contenido de cada interfaz es administrado por separado mediante el uso de un código y una contraseña. Hay dos tipos de usuarios en el sistema de administración de ABCD-Site. Administrador: con acceso completo a todas las áreas del ABCD-SITE Contenido: acceso restringido sólo al Area de Componentes Con la instalación del sistema se habilita un conjunto de contraseñas estándar para permitir el acceso inmediato al sistema, por lo que por razones de seguridad, deberían ser cambiadas por el administrador de ABCD. Las contraseñas son: Usuario: adm Contraseña: x Nota: la misma contraseña puede usarse en la interfaz para cualquier idioma. Para mayor información acerca del acceso del usuario y administración, vea el ítem 6 Administración del área de acceso, en este manual. 4

5 Menú principal El menú principal permite la administración de los contenidos de ABCD-SITE con la identificación de las fuentes, temas, vínculos con otros sitios, etc. Está dividido en 3 áreas principales: Estructura, Componentes, y Acceso. Estructura Figura 2 Estructura se refiere a la administración de los elementos de ABCD-SITE: nomenclatura, etiquetas, idiomas, control de acceso a contenidos (fuentes de información, temas y comunidades), y anexos (destacados y noticias), etc. Componentes Componentes se refiere a la administración de contenidos (fuentes de información, temas y comunidades) los que estarán disponibles en la interfaz ABCD-SITE. Acceso Acceso se refiere al modo de acceso de los productores responsables por la información, actualizaciones y validaciones del contenido del sitio. Funciones principales Después de ingresar el usuario y contraseña, el administrador ve la pantalla del Sistema General de Administración, donde es posible acceder a la Estructura, Contenido, y Acceso (registro de usuarios). La página principal del sistema de administración tiene tres funciones principales localizadas en la parte superior de la pantalla. 5

6 Vista preliminar Figura 3 Presenta una vista preliminar del sitio ABCD. El objetivo es facilitar la tarea de administración permitiendo una vista previa en forma inmediata de los cambios realizados sin tener que usar la vista pública. Salida Función usada para salir de la pantalla actual y retornar a la página de acceso del sistema. Si el usuario está en la página principal del Sistema de Administración, esta opción lo devolverá a la página de ingreso del sistema. Herramientas generales Corresponden a funciones disponibles en cualquier ventana de administración de contenidos en ABCD, sea en ESTRUCTURA, COMPONENTES, o ACCESO. En el ejemplo abajo, se ha seleccionado la caja SERVICIO. 6

7 Grabar Figura 4 Salva los cambios realizados en la sección actual y los registra en los archivos de la interfaz. Añadir Agrega ítems de datos de acuerdo al tipo de contenidos existentes en la sección. Modificar Editar contenido de los ítems de datos existentes en la sección. Eliminar Elimina los contenidos de datos existentes en la sección. Salir Retorna al menú principal. Lista de ítems Lista los ítems de datos de acuerdo al tipo de contenidos existentes en la sección. Presenta la información en niveles jerárquicos determinando cómo serán desplegados en la interfaz ABCD. Subir Sube el ítem seleccionado, permitiendo cambiar su orden o secuencia. Bajar Bale el ítem seleccionado, permitiendo cambiar su orden o secuencia. Herramientas específicas: Herramientas que varían de acuerdo al tipo disponible de cada componente del sistema. En el ejemplo abajo hemos seleccionado el elemento SciELO para la primer columna. 7

8 Area de Identificación Figura 5 Nombre de la sección que se va a cambiar (en el ejemplo, Conexión con otros sitios ). Status Status actual, que puede definirse como Disponible o No disponible. Disponible: el dato se almacena y estará disponible en la interfaz pública de ABCD. No disponible: el dato se almacena y se visualiza solamente por los administradores del sistema. Modificar Salva los cambios realizados en la sesión actual y los aplica a la interfaz. Salir Retorna al menú principal. 8

9 Administración del área ESTRUCTURA Figura 6 Funciones disponibles en el área ESTRUCTURA: ABCD Logotipo URL del logotipo y URL de la organización responsable que sirve ABCD (ABCD-padre) Figura 7 Etiqueta Identifica el nombre del logotipo disponible en ABCD Imagen URL de la imagen que forma parte del banner de ABCD (o logotipo) Enlace Inserta el enlace (link) a la pagina home de ABCD 9

10 Identificación Identifica el nombre que ABCD desplegará en el banner y también como primera línea de la página de administración del sistema. Etiqueta Nombre de ABCD. Imagen Imagen de identificación del Sitio Figura 8 Nota: El usuario debe elegir entre usar la etiqueta o la imagen, no es posible usar ambas al mismo tiempo. Contacto de contacto con la(s) persona(s) responsable(s) de ABCD. Es posible registrar más de una dirección, las que serán seleccionadas en la interfaz pública a través de un formulario. Figura 9 10

11 Asunto del Indicación del nombre de contacto. Se sugiere que se eviten datos personales. Dirección de correspondencia de . Note: Nunca deben usarse direcciones personales como contacto pues esos datos estarán visibles para los usuarios de la interfaz pública. Versiones Produce interfaces públicas disponibles en otros idiomas. Actualmente pueden ser: español, inglés, francés y portugués, disponibles en el módulo de administración de acuerdo al idioma de trabajo. Por ejemplo: para el idioma de trabajo portugués, las otras versiones disponibles son inglés, francés y español. Figura 10 Nombre Identificación de la versión que estará o no disponible. Enlace Identifica la dirección en el sistema que hará que esté disponible en la interfaz pública. Instituciones Nombre y enlace a las instituciones responsables de ABCD, desplegadas en la esquina superior derecha del sitio público. Esta área permite el registro separado de los enlaces a textos y logotipos. 11

12 Figura 11 Nombre Identifica la institución. Imagen URL a la imagen del logotipo (si hay logotipo) Enlace Enlace (link) al sitio web de la institución (si existe) Metabúsqueda Identifica y permite cambiar las etiquetas de los servicios disponibles de consulta en la interfaz pública. Figura 12 Texto Cambia el texto de las etiquetas de metabúsqueda 12

13 Las etiquetas pueden modificarse usando la opción Metabúsqueda de la columna de Estructura, o directamente editando el archivo: /bases/site/xml/<lang>/metasearch.xml Las últimas 5 filas sombreadas están implementadas en la versión completa del editor del sitio, debido a que están relacionadas con funciones de consulta especiales que usan el tesauro MeSH/DeCS de BIREME. Meta etiqueta search_title search_entrywords search_submit search_howtosearch search_allwords search_anyword search_error search_advancedsearch search_freesearch search_results search_method search_demo conceptsearch_title conceptsearch_entrywords decs_mesh Texto a desplegar Búsqueda en el ABCD por palabras Entre con una o más palabras Buscar cómo buscar? Todas la palabras Cualquier palabra Por favor utilice algún término para expresión de consulta filtro de búsqueda Resultado método demo por relevancia Buscar documentos más relacionados a los conceptos Búsqueda vía descriptores DeCS/MeSH Institución Responsable Información en el pie de página sobre el sitio. Describe datos para contacto con la institución a cargo de ABCD, tales como dirección, teléfono, etc. Figura 13 13

14 Nombre Indica la institución que tendrá sus datos de contacto publicados como nota de pie de página. Editor XHTML Permite la creación del texto de bienvenida que estará disponible en la interfaz pública (para más información acerca del editor de texto en XHTML, vea el ítem Colección de Fuentes) Meta información del Sitio Espacio para una breve descripción de ABCD, que permitirá ser indizado y recuperado por los navegadores web. Permite la descripción por autor, descriptor, descripción, etc. Figura 14 Elemento Indica el campo a ser indizado por los motores de consulta Internet. Estos pueden ser: author: URL de la institución. keywords: palabras claves, describiendo el contenido del sitio. description: identificación del sitio. Textos Administra la lista que comprende las etiquetas y URLs de imágenes que identifican las acciones y áreas comunes del sitio ABCD, diferentes a los servicios de consulta. Los textos pueden ser modificados usando la opción Textos de la columna de Estructuras, o directamente editando el archivo: /bases/site/xml/<lang>/bvs.xml Meta etiqueta Button_moreInformation Default_print Default_close Home Texto a desplegar Más informaciones imprimir cerrar inicio 14

15 Meta etiqueta Contact Contact: subject Contact: name Contact: Contact: message Contact: send Contact: error Contact: response topic.expand Texto a desplegar Contacto Asunto Nombre Mensaje Enviar Por favor llene los campos: Su mensaje fue enviado con éxito. mostrar subtemas Identificación Indica la etiqueta correspondiente Editor XHTML Figura 15 Permite la creación del texto de aviso que estará disponible en la interfaz pública (para más información acerca del editor de texto XHTML vea el ítem Colección de Fuentes, más adelante) Imagen URL de la imagen Administración de archivos Permite la carga de archivos locales a un área dedicada del servidor. ABCD Site está configurado para subir archivos en la carpeta /abcd/www/htdocs/local. El administrador del servidor deberá dar los acceso de lectura/escritura en esa carpeta. 15

16 El administrador puede filtrar el tipo de archivos a subir, modificando la variable en el archivo de configuración: /htdocs/site/admin/fnow/include_config_system.php $cfg["allowed_extensions"] = "(gif bmp png jpg jpeg doc txt xml pdf)"; Se recomienda diseñar una estrategia clara de almacenamiento de archivos en esta área, clasificándolos por tipo. Si hubiere una gran cantidad de archivos de la misma clase, se recomienda preparar una estructura jerárquica balanceada, de modo de que no haya demasiados archivos en un una carpeta del mismo nivel. Se recomienda crear un árbol decimal, como se muestra en la figura a la derecha. Componentes La versión 4.02 de ABCD-SITE permite la administración del sistema por medio de columnas subdivididas en componentes (o cajas) presentadas hasta en tres columnas, sin límites en cuanto a la cantidad de componentes dentro de cada una de ellas. Columna 1 Enlaces a otras bibliotecas o portales relacionados. Columna 2 Colección de las fuentes de información de ABCD. Columna 3 Espacio disponible para destacados, noticias, etc. 16

17 Figura 16 El orden de cada componente, así como el de las columnas (dependiendo del tema de ABCD) puede cambiase en la administración de COMPONENTES, donde se organizan tanto las columnas como cada uno de los componentes (disponibles o no en la interfaz pública). Figura 17 Cada componente de la columna se representa por un título con el tipo de función que designa la funcionalidad de los contenidos. 17

18 Tipos de Componentes Figura 18 Además de la estructura de columnas, la versión 4.0x del ABCD-SITE también trabaja usando algunos tipos de componentes que pueden ser distribuidos a lo largo de ABCD. Tipos de componentes pueden ser: Figura 19 Aviso Permite la inserción de mensajes de aviso relativos a ABCD: Sitio en mantenimiento, Sitio sólo para demostración, etc. 18

19 Nombre Figura 20 Indica el título del aviso (sólo en el módulo de administración. No se publica) Editor XHTML Permite la creación de textos de aviso para que estén disponibles en la interfaz pública (por más información acerca del editor de texto e XHTML vea el ítem Colección de Fuentes) Colección de Fuentes Permite el registro de cada recurso de información, así como su configuración, para ser incluido en la Metabúsqueda. 19

20 Figura 21 Nombre Identificación de la fuente Imagen URL de la imagen de la fuente Enlace Enlace (link) al área de búsqueda del recurso fuente de información. Descripción XHTML Reservado para una descripción breve sobre el recurso de información y sus contenidos. Ejemplo del uso Descripción XHTML 20

21 Página del portal web (XHTML) Figura 22 Cuando se usa, el contenido de este campo genera una página de segundo nivel (portal) en ABCD. Sigue las mismas reglas editoriales que el área de descripción. Ejemplo de Página del portal web (XHTML) Para activar la página de segundo nivel, el primer casillero de Enlace (LINK) debe estar vacío, de otro modo sólo será desplegada la primera página XHTML. El enlace al sitio externo deberá ser incluido en el texto de esta página web. Figura 23 21

22 Metabúsqueda Este mecanismo permite al usuario realizar una búsqueda libre o una búsqueda temática simultáneamente sobre diferentes recursos de información incluidos en el Sitio. Se requiere alguna configuración en Metabúsqueda para que los recursos operen con tal sistema de consulta. Información sobre cómo configurar el sistema de búsqueda se explica en Parámetros de Configuración de Metabúsqueda en este manual. Comunidades Permite el registro de un recurso de información de una Comunidad específica, tal como comunidades virtuales, foros, etc. Figura 24 Nombre Identificación del recurso. Imagen URL de la imagen del recurso. Enlace Enlace (link) a la interfaz de consulta al recurso de información. Descripción XHTML Reservado para una breve descripción de la fuente de información y su contenido. 22

23 Página del portal web (XHTML) Cuando se usa, el contenido de este campo genera una página de segundo nivel (portal) en ABCD. Sigue las mismas reglas editoriales que el área de descripción. Sigue las mismas reglas de edición del área descripción, pero el campo de enlace (link) no debe llenarse. Destacados Colección de registros destacados en la página principal de ABCD. Figura 25 Nombre Identificación del recurso. Imagen URL de la imagen del recurso. Enlace Enlace (link) a la interfaz de consulta al recurso de información. Portales Colección de enlaces (links) a otros portales web relacionados con ABCD. 23

24 Figura 26 Nombre Identificación del recurso. Imagen URL de la imagen del recurso. Enlace Enlace (link) a la interfaz de consulta al recurso de información. Acerca de Permite el registro de información sobre ABCD, tales como objetivo, alcance, etc. 24

25 Nombre Identificación del recurso. Imagen URL de la imagen del recurso. Enlace Figura 27 Enlace (link) a la interfaz de consulta al recurso de información. Descripción XHTML Reservado para una breve descripción de la fuente de información y su contenido. Página del portal web (XHTML) Cuando se usa, el contenido de este campo genera una página de segundo nivel (portal) en ABCD. Sigue las mismas reglas editoriales que el área de descripción. Sigue las mismas reglas de edición del área descripción, pero el campo de enlace (link) no debe llenarse. Tópicos Colección de tópicos relacionados que permiten una metabúsqueda automática en un conjunto de fuentes previamente configuradas para este servicio. El servicio, para ser eficiente, requiere un vocabulario controlado. 25

26 Información acerca de cómo configurar el sistema de consulta para tópicos se describe bajo los temas Configuration parameters for Metasearch and Subjects en la versión completa del manual del BVS Site. HTML Uso del editor de páginas HTML para publicar información directamente en la página principal de ABCD. RSS Figura 28 Crea un enlace con agencias de noticias que hacen disponibles herramientas RSS a los usuarios. Enlace al archivo RSS Figura 29 Indicación de la URL correspondiente al servicio RSS Verificar Verifica si la dirección RSS es correcta. La verificación se hace en la ventana inferior, con nombre RSS. RSS Area para verificar la función RSS indicada. 26

27 Area de administración de COMPONENTES Figura 30 Una vez que los componentes de cada columna están definidos (item 4.10) sus contenidos pueden ser administrados mediante el área de COMPONENTES, dependiendo cada componente seleccionado. Información detallada sobre cómo trabajar cada tipo de componente en el sistema se presenta en el ítem Tipos de Componentes Metabúsqueda La configuración de la Metabúsqueda (que puede hacerse como búsqueda libre o por tema) es esencial para una efectiva consulta en los recursos de información de ABCD. Los parámetros debe ser llenados correctamente y los recursos correctamente registrados a los efectos de que funcione el Metabuscador. Parte fija del enlace de la búsqueda Figura 31 Un conjunto de parámetros que determina los recursos de información que están siendo consultados. 27

28 Parámetros para búsqueda libre Una variable que recibe el argumento de la búsqueda en el recurso de información a ser consultado. Parte fija del enlace de la muestra de resultados Conjunto de parámetros que determina la visualización de los resultados de la búsqueda. Nota: En la instalación estándar de ABCD algunas fuentes de información ya están configuradas, pero cuando se inserta una nueva Fuente, los campos mencionados están vacíos y deben llenarse. Configuración de parámetros para Metabúsqueda La configuración del motor del Metabuscador siempre se basa en la URL del Recurso de Información y deberá ser ajustado de acuerdo al tipo de fuente de información. Ejemplo de URL de la base DBLIL en el demo de ABCD. Usando una ruta relativa si la base de datos está en el mismo servidor del sitio ABCD /iah/?base=dblil&lang=es en este caso es posible referirse al servidor como %HOST% en los parámetros de la metabúsqueda. Para realizar una búsqueda deben ingresarse correctamente la configuración de los links y los parámetros. Notas: La metodología usada en este manual para la configuración del motor de Metabúsqueda se basa en el uso de aplicaciones ABCD en el modelo estándar. Podrían ser necesarios ajustes para casos específicos o en la modificación de aplicaciones. En este caso es importante la ayuda del analista de sistemas o desarrollador de ABCD para identificar los parámetros requeridos del motor de Metabúsqueda. Parámetros para configurar las BASES de DATOS disponibles con iah Tomamos como ejemplo la base de datos DBLIL de BIREME incluida en el paquete ABCD como demostración. Esta base de datos tiene la siguiente URL: En esta URL tenemos Con la ruta completa: Término /cgibin/wxis.exe/iah/scripts/?isisscrip t=iah.xis base=dblil lang=es Descripción Nombre y dirección del servidor donde se hará la búsqueda Mecanismo de consulta a usar (en los ejemplos usamos IAH), donde wxis.ese es el archivo ejecutable que también puede hallarse como wxislind.exe, wxis1660.exe, etc. Nombre de la base de datos donde se realiza la consulta Idioma a usarse en la consulta: pt = portugués en= inglés es = español Tabla 1 Una vez que se ha identificado la URL de la base, sólo es necesario añadir los parámetros indicados abajo al final de cada campo para que el Metabuscador funcione suavemente. 28

29 Parte fija del enlace de la búsqueda &nextaction=xml&count=1[&fmt=citation] el parámetro &fmt es opcional, si no se declara el resultado será presentado usando el formato por defecto de la base tal como se declara en el archivo <base>.def Parámetros para búsqueda libre exprsearch= Parte fija del enlace de la muestra de resultados &nextaction=lnk Siguiendo el ejemplo más arriba tendremos: URL de la fuente /iah/?base=dblil&lang=es Parte fija del enlace de la búsqueda tion=xml&count=1 Parámetros para búsqueda libre (aquí no varía): exprsearch= Parte fija del enlace de la muestra de resultados k Figura 32 Ayuda: en la línea Parámetros para búsqueda libre, la variable estándar usada por iah es exprsearch= la que recibirá la expresión usada por el usuario en la búsqueda libre (ingresada por el usuario en el área de búsqueda) o por tema. Sin embargo, este parámetro puede variar para otras fuentes de información. 29

30 Administración del área de ACCESO Figura 33 Se refiere a la administración y control de usuarios, contraseñas y otras eventualidades para la administración de ABCD. En esta sección, es posible agregar, editar o borrar el registro de usuarios y contraseñas para limitar la administración de la Interfaz. Funcionalidades disponibles en el área de ACCESO: Figura 34 Nombre Identifica el login de acceso del usuario Tipo Identifica el permiso del sistema para la administración del sitio por parte del usuario. 30

31 Hay dos tipos de permisos: Administrador el administrador el sistema, que tiene acceso a todos los módulos (estructura, contenido, acceso) Contenido Sólo se permite acceso para la administración del contenido y algunos ítems del área de estructura. Contraseña Identifica el login de acceso del usuario ABCD-Site: Menú de Administración con permiso de administrador, presenta el menú estándar completo. ABCD-Site: Menú de Administración con permiso de Contenido solamente. Figura 35 ABCD Site consejos y sugerencias BVS-Site y Google Analytics Esta sección explica cómo añadir al ABCD-Site el script de Google Analytics para mantener estadísticas de las visitas. Activación de la función paso a paso Paso 1: Paso 2: Paso 3: Registre el Sitio en Google Analytics Más información acerca del registro y cómo funciona el sistema puede obtenerse en la página de soporte de Google: Agregue su Sitio para ser monitoreado por la herramienta de Google. Este paso puede hacerse usando la interfaz de control de Google Analytics. Después de completar este paso, recibirá un ID (tracking code) el cual es un código único autogenerado para cada sitio que está siendo monitoreado. Se recomienda que anote este código en un lugar seguro. Edite el archivo../htdocs/site/bvs-site-conf.php de su instalación de ABCD Site añadiendo las siguientes líneas: 31

32 [ANALYTICS] GOOGLE_ANALYTICS_ID=XX (código recibido en el paso 2) ABCD-Site en múltiples idiomas ABCD Site opera en 4 idiomas por defecto: inglés, portugués, español y francés. Esta sección describe los pasos requeridos para agregar nuevos idiomas la sistema. Nota: La versión actual usa la codificación de caracteres ISO , por lo cual solamente pueden representarse idiomas en los que esta codificación funciona correctamente. En la versión 4.1.x y superior del sistema (aún no liberada) la codificación cambia a UTF-8 con el objetivo de incrementar la cantidad de idiomas soportados. Pasos para agregar un nuevo idioma al ABCD Site Paso 1: Cree directorios para el nuevo idioma usando la notación de idioma de dos letras de la ISO (pt-portugués, es-español, fr-francés, en-inglés, etc.) debajo del directorio../bases de la instalación de ABCD-Site. Ejemplo: agregar soporte para francés (se asume que ABCD-Site está instalado bajo /ABCD/www/) cd /ABCD/www/bases/site/xml/ mkdir fr cd /ABCD/www/bases/site/html/ mkdir fr cd /ABCD/www/bases/site/ini/ mkdir fr Cuando finalice esta paso, el directorio /bases tendrá la siguiente estructura de directorios. xml/ pt/ es/ en/ fr/ ini/ pt/ es/ en/ fr/ html/ pt/ es/ en/ fr/ Paso 2: copie todos los directorios XML disponibles en un idioma en el Sitio ABCD en el directorio del nuevo idioma. Ejemplo de copia de archivos en inglés al francés cd /ABCD/www/bases/site/xml/en cp *.* /ABCD/www/bases/site/xml/fr Paso 3: edite el archivo bvs.xml en el directorio /xml/[new_language] reemplazando el código de dos letras correspondiente al idioma fuente con el código de dos letras del nuevo idioma. Nota: use el editor de texto de su preferencia (Notepad, Textpad, Vi, etc.) y verifique que el archivo se salva como texto puro. 32

33 Ejemplo: cambiar el código en a fr usando el editor Vi :s/\/en\//\/fr\//g Paso 4: copie el archivo adm.xml en la carpeta /xml/[new_language] reemplazando el código de dos letras correspondiente al idioma fuente con el código de dos letras del nuevo idioma. Nota: use el editor de texto de su preferencia (Notepad, Textpad, Vi, etc.) y verifique que el archivo se salva como texto puro. Ejemplo: cambiar el código en a fr usando el editor Vi :s/\/en\//\/fr\//g ABCD-Site: agregando sus propios javascripts Esta sección explica cómo agregar al ABCD-Site otras funciones javascript para que estén disponibles en diferentes lugares del ABCD-Site. Paso 1: crear el directorio../htdocs/site/local/js Paso 2: crear en este directorio un archivo llamado function.js e incluya allí todas sus funciones javascript. Paso 3: declare el uso del archivo en../htdocs/site/php/head.php incluyendo la siguiente línea. <script type="text/javascript" src="<?=$def['directory']?>local/js/functions.js"> </script> 33