|
2 | 2 |
|
3 | 3 |  |
4 | 4 |
|
5 | | -Página web oficial de la **comunidad de desarrolladores más grande de Salta**, construida con Jekyll y optimizada para GitHub Pages. |
| 5 | +Sitio web oficial de la comunidad SaltaDev. Construido con Jekyll, Tailwind CDN y componentes reutilizables. |
6 | 6 |
|
7 | | -## 🌟 Características |
| 7 | +## Caracteristicas |
8 | 8 |
|
9 | | -- **Diseño responsive** compatible con dispositivos móviles y desktop |
10 | | -- **Sistema de eventos dinámico** con countdown automático |
11 | | -- **Galería de partners** con carousel animado |
12 | | -- **Sección de equipo** con información de administradores |
13 | | -- **Formulario de contacto** integrado |
14 | | -- **Optimización SEO** y rendimiento web |
15 | | -- **Arquitectura modular** con componentes reutilizables |
| 9 | +- Diseno responsive para mobile y desktop. |
| 10 | +- Landing con animaciones GSAP y scroll suave. |
| 11 | +- Eventos dinamicos con countdown. |
| 12 | +- Staff y colaboradores desde colecciones Jekyll. |
| 13 | +- SEO completo (Open Graph, Twitter cards, canonical, robots, sitemap). |
16 | 14 |
|
17 | | -## 🛠️ Tecnologías Utilizadas |
| 15 | +## Tecnologias |
18 | 16 |
|
19 | | -- **Jekyll** 4.x - Generador de sitios estáticos |
20 | | -- **Bootstrap** 5.3.3 - Framework CSS responsive |
21 | | -- **GSAP** 3.12.7 - Animaciones y efectos visuales |
22 | | -- **Font Awesome** 6.7.2 - Iconografía |
23 | | -- **Google Fonts** (Poppins) - Tipografía |
24 | | -- **Liquid** - Template engine de Jekyll |
| 17 | +- Jekyll (GitHub Pages) |
| 18 | +- Tailwind CSS via CDN |
| 19 | +- GSAP 3.12.7 (animaciones) |
| 20 | +- Liquid (templates) |
25 | 21 |
|
26 | | -## 📁 Estructura del Proyecto |
| 22 | +## Estructura del proyecto |
27 | 23 |
|
28 | 24 | ``` |
29 | | -├── _confidents/ # Archivos de partners/sponsors |
30 | | -├── _events/ # Eventos de la comunidad |
31 | | -├── _includes/ # Componentes reutilizables |
32 | | -│ ├── head/ # Meta tags y imports |
33 | | -│ ├── contact.html # Formulario de contacto |
34 | | -│ ├── footer.html # Pie de página |
35 | | -│ ├── nav.html # Navegación |
36 | | -│ ├── partners.html # Sección de partners |
37 | | -│ └── staff.html # Equipo de administración |
38 | | -├── _staff/ # Información del equipo |
39 | | -├── assets/ # Recursos estáticos organizados |
40 | | -│ ├── css/ # Estilos CSS modulares |
41 | | -│ │ ├── components/ # Estilos de componentes |
42 | | -│ │ ├── pages/ # Estilos específicos de páginas |
43 | | -│ │ ├── main.css # Estilos principales |
44 | | -│ │ └── style.css # Configuración global |
45 | | -│ ├── fonts/ # Fuentes personalizadas |
46 | | -│ ├── img/ # Imágenes categorizadas |
47 | | -│ │ ├── backgrounds/ |
48 | | -│ │ ├── events/ |
49 | | -│ │ ├── icons/ |
50 | | -│ │ ├── partners/ |
51 | | -│ │ └── staff/ |
52 | | -│ └── js/ # JavaScript modular |
53 | | -│ ├── components/ # Módulos de componentes |
54 | | -│ ├── config/ # Configuraciones |
55 | | -│ └── main.js # Archivo principal |
56 | | -├── index.html # Página principal |
57 | | -├── events.html # Página de eventos |
58 | | -├── reglamento.html # Página de reglamento |
59 | | -└── _config.yml # Configuración de Jekyll |
| 25 | +├── _confidents/ # Colaboradores |
| 26 | +├── _events/ # Eventos |
| 27 | +├── _includes/ # Componentes reutilizables (nav/footer/etc.) |
| 28 | +├── _staff/ # Staff |
| 29 | +├── assets/ |
| 30 | +│ ├── css/ # CSS por pagina |
| 31 | +│ │ ├── index.css |
| 32 | +│ │ ├── events.css |
| 33 | +│ │ └── reglamento.css |
| 34 | +│ ├── img/ # Imagenes |
| 35 | +│ └── js/ # JS por pagina |
| 36 | +│ ├── index.js |
| 37 | +│ ├── events.js |
| 38 | +│ └── reglamento.js |
| 39 | +├── index.html |
| 40 | +├── events.html |
| 41 | +├── reglamento.html |
| 42 | +├── _config.yml |
| 43 | +└── robots.txt |
60 | 44 | ``` |
61 | 45 |
|
62 | | -## 🚀 Instalación y Desarrollo |
| 46 | +## Desarrollo local |
63 | 47 |
|
64 | 48 | ### Prerrequisitos |
65 | 49 |
|
66 | | -1. **Ruby** (versión 2.7 o superior) |
67 | | - - Windows: Descargar desde [RubyInstaller](https://rubyinstaller.org/) |
68 | | - - macOS: `brew install ruby` |
69 | | - - Linux: `sudo apt-get install ruby-full` |
| 50 | +- Ruby 2.7+ y Bundler |
70 | 51 |
|
71 | | -2. **Jekyll y Bundler** |
72 | | - ```bash |
73 | | - gem install jekyll bundler |
74 | | - ``` |
| 52 | +### Pasos |
75 | 53 |
|
76 | | -### Configuración Local |
77 | | - |
78 | | -1. **Clonar el repositorio** |
| 54 | +1. Clonar el repo |
79 | 55 | ```bash |
80 | 56 | git clone https://github.com/Salta-Dev/landing-page.git |
81 | 57 | cd landing-page |
82 | 58 | ``` |
83 | 59 |
|
84 | | -2. **Instalar dependencias** |
| 60 | +2. Instalar dependencias |
85 | 61 | ```bash |
86 | 62 | bundle install |
87 | 63 | ``` |
88 | 64 |
|
89 | | -3. **Ejecutar servidor de desarrollo** |
| 65 | +3. Levantar el servidor |
90 | 66 | ```bash |
91 | 67 | bundle exec jekyll serve --livereload --config _config.yml |
92 | 68 | ``` |
93 | 69 |
|
94 | | -4. **Abrir en navegador** |
95 | | - - Ir a `http://localhost:4000` |
96 | | - - Los cambios se recargan automáticamente con LiveReload |
97 | | - |
98 | | -### VS Code (Recomendado) |
99 | | - |
100 | | -El proyecto incluye una task configurada. Usar `Ctrl+Shift+P` → "Tasks: Run Task" → "Jekyll GitHub Pages Server" |
101 | | - |
102 | | -## 📅 Gestión de Eventos |
103 | | - |
104 | | -### Crear un Evento |
105 | | - |
106 | | -1. **Crear archivo** en `_events/` con formato: `dd_mm_yyyy_prioridad.md` |
107 | | - - Ejemplo: `15_12_2025_00.md` |
108 | | - - La prioridad (00-99) determina el orden de visualización |
109 | | - |
110 | | -2. **Estructura del archivo**: |
111 | | - ```yaml |
112 | | - --- |
113 | | - title: "Nombre del Evento" |
114 | | - description: "Descripción detallada del evento" |
115 | | - location: "Lugar del evento" |
116 | | - photo: "/assets/img/events/evento.jpg" |
117 | | - link: "https://enlace-al-evento.com" |
118 | | - date: 2025-12-15 19:00:00 -0300 |
119 | | - event_start_date: "15_12_2025:19_00_00" |
120 | | - event_end_date: "15_12_2025:22_00_00" |
121 | | - event_date_parsed: "15/12/2025" |
122 | | - event_hours_parsed: "19:00 - 22:00" |
123 | | - --- |
124 | | - |
125 | | - Contenido adicional del evento en Markdown... |
126 | | - ``` |
| 70 | +4. Abrir `http://localhost:4000` |
127 | 71 |
|
128 | | -### Formato de Fechas |
| 72 | +### VS Code |
129 | 73 |
|
130 | | -- **`event_start_date/event_end_date`**: `dd_MM_yyyy:hh_mm_ss` |
131 | | -- **`date`**: Formato ISO con timezone de Argentina (-0300) |
132 | | -- **`event_date_parsed`**: Formato de visualización `dd/MM/yyyy` |
133 | | -- **`event_hours_parsed`**: Formato de visualización `hh:mm - hh:mm` |
| 74 | +Usa la task: "Jekyll GitHub Pages Server". |
134 | 75 |
|
135 | | -## 👥 Gestión de Equipo |
| 76 | +## Troubleshooting |
136 | 77 |
|
137 | | -### Agregar Miembro del Staff |
| 78 | +- Si cambias `_config.yml`, reinicia el servidor de Jekyll. |
| 79 | +- Si falla `bundle exec jekyll serve` en Windows, verifica Ruby/Bundler y vuelve a ejecutar `bundle install`. |
| 80 | +- Si ves contenido viejo, borra `_site/` y vuelve a correr `bundle exec jekyll serve`. |
| 81 | +- Si no aparece `sitemap.xml`, asegurate de tener `jekyll-sitemap` en el `Gemfile` y reinicia Jekyll. |
138 | 82 |
|
139 | | -Crear archivo en `_staff/` con formato `nombre_apellido.md`: |
| 83 | +## Gestion de contenido |
140 | 84 |
|
| 85 | +### Eventos |
| 86 | + |
| 87 | +Crear un archivo en `_events/` con formato `dd_mm_yyyy_00.md`. |
| 88 | + |
| 89 | +Ejemplo: |
141 | 90 | ```yaml |
142 | 91 | --- |
143 | | -name: "Nombre Completo" |
144 | | -role: "Cargo" # Fundador, Administrador, Administradora |
145 | | -description: "Descripción profesional" |
146 | | -photo: "/assets/img/staff/nombre_apellido.jpg" |
147 | | -twitter: "https://twitter.com/usuario" # Opcional |
148 | | -linkedin: "https://linkedin.com/in/usuario" |
149 | | -github: "https://github.com/usuario" # Opcional |
| 92 | +title: "Nombre del Evento" |
| 93 | +description: "Descripcion del evento" |
| 94 | +location: "Lugar" |
| 95 | +photo: "/assets/img/events/evento.jpg" |
| 96 | +link: "https://enlace-al-evento.com" |
| 97 | +date: 2025-12-15 19:00:00 -0300 |
| 98 | +event_start_date: "15_12_2025:19_00_00" |
| 99 | +event_end_date: "15_12_2025:22_00_00" |
| 100 | +event_date_parsed: "15/12/2025" |
| 101 | +event_hours_parsed: "19:00 - 22:00" |
150 | 102 | --- |
151 | 103 | ``` |
152 | 104 |
|
153 | | -## 🤝 Gestión de Partners |
154 | | - |
155 | | -### Agregar Partner/Sponsor |
| 105 | +### Staff |
156 | 106 |
|
157 | | -Crear archivo en `_confidents/` con formato `nombre_empresa.md`: |
| 107 | +Crear un archivo en `_staff/` con formato `nombre_apellido.md`: |
158 | 108 |
|
159 | 109 | ```yaml |
160 | 110 | --- |
161 | | -name: "Nombre de la Empresa" |
162 | | -description: "Descripción de la empresa" |
163 | | -link: "https://empresa.com" |
164 | | -icon: "/assets/img/partners/logo_empresa.png" |
| 111 | +name: "Nombre Completo" |
| 112 | +role: "Cargo" |
| 113 | +description: "Descripcion" |
| 114 | +photo: "/assets/img/staff/nombre_apellido.jpg" |
| 115 | +linkedin: "https://linkedin.com/in/usuario" |
| 116 | +github: "https://github.com/usuario" |
| 117 | +twitter: "https://twitter.com/usuario" |
165 | 118 | --- |
166 | 119 | ``` |
167 | 120 |
|
168 | | -## 🎨 Personalización de Estilos |
169 | | - |
170 | | -### CSS Modular |
171 | | - |
172 | | -- **`main.css`**: Estilos principales del sitio |
173 | | -- **`components/`**: Estilos de componentes específicos |
174 | | -- **`pages/`**: Estilos específicos de páginas |
175 | | -- **`style.css`**: Configuración global y variables CSS |
176 | | - |
177 | | -### Variables CSS Principales |
178 | | - |
179 | | -```css |
180 | | -:root { |
181 | | - --primaryColor: #ff4444; |
182 | | - --font-path: '/assets/fonts/'; |
183 | | - --img-path: '/assets/img/'; |
184 | | -} |
185 | | -``` |
186 | | - |
187 | | -## 🚀 Despliegue |
| 121 | +### Colaboradores |
188 | 122 |
|
189 | | -### GitHub Pages (Automático) |
| 123 | +Crear un archivo en `_confidents/` con formato `nombre.md`: |
190 | 124 |
|
191 | | -El sitio se despliega automáticamente en GitHub Pages con cada push a la rama `main`. |
192 | | - |
193 | | -### Despliegue Manual |
194 | | - |
195 | | -```bash |
196 | | -# Construir sitio para producción |
197 | | -bundle exec jekyll build |
198 | | - |
199 | | -# Los archivos generados estarán en _site/ |
| 125 | +```yaml |
| 126 | +--- |
| 127 | +name: "Nombre de la empresa" |
| 128 | +description: "Descripcion" |
| 129 | +customURL: "https://empresa.com" |
| 130 | +icon: "/assets/img/partners/logo.png" |
| 131 | +--- |
200 | 132 | ``` |
201 | 133 |
|
202 | | -## 📱 SEO y Performance |
203 | | - |
204 | | -- **Meta tags** optimizados para redes sociales |
205 | | -- **Imágenes optimizadas** en formatos WebP y AVIF |
206 | | -- **CSS y JS minificados** en producción |
207 | | -- **Lazy loading** de imágenes |
208 | | -- **Sitemap** automático generado por Jekyll |
209 | | - |
210 | | -## 🤝 Contribución |
| 134 | +## SEO |
211 | 135 |
|
212 | | -1. **Fork** del repositorio |
213 | | -2. **Crear rama** para la característica: `git checkout -b feature/nueva-caracteristica` |
214 | | -3. **Commit** de cambios: `git commit -m 'Agregar nueva característica'` |
215 | | -4. **Push** a la rama: `git push origin feature/nueva-caracteristica` |
216 | | -5. **Crear Pull Request** |
| 136 | +- Metas Open Graph y Twitter en cada pagina. |
| 137 | +- `robots.txt` y `sitemap.xml` generados por Jekyll. |
217 | 138 |
|
218 | | -## 📞 Contacto |
| 139 | +## Despliegue |
219 | 140 |
|
220 | | -- **Email**: contacto@salta.dev.ar |
221 | | -- **Website**: [salta.dev.ar](https://salta.dev.ar) |
222 | | -- **WhatsApp**: [Únete a la comunidad](https://salta.dev.ar) |
| 141 | +- GitHub Pages con push a `main`. |
| 142 | +- Build manual: `bundle exec jekyll build`. |
223 | 143 |
|
224 | | -## 📄 Licencia |
225 | | - |
226 | | -Este proyecto está bajo la Licencia GPL-3.0. Ver el archivo `LICENSE` para más detalles. |
227 | | - |
228 | | ---- |
| 144 | +## Licencia |
229 | 145 |
|
230 | | -**Hecho con ❤️ por la comunidad SaltaDev** |
| 146 | +GPL-3.0. Ver [LICENSE](LICENSE). |
0 commit comments