🌎 Atlas de comunidades
💻 Puedes visitar el Atlas en la dirección de https://comunidades.lat
¡Bienvenido internauta! Este es el repositorio oficial de la plataforma Atlas de comunidades
Aquí puedes conocer todos los detalles detrás del proyecto Atlas y como colaborar para hacer más grande la plataforma.
¿Quieres agregar una comunidad al Atlas? Mira en la sección de Agregando una comunidad
📖 Índice
Acerca del proyecto
Atlas nace con la intención de ser una plataforma que reuna a todas las comunidades tecnológicas que trabajan en la región latinoaméricana, queremos darle mayor visibilidad a aquellas comunidades que van empezando y también ayudar a que las personas puedan encontrar un grupo dónde se reunan intereses en común.
Atlas ha sido construido con Gridsome, un framework para construcción de sitios web estáticos hechos con Vue, esto nos permite generar sitios extremadamente eficientes y rápidos para el usuario, además de no requerir de un backend para alojar la información del sitio.
El sitio está alojado en GitHub pages de forma gratuita.
Requisitos
Para poder levantar el proyecto en tu equipo local de desarrollo, es necesario que tengas instalado lo siguiente:
- Editor de código (vim, VS Code, Webstorm, Atom, etc...)
- Node.js
- npm o yarn
- Git
- Un navegador web para probar los cambios
Desarrollo
Descarga
-
Clona el repositorio
Para poder realizar cambios y conservar el historial de git, es necesario que clones el repositorio en tu equipo de desarrollo local.
git clone https://github.com/devspacemx/atlas.git cd atlasEste comando habrá descargado una copia local, ahora estarás listo para realizar cambios
-
Instala las dependencias
Atlas requiere de un par de dependencias para poder funcionar, ¡No te preocupes! Todas estas dependencias son manejadas por el gestor de paquetes de node (npm), por lo cuál solo necesitaras ejecutar un comando
# si utilizas npm: npm install # si utilizas yarn: yarn install
Una vez ejecutado el comando ya estarás listo para ejecutar el proyecto de forma local
Nota: Es posible que equipos que utilizan una arquitectura ARM (e.j: Mac con M1) tengan problemas al momento de instalar las dependencias, esto se debe a que el pre-procesador de estilos sass aún no está porteado completamente para ese tipo de arquitecturas.
Ejecución
-
Ejecuta el proyecto
Gridsome provee de un comando para levantar un servidor y reiniciar el sitio en cuanto realices cualquier cambio en el código fuente del proyecto, podrás acceder al sitio desde tu navegador visitando la url http://localhost:8080 (por default).
# si utilizas npm: npm run dev # si utilizas yarn: yarn run dev
Observaciones: Si realizas un cambio en un archivo markdown es necesario que pares la ejecución del comando y vuelvas a correrlo para ver los cambios.
Agregando una comunidad
📑 Alternativamente puedes llenar un formulario de Google Docs en la siguiente liga: https://forms.gle/o4CeeMgSaJbXE7896
Agregar una comunidad es muy sencillo, solo necesitas hacer lo siguiente:
- Clona el repositorio en tu cuenta de GitHub, encontrarás el botón en la parte superior derecha del repositorio y dice Fork
- Crea un archivo con formato
.mdcon el nombre de la comunidad en la carpetacomunidades, puedes seguir la plantilla llamadatemplate-comunidades.mden la raíz del repositorio. - Sube el logotipo en la carpeta de
uploads - Prueba tus cambios ejecutando los comandos del apartado de Ejecución
- Crea un Pull Request
- Espera a que un mantainer apruebe tus cambios
Estructura de un archivo de comunidad
---
title: Nombre de comunidad
date: 2021-06-20 <-- SIGUE ESTE FORMATO DE FECHA (YYYY-MM-DD)
description: Te recomendamos colocar una descripción corta
tags: ["Coloca", "Tags", "Para", "Identificar", "Tu", "Comunidad"]
location: Pais
image: /uploads/logo.png
# Tags opcionales, te recomendamos colocar por lo menos uno
twitter: username
facebook: username
youtube: username (o lo que vaya después de youtube.com/)
instagram: username
github: username
web: https://web.com
slack: url completa de slack
discord: url de invitación completa de discord
---
Contenido extra, puede ser formato Markdown y HTMLContribuye
¿Te gustaría colaborar con el desarollo de Atlas? ¡Adelante! La plataforma es de todos y si tienes una idea que te gustaría fuera implementada puedes abrir un Issue describiendo que cambios te gustaría ver, así como también puedes abrir un Pull Request con modificaciones para la plataforma.
Otra forma en la que puedes contribuir es revisar que issues están abiertos en el Repositorio
También puedes agregar comunidades en las cuales participas, solo asegurate de llenar bien los datos de la comunidad :)