') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); })(); GitHub - paxapos/documentation: sveltekit project for documentation · GitHub
Skip to content
BranchesTags

Repository files navigation

Plataforma de Gestión Empresarial - Documentation

Sitio web de documentación oficial de nuestra solución integral de gestión, construido con SvelteKit y Tailwind CSS.

Descripción

Este proyecto contiene la documentación completa del sistema de gestión, incluyendo:

  • API Reference: Documentación de todas las APIs y endpoints
  • Manual de Usuario: Guías paso a paso para usuarios finales
  • Guía de Administrador: Configuración y administración del sistema
  • Guías de Integración: Conexiones con servicios externos
  • SDKs: Librerías y herramientas para desarrolladores
  • Troubleshooting: Solución de problemas comunes

Características

  • ✅ Navegación responsive con menú móvil
  • ✅ Búsqueda en tiempo real
  • ✅ Diseño moderno con Tailwind CSS
  • ✅ Estructura modular y escalable
  • ✅ Optimizado para SEO

Desarrollo

Para ejecutar el servidor de desarrollo:

# Instalar dependencias (requiere Node.js 20+)
pnpm install
# Ejecutar servidor de desarrollo
pnpm dev
# Con host expuesto para acceso desde red
pnpm dev --host

El servidor estará disponible en http://localhost:5173 (o el puerto disponible).

Estructura del Proyecto

src/
├── routes/
│ ├── +layout.svelte # Layout principal con navegación
│ ├── +page.svelte # Página de inicio
│ ├── api/+page.svelte # Documentación de API
│ ├── user-guide/+page.svelte # Manual de usuario
│ ├── admin-guide/+page.svelte # Guía de administrador
│ ├── integration/+page.svelte # Guías de integración
│ ├── sdk/+page.svelte # SDKs y librerías
│ └── troubleshooting/+page.svelte # Solución de problemas
├── app.css # Estilos globales
└── app.html # Template HTML base

Funcionalidades

Búsqueda

  • Búsqueda en tiempo real mientras escribes
  • Filtrado por tipo de contenido (API, Usuario, Admin, etc.)
  • Navegación directa a secciones específicas

Navegación

  • Menú principal responsive
  • Navegación lateral en páginas de documentación
  • Breadcrumbs en páginas secundarias
  • Enlaces de ancla para secciones

Responsive Design

  • Optimizado para móviles, tablets y escritorio
  • Menú hamburguesa en dispositivos móviles
  • Búsqueda adaptativa

Compilación

Para crear una versión de producción:

pnpm build

Esto generará los archivos estáticos en el directorio build/.

Para previsualizar la compilación de producción:

pnpm preview

Tasks de VS Code

Se incluyen las siguientes tasks configuradas:

  • DEV Documentation Site: Ejecuta el servidor de desarrollo
  • Usa Ctrl+Shift+P → Tasks: Run Task para ejecutarlas

Contribuir

  1. Las páginas están en src/routes/
  2. Cada página es un componente Svelte independiente
  3. Se usa Tailwind CSS para estilos
  4. La navegación se configura en +layout.svelte
  5. Los contenidos de búsqueda en searchableContent del layout

Tecnologías

  • SvelteKit: Framework principal
  • Tailwind CSS: Estilos y diseño
  • TypeScript: Tipado estático
  • Vite: Build tool y dev server
  • pnpm: Package manager

Despliegue

El sitio puede desplegarse en cualquier plataforma que soporte sitios estáticos:

  • Vercel
  • Netlify
  • GitHub Pages
  • Cloudflare Pages

Simplemente ejecuta pnpm build y despliega el contenido del directorio build/.

About

sveltekit project for documentation

Resources

Readme
Activity
Custom properties

Stars

0 stars

Watchers

3 watching

Forks

2 forks
Report repository

Releases

Packages

Contributors

Languages