Artículo

En el siguiente artículo hablaré sobre como contribuir en el blog de Python Barranquilla. Para colaborar en el blog de la comunidad es necesario que tengas conocimientos previos en Git, GitHub, Markdown y virtualenvs( esto ya es opcional).

El contenido de este artículo se encuentra dividido en 2 secciones importantes:

  1. Cómo usar el panel de administrador de Lektor
  2. Cómo hacer el Pull Request (o PR, coomo se le conoce por su sigla) al repositorio de PyBAQ.

Teniendo esto claro, empecemos a detallar el paso a paso de cada una de las secciones.

Como usar el panel de administrador de Lektor

Clonar repositorio

Editar el sitio web de python Barranquilla puede realizarse en un panel gráfico, para ejecutarlo es requerido clonar el proyecto de nuestra página web e instalarlo localmente usando:

git clone https://github.com/PyBAQ/django-quilla-web.git

Una vez hayas clonado el repositorio e instalado lektor en tu computador, debes correr el servidor local usando lektor server.

Clonar repositorio consola

Creación de entrada en lektor

Ahora, ingresamos a la URL http://localhost:5000 y verás el sitio web en tu navegador.

Página de inicio

Se navega hacia la página que se quiere editar, para nuestro caso se navega hacia blog y se presiona el botón editar.

Página del blog

Luego nos dirigimos hacia la parte superior derecha y presionamos un botón con forma de lápiz.

Botón editar

Al presionar el botón, se cargara el panel administrativo para editar la página del blog.

Editar blog

Para proceder con la creación de la entrada se ingresa el título y el slug

Crear entrada

Luego se completa el resto de la información

Editar entrada

Title: Se refiere al título de la entrada.

Author: Nombre legible de la persona que escribe el artículo.

Twitter_Handle: Tu nickname en Twitter.

Publication_date: Fecha en formato YYYY-MM-DD con la fecha actual.

Excerpt: Resumen corto que se visualiza en el listado del blog.

Body: Contenido central del artículo.

Anexos

Para Cargar los anexos(imágenes) se presiona el botón Añadir Adjunto Ubicado en la barra lateral.

Cargar adjuntos

Como paso final si se suben multiples imágenes, para que solo muestre una de las imágenes cargadas como anexos, se debe seleccionar la imagen y marcarla como oculta seleccionando la opción ¿Debería estar oculta esta página? y desactivar Si esto está habilitado la página puede ser detectada, en caso contrario la URL ha de ser conocida. Ocultar imagenes

Una vez terminada la redacción se puede visualizar el artículo en el administrador.

Previsualizar

También podrás verlo finalizado en el blog.

Resultado final

Como hacer el Pull Request al repositorio de PyBAQ.

Pull request

Crear Branch

Para aceptar los cambios que los miembros de la comunidad realizan, se efectuá un control de los diferentes commits. Para poder realizar un commit es necesario que la persona este acostumbrada a las diferentes operaciones de git como lo son add y commit.

Commit

Como ultimo paso en el terminal, hacemos un envió de los elementos a subir, verificando la rama en la que se encuentra git en el momento, ademas de corroborar la rama remota en la que se subirá

Push

Y en la interfaz de git se procede a hacer el Pull Request final, para pasar los cambios a aprobación

Pull Request

Espero que haya sido de ayuda mi artículo. Si ven que hay secciones de esta entrada que se pueden mejorar, por favor escríbanme un comentario o un issue en Github etiquetando mi usuario @Scot3004.

Nota del Editor:

Para las personas que está empezando, les dejamos en el artículo enlaces hacia las herramientas que necesitan aprender para hacer sus contribuciones. Enseñar y explicar a los demás es una muy buena forma de aprender muchísimo más ¡Ánimo!

Atte, Javier