Docs Documentación

Columnas de objetos

Referencia completa de las columnas de objects.csv con soporte bilingüe de nombres de columnas. Para la normalización de columnas y soporte de encabezados dobles, consulta Columnas del proyecto.

CSV de objetos (objects.csv / objetos.csv)

Cataloga todos los objetos usados en las historias y mostrados en la galería.

Ubicación: telar-content/spreadsheets/objects.csv o telar-content/spreadsheets/objetos.csv

Columnas

Inglés Español Requerido Descripción
object_id id_objeto Sí Identificador único (minúsculas, guiones, guiones bajos)
title titulo Sí Título del objeto
description descripcion No Descripción extensa (admite markdown)
source_url url_fuente No URL de la imagen IIIF info.json o manifiesto
creator creador No Nombre del creador o artista
period periodo No Periodo histórico
year año No Año de creación o datación (se usa para ordenar en la galería)
medium medio No Material o medio
dimensions dimensiones No Dimensiones físicas
source fuente No Ubicación o repositorio (renombrado desde location en v0.8.0)
credit credito No Línea de atribución o crédito
thumbnail miniatura No Ruta a la imagen en miniatura
object_type tipo_objeto No Clasificación del objeto (se usa para el filtro de la galería)
subjects temas No Temas, separados por comas (se usa para el filtro de la galería)
featured destacado No Pon yes para destacar en la página principal

Columnas de metadatos personalizados

Cualquier columna que agregues más allá de las 15 columnas estándar listadas arriba se muestra automáticamente en las páginas de objetos como campos de metadatos adicionales. El nombre de la columna se convierte en la etiqueta y el valor de la celda en el texto mostrado.

Por ejemplo, si agregas columnas material y technique a tu hoja de cálculo:

object_id,title,material,technique
textile-001,Textil Colonial,Mezcla de algodón y lana,Tejido en telar de cintura

Los valores “Mezcla de algodón y lana” y “Tejido en telar de cintura” aparecen como metadatos adicionales en la página del objeto, con las etiquetas “material” y “technique” respectivamente.

Ejemplo

Inglés:

object_id,title,description,creator,year,object_type,subjects,source,credit,featured,source_url
textile-001,Colonial Textile,A woven fragment showing complex patterns...,Unknown,1650,textile,"weaving, colonial",National Museum,Public Domain,yes,
map-lima,Map of Lima,Early colonial map showing city layout,Juan de Cuellar,1685,map,"cartography, Lima",British Library,,no,https://example.org/iiif/map/info.json

Español:

id_objeto,titulo,descripcion,creador,año,tipo_objeto,temas,fuente,credito,destacado,url_fuente
textil-001,Textil Colonial,Un fragmento tejido con patrones complejos...,Desconocido,1650,textil,"tejido, colonial",Museo Nacional,Dominio Público,si,
mapa-lima,Mapa de Lima,Mapa colonial temprano...,Juan de Cuellar,1685,mapa,"cartografía, Lima",Biblioteca Británica,,no,https://ejemplo.org/iiif/mapa/info.json

Notas de los campos

object_id / id_objeto

description / descripcion

source_url / url_fuente

year / año

source / fuente

object_type / tipo_objeto

subjects / temas

featured / destacado

credit / credito

thumbnail / miniatura

Alias del CSV de objetos

Normalizado Acepta
object_id object_id, id_objeto, objeto, object, id
title title, titulo
description description, descripcion
creator creator, creador
period period, periodo
year year, año, ano
medium medium, medio
dimensions dimensions, dimensiones
source source, fuente, location, ubicacion
credit credit, credito
thumbnail thumbnail, miniatura
object_type object_type, tipo_objeto
subjects subjects, temas, materias, materia
featured featured, destacado
source_url source_url, url_fuente
iiif_manifest iiif_manifest, manifiesto_iiif (heredado)

Buenas prácticas

Elegir nombres de columnas

Sitios monolingües: Usa tu idioma preferido de forma consistente

# Sitio en inglés
order,story_id,title,subtitle,byline

# Sitio en español
orden,id_historia,titulo,subtitulo,firma

Equipos bilingües: Usa encabezados dobles

order,story_id,title,subtitle,byline
orden,id_historia,titulo,subtitulo,firma

Organización de archivos

telar-content/spreadsheets/
├── project.csv              # Metadatos de las historias
├── objects.csv              # Catálogo de objetos
├── textiles-coloniales.csv  # Pasos de la historia (usando story_id)
├── rutas-comerciales.csv    # Otra historia
└── glossary.csv             # Términos de glosario (opcional)

Consejos para los metadatos de la galería

Para la mejor experiencia de galería con exploración, búsqueda y filtrado:

  1. Completa object_type para cada objeto — alimenta el filtro de tipo
  2. Agrega subjects con 2-4 términos separados por comas — alimenta el filtro de temas
  3. Incluye year para ordenación cronológica
  4. Marca 4-6 objetos como featured: yes para la muestra de la página principal
  5. Escribe campos description significativos — la búsqueda los indexa para texto completo

Migración de v0.7.x a v0.8.0

Columnas nuevas (opcionales)

Agrega estas a tu objects.csv si deseas filtrado y ordenación en la galería:

Columna Propósito
year Habilita ordenar por año en la galería
object_type Habilita el filtro de tipo en la barra lateral
subjects Habilita el filtro de temas en la barra lateral
featured Controla la muestra de objetos en la página principal

Columnas renombradas

Anterior (v0.7.x) Nuevo (v0.8.0) Notas
location source El nombre anterior sigue funcionando

Nueva columna en project.csv

Columna Propósito
protected Marca historias para encriptación (requiere story_key en la configuración)

Sin cambios que rompan compatibilidad. Todos los CSV de v0.7.x funcionan sin modificación.

Validación

Telar valida los datos CSV durante la compilación:

Errores (la build falla):

Advertencias (la build continúa):

Revisa la salida de la build para ver mensajes de validación.

Véase también