Teclado latinoamericano para Mac

Hace casi dos años que por cuestiones de trabajo empecé a usar MacOS a diario. Una de las muchas frustraciones que enfrenté, al ser un usuario de Linux, es que no tenía la opción de distribución de teclado latinoamericano.

Al no encontrar nada satisfactorio decidí escribir mi propia distribución de teclado desde cero y compartirla con el mundo. Esta entrada explica cómo agregar una distribución de teclado latinoamericano a tu Mac, especialmente si vienes de Linux.

Read more...

Documentation as code

As Technical Writers, we all are living the same life. Writing documentation is a fun learning journey, an opportunity to grow, and overall a great career. At the same time, we can’t avoid the perils of writing docs: it’s hard to find good writing tools, it’s is hard to maintain outdated docs, and delivering to the end-users can become a nightmare.

There’s another guild that faces similar challenges, the Software Developers. They need tools to write code, test it, and deploy it. The good news is that they already have those tools.

What if we as writers were able to leverage those very same tools to improve our everyday job and create great documentation? That’s what this post is all about. I will present some of the software tools that will help you to implement docs as code.

Read more...

Docs as code - Sphinx + Gitlab + Heroku

In a another post I talk about Documentation as Code, showing a list of tools for this purpose. In this post I’m going to talk about a concrete example to implement a Docs as Code workflow.

This example uses Sphinx for the site generation, GitLab for version control, and Heroku to serve the site. The process may seem scary, especially if you are not familiar with some of the tools, but with a little of patience and commitment you can make it through. Keep in mind that you only have to do this once and it will simplify your work in the long term.

Read more...

Fix Tinkerer error with latest Sphinx version

This a superquick entry that focuses on a simple problem. I use Tinkerer, a blogging platform, to create this website. Trying to generate the HTML output, the following error popped up:

Extension error:
Config value 'author' already present

And it seems others using Sphinx-related packages are having similar problems too. This entry explains how I solved it, it is a simple trick.

Read more...

n+1 cosas que hacer después de instalar Linux

Ubuntu publica una nueva versión dos veces por año. Esto se convierte en una oportunidad para escribir sobre qué hacer luego de instalar cada nueva versión, para tener un sistema funcional y listo para el uso diario.

Aunque OpenSuSE mi sistema favorito, de cuando en cuando instalo alguna otra distro. Recientemente instalé Ubuntu en mi portátil y tuve que hace el ritual usual de configurar el sistema a mi gusto. Decidí documentar el proceso. Aunque no soy un usuario promedio, algunas de los siguientes puntos pueden ser útiles para otros.

Read more...

Instalar certificado de Let’s Encrypt en cuenta de GoDaddy

Desde hace poco más de año y medio, varios navegadores decidieron fomentar el uso de comunicación encriptada. Por esta razón, cuando accedes una página que no usa https, tu navegador muestra una alerta de seguridad.

Aunque es discutible si esta política da un falsa sensación de seguridad, si queremos que nuestro sitio web sea accesible hay que conseguir un certificado y configurarlo correctamente.

Por suerte la iniciativa Let’s Encrypt permite obtener un certificado gratis y usarlo en tu sitio web. Este post explica cómo obtener un certificado de Let’s Encrypt, para luego configurarlo y que funcione con el servicio de alojamiento de GoDaddy.

Read more...

Julia sets

Julia sets are a family of fractals that you draw by iterating a complex function and coloring the invariant sets. They are named Julia sets to honor the famous mathematician Gaston Julia. The complement of a Julia set is known as Fatou set, after the mathematician Pierre Fatou.

Loosely speaking, the Julia set of a complex rational function comprises the points with chaotic behavior. For these points, small changes in the input produce huge changes in the output of the function. Fatou sets, on the other hand, remain stable.

Read more...

Spiral seeds

Spirals and sunflowers. Common words when someone wants to show an example of how mathematics is deeply embedded in nature. But, how that really works? What’s the role of the Fibonacci series and the golden ratio in this?

Of course, there are some other examples of Fibonacci spirals in nature. But, what advantages do these spirals offer?

Read more...

Punteros y listas enlazadas

Recientemente, en una entrada anterior, usamos listas enlazadas para animar un sistema de partículas. Aunque la implementación en Javascript en esa entrada funciona correctamente, existen formas de mejorarla.

En esta entrada hablaré sobre listas enlazadas y su implementación en C. La inspiración para este post es un video en Computerphile con el Profesor Braisfold. Usando bloques de Lego el profesor logra comunicar de manera simple las ideas detrás de esto.

Esta entrada abordará las mismas ideas, enfocándonos más en el código que en las analogías.

Read more...

Sistemas de partículas (NC6)

Un sistema de partículas es un conjunto de pequeños objetos que juntos representan un objeto más grande. Esta entrada trata precisamente sobre sistemas de partículas, y corresponde al capítulo 4 del libro “The Nature of Code” de Daniel Shiffman.

El origen de los sistemas de partículas es interesante. El término se acuñó durante la creación de una animación para Star Trek II: The Wrath of Khan. El primer sistema se creó para animar la terraformación creada por un Genesis Device.

Read more...