ponysay/manuals/manpage.es.6

248 lines
9.8 KiB
Groff

.TH PONYSAY 6 "16 de Julio de 2013"
.SH NOMBRE
ponysay \- Una reimplementación de cowsay usando ponis
.SH SINOPSIS
.B ponysay
.RI [ opciones ]
[--]
.RI [ mensaje ]
.br
.B ponythink
.RI [ opciones ]
[--]
.RI [ mensaje ]
.br
.SH DESCRIPCIÓN
.PP
\fBponysay\fP muestra la imagen de un poni con un texto dado por el usuario,
esto dentro de la terminal.
.br
Si el \fImesaje\fP no es provisto, ponysay aceptará una orden estándar.
El mensaje debería de tener alrededor de 60 columnas, y el o la poni devería
de mostrar este mensaje en una salida estándar.
.PP
Si no se da ningún argumento, el programa solamente aceptará mensajes
estándares provistos por otros programas, un archivo, ambos o una cadena de
caracteres (véase también bash(1) para detalles de archivos y cadenas de caracteres.)
.PP
\fBponythink\fP es a \fIponysay\fP lo que \fIcowthink\fP es a \fIcowsay\fP.
.SH OPCIONES
El resumen de las opciones está incluido acontinuación.
.TP
.B \-h, \-\-help
Muestra la ayuda, un resumen de las opciones.
.TP
.B \-v, \-\-version
Muestra la versión del programa.
.TP
.B \-f, \-\-file, \-\-pony \fInombre\fP
Selecciona un poni específico (ya sea un archivo o el nombre directamente),
puedes usar esta opción con múltiples ponis y de estos será elejído uno al azar.
.TP
.B \+f, \+\+file, \+\+pony \fInombre\fP
Selecciona un poni no pertenecientes a MLP:FiM (ya sea un archivo o el nombre
directamente), puede usar esta opción con múltiples ponis y de estos será
elejído uno al azar.
.TP
.B \-F, \-\-any\-file, \-\-anyfile, \-\-anypony \-\-any\-pony \fInombre\fP
Esta opción combina \fI-f\fP y \fI+f\fP.
.TP
.B \-q, \-\-quote [\fInombre\fP...]
Usando esta opción un poni será mostrado dando una cita de
My Little Pony: Frienship is magic (My Little Pony: La magia de la amistad).
Este poni será seleccionado aleatoriamente salvo que uno o varios ponis sean
agregados tras la opción \fI-q\fP, en cuyo caso se seleccionará aleatoriamente
uno de este conjunto.
.TP
.B \-\-f, \-\-files, \-\-ponies \fI[nombre...]\fP
Variable variádica de \fI-f\fP, o sea, todos los argumentos dados después de
este argumento serán pasados a dicha opción.
.TP
.B \+\+f, \+\+files, \+\+ponies \fI[nombre...]\fP
Variable variádica de \fI+f\fP, o sea, todos los argumentos dados después de
este argumento serán pasados a dicha opción.
.TP
.B \-\-F, \-\-any\-files, \-\-anyfiles, \-\-anyponies \-\-any\-ponies \fInombre\fP
Esta opción combina \fI--f\fP y \fI++f\fP.
.TP
.B \-\-q, \-\-quotes [\fInombre\fP...]
Variable variádica de \fI-q\fP, todos los argumentos dados después de este
argumento serán pasados a dicha opción.
.TP
.B \-b, \-\-bubble, \-\-balloon \fIestilo\fP
Especifica el tipo de globo de texto a utilizar, puede ser la ruta a un archivo
o bien una de las opciones dadas por \fIponysay -B\fP.
.TP
.B \-W, \-\-wrap \fIcolumna\fP
Las columnas de la pantalla en las que debe presentarse el mensaje,la anchura
extra del globo se toma en consideración. Si el argumento no es un número,
sino que inicia en su lugar con \fIn\fP, no hay ajuste alguno y si comienza
con \fIi\fP el ancho de la terminal es tomado.
.TP
.B \-c, \-\-compress, \-\-compact [\fIcolor-ansi\fP]
Comprime en mensaje en la misma manera que \fIcowsay\fP lo hace,
esto es básicamente sin multiples espacios y solo separando párafos.
.TP
.B \-l, \-\-list
Lista los ponis disponibles.
.TP
.B \-L, \-\-symlist, \-\-altlist
Lista los ponis con nombres alternativos (enlaces simbólicos) dentro de
paréntesis.
.TP
.B \+l, \+\+list
Lista los ponis no pertenecientes a MLP:FiM disponibles.
.TP
.B \+L, \+\+symlist, \+\+altlist
Lista los ponis no pertenecientes a MLP:FiM con nombres alternativos dentro de
paréntesis.
.TP
.B \-B, \-\-bubblelist, \-\-balloonlist \fIestilo\fP
Muestra la lista de globos de texto disponibles.
.TP
.B \-A. \-\-all
Lista todos los ponis, tanto pertenecientes a MLP:FiM cono no pertenecientes a
esta la primera lista son los pertenecientes a esta y la subsiguente los no
pertenecientes.
.TP
.B \+A, \+\+all, \-\-symall, \-\-altall
Lista todos los ponis incluyendo sus nombres alternativos, estos pertenecientes
a MLP:FiM cono no pertenecientes, la primera lista seran los pertenecientes y la
subsiguente los no pertenecientes a esta.
.TP
.B \-o, \-\-pony\-only, \-\-ponyonly
Solamente muestra al poni, No así con los demás elementos.
.TP
.B \-i, \-\-info
Agregando esta opción podrá ver los metadatos del poni en lugar de este.
.TP
.B \+i, \+\+info
Esta opción funciona como \fI-i\fP, solo que el poni mostrará la información
en un globo de texto.
.TP
.B \-r, \-\-restriction
Esta opción limita cuales ponis serán mostrados basados en sus metadatos.
Un valor para este argumento es una combinación del nombre de la etiqueta en
la forma de \fINOMBRE=VALOR\fP.
.TP
.B \-X, \-\-256\-colours, \-\-256colours, \-\-x\-colours
Usa el soporte de 256 colores de \fIxterm\fP (soportado por la mayoría de
terminales en X11), sindiferencia entre las capacidades de la terminal.
.TP
.B \-V, \-\-tty\-colours, \-\-ttycolours, \-\-vt\-colours
Usa la compatibilidad de la terminal VT de Linux \fPsin\fP usar KMS, indiferente
de las capacidades de la terminal.
.TP
.TP
.B \-K, \-\-kms\-colours, \-\-kmscolours
Usa la compatibilidad de la terminal VT de Linux \fPusando\fP KMS, indiferente
de las capacidades de la terminal (no funciona en todas las tarjetas con soporte KMS).
.TP
.B \+c, \-\-colour [\fIcolor-ansi\fP]
Colorea el globo, Incluyendo mensajes y enlaces.
Para más información acerca del coloreo vea las páginas \fIinfo\fP.
El argumento o \fIcolor-ansi\fP, Puede ser una secuencia de colores ANSI
sin precedir de CSI y sin la cola \fIm\fP, por ejemplo \fI1;31\fP puede
referirse al color rojo y en negrita (o claro dependiendo de la terminal.)
.TP
.B \-\-colour\-bubble, \-\-colour\-balloon [\fIcolor-ansi\fP]
Trabaja como \fI\--colour\fP pero solo colorea el globo de texto.
.TP
.B \-\-colour\-link [\fIcolor-ansi\fP]
Trabaja como \fI--colour\fP pero solo colorea en enlace al globo de texto.
.TP
.B \-\-colour\-msg, \-\-colour\-message [\fIansi-colour\fP]
Trabaja como \fI--colour\fP pero solo colorea el texto.
.TP
.B \-\-colour\-pony [\fIansi-colour\fP]
Trabaja como \fI--colour\fP pero solo colorea el poni.
Este coloreo no tiene efecto en archivos pony dado que tienen su propio coloreo.
.TP
.B \-\-colour\-wrap, \-\-colour\-hyphen [\fIansi-colour\fP]
Trabaja como \fI--colour\fP pero solo colorea guiones agregados por la
envoltura del texto.
Si desea remover el color use \fI0\fP (cero),
por omisión es \fI31\fP (treintaiuno).
.SH ENTORNO
.TP
.B PONYSAY_BOTTOM
Bajo TTY (Linux VT), si la imagen es mas larga que la anchura de la terminal
en pantalla, solo el inicio de esta es impreso, dejando solamente dos líneas
blancas, si desea que apesar de todo sea impreso el fondo puede exportar
\fIPONYSAY_BOTTOM\fP con el valor \fIyes\fP, \fIy\fP o \fI1\fP.
.TP
.B PONYSAY_SHELL_LINES
Bajo TTY (Linux VT), si la imagen es mas larga que la anchura de la terminal
en pantalla, solo dos líneas blancas serán impresas. si desea mas o menos
líneas blancas, puede exportar \fIPONYSAY_SHELL_LINES\fP con el valor de cuantas
desea.
.TP
.B PONYSAY_FULL_WIDTH
Puede exportar \fIPONYSAY_FULL_WIDTH\fP con el valor \fIyes\fP, \fIy\fP o
\fI1\fP, si desea que la salida sea truncada para que calce en la terminal.
.TP
.B PONYSAY_TRUNCATE_HEIGHT
Exporte \fIPONYSAY_TRUNCATE_HEIGHT\fP con el valor \fIyes\fP, \fIy\fP o
\fI1\fP, si desea truncar la salida en el largo aun si no se está dentro de
una terminal \fIponysay\fP bajo TTY.
.TP
.B PONYSAY_UCS_ME
Exportar \fIPONYSAY_UCS_ME\fP con el valor \fIyes\fP, \fIy\fP o \fI1\fP, si es
que busca 'simular enlaces simbólicos' a ponis usando
'Universal Character Set' (Conjunto de Caracteres Universal) [UCS] apuntando a
sus nombres.
.TP
.B PONYSAY_KMS_PALETTE, PONYSAY_KMS_PALETTE_CMD
\fIPONYSAY_KMS_PALETTE\fP o \fIPONYSAY_KMS_PALETTE_CMD\fP es usado para llamar a
ponysay usando la paleta TTY tal cual es, esto es usado para mostrar a las ponis
usando la mejor calidad de colores posible si esta bajo TTY y si su video
soporta 'Kernel Mode Seting' (KMS) y este está activo.
.TP
.B PONYSAY_TYPO_LIMIT
\fIponysay\fP es capaz de autocoregir nombres mal escritos y tipos de globo de
texto sin conciderar la transposición de texto, por omisión si la distancia
ponderada es mayor a 5 (cinco) para la palabra más cercana, entonces es
ignorada la autocorrección.
Este limite puede ser cambiado si se exporta un numero a la variable
\fIPONYSAY_TYPO_LIMIT\fI; Dejando este valor en 0 se desactiva la
autocorrección.
.TP
.B PONYSAY_WRAP_HYPHEN
Puede exportar que usará ponysay en lugar del guion cuando se envuelven
los mensajes.
.TP
.B PONYSAY_WRAP_LIMIT
Define cuan largo deverá de ser la palabra para que se utilice el guion.
Esta se utiliza para envolver palabras que son muy largas para que la salida
sea lo mejor posible.
Esta no es la única condición bajo la cual puede ser cortada una palabra,
también puede cortar si la palabra no puede encajar de otra manera.
.TP
.B PONYSAY_WRAP_EXCEED
Define cuan larga puede llegar a ser una palabra antes de que sea cortada con
un guion.
Esta opción es usada en conjunto con \fIPONYSAY_WRAP_LIMIT\fP.
.SH FALLOS
.nf
Los fallos pueden ser reportados en
.br
<\fBhttps://github.com/erkin/ponysay/issues\fP>.
.SH VEA TAMBIÉN
.BR cowsay (0),
.BR fortune (0).
.br
.SH AUTOR
ponysay fue escrito por Erkin Batu Altunbaş <erkinbatu@gmail.com>
con la ayuda de Mattias Andrée, Elis Axelsson, Sven-Hendrik Haase,
Pablo Lezaeta, Jan Alexander Steffens y otros.
.\" vea el archivo CREDITS para la lista completa.
.PP
Este manual originalmente fue escrito por Louis Taylor <kragniz@gmail.com>
para el proyecto Debian GNU/Linux (y puede ser usado por otros), y editado por
los autores de ponysay para el lanzamiento oficial de este.
.br
La actual traducción al español fue escrita por Pablo Lezaeta <prflr88@gmail.com>.
.br
.PP
Este programa está licenciado bajo la GNU GPLv3+
.\" Vea el archivo COPYING para ver la licencia completa.