Docs Documentación

Project Columns

Complete reference for project.csv columns with bilingual column name support.

Overview

Telar v0.6.0+ supports CSV columns in both English and Spanish. You can use either language consistently, mix them, or include dual headers for bilingual reference.

Column Normalization

All column names are normalized during processing:

Dual Header Support

Include both English and Spanish headers for bilingual teams:

order,story_id,title,subtitle,byline
orden,id_historia,titulo,subtitulo,firma
1,colonial-textiles,Colonial Textiles,Weaving traditions,by Dr. Smith
2,textiles-coloniales,Textiles Coloniales,Tradiciones textiles,por Dra. García

Telar automatically detects and skips the second header row.

Project CSV (project.csv / proyecto.csv)

Defines stories and their display order on the homepage.

Location: components/structures/project.csv or components/structures/proyecto.csv

Columns

English Spanish Required Description
order orden Yes Display order on homepage (1, 2, 3…)
story_id id_historia No Semantic identifier (e.g., colonial-textiles). If omitted, uses story-{order}
title titulo Yes Story title shown on homepage and story page
subtitle subtitulo Yes Brief description shown on story cards
byline firma No Author attribution; supports markdown for links and formatting
protected protegida No Set to yes to encrypt this story (requires story_key in config)

Example

English:

order,story_id,title,subtitle,byline,protected
1,colonial-textiles,Colonial Textiles,Weaving traditions of the Americas,by Dr. Jane Smith,
2,trade-routes,Trade Routes,Following the threads of commerce,based on [original research](https://example.com),yes

Spanish:

orden,id_historia,titulo,subtitulo,firma,protegida
1,textiles-coloniales,Textiles Coloniales,Tradiciones de tejido de las Américas,por Dra. María García,
2,rutas-comerciales,Rutas Comerciales,Siguiendo los hilos del comercio,basado en [investigación original](https://ejemplo.com),si

Field Notes

order

story_id

title

subtitle

byline

protected

Column Aliases

Normalized Accepts
order order, orden
story_id story_id, id_historia
title title, titulo
subtitle subtitle, subtitulo
byline byline, firma
protected protected, protegida, private, privada

See Also