Logo creado con 💖 por CandidDeer
¿Te gustaría convertirte en mantenedor de este proyecto? Lee la guía para mantenedores, únete a nuestro servidor de Discord y solicita unirte al equipo.
- Introducción
- ¿Para quién es esto?
- ¿Con qué voy a contribuir?
- Traducciones
- Preparación
- Contribuir
- Siguientes pasos
Esta es la versión del tutorial para terminal. Todo aquí usa Git por línea de comandos. Si prefieres una interfaz gráfica, usa GitHub Desktop.
Para cualquier persona lo bastante cómoda con terminal como para ejecutar comandos básicos de Git. No necesitas ser experto: si puedes moverte entre carpetas y correr comandos, ya puedes hacerlo.
Agregarás una tarjeta personal en la página del proyecto. Incluirá tu nombre, enlaces de contacto, una descripción corta y enlaces a recursos para desarrolladores que recomiendes.
Este tutorial también está disponible en otros idiomas. Ten en cuenta que las traducciones pueden ir un poco atrasadas frente a la versión en inglés.
| Bengalí | Alemán | Hindi | Coreano | Chino (Tradicional) |
|---|---|---|---|---|
| Portugués (BR) | Español | Telugu | Ucraniano |
Las traducciones de este tutorial son bienvenidas. Revisa CONTRIBUTING.md para empezar.
Asegúrate de tener Git instalado:
git --versionSi no lo tienes, descarga Git aquí.
Conviértete en contribuyente de código abierto en 10 pasos.
Haz fork de este proyecto haciendo clic en el botón Fork arriba a la derecha en la página del repositorio. Esto crea una copia del proyecto en tu cuenta de GitHub.
Clona tu fork en tu máquina local:
git clone https://github.com/tu-usuario-github/Contribute-To-This-Project.gitLuego entra al directorio del proyecto:
cd Contribute-To-This-ProjectCrea y cambia a una rama nueva:
git checkout -b tu-nombre-cardUsa un nombre descriptivo. tu-nombre-card es una buena convención para este proyecto.
NO trabajes en la rama master.
El proyecto tiene una plantilla de tarjeta lista en la carpeta cards/. Cópiala y renombra la copia con tu nombre de usuario exacto de GitHub:
cp cards/template.html cards/tu-usuario-github.htmlPor ejemplo, si tu usuario es octocat:
cp cards/template.html cards/octocat.htmlEste es el único archivo que vas a editar. No edites cards/template.html.
Abre tu archivo de tarjeta en el editor que prefieras:
code cards/tu-usuario-github.html # VS Code
# o: nano, vim, etc.Tu tarjeta se ve así:
<div class="card">
<p class="name">Your name</p>
<p class="contact">
<!-- Add one or more contact links. At minimum, include your GitHub. -->
<i class="fab fa-github"></i>
<a href="https://www.github.com/your_user_handle" target="_blank">Your handle</a>
</p>
<p class="about">Write a sentence or two about yourself.</p>
<div class="resources">
<p>3 Useful Dev Resources</p>
<ul>
<li>
<a href="#" target="_blank" title="First Resource">Resource 1</a>
</li>
<li>
<a href="#" target="_blank" title="Second Resource">Resource 2</a>
</li>
<li>
<a href="#" target="_blank" title="Third Resource">Resource 3</a>
</li>
</ul>
</div>
</div>Complétala así:
- Nombre: reemplaza
Your namepor tu nombre. No cambiesclass="name". - Contacto: reemplaza el enlace y usuario de GitHub por los tuyos. Puedes agregar más contactos. Busca clases de iconos en Font Awesome Icons (ej.
fab fa-linkedin,fab fa-x-twitter). - About: reemplaza el texto de ejemplo con una descripción corta sobre ti.
- Recursos: reemplaza
#con URLs reales, actualizatitle=""y el texto de cada enlace. Son opcionales, pero si los incluyes, cada uno debe tener enlace real. Máximo 5.
No cambies nombres de clases ni la estructura del HTML. El bot de validación revisa eso.
Guarda el archivo cuando termines.
Abre tu archivo de tarjeta y revisa que:
- Ya no haya texto de plantilla
- Todos los enlaces empiecen con
https:// - El nombre del archivo coincida exactamente con tu usuario de GitHub
La validación automática al enviar el PR detectará cualquier problema estructural que se te haya escapado.
Agrega tu archivo de tarjeta:
git add cards/tu-usuario-github.htmlHaz commit con un mensaje corto:
git commit -m "Add my card"Haz push de tu rama a tu fork:
git push origin tu-nombre-cardVe a tu fork en GitHub. Verás un mensaje para abrir un pull request de la rama que acabas de subir. Haz clic en Compare & pull request.
Asegúrate de que el repositorio base sea Syknapse/Contribute-To-This-Project y la rama base sea master.
Deja activada la opción Allow edits from maintainers y luego haz clic en Create pull request.
Un bot validará tu tarjeta automáticamente. Si todo está bien, la fusiona solo. Si hay algo que corregir, el bot dejará un comentario explicando exactamente qué cambiar. Haz push del arreglo a la misma rama y se vuelve a validar.
Ya hiciste tu primera contribución open source. Tu tarjeta aparecerá en https://syknapse.github.io/Contribute-To-This-Project poco después del merge.
¿Dónde quedó mi archivo HTML? Después de un tiempo, las tarjetas enviadas se archivan automáticamente para mantener el repositorio liviano. Tu archivo se elimina de cards/, pero sus datos se conservan en el archivo y tu tarjeta sigue apareciendo en el sitio. Más información.
- También puedes aprender a contribuir con esta serie gratuita: How to Contribute to an Open Source Project on GitHub
- Si este proyecto te fue útil, deja una ⭐ estrella ⭐ y comparte en X
- Únete a nuestro servidor de Discord
- ¿Quieres contribuir más allá de tu tarjeta? Revisa CONTRIBUTING.md para la guía completa.
- Gracias por contribuir! Ahora puedes probar contribuir en otros proyectos. Busca la etiqueta
para opciones amigables para principiantes.
Este proyecto está fuertemente influenciado por el gran proyecto first-contributions de Roshan Jossey.