======ASCIInema===== **ASCIInema** en una plataforma que permite registrar y almacenar el texto que aparece en la [[terminal de computadora|terminal]]. Funciona capturando la salida de texto [[arte ascii|ASCII]] del [[intérpretes de comandos|intérprete de comandos]] actual, y guardándola en un fichero ''.cast''. Este fichero puede quedar local y reproducirlo mas tarde, y opcionalmente se lo puede subír a una plataforma de agregado de capturas de terminal, [[https://asciinema.org|asciinema.org]]. >Las capturas subidas a ASCIInema.org pueden hacerse públicas, no listadas (para compartir con una URL específica) o bien dejarse privados. ====Uso de ASCIINEMA==== ===Grabar la terminal a un fichero local=== Si deseas grabar la salida de la sesión de terminal a un fichero local, ingresa: asciinema rec ~/archivo.cast Esto iniciará un intérprete de comandos anidado, y comenzará a registrar la grabación en el fichero local ''~/archivo.cast''. Para detener la grabación, ingresa **Ctrl+d**: esto detendrá el intérprete anidado y guardará la salida de terminal en ''archivo.cast''. ===Grabar la terminal con Asciinema === Si inicias una subida de una captura de terminal ''.cast'' a la plataforma, se te proveerá un URL que deberás introducir en un navegador. Esto te permitirá o bien asociar la grabación a un usuario de asciinema previamente existente (si lo tuviéses), o bien a un correo electrónico que desees asignar al usuario de asciinema para iniciar el proceso de registro en asciinema.org. En caso de ser la primera vez que lo h aces, debes aceptar el enlace que te llegue por correo electrónico, lo cual adosará un token a tu usuario. Entonces subirá la captura de terminal asociándolo al mismo. Podrás asociar o revocar tokens (lo cual útil en caso de tener varios dispositivos). En texto-plano, podrás grabar el contenido de la sesión actual de terminal y subirlo a la plataforma asciinema.org con un título, mediante: asciinema rec -t "Sesión de terminal de ~$USER en texto-plano.xyz" ...o bien no indicar título alguno (no recomendado): asciinema rec La grabación comenzará inmediatamente. Cuando desees interrumpir la grabación e iniciar la subida, deberás concluir la sesión del intérprete de comandos anidado, mediante **Ctrl+d**. ==Limitar tiempo inactivo== Una opción muy interesante que tiene ASCIInema es la de limitar el tiempo inactivo de la terminal, evitándolo si supera un período determinado. Por ejemplo, para limitar el tiempo máximo inactivo a 1,5 segundos, podríamos utilizar asciinema rec -i 1.5 archivo.cast ===Reproducción de la captura de terminal=== Podrás usar asciinema para reproducir capturas de terminal realizadas con la plataforma. Por ejemplo, para reproducir el fichero ''~/archivo.cast'' ingresa: asciinema play ~/archivo.cast Siempre podrás detener una reproducción con **Ctrl+z**. Por otro lado, también podrías reproducir cualquier captura almacenada en la plataforma asciinema.org. Para ello ingresa su URL, de este modo: asciinema play https://asciinema.org/a/444386 También es posible presentar en pantalla todo el ''archivo.cast'' mediante el comando //cat//, a fin de lograr la reproducción desde cualquier sistema tipo Unix. Para ello ingresa: asciinema cat archivo.cast ====Subir la captura a Asciinema.org ==== Si ya tienes un usuario creado en la plataforma, podrás subir un fichero ''.cast'' a ASCIInema.org. Para ello ingresa: asciinema upload archivo.cast -t "Título de la Captura" ====Compartir capturas de ASCIInema==== Una vez que hayas subido tu captura a la plataforma asciinema.org, podrás obtener un enlace para compartir para el registro en ASCII específica haciendo clic en el enlace "//Share//" en la página de la transmisión correspondiente en la plataforma ASCIInema.org Cualquiera de las opciones listadas en la sección “Personalizando la reproducción” permite agregar la URL de la transmsión ASCII y una serie de parámetros opcionales. Por ejemplo: https://asciinema.org/a/444386?t=25&speed=2&theme=tango De esta manera, al visitar este enlace se comenzará la reproducción a los 25 segundos y se reproducirá al doble de velocidad, utilizando el tema de terminal Solarized Dark. ===Pegar enlace de imagen=== En los lugares donde no se permiten los guiones, podrás pegar en enlace como si se tratara de un enlace de imagen. Por ejemplo, en un fichero ''README''. Podrás incluso incrustar fracciones de un asciicast específico presionando el botón "Share" en la página de ASCIIcast. ==HTML== En caso de usar HTML, utiliza este formato: ==Markdown== En caso de usar Markdown, recurre a este formato: [![asciicast](https://asciinema.org/a/14.png)](https://asciinema.org/a/14) A su vez, podrás pasar opciones extra (listadas en la sección "personalizar el reproductor") a la URL enlazada como "parámetros". Por ejemplo, para iniciar la reproducción automáticamente al abrir el enlace de asciicast, agrega la cadena ''?autoplay=1'' a la URL dentro del atributo ''href'' indicado, de esta forma: ===Incrustar el Enlace de Reproductor=== Si deseas incrustar el //widget// del reproductor en tu propia página web o en un sitio que permite el etiquetado de guiones, podrás recurrir a hacer clic en el enlace "Embbed" de la página del asciicast. Se te presentará un código con una apariencia similar a la siguiente: