Share IT 🚀

Bienvenido a Share IT. Somos una comunidad unida por el deseo de aprender, compartir conocimientos y crecer juntos en el ámbito tecnológico. Este es un rincón para intercambiar conocimientos y experiencias que nos han guiado y ayudado en nuestro recorrido.☀️

🛠️ Funcionalidades

📝 Publicación de artículos y recursos.
🏷️ Categorías y etiquetas para organizar el contenido.
🔍 Búsqueda de artículos y recursos.

💻 Instalación

Para ejecutar este proyecto localmente, sigue estos pasos:

Clona el repositorio:

git clone https://github.com/tu-usuario/share-it-blog.git

Navega al directorio del proyecto:
```
cd share-it-blog
```
Instala las dependencias:
```
npm install
```
Inicia el servidor de desarrollo:
```
npm start
```
Abre tu navegador y ve a http://localhost:4321 para ver el blog en funcionamiento. 🌐

🤝 Contribuir

Nota: Para añadir nuevos artículos, debes ser parte de nuestra comunidad. Si deseas contribuir creando artículos en el futuro, por favor únete a nuestra comunidad. Ten en cuenta que también se revisará detalladamente el artículo antes de publicarlo😉

📄 Añadir Artículos y Recursos

Artículos

Para añadir nuevos artículos y recursos al blog, sigue estos pasos:

Añade a o utiliza un tag de los que puedes encontrar en el archivo src/content/catalogs/tags.yaml que tienen la siguiente estructura:
```
- id: tag-id
  name: Tag name.
  description: Tag description.

Contenido del tag en formato YAML.
```
El archivo YAML contiene todos los tags, solo añade uno más a la lista si no existe o utiliza uno de los existentes con el formato anteriormente mostrado.

Crea un nuevo archivo Markdown en el directorio src/content/articles/ con la siguiente estructura:

---
title: 'Título del Artículo'
description: 'Descripción corta del artículo'
date: 'YYYY-MM-DD'
draft: false
author: '0N-nombre-a'
tags: 
 - tag-id
 - tag-id
---
Contenido del artículo en formato Markdown.

Guarda el archivo y el nuevo artículo aparecerá automáticamente en el blog. ✨

Recursos

Para añadir nuevos recursos, añade un nuevo elemento a la lista de recursos que se encuentra en el archivo src/content/catalogs/resources.yaml con las siguientes propiedades:

- id: res-id-res
  title: Resource name.
  description: Resource description.
  url: Resource ShareIT Community GitHub URL.
  date: 'yyyy-MM-dd'
  tags:
    - tag-id
    - tag-id
Contenido del recurso en formato YAML.

El archivo YAML contiene todos los recurso, solo añade uno más a la lista con el formato anteriormente mostrado.

👥 Añadir Autores

Para aparecer en la sección de Autores, añade tus datos creando un nuevo archivo .yaml dentro del directorio de autores (src/content/authors/). Asegúrate de incluir la información del autor en el siguiente formato:

name: 'Nombre del Autor'
avatar: 'URL del Avatar'
role: 'Rol del Autor'
github: 'URL de GitHub'
linkedin: 'URL de LinkedIn'
website: 'URL del porfolio web'
about: 'Descripción corta del Autor'

El nombre del archivo actualmente usa como prefijo un número ordinal, primer nombre y primera letra de tu apellido, todo separado por guión medio: 0N-nombre-a, por ejemplo, 01-john-d (John Doe).

¡Gracias por visitar Share IT! 🙌

🗂️ Estructura del Proyecto

Dentro de tu proyecto Astro, verás las siguientes carpetas y archivos:

/
├── public/
│   └── favicon.svg
├── src/
│   ├── content/
│   │   ├── articles/
│   │   ├── authors/
│   │   ├── catalogs/
│   ├── layouts/
│   │   └── Layout.astro
│   └── pages/
|       └── articles/
|       └── tags/
│       └── aboutUs.astro
│       └── collaborators.astro
│       └── collaborators.astro
|       └── resources.astro
└── package.json

🚀 Conoce al creador y el repositorio de la comunidad

Para aprender más sobre la estructura de carpetas de un proyecto Astro, consulta guía sobre la estructura de proyectos en Astro.

🧞 Comandos

Todos los comandos se ejecutan desde la raíz del proyecto, desde una terminal:

Comando	Acción
`npm install`	Instala las dependencias
`npm run dev`	Inicia el servidor de desarrollo local en `localhost:4321`
`npm run build`	Construye tu sitio de producción en `./dist/`
`npm run preview`	Previsualiza tu construcción localmente, antes de desplegar
`npm run astro ...`	Ejecuta comandos CLI como `astro add`, `astro check`
`npm run astro -- --help`	Obtén ayuda usando el CLI de Astro

👀 ¿Quieres aprender más?

No dudes en consultar Astro

coderdiaz/share-it-web