Control de versiones y GitJournal

Vistas: 21462
0:00 / 0:00
Control de versiones y GitJournal

Cuando descubrí por primera vez el control de versiones me pareció una idea fantástica. Pero sobre todo, me sorprendió y me sigue sorprendiendo que esta tecnología no esté aplicada en muchas mas disciplinas. Vamos, que me parece raro que con todo lo que tiene que aportar no esté en cualquier cosa que puedas imaginar, y se circunscriba casi por completo al mundo de la informática. Lo cierto, es que podría aplicarse a cualquier documento sin formato, o lo que vulgarmente denominamos texto plano. Sea como fuere, lo cierto es que dentro del amplio uso que yo le doy a esto de control de versiones, me faltaba una pata. Me faltaba meter a mi móvil Android dentro de la ecuación. Y digo me faltaba, porque ya está solucionado con GitJournal.

Pero no solo de GitJournal, te quiero hablar en este episodio del podcast, también quiero hacer mención al último directo, en el que además de otras cuestiones te hablo sobre, como llevar listas todo con Vim.

Control de versiones y GitJournal

Control de versiones y GitJournal

Sobre el control de versiones

Como te decía en la introducción, cuando descubrí esto del control de versiones, me quedé ojiplático. ¿Como podía ser que existiera el control de versiones y yo no tuviera conocimiento?. Pero voy mas allá, ¿porque no se utiliza para todo?. Eso es lo que me planteé en ese momento.

Tan es así, como te lo estoy contando, que por aquel entonces, se lo quería aplicar a cualquier cosa que pasara entre mis manos. Gracias a Dios, poco a poco, esta fiebre pasó a mejor vida, aunque de vez en cuando me da la neurosis de nuevo, ¿que le vamos a hacer?.

Desde luego que si no conoces el control de versiones, o simplemente piensas que no es para ti, te recomiendo que le des una oportunidad. No es necesario que profundices en exceso, solamente lo que necesites.

Markdown y el control de versiones

Por supuesto, que el problema que me podrías plantear es ¿como trabajo con mis documentos ofimáticos?, ¿como trabajo con mis documentos de LibreOffice o Microsoft Word?. Pues no puedes. Para utilizar un control de versiones como Git, tienes que hacerlo con documentos sin formato. Y para esto tienes al todopoderoso Markdown.

Y aquí viene mi siguiente sugerencia si no conoces Markdown, si no utilizas Markdown, o si piensas que Markdown no es para ti, dale una oportunidad al Markdown.

De verdad, el Markdown es un lenguaje de marcado ligero, muy sencilla de aprender, pero que te va a permitir ser infinitamente mas productivo, y conseguir unos resultados, sinceramente espectaculares. Sinceramente, mejor de lo que puedas conseguir tanto con Microsoft Word, como con LibreOffice, como con cualquier otro editor ofimático.

También es posible que me digas, que tanto Microsoft Word como LibreOffice, ya cuentan con un control de versiones integrado. Sin embargo, sigues teniendo el mismo problema, porque ¿que sucedería si cualquiera de estas dos suites ofimáticas decide abandonar su formato? Te has quedado sin documento.

Con Markdown no dependes de ningún fabricante, ni desarrollador, ni nada. Solo dependes de ti. Un documento en markdown es para toda la vida. Y Markdown con git se potencian.

GitJournal

Uno de los problemas que me he encontrado hasta el momento es la dificultad de tomar notas en mi ordenador y pasarlas al móvil. Si, ciertamente existen muchas herramientas, para hacerlo, pero algunas se apoyan en servicios de terceros, otras, necesitan de sincronización externa, otras no permiten el control de versiones…

¿Que te parecería una herramienta que te permitiera tomar notas, con control de versiones, donde pudieras elegir como sincronizar, y que la sincronización fuera fácil?. Pues todo esto que te comento, lo tienes y lo has tenido siempre al alcance de tus manos con Git, solo faltaba la sincronización con el móvil, sincronización que te proporciona GitJournal.

GitJorunal, es una herramienta para tomar notas en Markdown con tu móvil, integrado con Git. Pero además, dado que utiliza ssh, esta herramientas puede trabajar con cualquier repositorio, ya sea que esté alojado en GitLab, GitHub, Gitea o en tu propio servidor. Con lo que no solo puedes tomar notas de forma sencilla, además lo puedes gestionar con tu sistema de control de versiones, y lo sincronizas de forma fácil, ¿que mas se puede pedir?.

Entre otras características, GitJournal tiene las siguientes,

  • Te permite varios modos para mostrar las notas que tienes guardadas
  • Puedes elegir diferentes editores para modificar tus notas
  • Es posible enlazar unas notas con otras utilizando la misma sintaxis que en la Wiki. Este punto a mi no me termina de convencer porque me parece mezclar churras con merinas, pero, para gustos los colores.
  • Utiliza la variante de Markdown de GitHub.

¿Que es lo que no tiene GitJournal por el momento?. Actualmente no tiene cifrado. Sin embargo, esto es algo que no me preocupa demasiado, porque al fin y al cabo, prácticamente todo lo que hago es de dominio público.

vim-todo-lists

La otra de las herramientas sobre las que te quería hablar es vim-todo-lists. Un complemento para trabajar con listas todo en Vim. Esto me surgió recientemente en el último directo. La cuestión era plasmar un guión de lo que iba a hacer durante el directo para que todo el mundo pudiera seguir de forma sencilla lo que estábamos haciendo. Si bien el complemento fue todo un éxito, la mano ejecutora (la mía), no lo fue tanto, así que una de cal y otra de arena.

Este complemento de Vim, tiene algunas características que lo hacen realmente interesante,

  • Permite diferentes niveles, llamando padre al nivel inmediato superior.
  • Cuando cambias el estado del nivel padre cambia el estado de todos sus hijos.
  • Si todos los hijos son marcados como completados el padre es marcado como completado
  • Si el padre es marcado como completado y uno de los hijos se marca como no completado el padre se marca como no completado
  • Al marcar un elemento completado este se pone el último en su nivel de jerarquía

Aunque se trata de un complemento realmente sencillo, y cumple a la perfección su cometido, todavía tiene algunos detalles que es posible personalizar y modificar para mejorar y adaptar tu experiencia. Por ejemplo, puedes insertar la fecha de forma automática, por ponerte un ejemplo.


Sinceramente, espero que te haya gustado este nuevo episodio del podcast. Si puedes, te agradecería una valoración en iVoox y/o en Apple Podcast.

Más información

Imagen de portada de Bruce Hong en Unsplash

Ver el vídeo de este episodio
Transcripción

¿Qué es el control de versiones,

¿Qué es el control de versiones.

Vaya, en fin, en cualquier campo debería de estar aplicado.

Yo particularmente, desde el momento que lo descubrí, he ido aplicándolo poco a poco a todo lo que utilizo,

No solamente desde el punto de vista del desarrollo de software, que también, sino también desde el punto de vista de tomar notas, desde el punto de vista de un diario, desde el punto de vista de casi cualquier cosa,

Todo lo que pueda expresar con texto plano va a un control de versiones,

Es más, todo esto de las copias, del backup, pues todo esto lo puedes tener mucho mejor si además lo tienes versionado, lo tienes con un control de versiones,

De hecho, una de las grandes herramientas que tienes al alcance de tu mano son los .doc files, que lo que te permiten es guardar de una manera muy sencilla toda tu configuración y no solamente tenerla guardada, sino además versionada,

Y un poco de esto te quiero hablar en este nuevo episodio del podcast,

Te quiero hablar sobre el control de versiones, cómo lo puedes utilizar para cualquier ámbito y una aplicación que está disponible para Android y alguna que otra cosa más también bastante interesante,

Así que te invito a escuchar este nuevo episodio del podcast.

Soy Lorenzo y esto es Atareado.es. Este es el episodio número 267, un podcast sobre Linux y Open Source,

Aquí descubrirás cómo conseguir tener el mejor entorno de escritorio, hasta cómo instalar un servidor web, un proxy inverse o una base de datos, en fin, cualquier cosa que tú quieras instalar, ya sea en un VPS, en una Raspberry o en cualquier servidor,

Vamos, cualquier cosa que quieras hacer con Linux, seguro, seguro que la encontrarás aquí,

En fin, como te quería decir o como te estaba intentando convencer, porque esto ya se trata de convencer, de las bondades que tiene el control de versiones y por qué deberías de aplicarlo a tu vida en general.

A tu vida, pero a tu vida, vida.

Lo primero es hablarte sobre que, evidentemente, una de las ventajas o desventajas que tiene el control de versiones es que solamente lo puedes aplicar sobre texto plano,

¿Qué quiere decir esto? Pues, básicamente, que imágenes, archivos binarios y todo este tipo de cosas, en principio o inicialmente, no se pueden gestionar como un control de versiones,

No lo puedes hacer como un control de versiones como puede ser Git o Subversión.

Tienes que utilizar otros medios, que no es el caso de Teleste,

Pero me es igual. O sea, para mí lo más importante es que, lo primero, es que todos tus documentos los puedes hacer, básicamente, en texto plano,

Básicamente, utilizando Markdown, que es mi recomendación y que creo que, en repetidas ocasiones, a lo largo de este podcast, me habrás oído hablar de las bondades del Markdown y de todas las ventajas que conlleva.

Y esto es así.

¿Qué sucede? Que en muchas ocasiones te puedes plantear que, claro, a ver, ¿cómo voy a presentar yo un documento realizado en Markdown,

Por ejemplo, como proyecto final de carrera. Hombre, le tendré que dar un empaque, le tendré que dar un estilo,

Claro, todo esto lo puedes hacer perfectamente con Markdown.

Con Markdown y algunas otras herramientas, como puede ser Pandoc,

Pero la ventaja que te ofrece Markdown es que, realmente, te acostumbras a utilizar los estilos como se deben de utilizar,

Me he encontrado, a lo largo de mi vida profesional y de mi vida humana, que la mayoría de personas, o a lo mejor la mayoría es mucho, pero una gran parte de personas.

Utilizamos, pues, ya sea Microsoft Word, como LibreOffice, Writer, como cualquier otra herramienta, sin utilizar estilos,

Y esto es un fallo septembrino. Es decir, que como cometas este fallo vas a septiembre seguro.

Aquí me remito a las palabras de Joan Boluda.

Y es que es así. ¿Por qué,

Porque utilizar estilos es una gran ventaja y te permite, de una manera muy sencilla, cambiar todos tus documentos de un estilo a otro,

Sin embargo, si lo que estás haciendo es poner la letra más grande para utilizar el título 1 o poner solamente negrita,

Pues estás desperdiciando muchas de las ventajas que te ofrecen todos estos estilos.

Dicho esto, evidentemente, en el caso de Markdown, todo este tipo de problemas no los vas a tener,

Y no los vas a tener porque la única manera de poner un título 1 es utilizando la almohadilla,

Que sí, que también podrías poner asterisco asterisco como las negritas, pero bueno, no es el objetivo.

Otra de las grandes ventajas de Markdown es la velocidad con la que vas a ir.

Porque, claro, no te vas a preocupar de que si queda espaciado 1, si queda espaciado 2, todo ese tipo de cosas, pues no son importantes,

Al final, como dicen en muchos sitios, lo más importante es el contenido, más que el continente,

Pero la ventaja que te ofrece el Markdown, precisamente, es que una vez realizado tu documento con Markdown,

Convertirlo y darle una apariencia espectacular es muy sencillo.

Aquellas personas que en un momento determinado han donado el proyecto Tarea.es,

Deberían de haber recibido uno o dos libros de los que voy enviando a aquellas personas que donáis.

Y habréis visto que, básicamente, envío tres formatos,

Un formato móvil, un formato epaz y un formato pdf,

El formato en pdf es espectacular,

El formato en pdf es espectacular, pero de verdad,

O sea, nadie me podría decir en ningún momento que el aspecto no es un aspecto realmente cuidado,

Mucho más cuidado del que podrías conseguir incluso utilizando Microsoft Word o LibreOffice o cualquiera de estos,

Mucho mejor, te lo digo sinceramente.

Y es solamente, vaya, es que es así,

¿Cómo he conseguido esos resultados,

Pues, básicamente, combinando Markdown, Pandoc y Latex,

Pues, con esa combinación he conseguido hacerlo,

No te creas que me ha llevado mucho tiempo,

Todo lo contrario.

Bueno, no te voy a engañar,

La primera vez que generé el primer libro, pues, evidentemente, es que me llevó tiempo.

El segundo libro ya no me ha llevado tanto.

Vaya, básicamente, prácticamente no me ha llevado nada porque he aplicado los mismos formatos,

Pero es que el tercer libro, el que estoy trabajando actualmente,

Ese me va a llevar el tiempo que termine de recopilar todos los artículos que forman ese libro,

Y no me va a llevar más tiempo,

O sea, que por eso te digo que es una gran ventaja trabajar con Markdown,

Dicho esto, una vez ya te he contado toda la parte del Markdown y ya te he dado bastante la barrila,

Intentando convencerte de lo ventajoso que es utilizarlo, ahora viene la segunda parte,

Y es que todavía es más ventajoso si lo combinas utilizando toda la tecnología que viene detrás del control de versiones,

Y por esto te digo que aunque tú puedas pensar que es que esto del control de versiones no es para mí,

Bueno, ya te acabo de convencer, o bueno, por lo menos lo he intentado, de que Markdown sí que es para ti.

Bueno, pues en el momento que tienes claro que Markdown sí que es para ti.

Tienes que convencerte a ti mismo de que el control de versiones también es para ti,

Y tú dirás, ¿y por qué,

Tú imagínate que eres un escritor de un libro,

Y estás contando la aventura de Caperucita Roja, por ejemplo, por ponerte un caso.

Y llega un momento en que dices, ostras, pues ahora no sé si Caperucita Roja mata al lobo.

Mata a la abuela o mata al sun sun corda,

Bueno, pues aquí tienes la posibilidad, utilizando el control de versiones y las ramas.

De abrir tres historias en paralelo,

Bueno, esto es una tontería que se me ha acabado de ocurrir, pero es una posibilidad,

Pero no solamente eso, sino que además te permite volver atrás,

Y volver atrás en el tiempo todo lo que tú quieras,

Y lo vas a tener todo ahí.

Vaya, yo creo que es una posibilidad muy interesante para incorporarla a tu flujo de trabajo, exactamente,

De que la incorpores a tu flujo de trabajo, porque seguro, seguro, seguro que vas a ganar,

Te lo digo así.

Evidentemente, todo... ¿cómo se llama,

Toda ventaja o todo éxito conlleva un esfuerzo,

Y ese esfuerzo, evidentemente, es aprender Markdown y aprender Git,

Pero tampoco tienes que hacer un gran esfuerzo en aprender Git,

Quiero decir que al final, con unos pocos conocimientos de Git, lo tendrías,

Lo tendrías resuelto para básicamente lo que quieres hacer,

Que para cosas más complicadas, donde tienes que trabajar de forma colaborativa con mucha gente,

Sobre... ¿se puede complicar,

Sí, efectivamente.

Pero para lo que vas a hacer en tu día a día, es más que recomendable,

Y no vas a tener ningún problema en el sentido de que tú puedes pensar,

Bueno, es que al fin y al cabo esto también lo incorpora Microsoft Word o LibreOffice o cualquiera de estos.

Efectivamente, te voy a dar la razón,

Actualmente, cualquiera de estos también incorpora un control de versiones,

Pero un control de versiones con una peculiaridad,

Que depende del formato de Microsoft Word, depende del formato de LibreOffice.

Y si el día de mañana, LibreOffice, por la razón que sea, decide cambiar de formato.

Tú has perdido tu documento.

Lo mismo te digo de Microsoft Word o de cualquier otra aplicación,

Este es el gran inconveniente de no utilizar texto plano,

Y ahí es donde le tienes que sacar todo el jugo.

Dicho esto, ¿y por qué te vengo yo a contar toda esta historia y toda esta película sobre Git,

Aparte de un poco lo que te he comentado de Juan, de Podcast Linux,

Bueno, pues esto te lo vengo a contar porque el otro día en el grupo de Telegram de Ugeek,

Sniffer, uno de los integrantes del grupo de Telegram, habló sobre una aplicación que desconocía por completo,

Una aplicación Android y que era la pieza del puzzle que me faltaba.

Se trata de GitJournal.

GitJournal es una aplicación para tomar notas directamente en el móvil,

Y tú dirás, bueno, pues como todas, habrán a tropocientos mil aplicaciones para hacer esto,

Bueno, sí, efectivamente, habrán tropocientas.

Pero esta tiene la gracia de que se relaciona directamente con un repositorio en Git,

Y esta es realmente la gracia.

No te tienes que preocupar de absolutamente nada,

Vas a tenerlo todo versionado,

Y lo que puedes hacer es llevar un diario.

Y ese diario tú dirás, ostras, pero a menudo lío, ahora tal.

No, ningún lío,

Puedes elegir con qué repositorio te quieres conectar.

Puedes hacerlo de una manera súper sencilla.

Y, claro, todo esto tiene una ventaja brutal,

Y es que la ventaja brutal es que no necesitas ningún tipo de sincronización,

Porque para eso ya se encarga Git,

Ya se encarga de hacer la sincronización de la aplicación de GitJournal,

Con el repositorio que está en GitLab, en GitHub o donde tú quieras,

También podría estar en tu repositorio personal, en Gitea,

O incluso, pues directamente, acceder vía SSH a tu repositorio,

O sea, cualquiera de todas estas posibilidades las puedes tener,

Y no dependes de absolutamente nadie,

No dependes de absolutamente nadie,

Y, claro, todo, todo, todo, todo absolutamente versionado.

A mí es la pieza, te digo de verdad, es la pieza que me faltaba para completar el círculo,

Para completar el puzzle,

Porque de esta manera ya es que no dependo absolutamente de nadie,

Bueno, realmente sí,

Rependo, dependo totalmente de GitJournal,

Pero para tener mis notas en el móvil,

Porque si en un momento determinado GitJournal o el desarrollador de GitJournal decide abandonar la aplicación,

Yo no me tengo que preocupar,

Mis aplicaciones, mis aplicaciones, mis notas, todas mis notas, todos mis diarios, todos mis apuntes,

Todo lo que quiera tener, los tengo en mi repositorio, en GitLab o en GitHub o en mi ordenador.

Es más, recordarte que tanto GitHub como GitLab ahora también permiten repositorios privados,

Con lo cual tampoco te tienes que preocupar de que tus notas van a ser públicas,

O sea que, en fin, que tienes todo un abanico de posibilidades brutal para mantener todo esto a buen recaudo,

Así que una opción muy interesante y que te recomiendo muy mucho, que la tengas en cuenta.

Que no conoces el control de versiones,

Bueno, pues ya tienes la primera excusa para conocer el tema del control de versiones, de descubrir Git,

Que no conoces Markdown,

Bueno, pues ya tienes la primera excusa para conocer Markdown,

En fin, que te he dado aquí dos o tres excusas para conocerla,

Dicho esto, también te quería hablar de otra aplicación.

Y es que hace unos días hice un directo en Twitch en el que hice en directo, por eso era un directo básicamente.

Un directo en el que levanté una API, una API REST, utilizando Python, Flask y, por supuesto, Docker y Traffic,

Vaya, una combinación brutal.

Una hora y media de directo que terminó con un dolor de cabeza importante,

Pero bueno, al final conseguí el resultado.

La cuestión es que para hacer el directo, lo que pensé era pues tener un guión.

Un guión que lo viera todo el mundo de manera que pudiéramos seguir paso a paso qué es lo que se estaba haciendo,

Claro, para hacer un guión de este estilo, lo más interesante, lo más peculiar o lo más llamativo es que ese guión.

Además de que sea visible, es que sea una lista todo, de manera que cada vez que tú vas realizando una de las tareas de tu directo,

Pues la marques y se quede como completada,

Vaya, una lista todo de toda la vida.

¿Qué sucede,

Bueno, pues que como yo tengo ese cariño hacia BIM, pues lo que hice fue buscar un complemento,

Un complemento para BIM que me permitiera hacer esto de una manera muy sencilla,

Y efectivamente, existe,

Existe un complemento que se llama BIM BIM To Do List o algo así, lo dejaré en las notas del podcast,

Que te permite precisamente hacer eso,

Te permite crear una lista de tareas,

Y tú dirás, bueno, pues tampoco tiene mucha historia, porque en Mardown esto es relativamente sencillo,

Claro, esto es relativamente sencillo, pero es que con esta extensión o con este complemento para BIM es todavía más sencillo,

Porque simplemente con hacer un Enter te pone los corchetes, significando que es una tarea sin completar, una tarea iniciada.

Cuando vuelves a dar Enter te crea otra tarea y así sucesivamente,

Todo esto, por supuesto, en el modo de edición,

Cuando pasas al modo normal y estás navegando a través de los distintos puntos de tu lista Todoist o de tu lista Todo,

Esto es la reminiscencia que me queda todavía del Todoist que he abandonado, del Todoist que he abandonado,

Bueno, como te decía, conforme tú vas navegando, si le das a la tecla espacio, lo que hace es completarte la tarea,

Pero no solamente te completa la tarea, sino que además la pasa a la última de las tareas que tengas en ese nivel.

¿A qué me refiero con ese nivel? Bueno, la cuestión es que, como bien sabes, una tarea puede estar descompuesta en subtareas.

Me refiero a nivel a todas las tareas o subtareas que estén en esa posición,

De manera que si tú marcas la tarea principal que tiene subtareas, se marcarán todas las subtareas.

Y si marcas en particular una de las subtareas, solamente se marcará esa subtarea,

Y como te digo, lo que hará será desplazarse o moverse a la última posición de tu lista de tareas en ese nivel,

Y es súper interesante. Y sobre todo súper interesante para lo que te acabo de contar,

Pues para ver. O para ir poco a poco viendo cómo evoluciona todo esto del directo,

Porque si no, en un momento determinado puedes encontrarte perdido.

Dicho esto, la verdad es que preparé, como te digo, todo el guión.

Lo tenía allí mostrándolo en directo, mostrando cómo funcionaba y cómo íbamos haciendo,

Pero la verdad es que no le presté la atención que requería,

Y al final me lié a marcarlas todas, todas las que ya había completado,

En fin, que la idea estuvo muy bien.

El concepto también estuvo muy bien,

Pero luego el desempeño no estuvo tan bien como yo esperaba,

Pero bien, la verdad es que fue muy interesante, muy interesante.

Así que nada, bueno, pues ya ves,

Dos herramientas que te acabo de recomendar,

Tanto GitJournal como esta aplicación de este complemento para BIM,

Que son realmente muy, muy, muy, muy interesantes,

Así que nada, poco más que contarte,

Espero que te haya gustado este nuevo episodio del podcast.

Y que lo hayas disfrutado tanto como lo he disfrutado yo,

Así que poco más que decirte,

Recordarte que este es un podcast de la red de podcast de sospechosos habituales,

Donde puedes disfrutar de maravillosos y fantásticos podcasts.

Puedes suscribirte a la red de podcast de sospechosos habituales en fitpress.me,

Barra sospechosos habituales,

Y como te digo siempre, recuerda que la vida son dos días y uno ya ha pasado,

Así que disfruta como si no hubiera mañana,

Y si puede ser, con Linux.

Con GitJournal.

Con Git,

Con Markdown,

Y con todo lo que te he dicho, mejor que mejor,

Un saludo y nos escuchamos el próximo jueves.

Deja una respuesta