144 lines
16 KiB
HTML
144 lines
16 KiB
HTML
<table BORDER=0 WIDTH=100%>
|
|
<tr>
|
|
<td valign=top align=left><a class='menu1' href="/stta/help/es/sttaintro.html"><img align=middle border=0 alt="stta" src="/stta/help/images/stta-flower.gif"></td>
|
|
<td valig=top align=left><a class='menu1' href="/stta/help/es/toc.html">
|
|
<img align=middle border=0 alt="Indice" src="/stta/help/images/stta_button.gif"><tt>Indice</tt></a>
|
|
</td>
|
|
<td valign=top align=right><a class='menu1' href="/stta/help/es/"><img align=middle border=0 alt="Servicios Tarantella" src="/stta/help/images/es/stta_title.gif" width="300" height="39"></a><br>
|
|
<tt> [30/12/2003 10:56:48]</tt>
|
|
</td>
|
|
</tr></table>
|
|
<table BORDER=0 WIDTH=100%>
|
|
<tr background="/stta/help/images/bkg/help.jpg"><td background="/stta/help/images/bkg/help.jpg">
|
|
|
|
<table bgcolor=#ba9e79 BORDER=1 width=100% > <tr><td><table BORDER=1 width=100%><tr><th bgcolor=#ba9e79><img src="/stta/help/images/flower.gif" alt="Stta" width=18 height=20 align="top" border=0> * <font color=#ffffff size="+2">Acceso a la ayuda según contexto</font> *</th></tr>
|
|
|
|
<tr><td bgcolor=#ffe0b0 align=center> <b></b> </td></tr><tr><td background="/stta/help/images/bkg/p1.jpg">
|
|
<table><tr><td>
|
|
<a class='menu1' href="/stta/help/es/sec_inface.html"><img align=top border=0 alt="Interface de STTA " src="/stta/help/images/stta-flower.gif"></a></td>
|
|
<td> <b> Acceso a la ayuda según contexto<br>
|
|
</b><br>
|
|
|
|
</td></tr></table>
|
|
</td></tr></table></td></tr></table>
|
|
<br>
|
|
<table border="2" align="center"><tr><td>
|
|
<b>STTA</b> ofrece un completo sistema de Ayuda On-line:<br>
|
|
según contexto, enlaces de referecias cruzadas, <br>
|
|
<a onClick='window.open("/stta/help/es/toc.html?stta_webhelp", "stta_webhelp", "toolbar=no,menubar=no,scrollbars=yes,width=800,height=600,resizable=yes"); return false' class='menu1' class='menu1' href="/stta/help/es/toc.html?stta_webhelp">índice de contenidos</a>, <a onClick='window.open("/stta/help/es/tocbook.html?stta_webhelp", "stta_webhelp", "toolbar=no,menubar=no,scrollbars=yes,width=800,height=600,resizable=yes"); return false' class='menu1' class='menu1' href="/stta/help/es/tocbook.html?stta_webhelp">Libro STTA</a>, etc.<br>
|
|
<br>
|
|
<img src="/stta/help/images/icons/tip.gif" alt="TIP" width="16" height="16"border=0> El sistema de Ayuda es además multilengua <br>
|
|
y usa las "cadenas de texto", variables y valores del entorno.<br>
|
|
|
|
</td></tr></table>
|
|
<ul>
|
|
<li><a class='menu1' href="#context">Ayuda al contexto</a></li>
|
|
<li><a class='menu1' href="#how">Estructura</a></li>
|
|
<li><a class='menu1' href="#faq">Preguntas Frecuentes</a></li>
|
|
</ul>
|
|
<p>
|
|
<a name="context" >
|
|
<font size=+1><b>Ayuda al contexto</b></font><br>
|
|
<table width=100% align=left border0><tr bgcolor=#ffe0b0><td> </td></tr></table><br><br>
|
|
<ul>
|
|
<li>Los formularios de <b>STTA</b> ofrecen "enlaces" de ayuda específica sobre los items de entradad de datos. En la parte superior Izquierda de la ventana el texto <u>Ayuda</u> ofrece información genérica del formulario o cgi.<br></li>
|
|
<li>Una vez abiertas las ventans de ayuda <b>STTA</b> se puede "navegar" por los enlaces y referencias cruzadas que ofrecen las mismas.<br></li>
|
|
<li>La dimensión de las ventanas de ayuda puede configurarse en <a onClick='window.open("/stta/help/es/config_inface.html?stta_webhelp", "stta_webhelp", "toolbar=no,menubar=no,scrollbars=yes,width=800,height=600,resizable=yes"); return false' class='menu1' class='menu1' href="/stta/help/es/config_inface.html?stta_webhelp">Interface</a>, valores <u><i>Altura de la ventana de ayuda (pixels)</i></u> (600) y <u><i>Ancho de la ventana de ayuda (pixels)</i></u> (800). El aspecto o "look & feel" de la ayuda está sujeto a los mismos detalles y configuración que la interface de <b>STTA</b><br></li>
|
|
</ul>
|
|
<p>
|
|
<a name="how" >
|
|
<font size=+1><b>Estructura</b></font><br>
|
|
<table width=100% align=left border0><tr bgcolor=#ffe0b0><td> </td></tr></table><br><br>
|
|
<ul>
|
|
<li><b>STTA</b> usa una biblioteca propia para gestionar la infraestructra de la Ayuda del módulo que evalua etiquetas y texto para devolver texto HTML: <ul><br>
|
|
<li> Los ficheros html del "directorio base (help)" no contienen "cadenas de texto localizadas", usan variables de texto o valores del entorno en base a al idioma configurado en <b>Webmin</b>.<br></li>
|
|
<li> En algunos casos se "incluyen" otros ficheros para confeccionar la página, se incluyen secciones completas o se generarn valores de atributos de configuración del entorno.<br></li>
|
|
<li> El valor de LANG (que figura entre % ) es sustituido por el del idioma <b>Webmin</b>(ej: es, en, etc)<br></li>
|
|
<li> Todo el "texto localizado" en el idioma correspondiente, está en el subdirectorio LANG del "directorio base (help)" del módulo.<br></li>
|
|
</ul><br>
|
|
</li>
|
|
<li>El directorio dentro del módulo que contiene la ayuda es "help" que contiene: <ul><br>
|
|
<li> Ficheros html con la arquitectura básica del tema correspondiente: <ul>
|
|
<li> Carga de cabecera de página, etiqueta HTML "head". </li>
|
|
<li> Bloques de cabecera de la página de página, etiqueta HTML "headimg" y "headertitle".</li>
|
|
<li> "Include" de fichero <u>LANG/head</u> del tema. Texto de encabezado del tema.</li>
|
|
<li> "Include" de fichero <u>LANG/msg</u> del tema. Recuadro con información general en modo resumen y detalles relevantes. </li>
|
|
<li> "Include" de fichero <u>LANG/body</u> del tema. Texto con descripción y análisis detallado del tema. </li>
|
|
<li> Carga de referecias cruzadas (caja <u>ver también</u>), etiqueta HTML "footlinks". </li>
|
|
<li> Carga de pies y bloques de pie de la página, etiqueta HTML "foot". </li>
|
|
</ul><br></li>
|
|
<li> Directorios LANG del idioma correspondiente para ser "incluídos" por la <u>arquitectura base de las páginas</u>, con la estructura siguiente: <ul>
|
|
<li> Ficheros html de tipo general de la ayuda.</li>
|
|
<li> <u>LANG/head</u>/tema. Texto de encabezado del tema.</li>
|
|
<li> <u>LANG/msg</u>/tema. Recuadro con información general en modo resumen y detalles relevantes. </li>
|
|
<li> <u>LANG/body</u>/tema. Texto con descripción y análisis detallado del tema. </li>
|
|
<li> <u>LANG/config</u>/parámetro. Texto con detalles de la configuración del parámetro de la sección. Estos ficheros son cargados directamente del directorio LANG con una cabecera y pie por defecto. (cfg_head y cfg_foot). </li>
|
|
</ul><br></li>
|
|
</ul></li>
|
|
</ul>
|
|
<p>
|
|
<a name="faq" >
|
|
<font size=+1><b>Preguntas Frecuentes </b></font><br>
|
|
<table width=100% align=left border0><tr bgcolor=#ffe0b0><td> </td></tr></table><br><br><ul>
|
|
<li><b>¿ Se puede desactivar la ayuda ?</b> <br>Sí, cambiando el valor de la variable <i><a onClick='window.open("/stta/help/es/config/help_active.html?stta_webhelp", "stta_webhelp", "toolbar=no,menubar=no,scrollbars=yes,width=800,height=600,resizable=yes"); return false' class='menu1' class='menu1' href="/stta/help/es/config/help_active.html?stta_webhelp"><i>Usar ayuda en las pantallas de entrada</i></a></i> (help_active) en <a onClick='window.open("/stta/help/es/config_main.html?stta_webhelp", "stta_webhelp", "toolbar=no,menubar=no,scrollbars=yes,width=800,height=600,resizable=yes"); return false' class='menu1' class='menu1' href="/stta/help/es/config_main.html?stta_webhelp">main</a> </li><br>
|
|
<li><b>¿ Cómo se establece el enlace al <b>Libro STTA</b> <img align=top border=0 width=24 heigth=24 alt="" src="/stta/help/images/pdf.gif"> ?</b> <br>El enlace por defecto está establecido sobre la <a class='menu1' href="http://www.eagora.info/stta">Web de publicación</a> de la versión oficial del <a class='menu1' href="http://www.eagora.info/stta/help/es/bookstta.pdf">Libro en PDF</a>, si la plataforma no tiene acceso a <i>Internet</i>, basta con descargar el archivo del "bookstta.pdf" y colocarlo en directoryo help/LANG (ej: help/es para Español), entonces, el enlace se establecerá contra este path. Habrá que actualizar el fichero pdf del libro cuando cambie en la <a class='menu1' href="http://www.eagora.info/stta">Web de publicación</a>.</li><br>
|
|
<li><b>¿ Cómo se puede generar una estrucura de ayuda para otro idioma ?</b> <br>Usando el script <b>mklanghelp.sh</b> desde el directorio del módulo de <b>STTA</b> (ver <a onClick='window.open("/stta/help/es/inface_scripts.html#stta?stta_webhelp", "stta_webhelp", "toolbar=no,menubar=no,scrollbars=yes,width=800,height=600,resizable=yes"); return false' class='menu1' class='menu1' href="/stta/help/es/inface_scripts.html#stta?stta_webhelp">scripts</a>).</li><br>
|
|
<li><b>¿ Sobre qué ficheros hay que modificar el texto o traducir a otro idioma ?</b> <br>Sobre los ficheros del directorio help/LANG (ej: help/es para Español) y los ficheros LANG correspondientes al idioma del directorio "lang" del módulo, en especial el genérico y el del directorio "lang/help". No se deben traducir la variables de entorno y valores de carga de cadenas de texto.</li><br>
|
|
<li><b>¿ Se pueden usar variables del entorno y valores de cadenas de texto ?</b> <br>Sí, usando las siguietes expresiones entre <b><</b> <b>></b>, donde las palabras text, config e infoCfg van precedidas del signo <b>$</b> : <ul>
|
|
<li> "exec text{nombre-de-la-variable}" es sustituído por el valor de la <u>cadena de texto</u> correspondiente.</li>
|
|
<li> "exec config{nombre-de-la-variable}" es sustituído por el valor de la <u>variable</u> correspondiente.</li>
|
|
<li> "infoCfg{nombre-del-parámetro}" (no hay que incluirlo entre <>) es sustituído por el valor de la <u>cadena de texto del formulario de configuración</u> correspondiente (ficheros "config.info.LANG).</li>
|
|
</ul></li><br>
|
|
<li><b>¿ Cómo se puden usar los iconos de alerta en las páginas ?</b> <br>Escribiendo los siguientes textos entre signos <b>%</b> : <ul>
|
|
<li> "W" muestra un <img src="/stta/help/images/icons/warning.gif" alt="ALERT!" width="16" height="16" border=0> </li>
|
|
<li> "I" muestra un <img src="/stta/help/images/icons/tip.gif" alt="TIP" width="16" height="16"border=0> </li>
|
|
<li> "H" muestra un <img src="/stta/help/images/icons/help.gif" border="0" alt="HELP" width="16" height="16"> </li>
|
|
<li> "N" muestra un <img src="/stta/help/images/icons/new.gif" alt="new" width="26" height="8" border=0> </li>
|
|
<li> "S" muestra un <img src="/stta/help/images/icons/starred.gif" alt="starred" width="16" height="16"border=0> </li>
|
|
<li> "U" muestra un <img src="/stta/help/images/icons/updated.gif" alt="updated" width="56" height="8" border=0> </li>
|
|
<li> "P" muestra un <img src="/stta/help/images/icons/pencil.gif" alt="pencil" width="16" height="16" border=0> </li>
|
|
<li> "OK" muestra un <img src="/stta/help/images/icons/choice-yes.gif " alt="choice-yes" width="16" height="16" border=0> </li>
|
|
<li> "INFO" muestra un <img src="/stta/help/images/info.gif " alt="info" width="20" height="20" border=0> </li>
|
|
<li> "AR" muestra un <img src="/stta/help/images/icons/arrowright.gif " alt="arrowright" width="16" height="16" border=0> </li>
|
|
</ul></li><br>
|
|
<li><b>¿ Cómo se forma la URL de las páginas de ayuda ?</b> <br><br>
|
|
URL base: <u>http(s)://webmin-host:port/stta/help.cgi/stta/</u><br>
|
|
Hay que añadir: <ul>
|
|
<li> El nombre del fichero html de ayuda ubicado en el directorio <i>/usr/local/webmin-1.100/stta/help</i>   sin la extensión (.html).<br>
|
|
Ejemplo: página índice <a onClick='window.open("/stta/help/es/toc.html?stta_webhelp", "stta_webhelp", "toolbar=no,menubar=no,scrollbars=yes,width=800,height=600,resizable=yes"); return false' class='menu1' class='menu1' href="/stta/help/es/toc.html?stta_webhelp">/stta/help.cgi/stta/toc</a> </li>
|
|
<li> Si se trata de una sección de la <i><a onClick='window.open("/stta/help/es/sttaconfig.html?stta_webhelp", "stta_webhelp", "toolbar=no,menubar=no,scrollbars=yes,width=800,height=600,resizable=yes"); return false' class='menu1' class='menu1' href="/stta/help/es/sttaconfig.html?stta_webhelp">Configuración de STTA</a></i> usar "config_[sección]", la sección es el nombre del fichero ubicado en el directorio de configuración de <b>STTA</b> (<i>/etc/webmin/stta/dataconf</i>).<br></li>
|
|
<li> Si se trata de un parámetro de la ayuda, usar <u>config/[parámetro]</u>, el parámetro es el nombre del fichero html ubicado en el "directorio de la ayuda"/LANG/config.<br>
|
|
Ejemplo: página parámetro has_ldapcache <a onClick='window.open("/stta/help/es//config/is_ldapcache.html?stta_webhelp", "stta_webhelp", "toolbar=no,menubar=no,scrollbars=yes,width=800,height=600,resizable=yes"); return false' class='menu1' class='menu1' href="/stta/help/es//config/is_ldapcache.html?stta_webhelp">/stta/help.cgi/stta/config/is_ldapcache</a> </li>
|
|
<li>En todos los casos puede añadirse al final un valor como nombre de la ventana <u>?nombre-ventana</u> de modo que los enlaces de la página sean abiertos sobre la misma.</li>
|
|
<li> <img src="/stta/help/images/icons/warning.gif" alt="ALERT!" width="16" height="16" border=0> No todos los ficheros ".html" pueden cargarse, el <i>gestor de ayuda</i> requiere incluir secciones y valores específicos (cabecera, pie página, etc) para generar un formato "HTML" correcto para los navegadores. Todos los ficheros bajo los directorios LANG son usados como "includes" de las páginas base en <i>/usr/local/webmin-1.100/stta/help/</i>.<br>
|
|
</ul><br>
|
|
<li><b>¿ Se puede disponer de una página a modo de <u>MANUAL de STTA</u> ?</b> <br><br>
|
|
Usar la URL: <u>http(s)://webmin-host:port/stta/help.cgi/stta/tocbook</u><br>
|
|
O los enlaces a <img align=top border=0 src="/stta/help/images/icon_pencil.gif"><a onClick='window.open("/stta/help/es/tocbook.html?stta_webhelp", "stta_webhelp", "toolbar=no,menubar=no,scrollbars=yes,width=800,height=600,resizable=yes"); return false' class='menu1' class='menu1' href="/stta/help/es/tocbook.html?stta_webhelp">Libro STTA</a><br>
|
|
</li>
|
|
</ul>
|
|
|
|
|
|
<table bgcolor=#ba9e79 BORDER=1 width=100%><tr><td><table BORDER=1 width=100%><tr><td bgcolor=#ffe0b0><table><tr><td><a class='menu1' class='menu1' href="/stta/help/es/.html"></a> </td><td><a class='menu1' href="/stta/help/es/sec_inface.html"> Interface de STTA </a> </td><td><a class='menu1' href="/stta/help/es/config_interface.html"> Configuración interface</a> </td></tr></table></td></tr><tr><th bgcolor=#ba9e79><center><font color=#ffffff>ver también</font></th></tr></table> </td> </tr> </table>
|
|
</tr></td></table>
|
|
<HR noshade size=2>
|
|
<table BORDER=0 WIDTH=100%>
|
|
<tr>
|
|
<td valign=top align=left><a class='menu1' href="/stta/help/es/toc.html"> <img align=middle border=0 alt="Indice" src="/stta/help/images/stta_button.gif"><tt>Indice</tt></a><br><br>
|
|
<tt> [30/12/2003 10:56:48]</tt><br>
|
|
<small> Ayuda versión 3.1</small>
|
|
</td>
|
|
<td valign=top align=right>
|
|
<DIV align="right">
|
|
<small>
|
|
Versión 1.3 derechos de Copia © 2001-2003 por
|
|
<BR> Jesús Pérez
|
|
<BR>Este módulo STTA de Webmin está bajo
|
|
<BR> GNU GPL www.gnu.org <BR>
|
|
<a class='menu1' href="/stta/help/es/license.html"><tt>Licencia</tt></a></td>
|
|
</small>
|
|
</DIV>
|
|
</tr></table>
|
|
<hr>
|
|
|
|
<link rel='stta' href='../images/favicon.ico' type='image/x-icon' ><style type='text/css'>.menu1 { line-height: 20px; text-decoration: none; padding-left: 2px; } .menu1:Hover { text-decoration: none; color : ffffff; background-color: ba9e79; } .menu1:Visited { text-decoration: none; } .menu1:Active { text-decoration: none; } .menu2 { line-height: 20px; text-decoration: none; padding-left: 2px; color : ffffff; } .menu2:Hover { text-decoration: none; color : ba9e79; background-color: ffe0b0; } .menu2:Visited { text-decoration: none; } .menu2:Active { text-decoration: none; } </style> |