Un post puede tratar sobre cualquier tema que te parezca interesante relacionado con matemáticas e informática. Exponer características de un lenguaje de programación, resolver un problema de geometría clásica, explicar un sistema de paquetes, una aplicación de la programación lineal, qué es un comonoide, cómo trata Ruby la visibilidad de los métodos o la sintaxis del cálculo lambda son ideas muy válidas para un post. Además, entre las issues de este repositorio podrás encontrar varios temas que querríamos tratar y que están todavía abiertos.
En primer lugar, debes hacer un fork del blog en tu cuenta de Github. Trabajaremos en nuestra propia rama y cuando consideremos que nuestro post esta terminado realizaremos una Pull Request.
Para añadir un nuevo post basta con añadir el archivo con nombre YYYY-MM-DD-nombre-de-mi-post.md dentro de la carpeta ./blog/_posts con el contenido de nuestro post. Además, debes añadir a tu archivo una cabecera con datos sobre el post como la del recuadro inferior.
---
layout: post
title: Nuestro título
authors:
- Mi Nombre Y Apellido
lang: es
category: Categoría
---En caso de que no funcionara lo anterior, puede enviarse el post a [email protected] y dejar que alguien se encargue de publicarlo.
La guía de estilo te servirá de chuleta para la sintaxis de Markdown y algunas peculiaridades acerca de como dar formato correctamente a tu post.
Para comprobar si tu post queda como quieres, puedes construir y servir el blog de forma local. Para ello necesitarás tener Ruby instalado en tu máquina. La primera vez que vayas a construir el blog tendrás que obtener las dependencias:
$ gem install bundler
$ bundleTras este paso, cada vez que quieras construir el blog, simplemente ejecuta
$ bundle exec jekyll servey lo tendrás disponible en http://localhost:4000/blog/.
Revisamos los posts entre colaboradores para asegurar en la medida de lo posible la corrección de los posts. Cuando creas que tu post está listo para revisar, realiza una pull request desde tu navegador al repositorio original del blog. Rellena un poco la descripción y créala. A partir de entonces espera a que al menos dos colaboradores den su visto bueno, y pide a alguno de ellos que mezcle la pull request.
Este blog no solo vive de los posts escritos. También puedes ayudar de otras maneras.
Si el blog recibe un post mediante una pull request y crees que tienes conocimientos generales sobre el tema suficientes para revisarlo y corregir posibles errores, clona el repositorio y cambia a la rama conveniente:
$ git clone https://github.com/libreim/blog.git
$ cd blog
$ git checkout post-nombre-del-postUtiliza Jekyll para construir el blog localmente.
Los errores que encuentres y correcciones que quieras realizar puedes comentarlos
en la pull request asociada.
Cuando consideres que el post esté listo para ser publicado, asegúrate de dejar un comentario en la pull request dando tu visto bueno.
En el repositorio del blog tenemos más issues además de los posts, relacionadas con el aspecto técnico de mantener un blog. Puedes colaborar intentando solucionar cualquiera de ellas, o abriendo una nueva en caso de que detectes algún error.
Cualquier tema relacionado con las matemáticas y la ingeniería informática es apto para este blog.
Si quieres empezar a escribir tu artículo, puedes usar StackEdit, que es un editor online de Markdown y Mathjax con el que puedes previsualizar cómo quedarán las fórmulas matemáticas y el formato de tu artículo antes de enviarlo. Cuando lo termines, puedes enviarlo a [email protected]. A partir de ahí, empezaremos un proceso de revisión desde GitHub para asegurarnos de que no haya ninguna errata y que sigue la guía de estilo. En cuanto esté revisado, lo publicaremos en el blog.
Los contenidos del blog se publican por defecto en licencia de Creative Commons Reconocimiento-CompartirIgual 4.0 Internacional. Si nos envías tu artículo, asumiremos esta licencia a no ser que prefieras indicarnos otra licencia libre. En cualquier caso, incluye tu nombre para que podamos indicar tu autoría a la hora de publicarlo; así como el de otros autores o colaboradores del artículo.
También puedes presentar tu artículo como un pull-request a este repositorio. Puedes orientarte viendo otros posts escritos en la carpeta blog/_posts.
Este blog usa Jekyll para generar un sitio estático. Puedes contribuir en las plantillas (en HTML) o mediante plugins de Jekyll (en Ruby).