Tutorial de DocBook: Un enfoque integrado y a través de ejemplos | ||
---|---|---|
Anterior | Capítulo 3. Escribiendo un documento más complejo | Siguiente |
A veces es necesario describir la manera como interactua el usuario con una aplicación através de los menués que esta presenta o mediante combinaciones de teclas que el usuario digita, ese es el objetivo del siguiente ejemplo
<sect1> <title>Escribiendo y guardando un archivo</title> <para>Dentro del editor escriba la frase <userinput>Hola Mundo</userinput> y posteriormente guarde dicho archivo usando <menuchoice> <shortcut> <keycombo action="seq"><keycombo action="simul"><keycap>Control</keycap><keycap>x</keycap> </keycombo><keycombo><keycap>Control</keycap> <keycap>s</keycap></keycombo> </shortcut> <guimenu>Files</guimenu> <guimenuitem>Save Buffer as</guimenuitem> </menuchoice>, a continuación <application>emacs</application> responderá con el mensaje <computeroutput>File to save in:~/20013/doc-tut/e2</computeroutput>, restando que usted escriba solamente el nombre del archivo (<filename>hola.txt</filename>).</para> </sect1> |
y la manera como se ve dicho código es
Dentro del editor escriba la frase Hola Mundo y posteriormente guarde dicho archivo usando Files->Save Buffer as (Control+x Control-s), a continuación emacs responderá con el mensaje File to save in:~/20013/doc-tut/e2, restando que usted escriba solamente el nombre del archivo (hola.txt).
Dentro de este ejemplo hemos usado la marquilla menuchoice que indica la interacción con la aplicación através de menúes, posteriormente para seleccionar cada interacción con el menú lo hacemos através de guimenu y guimenuitem; como información adicional es útil saber que se tienen marquillas que permiten interacción con botones o iconos (guibutton y guiicon).
Otro punto importante de este ejemplo consiste en la utilización de shortcut que indica un atajo de interacción através del teclado, dentro de este usamos keycombo que nos permite describir una combinación de teclas, dicha marquilla tiene el atributo action el cual sirve para describir como se efectúa la combinación de teclas, en este caso la primera combinación es una secuencia (seq) y las siguientes dos combinaciones son simultáneas (simul), la marquilla keycap indica que se trata de una sola tecla.
La última observación consiste en que cuando se haga referencia a un nombre de un archivo es conveniente usar filename, en caso de que uno hable de un directorio debe usar el atributo de dicha marquilla class igual a directory