Datos Bolivia Datos Bolivia
llms.txt
guia • guide • Activo
Ver Raw (.md)

Guía de Fork y Despliegue de tu Propio Portal de Datos

Este repositorio está arquitecturado específicamente para ser forkeable: cualquier gobierno local (municipio, gobernación), universidad, centro de investigación o colectivo ciudadano puede reutilizarlo para publicar su propio portal de datos abiertos en menos de 5 minutos.

Paso 1: Hacer Fork del Repositorio

1. Dirígete a github.com/datosbolivia/catalogo y presiona el botón Fork.

2. Clona tu repositorio forkeado:

bash 
git clone https://github.com/datosbolivia/catalogo.git
cd catalogo
npm install

Paso 2: Personalizar la Configuración en portal.config.ts

Abre portal.config.ts y modifica los datos de tu institución:

typescript 
export const config = {
  organization: {
    name: "Datos Salud",
    slug: "datos-salud",
    url: "https://datos-salud.org",
    github: "https://github.com/datos-salud/datos-salud.github.io",
    description: "Portal de datos abiertos sobre Salud."
  },
  site: {
    title: "Catálogo de Datos Abiertos de Salud",
    description: "Índice del Sistema SNIS, RNVE, entre otros.",
    tagline: "Transparencia y datos abiertos de salud para Bolivia",
    url: "https://datos-salud.org",
    base: "/"
  },
  // ...
};

Paso 3: Personalizar el Estilo en src/styles/theme.css

Sin tocar código TypeScript ni componentes Astro, cambia las variables CSS en src/styles/theme.css para aplicar los colores institucionales de tu entidad:

css 
:root {
  --color-primary: #10b981;       /* Verde institucional */
  --color-primary-hover: #059669;
  --color-secondary: #064e3b;
  --color-accent: #f59e0b;
  /* ... */
}

Paso 4: Editar los Contenidos en content/pages/

Edita los archivos Markdown para adaptar los textos:

  • content/pages/home.md: Bienvenida y presentación institucional.
  • content/pages/about.md: Historia, equipo, publicaciones de la institución.
  • content/pages/download.md: Opciones de descarga.

Paso 5: Añadir tus Nodos de Datos en knowledge/

1. Añade carpetas dentro de knowledge/nodes//:

  • index.md: Resumen y metadatos YAML.
  • datapackage.yaml: Contrato de columnas y tipos.

2. Registra el nuevo dataset en knowledge/index.md.

3. Valida el estándar:

bash 
npm run lint:okf

Paso 6: Opciones de Despliegue

Despliegue en GitHub Pages (Gratuito)

1. Ejecuta el build:

bash 
npm run build

2. En GitHub, ve a Settings > Pages y selecciona la rama de publicación (ej. gh-pages o la carpeta dist).

Despliegue en Vercel, Netlify o Cloudflare Pages

Conecta tu repositorio de GitHub:

  • Build command: npm run build
  • Output directory: dist

Empaquetar como Aplicación de Escritorio con Electron

bash 
npm run electron:build

Los instaladores generados se guardarán en la carpeta dist/releases.