Enlarges and improves navigation between articles

Author: rogercgui

_includes/header.html

@@ -12,7 +12,9 @@
           {%- assign _paths_root = site.paths.root | default: site.data.variables.default.paths.root  -%}
           {%- include snippets/get-nav-url.html path=_paths_root -%}
           {%- if site.title -%}
-            <a title="{%- if site.description -%}{{ site.description }}{%- endif -%}" href="{{ __return }}{{ page.lang }}">{{ site.title }} - {%- include snippets/get-locale-string.html key='LABEL' -%}{%- assign _locale_label = __return -%} {{ _locale_label }}</a>
+            <a title="{%- if site.description -%}{{ site.description }}{%- endif -%}" href="{{ __return }}{{ page.lang }}">{{
+              site.title }} |&nbsp; {%- include snippets/get-locale-string.html key='LABEL' -%}{%- assign _locale_label = __return
+              -%} {{ _locale_label }}</a>
           {%- endif -%}
 
         </div>

_sass/custom.scss

@@ -107,3 +107,8 @@
     background-position: right center;
 }
 /* end custom scss snippet */
+
+
+.article__content table    {
+    width: 800px;
+}

docs/_data/navigation.yml

@@ -33,6 +33,8 @@ docs-en:
         url:    /docs/en/1-configuration/abcd_def
       - title:  Folders with the databases
         url:    /docs/en/1-configuration/folders_databases
+      - title:  Versions of databases
+        url:    /docs/en/1-configuration/versions_databases        
       - title:  Permits of ABCD operators
         url:    /docs/en/1-configuration/operators
       - title:  Change the appearance
@@ -64,6 +66,10 @@ docs-en:
       - title:  Record presentation formats
         url: /docs/en/2-cataloging/pft
       - title:  Associate digital documents
+      - title:  Integrated output formats
+        url: /docs/en/2-cataloging/pft-ref
+      - title:  Adding a javascript to PFT
+        url: /docs/en/2-cataloging/pft-js
         url: /docs/en/2-cataloging/doc_digital
       - title:  Modify database definition
         url: /docs/en/2-cataloging/modify-db
@@ -191,6 +197,8 @@ docs-en:
         url: /docs/en/99-cdsisis/pft-files
       - title:  Field Extraction Table (FST)
         url: /docs/en/99-cdsisis/fst-files
+      - title:  ANSI character set 
+        url: /docs/en/99-cdsisis/ansi-table
   - title:  Languages
     children:
       - title:  Spanish
@@ -221,6 +229,8 @@ docs-es:
         url:    /docs/es/1-configuration/abcd_def
       - title:  Carpetas con las bases de datos
         url:    /docs/es/1-configuration/folders_databases
+      - title:  Versiones de bases de datos
+        url:    /docs/es/1-configuration/versions_databases
       - title:  Permisología de los operadores de ABCD
         url:    /docs/es/1-configuration/operators
       - title:  Cambiar la apariencia
@@ -253,6 +263,8 @@ docs-es:
         url: /docs/es/2-cataloging/pft
       - title:  Formatos de salida que integrado
         url: /docs/es/2-cataloging/pft-ref
+      - title:  Agregar un javascript a PFT
+        url: /docs/es/2-cataloging/pft-js
       - title:  Asociar documentos digitales
         url: /docs/es/2-cataloging/doc_digital
       - title:  Modificar definición base de datos
@@ -387,6 +399,8 @@ docs-es:
         url: /docs/es/99-cdsisis/pft-files
       - title:  Tabla de extracción de campos (FST)   
         url: /docs/es/99-cdsisis/fst-files
+      - title:  Juego de caracteres ANSI   
+        url: /docs/es/99-cdsisis/ansi-table
   - title:      Languages
     children:
       - title:  English
@@ -417,6 +431,8 @@ docs-pt:
         url:    /docs/pt/1-configuration/abcd_def
       - title:  Pastas com os bancos de dados
         url:    /docs/pt/1-configuration/folders_databases
+      - title:  Versões das bases de dados
+        url:    /docs/pt/1-configuration/versions_databases               
       - title:  Permissões dos operadores do ABCD
         url:    /docs/pt/1-configuration/operators
       - title:  pasta de banco de dados
@@ -447,6 +463,10 @@ docs-pt:
         url: /docs/pt/2-cataloging/central-tesaurus
       - title:  Gravar formatos de apresentação
         url: /docs/pt/2-cataloging/pft
+      - title:  Formatos de saída integrados
+        url: /docs/pt/2-cataloging/pft-ref
+      - title:  Adicionando um javascript ao PFT
+        url: /docs/pt/2-cataloging/pft-js
       - title:  Associar documentos digitais
         url: /docs/pt/2-cataloging/doc_digital
       - title:  Modificar definição do banco de dados
@@ -575,6 +595,8 @@ docs-pt:
         url: /docs/pt/99-cdsisis/pft-files
       - title:  Tabela de Extração de Campo (FST)
         url: /docs/pt/99-cdsisis/fst-files
+      - title:  Conjunto de caracteres ANSI
+        url: /docs/pt/99-cdsisis/ansi-table
   - title:  Idiomas disponíveis
     children:
       - title:  English

docs/_docs/en/0.1-users.md

@@ -5,9 +5,7 @@ lang: en
 key: docs-users_abcd-en
 ---
 
-**If you want your institution to be mentioned on this page, you can send an email to guildaa@gmail.com** indicating the country, name of the institution and, optionally, a url of either the institution or the Opac of the database queries
-
-**If you want your institution in this list please send e-mail to guildaa@gmail.com** indicating the country , name of the institution and optionally a url either of the institution or the Opac of the databases
+**If you want your institution in this list** please send e-mail to *contat@abcd-community.org* indicating the country , name of the institution and optionally a url either of the institution or the Opac of the databases
 
 Total registered users: 123.
 

docs/_docs/en/1-configuration/1.9-versions_databases.md

@@ -0,0 +1,169 @@
+---
+title: Versiones de bases de datos
+permalink: /docs/en/1-configuration/versions_databases
+lang: en
+key: docs-versions_databases-en
+---
+
+
+**Para Windows**
+
+| charset |   Versión Cisis   |
+| :-----: | :---------------: |
+|  ansi   | 16-60 bigisis ffi |
+|  utf8   |     16-60 ffi     |
+
+**Para Linux**
+
+| charset |   Versión Cisis   |
+| :-----: | :---------------: |
+|  ansi   | 16-60 bigisis ffi |
+|  utf8   |   16-60 bigisis   |
+
+Desde el punto de vista de la instalación el directorio cgi-bin se presenta de la siguiente manera:
+
+[File:Cgi-bin.png](https://commons.wikimedia.org/wiki/Special:UploadWizard?wpDestFile=Cgi-bin.png)
+
+Para acceder correctamente la version del cisis, el config.php utiliza tres variables:
+
+|  Variable  |                            Valoe                             |
+| :--------: | :----------------------------------------------------------: |
+|  $UNICODE  | 0, el juego de caracteres es ansi 1, el juego de caracteres es utf8 |
+| $cisis_ver | Coloca la versión del cisis según las siguientes posibilidades:Si está en blanco se asume la versión 16-60 y el parámetro $UNICODE establecerá si se lee desde la carpeta **ansi** o desde la carpeta **utf8**Si tiene otro valor (ffi, bigisis) se utiliza el mismo para direccionar al directorio donde está instalado la versión a utilizar |
+|  $exe_ext  | coloca la extensión del ejecutable **wxis** si es windows tiene el valor **.exe**; si es linux, está vacío |
+
+Para determinar cuál versión de cisis va a utilizarse para gestionar una base de datos, en el archivo config.php se toman las siguientes decisiones:
+
+- Se define el path a la carpeta cgi-bin mediante la asignación
+
+```
+     $cgibin_path=$ABCD_path."www/cgi-bin/";  
+```
+
+
+
+- Se lee el archivo abcd.def donde deben figurar los parámetros
+
+```
+   $def["UNICODE"] y
+   $def["CISIS_VERSION"]
+```
+
+- Se incorpora el script config_extended.php y si hay alguna base de datos activa ($_REQUEST["base"]) se lee el archivo **dr_path.dat** que puede reconfigurar los parámetros **$def["UNICODE"]** y **$def["CISIS_VERSION"]**
+- A partir de aquí se toman las siguientes decisiones:
+
+
+
+```
+          $unicode='ansi';
+          $charset="ISO-8859-1";
+```
+
+
+
+```
+          $unicode='utf8';
+          $charset="UTF-8";
+```
+
+- Con estos valores se puede establecer la ruta hacia el ejecutable a utilizar para gestionar la base de datos:
+
+```
+          $cisis_path=$cgibin_path.$unicode."/".$cisis_ver."/";
+```
+
+
+
+```
+         cuando el método es post
+         $wxisUrl=$server_url."/cgi-bin/".$cisis_ver.$wxis_exec;
+         
+         si el método es GET
+         $Wxis=$cisis_path.$wxis_exec;
+```
+
+
+
+**HTML - Content-Type**
+
+Hay una tercera variable importante que viene del php.ini y se denomina **default_charset' \*que en algunos servidores viene como\*** *UTF-8 **y en otros como ISO-8859-1. Si es UTF-8 el juego de caracteres de la base de datos es** ansi* entonces en el **config.php** se incluye el comando
+
+```
+     header('Content-Type: text/html; charset=iso-8859-1'); 
+```
+
+ya que las bases de datos y archivos de mensajes están en **ansi**
+
+En el config.php se incluye entonces:
+
+```
+     if (ini_get('default_charset')=="UTF-8" and $unicode=="ansi")
+```
+
+header('Content-Type: text/html; charset=iso-8859-1');
+
+
+**Presentar en una misma página la información proveniente de bases de datos en diferentes versiones**
+
+Supongamos que en el sistema de préstamos la base de datos catalográfica y la de usuarios están en versión **utf8** mientras que transacciones (trans) y suspensiones y multas (suspml) están en versión **ansi**. Esta situación es más complicada por cuanto en un mismo proceso hay que extraer información de bases de datos en versiones diferentes.
+
+El config.php se lee al inicio del script por lo que necesitamos un mecanismo que nos varíe la versión dependiendo de la base de datos que se está procesando. Esta situación se resuelve a través del script **common/wxis_llamar.php** el cual tiene a su cargo acceder la base de datos.
+
+Para poder hacer el cambio de versiones, en el **abcd.def** debe activarse el parámetro **MULTIPLE_DB_FORMATS** para indicarle a **wxis_llamar.php** que debe verificar con cual versión se ha de leer la base de datos. Por ello, si en **wxis_llamar.php** se detecta que el parámetro **MULTIPLE_DB_FORMATS** está habilitado, se procederá a leer el archivo **dr_path.def** de la base de datos para verificar la versión de cisis a utilizar para gestionar los registros:
+
+```
+     parse_str($query, $arr_query);
+     $actual_db=$arr_query["base"];
+     $charset_db="";
+     if (isset($_SESSION["MULTIPLE_DB_FORMATS"]) and $_SESSION["MULTIPLE_DB_FORMATS"]=="Y" or isset($MULTIPLE_DB_FORMATS) and $MULTIPLE_DB_FORMATS=="Y"){
+           if (file_exists($db_path.$actual_db."/dr_path.def")){
+               $def_db = parse_ini_file($db_path.$actual_db."/dr_path.def");
+               $cisis_ver="";
+               if (isset($def_db["CISIS_VERSION"]) and $def_db["CISIS_VERSION"]!="16-60" )
+                   $cisis_ver=$def_db["CISIS_VERSION"];
+                   if ( !isset($def_db["UNICODE"]) or $def_db["UNICODE"] == "ansi" || $def_db["UNICODE"] == '0' ) {
+                         $unicode='ansi';
+                         $charset="ISO-8859-1";
+                   } else {
+                         $unicode='utf8';
+                         $charset="UTF-8";
+                   }
+                   $cisis_path=$cgibin_path.$unicode."/".$cisis_ver."/";   // path to directory with correct CISIS-executables
+                   $mx_path=$cisis_path.$mx_exec;                          // path to mx-executable
+                   if ($postMethod == '1'){ 
+                        $wxisUrl=$server_url."/cgi-bin/$unicode/".$cisis_ver.$wxis_exec;  // POST method used
+                        $Wxis="";
+                   }else{
+                        $wxisUrl="";
+                        $Wxis=$cisis_path.$wxis_exec;   //GET method is used
+                   }
+               }
+     }
+    
+```
+
+
+En **wxis_llamar.php** se agregó una rutina que que permite trabajar bases de datos en ANSI cuando el juego de caracteres establecido.
+
+```
+       $cset=strtoupper($charset); 
+       if (!isset( $charset_db)or $charset_db=="") $charset_db="ANSI";
+       $cset_db=strtoupper($charset_db);
+       if ($cset_db!=$cset){
+          foreach ($contenido as $value) {
+              if ($cset=="UTF-8" and $cset_db=="ISO-8859-1"){
+                   $cont_cnv[]=utf8_encode($value);
+              } else{
+                    $cont_cnv[]=utf8_decode($value)
+              } 
+          }
+          if (isset($cont_cnv) and count($cont_cnv)>0) $contenido=$cont_cnv;
+       }
+               
+```
+
+1. Se lee el charset establecido para la página ($cset=strtoupper($charset))
+2. Se lee el charset de la base de datos, $charset_db, (leído del dr_path.dat). Si no está definido se asume **ANSI**
+3. Si el charset de la la base de datos no es igual al charset de la página se convierte la salida del wxis ($contenido) al charset de la página
+
+>  NOTA: la conversion de utf-8 a ansi puede generar inconsistencias

docs/_docs/en/2-cataloging/1.7.1-pft-js.md

@@ -0,0 +1,111 @@
+---
+title: Agregar un javascript a la presentación de los registros en el módulo de catalogación
+permalink: /docs/en/2-cataloging/pft-js
+lang: en
+key: docs-pft-js-en
+---
+
+
+En la carpeta bases/www existe un formato denominado **prologoact.pft** donde se forma el encabezamiento del registro presentado en el área de catalogación. Este pft puede ser utilizado para agregar scripts y archivos de estilo que modifiquen la presentación de los registros que se muestran en el proceso de catalogación. Los scripts agregados en **prologoact.pft** pueden ser luego referenciados desde el formato que presenta el registro en la ventana de catalogación. Por ejemplo: si quiere agregar un script para colapsar alqunas secciones del registro desplegado en la pantalla (ejm. Tabla de contenido, resumen o existencias) siga el siguiente procedimiento:
+
+- Incluya en **prologoact.pft** los estilos que servirán para hacer visible/invisible la sección del documento que desea colapsar:
+
+```
+         <style type="text/css">
+           #i_division 
+              {text-align:left;
+               margin:0 auto;
+               width:100%;
+               padding:0px;
+              }
+         </style>
+```
+
+- Incluya en **prologoact.pft** el script que permite colapsar (esconder) una división (div) del documento:
+
+```
+         <script>
+             function Colapsar(obj) {      
+                 var el = document.getElementById(obj);
+                 if ( el.style.display != "none" ) {
+                    el.style.display = "none";
+                 }else {
+                    el.style.display = "";
+                 }
+             }
+         </script>
+```
+
+Recuerde que como estamos insertando el estilo y el javascript en formatos Isis, tenemos que colocar ambos bloques encerrados entre apóstrofes (' ... '), o sea, prologoact.pft nos quedará de la siguiente manera:
+
+```
+         '<style type="text/css">
+            #i_division {
+               text-align:left;
+               margin:0 auto;
+               width:100%;
+               padding:0px;
+            }
+          </style>'/
+          
+         '<script>
+             function Colapsar(obj) {      
+                 var el = document.getElementById(obj);
+                 if ( el.style.display != "none" ) {
+                    el.style.display = "none";
+                 }else {
+                    el.style.display = "";
+                 }
+              }
+          </script>'/
+```
+
+**No olvidar el / al final del formato**
+
+- Modifique el formato de despliegue del registro para crear divisiones con las secciones que desea colapsar, e incluya el llamado al javascript que hace las divisiones visibles/invisibles:
+
+```
+          if  p(v72)  then
+            `<div id="i_division">
+               <a onclick="Colapsar('mytc_` f(mfn,1,0) `');" style="text-decoration:none ">
+               <strong>Resumen</strong></a>
+               <div id='mytc_` f(mfn,1,0) `'" style="display:none">`/
+                   v72+|<br>|,
+               '</div>
+             </div>'/    
+          fi/
+```
+
+Nótese el uso de las comillas **`** que se usan para indicar el literal incondicional por cuanto para elaborar el formato que invoca al javascript se están usando el apóstrofe y la comilla para cumplir con las normas de sintaxis exigidas en HTML
+
+
+Este formato hace lo siguiente:
+
+- - Si está presente el resumen (if p(v72)) crea una division con el estilo establecido en i_division
+  - Al interior de esa divisón coloca un link (<a onclik=) al javascript Colapsar al cual se le envía el nombre de la sección que se desea colapsar.
+  - Hay que asegurarse que cada sección tenga su propio nombre. Por eso el nombre de la división se construye con el nombre genérico mytc_ y se le agrega el mfn del registro: f(mfn,1,0).
+  - Luego se crea la division con el mismo nombre que se le envió al javascript Colapsar y se le coloca como estilo style="display:none" para que cuando se abra la página se muestre escondido.
+  - Se construye con el lenguaje de formatos el despliegue del o los campos correspondientes
+  - Se cierran las dos divisiones que se abrieron.
+
+
+Esta secuencia introducirá en la hoja de presentación la siguiente salida:
+
+```
+           <div id="i_division">
+               <a onclick="Colapsar('mytc_1');" style="text-decoration:none ">
+                <strong>Resumen</strong></a>
+               <div id='mytc_1'" style="display:none">
+                  Texto del resumen ...  
+               </div>
+           </div>
+```
+
+Si el formato modificado va a ser utilizado en el IAH, debe agregar el estilo y el javascript en el formato ahhead.pft localizado en \abcd\www\htdocs\iah\scripts\es\
+
+
+
+```
+    Ver el formato prologoact.pft de la carpeta demo sin copias
+    Ver el formato donde se utiliza el código javascript del formato prologoact.pft
+```