Connect with us

Noticias

Cómo usar pandoc para convertir archivos en la línea de comandos de Linux

Published

on

Puede usar pandoc en Linux para convertir entre más de 40 formatos de archivo. También puede usarlo para crear un sistema simple de documentos como código escribiendo en Markdown, almacenando en git y publicando en cualquiera de sus formatos compatibles.

Si tiene un documento en cualquiera de pandoc's muchos formatos de archivo compatibles de pandoc's , convertirlo a cualquiera de los otros es muy sencillo. Esa es una herramienta útil para tener!

Pero el poder real de pandoc hace evidente cuando lo usas como la base de un sistema simple de docs-as-code. La premisa de docs-as-code es adoptar algunas de las técnicas y principios del desarrollo de software y aplicarlos a la documentación escrita, especialmente para proyectos de desarrollo de software. Sin embargo, puede aplicarlo al desarrollo de cualquier tipo de documentación.

Los desarrolladores de software usan su editor favorito o entorno de desarrollo integrado (IDE) para escribir sus programas. El código que escriben se guarda en archivos de texto. Estos contienen el código fuente del programa.

Utilizan un sistema de control de versiones, o VCS (Git es el más popular), para capturar cambios en el código fuente a medida que se desarrolla y mejora. Esto significa que el programador tiene un historial completo de todas las versiones de los archivos de código fuente. Él o ella puede acceder rápidamente a cualquier versión anterior de un archivo. Git almacena archivos en un repositorio. Hay un repositorio local en la computadora de cada desarrollador y un repositorio central, compartido y remoto que a menudo está alojado en la nube.

Cuando están listos para producir una versión funcional del programa, usan un compilador para leer el código fuente y generar un ejecutable binario.

Al escribir sus documentos en un lenguaje de marcado ligero y basado en texto, puede usar un VCS para controlar la escritura de su versión. Cuando esté listo para distribuir o publicar un documento, puede usar pandoc para generar tantas versiones diferentes de su documentación como necesite, incluidas las basadas en web (HTML), procesadas por texto o compuestas (LibreOffice, Microsoft Word, TeX) , formato de documento portátil (PDF), libro electrónico (ePub), etc.

Puede hacer todo esto desde un conjunto de archivos de texto livianos controlados por versión.

Para instalar pandoc en Ubuntu, use este comando:

sudo apt-get install pandoc en una ventana de terminal.

En Fedora, el comando que necesita es el siguiente:

sudo dnf install pandoc in a terminal window.

En Manjaro, debe escribir:

sudo pacman -Syu pandoc en una ventana de terminal.

Puede verificar qué versión ha instalado utilizando la opción --version :

pandoc --version en una ventana de terminal.

Si usa pandoc sin ninguna opción de línea de comandos, también acepta entradas escritas. Simplemente presione Ctrl + D para indicar que ha terminado de escribir. pandoc espera que escriba en formato Markdown y genera una salida HTML.

Veamos un ejemplo:

Pandoc en una ventana de terminal.

Hemos escrito algunas líneas de Markdown y estamos a punto de presionar Ctrl + D.

Ejemplo de líneas de rebajas escritas en pandoc en una ventana de terminal.

Tan pronto como lo hagamos, pandoc genera la salida HTML equivalente.

HTML generado por pandoc en una ventana de terminal.

pandoc embargo, para hacer algo útil con pandoc , realmente necesitamos usar archivos.

Markdown es un lenguaje de marcado ligero, y se da un significado especial a ciertos caracteres. Puede usar un editor de texto sin formato para crear un archivo Markdown.

Markdown se puede leer fácilmente, ya que no hay etiquetas visualmente engorrosas para distraer del texto. El formato en documentos Markdown se asemeja al formato que representa. A continuación se presentan algunos de los conceptos básicos:

Cubriremos más ejemplos de todos estos en la siguiente sección.

RELACIONADO: ¿Qué es Markdown y cómo se usa?

Las conversiones de archivos son sencillas. pandoc generalmente puede determinar con qué nombres de archivo está trabajando los formatos de archivo. Aquí, vamos a generar un archivo HTML a partir de un archivo Markdown. La opción -o (salida) le dice a pandoc el nombre del archivo que deseamos crear:

pandoc -o sample.html sample.md en una ventana de terminal.

Nuestro archivo Markdown de muestra, sample.md, contiene la sección corta de Markdown que se muestra en la imagen a continuación.

Texto de Markdown en el archivo sample.md en una ventana del editor gedit.

Se crea un archivo llamado sample.html. Cuando hacemos doble clic en el archivo, nuestro navegador predeterminado lo abrirá.

Representación HTML del archivo de reducción de muestra.md, en una ventana del navegador.

Ahora, generemos un documento de texto con formato de documento abierto que podamos abrir en LibreOffice Writer:

pandoc -o sample.odt sample.md en una ventana de terminal.

El archivo ODT tiene el mismo contenido que el archivo HTML.

Un documento ODT procesado desde Markdown y abierto en LibreOffice Writer.

Un toque ordenado es el texto alternativo para la imagen que también se utiliza para generar automáticamente un título para la figura.

Un pie de foto generado automáticamente en LibreOffice Writer.

Las opciones -f (de) y -t (a) se utilizan para indicarle a pandoc qué formatos de archivo desea convertir. Esto puede ser útil si está trabajando con un formato de archivo que comparte una extensión de archivo con otros formatos relacionados. Por ejemplo, TeX y LaTeX usan la extensión “.tex”.

También estamos utilizando la opción -s (independiente) para que pandoc genere todos los preámbulos de LaTeX necesarios para que un documento sea un documento de LaTeX completo, autónomo y bien formado. Sin la opción -s (independiente), la salida seguiría siendo LaTeX bien formada que podría insertarse en otro documento de LaTeX, no se analizaría correctamente como un documento de LaTeX independiente.

Escribimos lo siguiente:

pandoc -f markdown -t latex -s -o sample.tex sample.md en una ventana de terminal.

Si abre el archivo “sample.tex” en un editor de texto, verá el LaTeX generado. Si tiene un editor LaTeX, puede abrir el archivo TEX para ver una vista previa de cómo se interpretan los comandos de composición tipográfica LaTeX. Reducir la ventana para que se ajuste a la imagen de abajo hizo que la pantalla pareciera pequeña, pero, en realidad, estaba bien.

Un archivo LaTeX abierto en Texmaker, que muestra una vista previa de la página de composición tipográfica.

Utilizamos un editor de LaTeX llamado Texmaker. Si desea instalarlo en Ubuntu, escriba lo siguiente:

En Fedora, el comando es:

En Manjaro, use:

Probablemente esté comenzando a comprender la flexibilidad que proporciona pandoc . Puede escribir una vez y publicar en casi cualquier formato. Es una gran hazaña, pero los documentos se ven un poco vainilla.

Con las plantillas, puede dictar qué estilos usa pandoc cuando genera documentos. Por ejemplo, puede decirle a pandoc que use los estilos definidos en un archivo de Hojas de Estilo en Cascada (CSS) con la opción --css .

Hemos creado un pequeño archivo CSS que contiene el texto a continuación. Cambia el espacio por encima y por debajo del encabezado de nivel un estilo. También cambia el color del texto a blanco y el color de fondo a un tono de azul:

El comando completo está debajo: tenga en cuenta que también utilizamos la opción independiente ( -s ):

pandoc utiliza el estilo único de nuestro archivo CSS minimalista y lo aplica al encabezado de nivel uno.

HTML representado desde markdown con un estilo CSS aplicado al encabezado de nivel uno, en una ventana del navegador

Otra opción de ajuste que tiene disponible cuando trabaja con archivos HTML es incluir el marcado HTML en su archivo Markdown. Esto se pasará al archivo HTML generado como marcado HTML estándar.

Sin embargo, esta técnica debe reservarse para cuando solo está generando salida HTML. Si está trabajando con múltiples formatos de archivo, pandoc ignorará el marcado HTML para archivos que no sean HTML y se pasará a ellos como texto.

También podemos especificar qué estilos se usan cuando se generan archivos ODT. Abra un documento en blanco de LibreOffice Writer y ajuste los estilos de encabezado y fuente para satisfacer sus necesidades. En nuestro ejemplo, también agregamos un encabezado y pie de página. Guarde su documento como “odt-template.odt”.

Ahora podemos usar esto como una plantilla con la opción --reference-doc :

pandoc -o sample.odt --reference-doc = odt-template.odt sample.md en una ventana de terminal.

Compare esto con el ejemplo ODT de antes. Este documento utiliza una fuente diferente, tiene encabezados de colores e incluye encabezados y pies de página. Sin embargo, se generó a partir del mismo archivo Markdown “sample.md”.

Un archivo ODT procesado desde Markdown con un documento de LibreOffice que actúa como una hoja de estilo, en una ventana de LibreOffice Writer.

Las plantillas de documentos de referencia se pueden usar para indicar diferentes etapas de la producción de un documento. Por ejemplo, puede tener plantillas que tengan marcas de agua “Borrador” o “Para revisión”. Se usaría una plantilla sin marca de agua para un documento finalizado.

Por defecto, pandoc usa el motor LaTeX PDF para generar archivos PDF. La forma más fácil de asegurarse de tener satisfechas las dependencias apropiadas de LaTeX es instalar un editor de LaTeX, como Texmaker.

Sin embargo, es una instalación bastante grande: Tex y LaTeX son bastante fuertes. Si el espacio de su disco duro es limitado, o sabe que nunca usará TeX o LaTeX, es posible que prefiera generar un archivo ODT. Luego, puede abrirlo en LibreOffice Writer y guardarlo como PDF.

El uso de Markdown como lenguaje de escritura tiene varias ventajas, que incluyen las siguientes:

RELACIONADO: ¿Qué es GitHub y para qué se utiliza?

Hay muchas más opciones y características dentro de pandoc que las que hemos cubierto aquí. Los procesos de conversión para la mayoría de los tipos de archivos se pueden ajustar y ajustar. Para obtener más información, consulte los excelentes ejemplos en la página web oficial (y extremadamente detallada) de pandoc.

Advertisement

Noticias

La aplicación predeterminada en este teléfono inteligente Samsung resulta tener un agujero de seguridad

Published

on

By

La aplicación predeterminada en este teléfono inteligente Samsung resulta tener un agujero de seguridad

Una de las startups de seguridad cibernética llamada Oversecured ha descubierto una vulnerabilidad de seguridad en una de las aplicaciones predeterminadas de Samsung, donde se dice que esta vulnerabilidad permite a los piratas informáticos robar y acceder a datos personales de las víctimas.

El fundador de Oversecured, Sergey Toshin, dijo que la aplicación predeterminada de Samsung que tiene la brecha es Samsung DeX, donde Toshin ha encontrado esta brecha en la aplicación Samsung DeX para el Samsung Galaxy S10 +.

Para TechCrunch, Toshin también dijo que lo más probable es que este vacío legal también exista en otros dispositivos Samsung que tienen la aplicación, por lo que es bastante peligroso si es explotado por piratas informáticos.

Esta vulnerabilidad también permite a los piratas informáticos insertar aplicaciones de malware en el dispositivo de la víctima para robar fotos, videos, contactos, historial de llamadas, mensajes y cambiar configuraciones sin que el usuario lo sepa.

La propia Oversecured ha publicado detalles sobre esta vulnerabilidad en su blog oficial e informó de la vulnerabilidad a Samsung para su reparación.

Samsung también ha confirmado la existencia de esta vulnerabilidad y dice que hay ‘algunos’ dispositivos Galaxy que pueden ser pirateados, aunque no está claro qué dispositivos están en cuestión.

“Somos conscientes de esta vulnerabilidad y la resolveremos con un parche a través de una actualización de software para abril y mayo de 2021”, dijo Samsung.

Continue Reading

Noticias

Razer realmente venderá sus máscaras RGB en el cuarto trimestre de este año

Published

on

By

Razer realmente venderá sus máscaras RGB en el cuarto trimestre de este año

Hace algún tiempo, un fabricante de periféricos para juegos de Singapur, Razer, anunció su nuevo producto, Project Hazel. El proyecto Hazel en sí viene como una máscara que viene con un diseño moderno y tecnología avanzada.

Se sabe que la Razer Project Hazel es una máscara N95 modificada para que aparezca con un diseño transparente y está equipada con ventilación que admite luces RGB.

Por supuesto, para Razer, RGB es uno de los elementos obligatorios que deben presentarse en sus productos porque el RGB en sí mismo ahora está muy cargado de periféricos para juegos, especialmente los fabricados por Razer.

Ahora Razer ha confirmado que sus máscaras ‘gaming’ se producirán y venderán en el cuarto trimestre de 2021.

Sin embargo, se dice que Razer está vendiendo las máscaras Project Hazel en cantidades limitadas, por lo que serán artículos exclusivos que solo se pueden comprar en el sitio web oficial.

Anteriormente, el propio Razer dijo que esta máscara era capaz de protegerse de una serie de bacterias como las máscaras N95 en general. Sin embargo, debido a que fue hecha por Razer, por supuesto quiere darle una impresión moderna a esta máscara para que el usuario pueda lucir genial y tener estilo.

Hasta ahora, no se sabe cuánto costarán las máscaras hechas por Razer. Pero, por lo general, las máscaras N95 ordinarias ahora se venden a un precio de alrededor de $ 4. ¿Estás interesado en comprarlo?

Continue Reading

Noticias

En los EE. UU., Las personas que han sido vacunadas pueden ingresar a las tiendas Apple sin usar una máscara

Published

on

By

En los EE. UU., Las personas que han sido vacunadas pueden ingresar a las tiendas Apple sin usar una máscara

Se sabe que Apple, una empresa de tecnología de Cupertino, EE. UU., Está implementando una nueva política en sus tiendas relacionada con la pandemia de COVID-19.

Se afirma que a partir de mañana (15/6), los visitantes de la Apple Store en Estados Unidos que hayan recibido y hayan sido vacunados podrán ingresar a la Apple Store sin volver a usar máscara.

Pero una de las cosas que nos confunde es que los funcionarios posteriores de la Apple Store no podrán ver la información ni los certificados de vacunación. Esto, por supuesto, hace que cualquiera afirme haber sido vacunado cuando en realidad no lo ha hecho.

Hasta ahora, los visitantes de la Apple Store deben usar máscaras. Además, la capacidad de visitantes será limitada para que no se produzcan acumulaciones en la tienda.

Por supuesto, esto también muestra que Apple parece estar convencido de que esta vacuna COVID-19 puede protegerse del virus corona. Es por eso que a las personas que han sido vacunadas se les permite no usar más mascarillas, aunque todavía tienen que aplicar protocolos de seguridad como el distanciamiento social.

Por otro lado, Tim Cook como CEO de Apple también anunció recientemente a sus empleados que más tarde todos los empleados volverán a trabajar en la oficina aunque solo sea tres días a la semana.

Continue Reading
Advertisement
Advertisement

Categories

Trending

close
Copy link
Powered by Social Snap