Colaborar

Colabora con Línea de Código

Línea de Código es una plataforma abierta a cualquier tipo de colaboración relacionada con la programación, independientemente del nivel. Buscamos contenidos con un enfoque claro, didáctico y pedagógico.

Si quieres colaborar con Línea de Código, sigue los pasos que se detallan a continuación:

1. Trabaja con el repositorio Git

   En Línea de Código trabajamos mediante un repositorio Git público disponible en: https://github.com/victorcuervo/lineadecodigo

   El primer paso es crear un fork del repositorio en tu cuenta de GitHub.

2. Ubicación del artículo

   El artículo debe ubicarse dentro de la carpeta: /src/content/docs/

   A su vez, deberá estar dentro de la subcarpeta correspondiente al lenguaje y a la temática. Por ejemplo:

   • Lenguajes: java, html, python, etc.
   • Temáticas: basicos, cadenas, tablas, etc.

   Quedándonos una carpeta de la siguiente forma: /src/content/docs/lenguaje/tematica

   Si no existe una carpeta adecuada, puedes crear una nueva siguiendo la misma estructura.

3. Formato del artículo

   El artículo debe estar escrito en Markdown. El nombre del fichero debe seguir el formato:

   nombre-del-articulo-entre-guiones.md

   Se recomienda revisar los artículos existentes para mantener coherencia de formato y estilo.

4. Metainformación del artículo

   En la parte superior del artículo debes incluir la metainformación en formato front matter:

   nombre-del-articulo-entre-guiones.md

   ---
   title: "Título del artículo"
   description: "Descripción del Artículo"
   tags: ["tag1","tag2",..."tagN"]
   author: id_autor
   download: URL con el repositorio del código fuente
   ---

   A tener en cuenta:

   • No utilices demasiadas etiquetas.
   • Se debe de poner una URL con el repositorio y archivo que contenga el código
   • El id_autor los explicamos más adelante
    

5. Imágenes del artículo

   En el caso de que tu artículo contenga imágenes debes de seguir los siguientes pasos

   • Las imágenes deben almacenarse en la carpeta /src/assets/lenguaje/images. Donde lenguaje es el lenguaje de programación principal del artículo.
   • Preferiblemente utiliza un formato webp: Pero los formatos jpg o png también están permitidos.
   • Optimiza las imágenes antes de subirlas (por ejemplo, con TinyPNG).

   La referencia a las imágenes será relativa a la ubicación del artículo, por lo que el código markdown será:

   nombre-del-articulo-entre-guiones.md

   ![Texto alternativo relativo a la imagen](../../../..//src/assets/lenguaje/images/nombre-imagen.webp)

6. Crea tu perfil de autor

   Si es tu primera colaboración, debes crear tu perfil de autor en el directorio: /src/configs/authors/:

   El nomre del fichero deberá de ser id-autor.ts, donde id-autor es el mismo que utilizarás en la metainformación del artículo.

   Añade una entrada con la siguiente estructura:

   id-autor.ts

   export const id-autor = {
       id: 'id-autor',
       name: 'Nombre Autor',
       photo: 'URL con la foto Autor',
       description: 'Descripción Autor',
       rrss: [
           {
               label: 'rrss_name',
               url: 'url',
           },
       ],
   };

   A tener en cuenta:

   • El id-autor será un identificador a utilizar en este archivo y en el artículo.
   • Puedes añadir tantas redes sociales como desees. Con los valores de label como x.com, linkedin, github, facebook,...
   • Se puede añadir el label laptop para poder hacer referencia a vuestras páginas personales.
    

7. Enviar el artículo

   Ya solo queda un último paso que será enviarnos el artículo

   • Verifica que el contenido cumple las normas de formato.
   • Realiza un Pull Request contra la rama main.
   • El equipo revisará el contenido y propondrá mejoras si es necesario.

   Una vez que tengamos todo pasaremos a Publicar el artículo.

Si tienes cualquier duda durante el proceso, no dudes en contactar con nosotros. Estaremos encantados de ayudarte.