Cómo escribir ficción, novelas y ensayos utilizando VSCode (y VSCodium)

Desde hace un tiempo estoy intentando escribir textos más largos. Ensayos, novelas, ese tipo de cosas. Y escribir textos largos, de miles y miles de palabras, demuestra tener varias sorpresas técnicas que no esperaba.

Hasta el momento siempre estuve utilizando LibreOffice Writer pare escribir. Se trata de un procesador de texto al estilo Microsoft Word, ninguna sorpresas con eso. Ese tipo de programa no tiene ningún problema trabajando con textos largos. El inconveniente comienza al intentar ordenar un texto largo en una obra terminada.

Mi experiencia escribiendo sin usar VSCodium

Entonces tengo un ensayo de unas cincuenta mil palabras, dividido en ocho documentos diferentes. ¿Cómo puedo hacer para poder entender el conjunto entre todas esas partes?

Lo primero que intenté es utilizar la función de navegación que es parte de LibreOffice. Eso nos permite movernos fácilmente entre los distintos subtítulos dentro del material, y podemos saltar entre los archivos en el directorio.

Esto soluciono el problema de la navegación momentáneamente, pero la mayor parte de los problemas continuaba. Por ejemplo no tenía una forma práctica de saber si alguna parte del texto se repetía en un documento diferente.

Pero dos problemas persistían:

1- Todavía era poco práctico mover partes y crear nexos entre documentos. Muchas veces un título H2 terminaba pegándose con un párrafo normal y sin querer una parte perdía el formato.

2- En general sentía que me faltaba algo. Algo en todo el proceso me hacía pensar que me estaba perdiendo de alguna forma más sencilla de poder escribir más rápido y divertido.

Antes de continuar experimenté con algunas ideas. Estuve utilizando un poco del lenguaje LaTex y un poco de Markdown para entender que alternativas tenía.

Luego encontré en la red algunas ideas que iban en la dirección que buscaba:

-Writing Novels and Non-Fiction with Visual Studio Code

-Writing a Novel with Visual Studio Code

-Using VS Code for writing novels

Motivado por todas esas ideas me decidí a crear mi propia pequeña guía para encontrar otra forma de escribir, usando diferentes herramientas de otra forma.

Cómo convertir VSCode en un ambiente para escribir novelas y Ensayos

conseguir e instalar VSCode

Bueno… esto no es una guía para instalar VSCode. Y por mi parte estoy utilizando VSCodium, que puede encontrarse en este sitio.

En todo caso, lo importante de este apartado es que esta es la parte más compleja.

Y no es lo más complejo porque es difícil de instalar el programa, es complicado porque nos implica empezar a utilizar un programa nuevo. Es muy difícil romper una costumbre, en especial si utilizamos Word o Writer desde hacer muchos años.

En resumen, si ya utilizás VSCode para escribir código de computadora, esto es simplemente empezar a usarlo para otro tipo de escritura.

Y si nunca utilizaste este programa, conseguirlo es abrir la oportunidad de probar hacer las cosas de otra forma. De más esta decir que el programa es gratuito y puede usarse en todos los sistemas operativos más populares.

Editar el tema y la configuración de VSCode

Otro detalle a consideración libre. Es posible editar la forma en que se presenta el programa, tipografía, tamaño de letra y esos asuntos.

Principalmente hay que recordar que es posible modificar el tema, por ejemplo para cambiar el color de la pantalla.

Utilizar Markdown

Este es otro paso importante. Pueden creerme, hice lo posible por evitarlo bastante tiempo. Pero empezar a usarlo es una ventaja que puede acompañarnos incluso si buscamos utilizar otro tipo de programa para escribir.

Lo primero y más importante es que tenemos que crear el documento que vamos a usar con “.mkd” como extensión.

Segundo tenemos que saber que Markdown es una forma de darle formato al documento. Pero lo verdaderamente interesante es que este formato no vamos a notarlo directamente, solamente vamos a tenerlo al exportar o convertir el archivo.

Por ejemplo, cuando utilizamos un procesador de texto como Word y creamos un título H2, inmediatamente vemos que el título se diferencia del párrafo común. Esto es bueno, pero vuelvo un texto largo difícil de manipular.

En cambio al usar Markdown, un título H2 va a verse como: “## mi titulo”.

Es mucho más fácil de leer en un solo movimiento, y nos permite escribir mucho más rápido.

Cómo mostrar markdown desde VSCode

Para pre visualizar el documento puedo usar el atajo de teclado:

Shift + ctrl + P

Esto abre la paleta de comandos. Desde ahí selecciono:

Markdown: open preview

No necesito ninguna extensión extra para hacerlo.

Agregar un contador de palabras

Esto demostró ser más difícil de lo que pensaba. Esta es una solución que funciona, pero voy a buscar otras opciones.

Para tener acceso al contador de palabras vamos a tener que buscar la extensión:

Markdown & Quarto Word Count

Y luego la activamos desde la paleta de comandos. Recordar reiniciar el programa antes de usar la extensión por primera vez.

La extensión funciona bien, pero me gustaría encontrar alguna otra forma de hacerlo, solo por curiosidad de entender cómo funciona.

Pero en resumen, con esta extensión ya vamos a tener contador de palabras activado.

Activar un control de ortografía

Existen varias extensiones para conseguir revisar la ortografía del documento.

De momento esto utilizando la extensión: Spell Right

También existe otra opcion, tal vez más sencilla de poner a funcionar en VScodium: Code Spell Checker

Cómo instalar Spell Right en VSCodium

Esto merece un pequeño apartado propio. En VSCodium esta extensión no parece funcionar instalándola directamente como en VSCode

Por eso primero tengo que ir al sitio de la extensión: Spell Right

Y luego tengo que hacer clic en “Download Extension”.

Con eso voy a bajar un archivo en la computadora. Por ejemplo al directorio “Descargas”. Ese archivo va a tener el número de versión de la extensión, por ejemplo:

ban.spellright-3.0.124.vsix

Luego voy a abrir la terminal en ese directorio y voy a instalar la extensión con este comando:

$ codium --install-extension ban.spellright-3.0.124.vsix

Por supuesto voy a necesitar modificar el nombre del archivo según el que yo tengo en el equipo en ese momento.

Ahora voy a necesitar agregar diccionarios para que la extensión funcione. Ya que esta herramienta puede usarse puedo utilizar por ejemplo los mismos diccionarios de Libreoffice o del sistema Lunux que se encuentran en la carpeta “hunspell”. Puede ser este directorio:

/usr/share/hunspell

Luego tengo que copiarlos y pegarlos en el siguiente directorio (otra vez en Linux):

~/.config/VSCodium/Dictionaries

Pero para simplificar, puedo crear una link simbólico entre el contenido de la carpeta hunspell y los diccionarios de VSCodium. Eso puedo hacerlo directamente con este comando:

$ ln -s /usr/share/hunspell/* ~/.config/VSCodium/Dictionaries

Luego tengo que abrir la extensión en la paleta de comandos, y elegir el diccionario que quiero utilizar.

Y eso es todo, ya puedo revisar la ortografía utilizando Spell Right en VSCodium dentro de Linux.

Cómo solucionar el error: command ‘spellright.’ not found

A veces ocurre que Spell Right nos da un error similar a este:

Command 'SpellRight: Select Dictionary (Language)' resulted in an error (command 'spellright.selectDictionary' not found)

Según entiendo este error puede ocurrir por alguna de estas razones:

A) VSCodium recibe una actualización, y la extensión Spell Right necesita algunos días para poder responder a esa actualización.

B) Por algún raro motivo imposible de descifrar la extensión deja de descrifrar.

En caso de que algo de esto ocurra, lo mejor es esperar un poco y reintentar la instlación un tiempo despues.

La otra opción es instalar “Code Spell Checker”, y empezar a escribir.

Empezar a escribir es lo más importante despues de todo, estas cosas son simples herramientas y no tenemos que dejar que la personalización constante del procesador de texto nos distraiga demasiado.

Entrar en modo zen con VSCodium

El modo zen permite remover todos los menús del programa, para centrarnos únicamente en la pantalla para escribir.

Podemos activarlo y desactivarlo con un atajo, primero presione “Ctrl + k” y el sistema se queda esperando que ingrese otra tecla. Luego presiono “z”y entro en este modo zen.

Utilizo el mismo atajo para salir.

Entonces el atajo es:

Ctrl + k z

Escribir guiones cinematográficos con VSCode

Existe un lenguaje para darle formato a un guion cinematográfico llamado Fountain.

Puedo utilizar de manera sencilla esta sintaxis utilizando la extensión: Better Fountain.

Por supuesto la utilización de esta sintaxis requiere algunos pequeños trucos que se aprenden con la práctica. Además es necesario ajustar algunas cosas para usarlo más rápido en castellano.

Conclusión

Con esto termina este breve apunte sobre Cómo escribir ficción, novelas y ensayos utilizando VSCode.

Bueno, en realidad estuve utilizando VSCodium, pero se entiende el punto.Esta misma entrada fue escrita utilizando una configuración como la que describí antes.

Lo bueno de utilizar este editor es que se puede personalizar de muchas formas. Y la estructura que permite mantener el explorador de directorios del programa vuelve mucho más fácil organizar textos largos como novelas o ensayos.

Cualquier idea o crítica que tengas sobre este texto, me gustaría conocer tus opiniones en los comentarios.

La seguimos en el próximo apunte.