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<65>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<65>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<65>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"><EFBFBD>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<65>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<65>fica sobre los items de entradad de datos. En la parte superior Izquierda de la ventana el texto <u>Ayuda</u> ofrece informaci<63>n gen<65>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<73>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<73> sujeto a los mismos detalles y configuraci<63>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<63>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<73> 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<63>n general en modo resumen y detalles relevantes. </li>
|
|||
|
|
<li> "Include" de fichero <u>LANG/body</u> del tema. Texto con descripci<63>n y an<61>lisis detallado del tema. </li>
|
|||
|
|
<li> Carga de referecias cruzadas (caja <u>ver tambi<62>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<6C>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<63>n general en modo resumen y detalles relevantes. </li>
|
|||
|
|
<li> <u>LANG/body</u>/tema. Texto con descripci<63>n y an<61>lisis detallado del tema. </li>
|
|||
|
|
<li> <u>LANG/config</u>/par<61>metro. Texto con detalles de la configuraci<63>n del par<61>metro de la secci<63>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><EFBFBD> Se puede desactivar la ayuda ?</b> <br>S<EFBFBD>, 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><EFBFBD> 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<73> establecido sobre la <a class='menu1' href="http://www.eagora.info/stta">Web de publicaci<63>n</a> de la versi<73>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<70>ol), entonces, el enlace se establecer<65> contra este path. Habr<62> que actualizar el fichero pdf del libro cuando cambie en la <a class='menu1' href="http://www.eagora.info/stta">Web de publicaci<63>n</a>.</li><br>
|
|||
|
|
<li><b><EFBFBD> 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><EFBFBD> Sobre qu<71> 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<70>ol) y los ficheros LANG correspondientes al idioma del directorio "lang" del m<>dulo, en especial el gen<65>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><EFBFBD> Se pueden usar variables del entorno y valores de cadenas de texto ?</b> <br>S<EFBFBD>, 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<74>do por el valor de la <u>cadena de texto</u> correspondiente.</li>
|
|||
|
|
<li> "exec config{nombre-de-la-variable}" es sustitu<74>do por el valor de la <u>variable</u> correspondiente.</li>
|
|||
|
|
<li> "infoCfg{nombre-del-par<61>metro}" (no hay que incluirlo entre <>) es sustitu<74>do por el valor de la <u>cadena de texto del formulario de configuraci<63>n</u> correspondiente (ficheros "config.info.LANG).</li>
|
|||
|
|
</ul></li><br>
|
|||
|
|
<li><b><EFBFBD> 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><EFBFBD> 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<73>n (.html).<br>
|
|||
|
|
Ejemplo: p<>gina <20>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<63>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<EFBFBD>n de STTA</a></i> usar "config_[secci<63>n]", la secci<63>n es el nombre del fichero ubicado en el directorio de configuraci<63>n de <b>STTA</b> (<i>/etc/webmin/stta/dataconf</i>).<br></li>
|
|||
|
|
<li> Si se trata de un par<61>metro de la ayuda, usar <u>config/[par<61>metro]</u>, el par<61>metro es el nombre del fichero html ubicado en el "directorio de la ayuda"/LANG/config.<br>
|
|||
|
|
Ejemplo: p<>gina par<61>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<65>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><EFBFBD> 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<63>n interface</a> </td></tr></table></td></tr><tr><th bgcolor=#ba9e79><center><font color=#ffffff>ver tambi<62>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<73>n 3.1</small>
|
|||
|
|
</td>
|
|||
|
|
<td valign=top align=right>
|
|||
|
|
<DIV align="right">
|
|||
|
|
<small>
|
|||
|
|
Versi<EFBFBD>n 1.3 derechos de Copia © 2001-2003 por
|
|||
|
|
<BR> Jes<65>s P<>rez
|
|||
|
|
<BR>Este m<>dulo STTA de Webmin est<73> 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>
|