馃捇 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
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.
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
-
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 atlas
Este 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.
-
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.
馃搼 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
.md
con el nombre de la comunidad en la carpetacomunidades
, puedes seguir la plantilla llamadatemplate-comunidades.md
en 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
---
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
instagram: username
github: username
youtube: username o lo que vaya despu茅s de youtube.com/<!here>
web: https://web.com
---
Contenido extra, puede ser formato Markdown y HTML
驴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 :)