diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml
index ea249b0..b846abe 100644
--- a/.github/workflows/pages.yml
+++ b/.github/workflows/pages.yml
@@ -1,53 +1,47 @@
-name: Deploy Jekyll site to Pages
+name: Build and deploy Telar with Hugo
on:
push:
- branches: ["main"]
+ branches: [main]
+ pull_request:
workflow_dispatch:
permissions:
contents: read
- pages: write
- id-token: write
concurrency:
- group: "pages"
- cancel-in-progress: false
+ group: pages-${{ github.ref }}
+ cancel-in-progress: ${{ github.event_name == 'pull_request' }}
jobs:
build:
runs-on: ubuntu-latest
steps:
- - name: Checkout
- uses: actions/checkout@v4
-
- - name: Setup Ruby
- uses: ruby/setup-ruby@v1
+ - uses: actions/checkout@v4
+ - uses: actions/setup-node@v4
with:
- ruby-version: '3.1'
- bundler-cache: true
-
- - name: Setup Pages
- id: pages
- uses: actions/configure-pages@v4
-
- - name: Build with Jekyll
- run: bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
- env:
- JEKYLL_ENV: production
-
- - name: Build search index with Pagefind
- run: npx -y pagefind --site _site
-
- - name: Upload artifact
- uses: actions/upload-pages-artifact@v3
+ node-version: '22'
+ cache: npm
+ - uses: actions/setup-python@v5
+ with:
+ python-version: '3.12'
+ - run: npm ci
+ - run: npm run build
+ - run: npm test
+ - uses: actions/upload-pages-artifact@v3
+ with:
+ path: public
deploy:
+ if: github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
+ needs: build
+ runs-on: ubuntu-latest
+ permissions:
+ pages: write
+ id-token: write
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
- runs-on: ubuntu-latest
- needs: build
steps:
- name: Deploy to GitHub Pages
id: deployment
diff --git a/.gitignore b/.gitignore
index 51a6793..e592766 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,28 +1,8 @@
-# Jekyll build files
-_site/
-.jekyll-cache/
-.jekyll-metadata
-.sass-cache/
-
-# Ruby/Bundler
-vendor/
-.bundle/
-Gemfile.lock
-
-# macOS
+node_modules/
+public/
+resources/
+.hugo_build.lock
.DS_Store
-
-# IDEs
-.vscode/
-.idea/
-*.swp
-*.swo
-*~
-
-# Logs
*.log
-
-# Screenshot automation
-screenshots/google-auth.json
-screenshots/gifs/_tmp_video/
-screenshots/gifs/_tmp_frames/
+reports/
+.build-result.json
diff --git a/.nojekyll b/.nojekyll
new file mode 100644
index 0000000..e69de29
diff --git a/Gemfile b/Gemfile
deleted file mode 100644
index ada9ea3..0000000
--- a/Gemfile
+++ /dev/null
@@ -1,11 +0,0 @@
-source "https://rubygems.org"
-
-gem "jekyll", "~> 4.3.4"
-gem "just-the-docs", "0.10.0"
-gem "csv"
-gem "base64"
-
-group :jekyll_plugins do
- gem "jekyll-seo-tag"
- gem "jekyll-last-modified-at"
-end
diff --git a/MIGRATION.md b/MIGRATION.md
new file mode 100644
index 0000000..a1f38a7
--- /dev/null
+++ b/MIGRATION.md
@@ -0,0 +1,52 @@
+# Jekyll → Hugo migration
+
+Pre-publication validation recorded 1 November 2026 on `site/hugo-migration`. This document records the migration scope, local checks and publication checklist.
+
+## Scope
+
+The migration starts from the approved redesigned Jekyll working tree, including its uncommitted changes, rebased onto main at `143fc62`, including its v1.8.3 release notes. Its original checkout and a separate source/rendered snapshot were preserved.
+
+All 234 existing HTML routes are retained. The native site contains 233 non-homepage pages plus English and Spanish homepages. These include all 160 canonical documentation pages, the 118-route legacy inventory, showcase pages/forms, the workshop and worksheet redirects, and the internal manual review page. The latter remains available but is excluded from search and marked noindex.
+
+The approved design, credits, screenshots, animations, video integration and copy are retained. The Spanish title is **Planea el recorrido de la historia**, with its former anchor preserved. The native Spanish homepage is `/es/`; old `?lang=` links forward while preserving the section fragment.
+
+## Native implementation
+
+Content is authored in Hugo's English and Spanish directories. Existing published URLs are explicit in front matter, and `translationKey` supplies native pairing. Shared data controls editorial navigation order, labels and media; the duplicate per-page title/translation registry is removed.
+
+The three shared page shells use native Go templates. Includes for diagrams, media, callouts and repeated guide content use shortcodes. Interactive configuration tools and showcase browser code are retained as source components. No Jekyll-generated page body is embedded in the site. The former Ruby/theme/Sass build has been removed from this worktree.
+
+Metadata, canonicals, language alternates, sitemaps and robots rules are generated by Hugo. Local builds use a separate preview configuration. Search indexes all 160 guide pages in two languages. The build uses pinned Hugo Extended 0.160.1 and Pagefind 1.5.2 dependencies installed by `npm ci`, without referencing another repository's tools.
+
+The production service addresses remain the existing showcase Worker. Local integration testing uses a separate Worker copy, database and test Turnstile keys, with no Slack destination. The documented preview harness was started successfully against the separate Worker checkout.
+
+## Validation
+
+- Clean `npm ci` succeeded.
+- Production: **20,441 checks; zero failures**.
+- Preview: **20,370 checks; zero failures**.
+- Source-to-output comparison: all 233 non-homepage pages and 160 canonical docs; **zero outstanding differences** under the recorded comparison rules.
+- Every existing served HTML route and all 118 legacy inventory entries remain available. Internal links, fragments, heading aliases, image targets and alt attributes pass.
+- Browser testing covered language pairing, both searches, slash/Escape search navigation, the configuration tools, math rendering, the gallery and both forms. English and Spanish teaching requests and one showcase request were stored locally. The three local notification jobs had zero delivery attempts and no sent timestamp.
+- Seven representative pages were measured at 390×844 and four at 768×1024. None had page-level horizontal overflow. The viewport capability affects the selected browser tab, which was explicitly verified before recording these results.
+- `git diff --check` passed. The prepared GitHub workflow has not yet run on GitHub.
+
+Machine-readable inventory and evidence are in `migration/`. Fresh test results are written to the ignored `reports/` directory. Route/content contracts are snapshots for regression checking; they are not runtime dependencies or copied page bodies.
+
+## Rendering and tool corrections
+
+The port preserves Kramdown heading IDs explicitly, converts callout annotations, supplies Chroma styles for native highlighting, and renders the approved HTML in quick-guide data as HTML. Large interactive HTML forms use native source components so CommonMark does not reinterpret their indentation as code.
+
+Two existing configuration-tool bugs were corrected during browser testing: the generator quoted its version/date twice, producing invalid YAML; and the validator did not recognise the existing `trama` theme. The generator now emits valid quoted values and the validator accepts all five installed theme names. No surrounding instructional wording was rewritten.
+
+One precisely recorded prose comparison exception covers stray visible Markdown delimiters around the Spanish “View full site” troubleshooting label. Hugo formats the unchanged words correctly. This is a rendering correction, not a new translation.
+
+## Publication checklist
+
+1. Review the complete local site at port 4004. The remaining Spanish editorial batches remain separate from this technical migration.
+2. Commit and push the migration branch when ready, then run the prepared pull-request build on GitHub. Remote CI and production deployment have not been exercised here.
+3. After the review and checks, merge to switch the existing Pages build to Hugo. No DNS or hosting migration is needed for the proposed workflow.
+4. Verify the live language homepages, old workshop links, search, gallery, Vimeo and both forms. Any live notification test should be deliberate; this migration's tests did not send notices.
+5. For rollback, restore the pre-release source/workflow commit or redeploy the previous Pages artifact. The old Jekyll working tree remains available locally for comparison.
+
+Telar exhibition sites and the Compositor's application build are unchanged by this documentation-site migration.
diff --git a/README.md b/README.md
index aacee18..34ea557 100644
--- a/README.md
+++ b/README.md
@@ -1,94 +1,58 @@
-# Telar Documentation
+# Telar project website
-Official documentation site for [Telar](https://github.com/UCSB-AMPLab/telar), a minimal-computing framework that weaves together IIIF images, audio, video, and texts to create layered visual narratives for digital scholarship, public exhibitions, community storytelling, and classroom projects.
+The bilingual documentation and project website for [Telar](https://telar.org), built with Hugo Extended and Pagefind. This repository publishes the manuals, exhibition-planning guides, teaching resources, showcase and landing pages. Telar exhibitions themselves still use the separate Telar framework and its Jekyll build.
-## About
+## Install and preview
-This is a bilingual (English/Spanish) documentation site built with Jekyll using a custom docs theme with [Pagefind](https://pagefind.app/) search.
+Requires Node.js 22 or later. Regression checks additionally use Python 3, with no Python packages required.
-## Local Development
-
-### Prerequisites
-
-- Ruby 3.0+
-- Bundler
-- Node.js (for Pagefind search indexing)
-
-### Basic Setup (without search)
-
-```bash
-# Install dependencies
-bundle install
-
-# Serve locally with live reload
-bundle exec jekyll serve --livereload
-
-# View at http://localhost:4000
+```sh
+npm ci
+npm run build:preview
+npm run preview
```
-### With Search
+Open for English, for Spanish, or `/docs/` and `/guia/` for the guides. Existing `?lang=en` and `?lang=es` homepage links forward to the appropriate language's canonical homepage.
-Pagefind requires a two-step process (can't use `jekyll serve` as it overwrites the search index):
+For live content/layout rebuilding, run `npm run dev` after the initial preview build. Rebuild with `npm run build:preview` after content changes when checking search results: Pagefind indexes the generated HTML.
-```bash
-# Build Jekyll site
-bundle exec jekyll build
+### Previewing forms and the showcase
-# Build search index and serve
-npx pagefind --site _site --serve
+The production site uses the separate `telar-showcase` Cloudflare Worker. The local preview points both forms and the gallery to port 8790 instead. To run the local integration harness, use a checkout of that Worker containing the teaching-request endpoint and its installed dependencies:
-# View at http://localhost:1414
+```sh
+node scripts/preview-api.mjs --worker /path/to/telar-showcase
```
-For regular development without search, use `jekyll serve`. Search is automatically built during GitHub Actions deployment.
-
-## Bilingual Structure
+The harness copies only Worker source and migrations into a temporary directory, creates a separate local database, loads a public showcase fixture and uses Cloudflare's test Turnstile keys. It does not copy credentials, notification destinations or existing records. Submitted test data remains in that temporary database; Slack delivery is disabled. Stop the API with Ctrl-C. The temporary path is printed at startup.
-This site uses a manual bilingual approach without plugins:
+The pages can be browsed without this API. Forms then show their existing connection error; the gallery shows its existing fallback. Production service configuration is in `hugo.json`, and local overrides are in `hugo.preview.json`.
-- **English pages**: Standard `.md` files (e.g., `docs/1-getting-started.md`)
-- **Spanish pages**: `.es.md` extension (e.g., `docs/1-getting-started.es.md`)
-- **URL structure**:
- - English: `/`, `/about/`, `/docs/...`
- - Spanish: `/es/`, `/acerca-de/`, `/documentacion/...`
+## Edit the site
-### Adding Content
+- `content/en/` and `content/es/` contain the content. Paths mirror the published routes. An `_index.md` is a page that also has child pages.
+- Each page's `url` retains its published address. Keep its `translationKey` aligned with its counterpart; Hugo supplies the translation links.
+- `data/guides.json` contains shared guide/quick-guide copy. `data/docs_navigation.json` controls the editorial grouping and order. Page titles and translation pairing live in front matter rather than a second page registry.
+- `data/teaching_contact.json` contains the approved teaching form copy. `data/docs_media.json` supplies screenshot captions and optional animations.
+- `layouts/_partials/docs-shell.html`, `section-shell.html` and `home.html` are the three shared page shells. Metadata lives in `meta.html`.
+- `layouts/_shortcodes/` contains media, callout, diagram and shared-content components. Larger interactive tools use source templates in `layouts/_partials/pages/`.
+- `static/` contains the existing styles, browser scripts and media. Hugo does not rewrite Telar framework examples in the documentation.
-1. Create English page: `docs/new-page.md`
-2. Add frontmatter with `lang: en` and `permalink:`
-3. Create Spanish version: `docs/new-page.es.md`
-4. Add frontmatter with `lang: es` and Spanish `permalink:`
+Preserve explicit heading IDs and alias spans when changing headings. They keep existing links and workshop references working. The approved design and wording carry over; the remaining Spanish editorial review is a separate task.
-### Navigation
+## Build and verify
-The custom navigation (`_includes/components/site_nav.html`) groups pages by language, showing:
-- English section with English pages
-- Español section with Spanish pages
-
-The language switcher appears at the top-right of each page.
-
-## Customization
-
-- **Theme styles**: `_sass/custom/custom.scss`
-- **Logo**: `images/telar.png` (placeholder - replace with final logo)
-- **Site config**: `_config.yml`
-
-## Credits
-
-Telar is developed by Adelaida Ávila, Ana María Cárdenas Gasca, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, and students and scholars at the [UCSB Archives, Memory, and Preservation Lab](https://ampl.clair.ucsb.edu), the UT Archives, Mapping, and Pedagogy Lab, and [Neogranadina](https://neogranadina.org).
+```sh
+npm run build
+npm test
+```
-We gratefully acknowledge the support of the [Caribbean Digital Scholarship Collective](https://cdscollective.org), the [Center for Innovative Teaching, Research, and Learning (CITRAL)](https://citral.ucsb.edu/home) at the University of California, Santa Barbara, the [UCSB Library](https://library.ucsb.edu), the [Routes of Enslavement in the Americas University of California MRPI](https://www.humanities.uci.edu/routes-enslavement-americas), and the [Department of History of The University of Texas at Austin](https://liberalarts.utexas.edu/history/).
+The production build writes `public/` and indexes the guides in English and Spanish. The test command checks the migrated route inventory, legacy anchors, headings, code examples, tables, callouts, images, metadata, translation links and internal link targets. It also rejects prototype dependencies and local runtime URLs in production HTML. Results are written to the ignored `reports/` directory.
-Telar is built with:
-- [Jekyll](https://jekyllrb.com/) - Static site generator
-- [OpenSeadragon](https://openseadragon.github.io/) - IIIF viewer
-- [Bootstrap 5](https://getbootstrap.com/) - CSS framework
-- [libvips](https://www.libvips.org/) - IIIF tile generator
+After an approved change to a heading or code example, update that page's entry in `migration/content-contracts.json` as part of the same edit. Retain the old anchor IDs as aliases. Ordinary prose changes do not require changing the heading/code contracts.
-It is based on [Paisajes Coloniales](https://paisajescoloniales.com/), and inspired by:
-- [Wax](https://minicomp.github.io/wax/) - Minimal computing for digital exhibitions
-- [CollectionBuilder](https://collectionbuilder.github.io/) - Static digital collections
+`migration/inventory.json` records the original source file and native Hugo destination for each migrated page. `migration/content-contracts.json` records the baseline rendering contracts. These are regression evidence, not generated page bodies.
-## License
+The Pages workflow builds and tests pull requests. Its deployment job runs only for `main`, after the checks pass. The deployment artifact is `public/`; source files, local fixtures and migration records are not published.
-The Telar documentation site is licensed under the [Creative Commons Attribution 4.0 International License (CC BY 4.0)](LICENSE). You are free to share and adapt the content, including for commercial use, as long as you give appropriate credit and indicate if changes were made.
+See [MIGRATION.md](MIGRATION.md) for migration scope, validation and the remaining release steps.
diff --git a/_config.dev.yml b/_config.dev.yml
deleted file mode 100644
index fe3474c..0000000
--- a/_config.dev.yml
+++ /dev/null
@@ -1,3 +0,0 @@
-# Development overrides for browser testing against a local Worker.
-# Use: bundle exec jekyll serve --port 4001 --config _config.yml,_config.dev.yml
-showcase_api: "http://127.0.0.1:8787"
diff --git a/_config.yml b/_config.yml
deleted file mode 100644
index a0ac923..0000000
--- a/_config.yml
+++ /dev/null
@@ -1,92 +0,0 @@
-# Telar - Official Project Site
-title: Telar
-description: "A minimal-computing framework that weaves together IIIF images, audio, video, and texts to create layered visual narratives for digital scholarship, public exhibitions, community storytelling, and classroom projects."
-baseurl: ""
-url: "https://telar.org"
-logo: "/images/telar.png"
-
-# Theme
-theme: just-the-docs
-color_scheme: telar
-
-# Aux links for header
-aux_links:
- "Home":
- - "/"
- "GitHub":
- - "https://github.com/UCSB-AMPLab/telar"
- "Demo":
- - "https://ampl.clair.ucsb.edu/telar"
-
-# Footer content
-footer_content: "Developed by Adelaida Ávila, Ana María Cárdenas Gasca, Juan Cobo Betancourt, Natalie Cobo, Santiago Muñoz, and students and scholars at the UCSB Archives, Memory, and Preservation Lab, the UT Archives, Mapping, and Pedagogy Lab, and Neogranadina"
-
-# Search
-search_enabled: true
-search:
- heading_level: 2
- previews: 3
- preview_words_before: 5
- preview_words_after: 10
- tokenizer_separator: /[\s/]+/
- rel_url: true
- button: false
-
-# Navigation
-nav_sort: order
-nav_external_links:
- - title: Telar GitHub Repository
- url: https://github.com/UCSB-AMPLab/telar
- hide_icon: false
-
-# Code copying
-enable_copy_code_button: true
-
-# Back to top
-back_to_top: true
-back_to_top_text: "Back to top"
-
-# Heading anchors
-heading_anchors: true
-
-# Callouts
-callouts_level: quiet
-callouts:
- warning:
- title: Warning
- color: red
- note:
- title: Note
- color: blue
- tip:
- title: Tip
- color: green
- beta:
- title: Beta Release
- color: yellow
-
-# Telar framework version (used across the docs site)
-telar_version: "1.8.3"
-telar_release_date: "2026-10-31"
-
-# Showcase: form and gallery backed by the telar-showcase Worker
-showcase_api: "https://showcase.telar.org"
-showcase_turnstile_site_key: "0x4AAAAAAE2tYZjlIcT_XQw9"
-
-# Build settings
-markdown: kramdown
-kramdown:
- math_engine: null
-permalink: pretty
-
-# Plugins
-plugins:
- - jekyll-seo-tag
-
-# Exclude from build
-exclude:
- - Gemfile
- - Gemfile.lock
- - node_modules
- - vendor
- - README.md
diff --git a/_includes/components/site_nav.html b/_includes/components/site_nav.html
deleted file mode 100644
index 4345d58..0000000
--- a/_includes/components/site_nav.html
+++ /dev/null
@@ -1,108 +0,0 @@
-{%- comment -%}
- Custom site navigation with language grouping
- Each language section includes home link, pages, and external links
-{%- endcomment -%}
-
-
-
-{% if site.nav_error_report %}
-{{ nav_error_report }}
-{%- endif %}
diff --git a/_includes/docs/nav.html b/_includes/docs/nav.html
deleted file mode 100644
index 2520ded..0000000
--- a/_includes/docs/nav.html
+++ /dev/null
@@ -1,129 +0,0 @@
-{%- comment -%}
-Build navigation from pages with parent frontmatter.
-Adds data-lang attribute for language filtering.
-{%- endcomment -%}
-
-{%- comment -%} Get top-level pages (no parent) {%- endcomment -%}
-{% assign top_pages = site.html_pages | where_exp: "item", "item.parent == nil" | where_exp: "item", "item.nav_exclude != true" | where_exp: "item", "item.title != nil" | sort: "nav_order" %}
-
-{%- comment -%} Group by language {%- endcomment -%}
-{% assign en_pages = top_pages | where: "lang", "en" %}
-{% assign es_pages = top_pages | where: "lang", "es" %}
-
-{%- comment -%} English Navigation {%- endcomment -%}
-
When on, your site serves at the root of your domain. When off, it serves at domain.com/repo-name.
-
-
-
-
-
-
-
-
-
-
-
-
Your site's base domain
-
-
-
-
-
-
-
Path after domain. Leave empty to serve at the root.
-
-
-
-
-
-
-
-
Google Sheets Integration
-
Manage your content via Google Sheets instead of editing CSV files directly. Telar fetches your data automatically during each build.
-
-
-
-
-
-
When off, Telar uses CSV files from your repository instead — make sure you have them in telar-content/spreadsheets/
-
-
-
-
-
-
-
-
-
-
-
From File → Share → Publish to web
-
-
-
-
-
-
-
-
Story Interface
-
Control how stories display and behave on your site. These settings affect the story viewer and homepage presentation.
-
-
-
-
-
-
When on, story cards appear on the homepage. Stories are still accessible via navigation when off.
-
-
-
-
-
-
-
-
Displays "Step 1", "Step 2", etc. as you scroll through a story. Purely visual.
-
-
-
-
-
-
-
-
Displays a dismissable credit badge in the bottom-left corner of story viewers. Credit information still appears in the metadata table either way.
-
-
-
-
-
-
-
-
Fetches tutorial stories from the Telar content server. These show a "Demo" badge and help new users explore the interface. Turn off for production sites.
-
-
-
-
-
-
-
Collection Interface
-
Control how the objects gallery displays and behaves, including filtering, search, and homepage presentation.
-
-
-
-
-
-
Enables the filter sidebar with facets on the objects page
-
-
-
-
-
-
-
-
Displays a "View the objects" link on the homepage
-
-
-
-
-
-
-
-
Displays objects marked as featured in your objects.csv on the homepage
-
-
-
-
-
-
-
-
Number of objects to show in the homepage sample
-
-
-
-
-
-
-
Private Stories
-
Encrypt stories so only viewers with the correct key can access them. Stories with private: yes in your project.csv (or Google Sheets Project tab) will be encrypted during build.
-
-
-
-
-
-
Uses client-side encryption. Prevents casual access but is not suitable for highly sensitive content.
-
-
-
-
-
-
-
-
-
-
-
Viewers access protected stories via ?key=your-secret-key
-
-
-
-
-
-
-
-
-
- Copied!
-
-
-
-
-
Generated _config.yml
-
-
1
-
-
-
-
-
+{{< template "widget-docs-configure-config-generator" >}}
+
-## What this checks
+## What this checks {#what-this-checks}
1. **YAML syntax** — Catches parse errors, tab characters, and unclosed quotes, with line numbers
2. **Required fields** — Ensures `title`, `url`, and `baseurl` are present and properly formatted
3. **Telar settings** — Validates theme names, language codes, Google Sheets URLs, and baseurl formatting
4. **Helpful warnings** — Notes about default settings, common GitHub Pages pitfalls, and the read-only section
-## See also
+## See also {#see-also}
- [Configuration Reference](/docs/configure/configuration/) — Full list of all `_config.yml` settings
- [Config Generator and Editor](/docs/configure/config-generator/) — Generate or edit a `_config.yml` file
diff --git a/docs/3-2-configuration.md b/content/en/docs/configure/configuration.md
similarity index 82%
rename from docs/3-2-configuration.md
rename to content/en/docs/configure/configuration.md
index 934ada6..f590e46 100644
--- a/docs/3-2-configuration.md
+++ b/content/en/docs/configure/configuration.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "3.2. Configuration Reference"
-parent: "3. Configure Your Site"
-grand_parent: Documentation
-nav_order: 2
-lang: en
-permalink: /docs/configure/configuration/
+title: Configuration
+url: /docs/configure/configuration/
+translationKey: docs-configure-configuration
+type: guide
+docs_section: reference
---
-# Configuration
+# Configuration {#configuration}
Configure your Telar site through the `_config.yml` file in your repository root.
-## Site Settings
+## Site Settings {#site-settings}
Basic site information and appearance:
@@ -30,7 +28,7 @@ telar_language: "en" # Options: "en" (English), "es" (Español)
collection_mode: false # Set to true for objects-first homepage layout
```
-### collection_mode
+### collection_mode {#collection_mode}
Switches the homepage layout from stories-first (default) to objects-first:
@@ -41,7 +39,7 @@ This is a top-level setting — not nested inside `collection_interface:`. See [
**New in v1.1.0.**
-### baseurl vs. url
+### baseurl vs. url {#baseurl-vs-url}
- **url**: Your site's base domain
- **baseurl**: Path after domain (use `""` for root domain, or `/repo-name` for GitHub Pages)
@@ -59,7 +57,7 @@ baseurl: ""
# Result: https://mysite.org
```
-### Site Logo
+### Site Logo {#site-logo}
Add a logo to replace the site title in the navigation header:
@@ -72,7 +70,7 @@ logo: "/telar-content/objects/my-logo.png"
- Recommended dimensions: max 80px tall, 200-300px wide
- Supports PNG, JPG, SVG formats
-## Theme Selection
+## Theme Selection {#theme-selection}
Telar includes 4 preset themes:
@@ -80,7 +78,7 @@ Telar includes 4 preset themes:
telar_theme: "paisajes" # Options: paisajes, neogranadina, santa-barbara, austin, or custom
```
-### Available Themes
+### Available Themes {#available-themes}
- **paisajes** (default): Terracotta and olive
- **neogranadina**: Burgundy and gold
@@ -89,7 +87,7 @@ telar_theme: "paisajes" # Options: paisajes, neogranadina, santa-barbara, austi
See [Customization: Themes](/docs/customization/themes/) for details and creating custom themes.
-## Multilingual Interface
+## Multilingual Interface {#multilingual-interface}
Telar v0.4.0+ supports multilingual user interfaces in English and Spanish:
@@ -99,7 +97,7 @@ telar_language: "en" # Options: "en" (English), "es" (Español)
This controls the language of all interface elements, including navigation, buttons, labels, error messages, and instructions.
-### What Gets Translated
+### What Gets Translated {#what-gets-translated}
The `telar_language` setting changes the language of:
@@ -111,7 +109,7 @@ The `telar_language` setting changes the language of:
- **Object pages**: IIIF manifest labels, coordinate identification instructions
- **Glossary**: Panel headers, navigation elements
-### What Stays in Your Language
+### What Stays in Your Language {#what-stays-in-your-language}
The `telar_language` setting **does not** translate your content:
@@ -121,10 +119,11 @@ The `telar_language` setting **does not** translate your content:
- About page content
- Site title and description
-{: .note }
-> If you need a fully bilingual site with content in multiple languages, you'll need to create separate Telar sites for each language.
+{{< callout "note" >}}
+If you need a fully bilingual site with content in multiple languages, you'll need to create separate Telar sites for each language.
+{{< /callout >}}
-### IIIF Metadata Language Detection
+### IIIF Metadata Language Detection {#iiif-metadata-language-detection}
When Telar auto-extracts metadata from IIIF manifests, it respects your `telar_language` setting:
@@ -133,7 +132,7 @@ When Telar auto-extracts metadata from IIIF manifests, it respects your `telar_l
This ensures that object metadata appears in your preferred language when available from the source institution.
-## Google Sheets Integration
+## Google Sheets Integration {#google-sheets-integration}
Manage content via Google Sheets instead of editing CSV files directly:
@@ -143,7 +142,7 @@ google_sheets:
published_url: "https://docs.google.com/spreadsheets/d/e/YOUR_PUBLISHED_ID/pubhtml"
```
-### Setup Steps
+### Setup Steps {#setup-steps}
1. **Get the template**: Duplicate the template at [bit.ly/telar-template](https://bit.ly/telar-template)
2. **Publish your sheet**: **File** → **Share** → **Publish to web**
@@ -155,12 +154,13 @@ google_sheets:
- **GitHub Pages**: GitHub Actions automatically discovers tab GIDs and fetches CSVs
- **Local development**: Run `python3 scripts/fetch_google_sheets.py` before building
-{: .note }
-> Only the published URL is needed. If your config still has a `shared_url` line from an older version, it is safely ignored.
+{{< callout "note" >}}
+Only the published URL is needed. If your config still has a `shared_url` line from an older version, it is safely ignored.
+{{< /callout >}}
See [Google Sheets Reference](/docs/your-data/google-sheets/) for complete setup instructions.
-## Story Interface Settings
+## Story Interface Settings {#story-interface-settings}
Control how stories display and behave:
@@ -172,7 +172,7 @@ story_interface:
include_demo_content: false # Set to true to enable demo stories
```
-### show_on_homepage
+### show_on_homepage {#show_on_homepage}
Controls whether the stories section appears on the homepage:
@@ -181,7 +181,7 @@ Controls whether the stories section appears on the homepage:
Use this when you want objects on the homepage but prefer stories to be accessed through navigation or direct links rather than homepage cards.
-### show_story_steps
+### show_story_steps {#show_story_steps}
Controls whether the "Step X" indicator appears in the top-left corner of the story page.
@@ -190,7 +190,7 @@ Controls whether the "Step X" indicator appears in the top-left corner of the st
This is purely visual - users can still navigate through steps normally.
-### include_demo_content
+### include_demo_content {#include_demo_content}
Enable pre-built demonstration stories that showcase Telar's features:
@@ -210,7 +210,7 @@ Demo stories appear alongside your own content with a "Demo content" badge. They
See [Demo Content](/docs/customization/demo-content/) for complete details on available demos.
-## Collection Interface Settings
+## Collection Interface Settings {#collection-interface-settings}
Control how the objects gallery displays and behaves:
@@ -222,28 +222,28 @@ collection_interface:
featured_count: 4 # Number of objects to show on homepage
```
-### browse_and_search
+### browse_and_search {#browse_and_search}
Controls the gallery's filtering sidebar and full-text search:
- **`true` (default)**: Objects page shows a filter sidebar with facets (type, creator, period, subjects) and a search bar powered by Lunr.js
- **`false`**: Objects page shows a simple grid without filtering or search
-### show_link_on_homepage
+### show_link_on_homepage {#show_link_on_homepage}
Controls the "View the objects" link on the homepage:
- **`true` (default)**: Shows a link to the objects gallery on the homepage
- **`false`**: Hides the link (objects page still accessible via navigation)
-### show_sample_on_homepage
+### show_sample_on_homepage {#show_sample_on_homepage}
Controls whether sample objects appear on the homepage:
- **`true` (default)**: Shows a sample of objects on the homepage, drawn from those marked as `featured` in objects.csv (or random if none are featured)
- **`false`**: No objects displayed on the homepage
-### featured_count
+### featured_count {#featured_count}
Number of objects to display on the homepage when `show_sample_on_homepage` is true:
@@ -251,7 +251,7 @@ Number of objects to display on the homepage when `show_sample_on_homepage` is t
- Prioritizes objects marked `featured: yes` in objects.csv
- If fewer featured objects exist than `featured_count`, fills remaining slots randomly
-## Story Protection
+## Story Protection {#story-protection}
Encrypt stories so that only viewers with the correct key can access them:
@@ -269,10 +269,11 @@ story_key: "your-secret-key"
- See [Private Stories](/docs/site-features/private-stories/) for setup, local-testing, and
build-failure details
-{: .warning }
-> Story protection uses client-side encryption. It prevents casual access but is not suitable for highly sensitive content. For stronger security, use a private GitHub repository.
+{{< callout "warning" >}}
+Story protection uses client-side encryption. It prevents casual access but is not suitable for highly sensitive content. For stronger security, use a private GitHub repository.
+{{< /callout >}}
-### show_object_credits
+### show_object_credits {#show_object_credits}
Controls the credit attribution badge on object pages:
@@ -281,15 +282,16 @@ Controls the credit attribution badge on object pages:
The credit badge displays in the top-right corner of object images, showing attribution from the `credit` field in your `objects.csv`.
-## Advanced Settings
+## Advanced Settings {#advanced-settings}
The following settings are pre-configured and typically don't need modification unless you're doing advanced customization.
-{: .warning }
-> **Do Not Edit**
-> The Telar `_config.yml` includes a line: "PLEASE DO NOT EDIT BELOW THIS LINE UNLESS YOU KNOW WHAT YOU ARE DOING". The sections below this line are configured automatically and rarely need changes.
+{{< callout "warning" >}}
+**Do Not Edit**
+The Telar `_config.yml` includes a line: "PLEASE DO NOT EDIT BELOW THIS LINE UNLESS YOU KNOW WHAT YOU ARE DOING". The sections below this line are configured automatically and rarely need changes.
+{{< /callout >}}
-### Collections
+### Collections {#collections}
Jekyll collections define content types:
@@ -312,12 +314,13 @@ collections:
collections_dir: _jekyll-files
```
-{: .note }
-> You typically don't need to modify collection settings unless doing advanced customization.
+{{< callout "note" >}}
+You typically don't need to modify collection settings unless doing advanced customization.
+{{< /callout >}}
The `collections_dir` setting tells Jekyll where to find auto-generated working files.
-### Defaults
+### Defaults {#defaults}
Layout defaults for each collection:
@@ -345,7 +348,7 @@ defaults:
layout: "user-page"
```
-### Build Settings
+### Build Settings {#build-settings}
Standard Jekyll build configuration:
@@ -367,7 +370,7 @@ future: true
show_drafts: false
```
-### Plugins
+### Plugins {#plugins}
Required plugin:
@@ -378,17 +381,17 @@ plugins:
Installed automatically when you run `bundle install`.
-### Telar Version
+### Telar Version {#telar-version}
Version information (updated automatically during releases):
```yaml
telar:
- version: "{{ site.telar_version }}"
- release_date: "{{ site.telar_release_date }}"
+ version: "{{< site-value "telar_version" >}}"
+ release_date: "{{< site-value "telar_release_date" >}}"
```
-### Development Features
+### Development Features {#development-features}
Options for development, testing, and special use cases (please do not edit these unless you know what you are doing):
@@ -405,7 +408,7 @@ development-features:
skip_collections: false
```
-#### christmas_tree_mode
+#### christmas_tree_mode {#christmas_tree_mode}
Displays all warning messages for testing multilingual support:
@@ -414,7 +417,7 @@ Displays all warning messages for testing multilingual support:
Use this only when testing translations or warning message styling.
-#### hide_warnings
+#### hide_warnings {#hide_warnings}
Hides the warnings the build produces on the published site:
@@ -423,7 +426,7 @@ Hides the warnings the build produces on the published site:
Use this only when you have checked a warning and know it does not affect your site. While it is on, you won't see warnings about new problems on your site either.
-#### viewer_preloading
+#### viewer_preloading {#viewer_preloading}
Controls how story viewers are preloaded for smoother navigation:
@@ -434,7 +437,7 @@ Controls how story viewers are preloaded for smoother navigation:
Higher values = smoother scrolling but more memory usage. The defaults work well for most sites.
-#### skip_stories
+#### skip_stories {#skip_stories}
Build a site without stories, keeping only objects visible:
@@ -443,10 +446,11 @@ Build a site without stories, keeping only objects visible:
Use this when you want to showcase objects without narrative stories, or when building a catalog-style site.
-{: .note }
-> Renamed from `hide_stories` in v0.8.0. The old name still works for backward compatibility.
+{{< callout "note" >}}
+Renamed from `hide_stories` in v0.8.0. The old name still works for backward compatibility.
+{{< /callout >}}
-#### skip_collections
+#### skip_collections {#skip_collections}
Build a site with only custom user pages (no objects or stories):
@@ -455,10 +459,11 @@ Build a site with only custom user pages (no objects or stories):
Use this when building a site with only custom pages (like an "About" or landing page) without any collections.
-{: .note }
-> When `skip_collections` is enabled, `skip_stories` is automatically implied. Renamed from `hide_collections` in v0.8.0 — the old name still works for backward compatibility.
+{{< callout "note" >}}
+When `skip_collections` is enabled, `skip_stories` is automatically implied. Renamed from `hide_collections` in v0.8.0 — the old name still works for backward compatibility.
+{{< /callout >}}
-## Full Example
+## Full Example {#full-example}
Here's a complete `_config.yml` example:
@@ -559,8 +564,8 @@ show_drafts: false
# Telar Settings
telar:
- version: "{{ site.telar_version }}"
- release_date: "{{ site.telar_release_date }}"
+ version: "{{< site-value "telar_version" >}}"
+ release_date: "{{< site-value "telar_release_date" >}}"
# Plugins
plugins:
@@ -586,7 +591,7 @@ development-features:
skip_collections: false
```
-## See Also
+## See Also {#see-also}
- [Config Validator](/docs/configure/config-validator/) — Check your `_config.yml` for common errors
- [Config Generator and Editor](/docs/configure/config-generator/) — Generate or edit a `_config.yml` file
diff --git a/content/en/docs/content-structure/_index.md b/content/en/docs/content-structure/_index.md
new file mode 100644
index 0000000..81655a0
--- /dev/null
+++ b/content/en/docs/content-structure/_index.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/content-structure/
+translationKey: redirects-en-content-structure-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/your-content/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/content-structure/custom-pages.md b/content/en/docs/content-structure/custom-pages.md
new file mode 100644
index 0000000..e50a735
--- /dev/null
+++ b/content/en/docs/content-structure/custom-pages.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/content-structure/custom-pages/
+translationKey: redirects-en-cs-custom-pages-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/site-features/custom-pages/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/content-structure/glossary.md b/content/en/docs/content-structure/glossary.md
new file mode 100644
index 0000000..c474f1d
--- /dev/null
+++ b/content/en/docs/content-structure/glossary.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/content-structure/glossary/
+translationKey: redirects-en-cs-glossary-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/site-features/glossary/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/content-structure/objects-gallery.md b/content/en/docs/content-structure/objects-gallery.md
new file mode 100644
index 0000000..c261a05
--- /dev/null
+++ b/content/en/docs/content-structure/objects-gallery.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/content-structure/objects-gallery/
+translationKey: redirects-en-cs-objects-gallery-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/your-content/objects/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/content-structure/private-stories.md b/content/en/docs/content-structure/private-stories.md
new file mode 100644
index 0000000..0c652f9
--- /dev/null
+++ b/content/en/docs/content-structure/private-stories.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/content-structure/private-stories/
+translationKey: redirects-en-cs-private-stories-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/site-features/private-stories/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/content-structure/stories-panels.md b/content/en/docs/content-structure/stories-panels.md
new file mode 100644
index 0000000..504faba
--- /dev/null
+++ b/content/en/docs/content-structure/stories-panels.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/content-structure/stories-panels/
+translationKey: redirects-en-cs-stories-panels-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/your-content/stories-panels/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/content-structure/widgets.md b/content/en/docs/content-structure/widgets.md
new file mode 100644
index 0000000..afab597
--- /dev/null
+++ b/content/en/docs/content-structure/widgets.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/content-structure/widgets/
+translationKey: redirects-en-cs-widgets-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/your-content/widgets/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/docs/7-0-customization.md b/content/en/docs/customization/_index.md
similarity index 75%
rename from docs/7-0-customization.md
rename to content/en/docs/customization/_index.md
index 347fb43..54c04e2 100644
--- a/docs/7-0-customization.md
+++ b/content/en/docs/customization/_index.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "7. Customization"
-parent: Documentation
-nav_order: 7
-has_children: true
-lang: en
-permalink: /docs/customization/
+title: Customization
+url: /docs/customization/
+translationKey: docs-customization
+type: guide
+docs_section: reference
---
-# Customization
+# Customization {#customization}
Make Telar your own with themes, custom styling, and layout modifications.
-## Themes
+## Themes {#themes}
Telar includes 4 preset themes that you can switch with a single line in `_config.yml`:
@@ -23,13 +21,13 @@ Telar includes 4 preset themes that you can switch with a single line in `_confi
[Learn about Themes](/docs/customization/themes/)
-## Advanced Styling
+## Advanced Styling {#advanced-styling}
For customization beyond the standard themes, you can modify CSS variables, layouts, and component styles.
[Advanced Styling Guide](/docs/developers/styling/)
-## Quick Theme Switch
+## Quick Theme Switch {#quick-theme-switch}
Change your theme in `_config.yml`:
diff --git a/docs/7-4-demo-content.md b/content/en/docs/customization/demo-content.md
similarity index 86%
rename from docs/7-4-demo-content.md
rename to content/en/docs/customization/demo-content.md
index f67d821..e99908e 100644
--- a/docs/7-4-demo-content.md
+++ b/content/en/docs/customization/demo-content.md
@@ -1,24 +1,22 @@
---
-layout: docs
-title: "7.4. Demo Content"
-parent: "7. Customization"
-grand_parent: Documentation
-nav_order: 4
-lang: en
-permalink: /docs/customization/demo-content/
+title: Demo Content
+url: /docs/customization/demo-content/
+translationKey: docs-customization-demo-content
+type: guide
+docs_section: reference
---
-# Demo Content
+# Demo Content {#demo-content}
Demo content adds two finished example stories to your site, so you can see how a Telar story is built and how it behaves before you write your own.
-## What is Demo Content?
+## What is Demo Content? {#what-is-demo-content}
Demo content is a set of example stories, together with the objects and glossary entries they use. Telar downloads it from [content.telar.org](https://content.telar.org) each time your site builds and adds it to your own content. It is never saved in your repository, so when you turn it off, the next build leaves it out.
Demo content is marked wherever it appears, so you can always tell it apart from your own work.
-## The Demo Stories
+## The Demo Stories {#the-demo-stories}
Your site gets two stories, in your site's language:
@@ -27,7 +25,7 @@ Your site gets two stories, in your site's language:
| The Allegorical Woman | La mujer alegórica | 10 | A simple story built around one image |
| Colonial Landscapes | Paisajes coloniales | 22 | A longer story with chapters, panels and primary sources |
-### The Allegorical Woman
+### The Allegorical Woman {#the-allegorical-woman}
This story, by Natalie Cobo, follows the details of *Aspecto Symbólico del Mundo Hispánico*, a 1761 engraving by Laureano Atlas held by Princeton University Library. It shows:
@@ -39,7 +37,7 @@ This story, by Natalie Cobo, follows the details of *Aspecto Symbólico del Mund
The first step links to the story's spreadsheet in Google Sheets, so you can compare each row with the step it produces.
-### Colonial Landscapes
+### Colonial Landscapes {#colonial-landscapes}
This story is a selection from *Colonial Landscapes*, a project by Santiago Muñoz, Adelaida Ávila, and María Alejandra Orduz Avella. It is built around a 1614 painting of the Bogotá savanna, made for a lawsuit and held by the Archivo General de Indias in Seville.
@@ -53,7 +51,7 @@ Each primary source is a glossary entry, which opens from its callout in a panel
The glossary also includes several key terms and one person, so the glossary page groups its entries under **Key terms**, **Primary sources**, and **People and entities**.
-## Turning Demo Content On or Off
+## Turning Demo Content On or Off {#turning-demo-content-on-or-off}
Demo content is controlled by one setting in `_config.yml`. A new Telar site has it turned on.
@@ -72,11 +70,12 @@ To change it:
GitHub Actions rebuilds your site, and the change appears when the build finishes. If you build your site on your own computer, run `python3 scripts/csv_to_json.py` and `python3 scripts/generate_collections.py` (or `python3 scripts/build_local_site.py`, which runs both) before Jekyll. See [Local Development](/docs/getting-started/local-dev/).
-{: .tip }
-> **Keep the demos while you learn**
-> The demo stories are useful to keep open next to your own while you write your first story. Turn them off before you share your site.
+{{< callout "tip" >}}
+**Keep the demos while you learn**
+The demo stories are useful to keep open next to your own while you write your first story. Turn them off before you share your site.
+{{< /callout >}}
-## Where Demo Content Appears
+## Where Demo Content Appears {#where-demo-content-appears}
Demo content appears in the same places as your own content, with a label:
@@ -92,7 +91,7 @@ Demo content appears in the same places as your own content, with a label:
On a Spanish site the labels read **DEMO** and **Contenido de demostración**.
-## Language
+## Language {#language}
Demo content follows your site's language, set by `telar_language` in `_config.yml`:
@@ -103,7 +102,7 @@ Demo content follows your site's language, set by `telar_language` in `_config.y
Any other value gets the English demo content. If you change your site's language, the next build fetches the demo content in the new language.
-## Demo Content and Your Own Content
+## Demo Content and Your Own Content {#demo-content-and-your-own-content}
Demo content is added to your content during the build, and it never replaces anything of yours:
@@ -117,7 +116,7 @@ Demo content is added to your content during the build, and it never replaces an
The demo object and glossary IDs all begin with `demo-`, so they do not normally match yours.
-## Using the Demos as Models
+## Using the Demos as Models {#using-the-demos-as-models}
The demo stories are written in the same spreadsheet format as your own stories. Their sources are published in the [demo content repository](https://github.com/UCSB-AMPLab/demo-content) on GitHub, under `demos/v1.8.0/en/` and `demos/v1.8.0/es/`:
@@ -129,9 +128,9 @@ The demo stories are written in the same spreadsheet format as your own stories.
To see how a story's structure shows up on the page, compare the rows of `colonial-landscapes.csv` with the story on your site: the rows with an empty `object` column are the chapter title cards.
-## Troubleshooting
+## Troubleshooting {#troubleshooting}
-### Demo Stories Do Not Appear
+### Demo Stories Do Not Appear {#demo-stories-do-not-appear}
If you turned demo content on and the stories are missing:
@@ -140,10 +139,10 @@ If you turned demo content on and the stories are missing:
3. Open the build log, expand the **Convert CSV to JSON** step, and look for the lines that begin with **Telar Demo Content Fetcher**
4. Reload the page without the cache (Ctrl+Shift+R on Windows/Linux, Cmd+Shift+R on Mac)
-### The Demo Content Could Not Be Downloaded
+### The Demo Content Could Not Be Downloaded {#the-demo-content-could-not-be-downloaded}
If content.telar.org cannot be reached, or the download fails, the build log says that your site will build without demos, and the build continues. Your own content is published as usual, without the demo stories. The next build tries again.
-### Demo Content Is in the Wrong Language
+### Demo Content Is in the Wrong Language {#demo-content-is-in-the-wrong-language}
Check `telar_language` in `_config.yml`. It must be `"en"` or `"es"`; any other value gets the English demo content.
diff --git a/docs/7-2-home-page.md b/content/en/docs/customization/home-page.md
similarity index 83%
rename from docs/7-2-home-page.md
rename to content/en/docs/customization/home-page.md
index fc40997..726839a 100644
--- a/docs/7-2-home-page.md
+++ b/content/en/docs/customization/home-page.md
@@ -1,22 +1,23 @@
---
-layout: docs
-title: "7.2. Customizing the Home Page"
-parent: "7. Customization"
-grand_parent: Documentation
-nav_order: 2
-lang: en
-permalink: /docs/customization/home-page/
+title: Customizing the Home Page
+url: /docs/customization/home-page/
+translationKey: docs-customization-home-page
+type: guide
+docs_section: reference
---
-# Customizing the Home Page
+# Customizing the Home Page {#customizing-the-home-page}
The homepage of your Telar site is controlled by a simple markdown file (`index.md`) in the root of your repository. This makes it easy to customize your welcome message, section headings, and introductory content.
-## File Location
+
+In the Compositor, use [Home and Pages](/docs/the-compositor/pages/). The file format below describes the same published homepage.
+
+## File Location {#file-location}
`index.md` **must** be in the root directory of your repository (not in a subdirectory). Jekyll automatically serves this file as your homepage.
-## Basic Structure
+## Basic Structure {#basic-structure}
Here's the default `index.md` structure:
@@ -33,7 +34,7 @@ objects_intro: "Browse {count} objects featured in the stories."
Your custom content goes here...
```
-## Collection mode
+## Collection mode {#collection-mode}
By default, the homepage shows stories first with a sample of objects below. Collection mode reverses this — objects appear first in a large grid, with stories in a smaller grid below.
@@ -55,21 +56,21 @@ Collection mode works well for sites with a large number of objects and fewer st
**New in v1.1.0.** See [Configuration Reference](/docs/configure/configuration/#collection_mode) for the setting details.
-## Frontmatter Options
+## Frontmatter Options {#frontmatter-options}
-### stories_heading
+### stories_heading {#stories_heading}
The heading displayed above the story grid. Default: `"Explore the stories"`
-### stories_intro
+### stories_intro {#stories_intro}
Optional introductory text displayed between the heading and story grid. Leave blank (`""`) if you don't want intro text.
-### objects_heading
+### objects_heading {#objects_heading}
The heading displayed above the objects section teaser. Default: `"See the objects behind the stories"`
-### objects_intro
+### objects_intro {#objects_intro}
Introductory text for the objects section. Use `{count}` as a placeholder for the number of objects.
@@ -77,7 +78,7 @@ Default: `"Browse {count} objects featured in the stories."`
The `{count}` placeholder will be automatically replaced with the actual number of objects.
-## Adding Custom Content
+## Adding Custom Content {#adding-custom-content}
Any markdown content you add below the frontmatter will appear above the stories section. This is perfect for:
@@ -86,7 +87,7 @@ Any markdown content you add below the frontmatter will appear above the stories
- Important notices
- Custom calls-to-action
-### Example: Custom Welcome
+### Example: Custom Welcome {#example-custom-welcome}
```markdown
---
@@ -107,7 +108,7 @@ Navigate through our curated stories to discover the techniques,
patterns, and cultural significance of these remarkable artifacts.
```
-### Example: Alert Box
+### Example: Alert Box {#example-alert-box}
Use Bootstrap alert classes for styled messages:
@@ -128,21 +129,21 @@ objects_intro: "Browse {count} objects featured in the stories."
> are added regularly. Check back soon for updates!
```
-## Demo Site Notice
+## Demo Site Notice {#demo-site-notice}
The template includes a demo site notice by default that links to the GitHub repository and documentation.
-### To Customize
+### To Customize {#to-customize}
Edit the markdown content to match your project.
-### To Remove
+### To Remove {#to-remove}
Simply delete the demo notice block from `index.md`.
-## Examples
+## Examples {#examples}
-### Minimal Homepage
+### Minimal Homepage {#minimal-homepage}
```markdown
---
@@ -157,7 +158,7 @@ objects_intro: "Browse {count} objects featured in the stories."
No custom content — just displays stories and objects. Story cards show media-type-aware thumbnails: video and audio stories display an icon placeholder when no image object is available.
-### With Introductory Text
+### With Introductory Text {#with-introductory-text}
```markdown
---
@@ -176,20 +177,20 @@ The **Colonial Landscapes Project** uses digital storytelling to explore
the complex histories embedded in material culture.
```
-## Best Practices
+## Best Practices {#best-practices}
- Keep homepage content concise to get visitors into your stories quickly
- Use `##` (second-level) or `###` (third-level) headings for custom content
- Test your homepage on different screen sizes
- Update notices and introductory text as your exhibition evolves
-## Technical Notes
+## Technical Notes {#technical-notes}
- The `layout: index` setting is required and should not be changed
- The `title` setting controls the page `` tag
- All markdown features are supported (see [Markdown Syntax Guide](/docs/your-content/markdown-syntax/))
-## Next Steps
+## Next Steps {#next-steps}
- [Learn about themes](/docs/customization/themes/) to style your homepage
- [Explore advanced styling](/docs/developers/styling/) for custom CSS
diff --git a/content/en/docs/customization/mobile.md b/content/en/docs/customization/mobile.md
new file mode 100644
index 0000000..59afe1f
--- /dev/null
+++ b/content/en/docs/customization/mobile.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/customization/mobile/
+translationKey: redirects-en-cust-mobile-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/developers/mobile/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/docs/7-3-navigation-menu.md b/content/en/docs/customization/navigation-menu.md
similarity index 78%
rename from docs/7-3-navigation-menu.md
rename to content/en/docs/customization/navigation-menu.md
index 3edce3a..beb41e4 100644
--- a/docs/7-3-navigation-menu.md
+++ b/content/en/docs/customization/navigation-menu.md
@@ -1,18 +1,19 @@
---
-layout: docs
-title: "7.3. Navigation Menu"
-parent: "7. Customization"
-grand_parent: Documentation
-nav_order: 3
-lang: en
-permalink: /docs/customization/navigation-menu/
+title: Navigation Menu Configuration
+url: /docs/customization/navigation-menu/
+translationKey: docs-customization-navigation-menu
+type: guide
+docs_section: reference
---
-# Navigation Menu Configuration
+# Navigation Menu Configuration {#navigation-menu-configuration}
Customize your site's navigation menu to include custom pages, external links, and bilingual labels.
-## What is the Navigation Menu?
+
+In the Compositor, arrange navigation in [Home and Pages](/docs/the-compositor/pages/). This page documents the underlying navigation file.
+
+## What is the Navigation Menu? {#what-is-the-navigation-menu}
The navigation menu appears in your site's header and provides links to:
- Your stories (automatically generated)
@@ -22,15 +23,15 @@ The navigation menu appears in your site's header and provides links to:
-## How It Works
+## How It Works {#how-it-works}
Navigation is configured through `_data/navigation.yml`. This data-driven approach gives you complete control over menu structure and labels.
When `navigation.yml` exists, Telar uses it to build your menu. If the file is missing, a hardcoded fallback menu appears with basic links (Stories, Objects, About).
-## Creating Your Navigation File
+## Creating Your Navigation File {#creating-your-navigation-file}
-### Step 1: Create the File
+### Step 1: Create the File {#step-1-create-the-file}
Add `navigation.yml` to the `_data/` directory:
@@ -41,7 +42,7 @@ _data/
└── project.json # Generated project data
```
-### Step 2: Define Your Menu Structure
+### Step 2: Define Your Menu Structure {#step-2-define-your-menu-structure}
Here's a basic configuration:
@@ -64,7 +65,7 @@ menu:
url: "/credits/"
```
-### Required Fields
+### Required Fields {#required-fields}
Each menu item needs:
@@ -74,15 +75,15 @@ Each menu item needs:
| `titulo_es` | Spanish label | `"Acerca de"` |
| `url` | Page URL | `"/about/"` |
-### Optional Fields
+### Optional Fields {#optional-fields}
| Field | Purpose | Example |
|-------|---------|---------|
| `external` | Opens in new tab | `true` |
-## Menu Item Types
+## Menu Item Types {#menu-item-types}
-### Internal Pages
+### Internal Pages {#internal-pages}
Link to pages within your site:
@@ -94,7 +95,7 @@ Link to pages within your site:
The URL should match your page's filename (`methodology.md` → `/methodology/`).
-### External Links
+### External Links {#external-links}
Link to external resources:
@@ -107,7 +108,7 @@ Link to external resources:
When `external: true`, the link opens in a new tab with `target="_blank"`.
-### Stories Homepage
+### Stories Homepage {#stories-homepage}
Link to the stories list:
@@ -117,7 +118,7 @@ Link to the stories list:
url: "/"
```
-### Objects Index
+### Objects Index {#objects-index}
Link to the objects catalog:
@@ -127,7 +128,7 @@ Link to the objects catalog:
url: "/objects/"
```
-## Complete Example
+## Complete Example {#complete-example}
Here's a full navigation configuration for a research project:
@@ -167,16 +168,16 @@ menu:
external: true
```
-## Bilingual Labels
+## Bilingual Labels {#bilingual-labels}
-### How Language Selection Works
+### How Language Selection Works {#how-language-selection-works}
Telar displays menu labels based on your site's language setting (`telar_language` in `_config.yml`):
- If `telar_language: en` → Shows `title_en` labels
- If `telar_language: es` → Shows `titulo_es` labels
-### Fallback Behavior
+### Fallback Behavior {#fallback-behavior}
If a menu item is missing the appropriate language label, Telar falls back gracefully:
@@ -184,7 +185,7 @@ If a menu item is missing the appropriate language label, Telar falls back grace
2. If missing, try the other language
3. If both missing, show URL as label
-## Menu Order
+## Menu Order {#menu-order}
Menu items appear in the order you list them in `navigation.yml`:
@@ -198,9 +199,9 @@ menu:
...
```
-## Updating the Menu
+## Updating the Menu {#updating-the-menu}
-### Adding a New Page
+### Adding a New Page {#adding-a-new-page}
When you create a new custom page:
@@ -217,7 +218,7 @@ When you create a new custom page:
The menu updates automatically.
-### Removing a Page
+### Removing a Page {#removing-a-page}
To remove a page from the menu:
@@ -233,7 +234,7 @@ To remove a page from the menu:
The page file can remain in `telar-content/texts/pages/` but won't appear in navigation.
-### Reordering Items
+### Reordering Items {#reordering-items}
Change the order in `navigation.yml`:
@@ -251,7 +252,7 @@ menu:
# Rest of menu...
```
-## Fallback Menu
+## Fallback Menu {#fallback-menu}
If `_data/navigation.yml` doesn't exist, Telar shows a hardcoded fallback menu:
@@ -261,9 +262,9 @@ If `_data/navigation.yml` doesn't exist, Telar shows a hardcoded fallback menu:
This ensures your site always has basic navigation, even without configuration.
-## Troubleshooting
+## Troubleshooting {#troubleshooting}
-### Menu Not Updating
+### Menu Not Updating {#menu-not-updating}
If your menu changes don't appear:
@@ -272,7 +273,7 @@ If your menu changes don't appear:
3. **Clear browser cache**: Use Ctrl+Shift+R (Cmd+Shift+R on Mac) to hard refresh
4. **Verify file location**: File must be at `_data/navigation.yml` (not `data/` or `_data/nav.yml`)
-### Wrong Language Showing
+### Wrong Language Showing {#wrong-language-showing}
If menu labels appear in the wrong language:
@@ -280,7 +281,7 @@ If menu labels appear in the wrong language:
2. Verify you're using correct field names (`title_en` and `titulo_es`, not `title` or `label`)
3. Ensure both language labels are present
-### External Link Not Opening in New Tab
+### External Link Not Opening in New Tab {#external-link-not-opening-in-new-tab}
Add the `external: true` field:
@@ -291,9 +292,9 @@ Add the `external: true` field:
external: true # Required for new tab
```
-## Best Practices
+## Best Practices {#best-practices}
-### Clear, Descriptive Labels
+### Clear, Descriptive Labels {#clear-descriptive-labels}
Use labels that clearly describe the destination:
@@ -309,7 +310,7 @@ Use labels that clearly describe the destination:
titulo_es: "Info"
```
-### Consistent Ordering
+### Consistent Ordering {#consistent-ordering}
Keep related items together:
@@ -327,11 +328,11 @@ Keep related items together:
- title_en: "Archive"
```
-### Limit Menu Length
+### Limit Menu Length {#limit-menu-length}
Keep menus focused (5-7 items is ideal). For larger sites, consider grouping content differently or using footer links for secondary pages.
-## Related Documentation
+## Related Documentation {#related-documentation}
- [Custom Pages](/docs/site-features/custom-pages/) - Creating pages to link in navigation
- [Configuration Reference](/docs/configure/configuration/) - Complete `_config.yml` options including `telar_language`
diff --git a/content/en/docs/customization/styling.md b/content/en/docs/customization/styling.md
new file mode 100644
index 0000000..8dab9af
--- /dev/null
+++ b/content/en/docs/customization/styling.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/customization/styling/
+translationKey: redirects-en-cust-styling-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/developers/styling/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/docs/7-1-themes.md b/content/en/docs/customization/themes.md
similarity index 83%
rename from docs/7-1-themes.md
rename to content/en/docs/customization/themes.md
index e4aee94..11f9598 100644
--- a/docs/7-1-themes.md
+++ b/content/en/docs/customization/themes.md
@@ -1,20 +1,18 @@
---
-layout: docs
-title: "7.1. Themes"
-parent: "7. Customization"
-grand_parent: Documentation
-nav_order: 1
-lang: en
-permalink: /docs/customization/themes/
+title: Themes
+url: /docs/customization/themes/
+translationKey: docs-customization-themes
+type: guide
+docs_section: reference
---
-# Themes
+# Themes {#themes}
Telar includes 5 preset visual themes that can be easily switched via `_config.yml`.
-## Available Themes
+## Available Themes {#available-themes}
-### Trama (Default)
+### Trama (Default) {#trama-default}
Telar's own visual identity, designed by Adelaida Ávila. Terracotta and lavender, with Space Grotesk headings.
@@ -28,7 +26,7 @@ Telar's own visual identity, designed by Adelaida Ávila. Terracotta and lavende
**Best for:** A versatile default suitable for most exhibitions.
-### Paisajes Coloniales
+### Paisajes Coloniales {#paisajes-coloniales}
Earth and sky, from the [Colonial Landscapes](https://colonial-landscapes.com) project. Slate blue and plum, with Playfair Display headings.
@@ -42,7 +40,7 @@ Earth and sky, from the [Colonial Landscapes](https://colonial-landscapes.com) p
**Best for:** Historical narratives, archaeological exhibits.
-### Neogranadina
+### Neogranadina {#neogranadina}
High-contrast green and crimson on charcoal, with IM Fell, a typeface cut from the punches of a seventeenth-century press.
@@ -57,7 +55,7 @@ High-contrast green and crimson on charcoal, with IM Fell, a typeface cut from t
**Best for:** Archival materials.
-### Santa Barbara
+### Santa Barbara {#santa-barbara}
Gold and deep navy, in the University of California, Santa Barbara colors. Roboto Serif headings.
@@ -72,7 +70,7 @@ Gold and deep navy, in the University of California, Santa Barbara colors. Robot
**Best for:** Greyscale and monochrome images
-### Austin
+### Austin {#austin}
The University of Texas at Austin's burnt orange, with sage and stone. Crimson Pro headings.
@@ -85,7 +83,7 @@ The University of Texas at Austin's burnt orange, with sage and stone. Crimson P
**Best for:** Contemporary materials
-## Switching Themes
+## Switching Themes {#switching-themes}
Edit `_config.yml` in your repository:
@@ -95,9 +93,9 @@ telar_theme: "santa-barbara" # Options: trama, paisajes, neogranadina, santa-ba
Commit the change and GitHub Actions will rebuild your site automatically (2-5 minutes).
-## Creating Custom Themes
+## Creating Custom Themes {#creating-custom-themes}
-### Step 1: Create Theme File
+### Step 1: Create Theme File {#step-1-create-theme-file}
Create a new file at `_data/themes/custom.yml`. Colors are grouped under `colors.text` and `colors.background`, and fonts under `fonts`:
@@ -127,10 +125,11 @@ fonts:
The quickest start is to copy a shipped theme from `_data/themes/` and change its values. Every key is optional, and Telar uses the Trama value for any you leave out.
-{: .warning }
-> Telar reads only the keys shown here. A theme file built from other key names loads without an error and has no effect, and your site renders in the default colors. The build log names the keys Telar looked for and did not find.
+{{< callout "warning" >}}
+Telar reads only the keys shown here. A theme file built from other key names loads without an error and has no effect, and your site renders in the default colors. The build log names the keys Telar looked for and did not find.
+{{< /callout >}}
-### Step 2: Activate Custom Theme
+### Step 2: Activate Custom Theme {#step-2-activate-custom-theme}
In `_config.yml`:
@@ -138,14 +137,14 @@ In `_config.yml`:
telar_theme: "custom"
```
-### Step 3: Test and Refine
+### Step 3: Test and Refine {#step-3-test-and-refine}
1. Commit changes
2. Wait for automatic build
3. Review your site
4. Adjust colors and fonts as needed
-## Theme Color Keys
+## Theme Color Keys {#theme-color-keys}
All themes support these color keys:
@@ -163,10 +162,11 @@ All themes support these color keys:
| `colors.background.panel_layer2` | Second panel background |
| `colors.background.panel_glossary` | Glossary panel background |
-{: .note }
-> The four keys under `colors.background` are the ones Telar checks for contrast. See [Color Accessibility](#color-accessibility).
+{{< callout "note" >}}
+The four keys under `colors.background` are the ones Telar checks for contrast. See [Color Accessibility](#color-accessibility).
+{{< /callout >}}
-## Typography Keys
+## Typography Keys {#typography-keys}
Control fonts across your site:
@@ -175,7 +175,7 @@ Control fonts across your site:
| `fonts.headings` | h1-h6, page titles |
| `fonts.body` | Paragraphs, lists, general text |
-### Font Examples
+### Font Examples {#font-examples}
Both keys sit under `fonts`, and each takes a stack: the font you want, then the fallbacks a browser uses when it cannot load that one.
@@ -200,7 +200,7 @@ fonts:
```
Or `'Open Sans', Helvetica, sans-serif`, or `'Crimson Text', Georgia, serif`.
-## Using Google Fonts
+## Using Google Fonts {#using-google-fonts}
To use fonts not included by default:
@@ -215,11 +215,11 @@ To use fonts not included by default:
headings: "'Your Font', serif"
```
-## Theme Creator Attribution
+## Theme Creator Attribution {#theme-creator-attribution}
Telar v0.4.0+ supports optional theme creator attribution, allowing you to credit theme designers in your site footer.
-### Adding Attribution to Custom Themes
+### Adding Attribution to Custom Themes {#adding-attribution-to-custom-themes}
When creating a custom theme, you can add creator information to your theme YAML file:
@@ -250,7 +250,7 @@ fonts:
body: "'Inter', sans-serif"
```
-### Attribution Fields
+### Attribution Fields {#attribution-fields}
All fields are optional:
@@ -276,7 +276,7 @@ creator_url: "https://github.com/mirl-ucsb"
description: "Retro Cool. Digital Heat."
```
-### How Attribution Displays
+### How Attribution Displays {#how-attribution-displays}
When you add creator information, it appears in your site footer:
@@ -292,7 +292,7 @@ When you add creator information, it appears in your site footer:
**With neither:**
No theme attribution shown
-### Attribution for Preset Themes
+### Attribution for Preset Themes {#attribution-for-preset-themes}
All of Telar's preset themes include attribution:
@@ -316,7 +316,7 @@ All of Telar's preset themes include attribution:
- Creator: AMPL at UT Austin
- URL: https://liberalarts.utexas.edu/history/
-### Sharing Custom Themes
+### Sharing Custom Themes {#sharing-custom-themes}
If you create a theme you'd like to share with the Telar community:
@@ -325,7 +325,7 @@ If you create a theme you'd like to share with the Telar community:
3. Include usage recommendations (best for grayscale images, colorful content, etc.)
4. Share on the [Telar Discussions](https://github.com/UCSB-AMPLab/telar/discussions) forum
-### Removing Attribution
+### Removing Attribution {#removing-attribution}
To use a theme without attribution:
@@ -338,11 +338,11 @@ To use a theme without attribution:
No attribution will appear in the footer.
-## Color Accessibility
+## Color Accessibility {#color-accessibility}
Every theme pairs a text color with a background: `colors.text.panel_layer1` sits on `colors.background.panel_layer1`, and so on. When the two are too close in brightness, the text is hard to read.
-### How Telar Checks Your Colors
+### How Telar Checks Your Colors {#how-telar-checks-your-colors}
During the build, Telar works out a text color that reaches a contrast ratio of 4.5:1 on each of four backgrounds: `button`, `panel_layer1`, `panel_layer2` and `panel_glossary`. That is the WCAG AA level for normal-size text.
@@ -353,7 +353,7 @@ Your own color comes first. Telar keeps it whenever it reaches 4.5:1, so a theme
1. Your `colors.text.heading` or `colors.text.button`, whichever has the higher contrast on that background
2. White or black, whichever has the higher contrast
-### When Telar Replaces a Color
+### When Telar Replaces a Color {#when-telar-replaces-a-color}
Telar prints one line in the build log for each color it replaces:
@@ -363,7 +363,7 @@ Theme "santa-barbara": colors.text.button is #FFFFFF, a contrast ratio of 1.69:1
A theme whose colors all pass prints nothing. To keep the color you wanted, change the background rather than the text.
-### What Telar Does Not Check
+### What Telar Does Not Check {#what-telar-does-not-check}
These are still yours to get right:
@@ -374,15 +374,15 @@ These are still yours to get right:
Use tools like [WebAIM Contrast Checker](https://webaim.org/resources/contrastchecker/) to verify.
-### Colors Telar Cannot Read
+### Colors Telar Cannot Read {#colors-telar-cannot-read}
Telar only reads hex colors, like `#FFFFFF` or `#FFF`. A named color like `white`, or an `rgb()` value, is left exactly as you wrote it and unchecked, and the build log says so.
-## Theme Fallback
+## Theme Fallback {#theme-fallback}
If Telar cannot find the theme file named in `_config.yml`, it falls back to the **Trama** theme, so your site never breaks. A file Telar can find is always used, even when none of its keys are ones Telar reads. Each key you have not set takes its Trama value, and the build log says which ones were missing.
-## Next Steps
+## Next Steps {#next-steps}
- [Advanced Styling](/docs/developers/styling/) for deeper customization
- [Configuration](/docs/configure/configuration/) for other site settings
diff --git a/docs/8-0-for-developers.md b/content/en/docs/developers/_index.md
similarity index 72%
rename from docs/8-0-for-developers.md
rename to content/en/docs/developers/_index.md
index 94f3afe..efe8683 100644
--- a/docs/8-0-for-developers.md
+++ b/content/en/docs/developers/_index.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "8. For Developers"
-parent: Documentation
-nav_order: 8
-has_children: true
-lang: en
-permalink: /docs/developers/
+title: For Developers
+url: /docs/developers/
+translationKey: docs-developers
+type: guide
+docs_section: developers
---
-# For Developers
+# For Developers {#for-developers}
Technical documentation for developers, contributors, and those maintaining Telar forks.
-## Who This Section Is For
+## Who This Section Is For {#who-this-section-is-for}
This section is designed for:
- **Developers** building features or fixing bugs in Telar
@@ -24,32 +22,32 @@ If you're a storyteller creating content for a Telar site, you probably want the
---
-## What's In This Section
+## What's In This Section {#whats-in-this-section}
-### [8.1 Local Dev Setup](/docs/developers/local-development/)
+### [8.1 Local Dev Setup](/docs/developers/local-development/) {#81-local-dev-setup}
Set up your development environment, run builds locally, and test changes before deploying.
-### [8.2 GitHub Actions](/docs/developers/github-actions/)
+### [8.2 GitHub Actions](/docs/developers/github-actions/) {#82-github-actions}
Understand Telar's automated build workflow and how to customize the deployment pipeline.
-### [8.3 Demo System Architecture](/docs/developers/demo-system/)
+### [8.3 Demo System Architecture](/docs/developers/demo-system/) {#83-demo-system-architecture}
Learn how the demo content fetching system works, from version matching to bundle integration.
-### [8.4 Embedding System](/docs/developers/embedding-system/)
+### [8.4 Embedding System](/docs/developers/embedding-system/) {#84-embedding-system}
Technical details of Telar's iframe embedding system and how it handles different contexts.
-### [8.5 Advanced Styling](/docs/developers/styling/)
+### [8.5 Advanced Styling](/docs/developers/styling/) {#85-advanced-styling}
Customize Telar's styles with custom CSS, CSS variables and cascade layers.
-### [8.6 Layouts and Small Screens](/docs/developers/mobile/)
+### [8.6 Layouts and Small Screens](/docs/developers/mobile/) {#86-layouts-and-small-screens}
How the story page chooses between its two layouts, and how the site adapts to small and short windows.
-### [8.7 Story Engine Vocabulary](/docs/developers/story-engine/)
+### [8.7 Story Engine Vocabulary](/docs/developers/story-engine/) {#87-story-engine-vocabulary}
The terms the story engine's code and these docs use for a story's parts, its moves and its layouts.
---
-## Contributing to Telar
+## Contributing to Telar {#contributing-to-telar}
Telar is open source and welcomes contributions. Before contributing:
@@ -62,7 +60,7 @@ Telar is open source and welcomes contributions. Before contributing:
---
-## Getting Help
+## Getting Help {#getting-help}
- **Issues**: Report bugs or request features on [GitHub Issues](https://github.com/UCSB-AMPLab/telar/issues)
- **Discussions**: Ask questions in [GitHub Discussions](https://github.com/UCSB-AMPLab/telar/discussions)
@@ -70,7 +68,7 @@ Telar is open source and welcomes contributions. Before contributing:
---
-## Quick Links
+## Quick Links {#quick-links}
- [Main Documentation](/docs/) - User-facing docs for storytellers
- [Configuration Reference](/docs/configure/configuration/) - All _config.yml options
diff --git a/docs/8-3-demo-system-architecture.md b/content/en/docs/developers/demo-system.md
similarity index 94%
rename from docs/8-3-demo-system-architecture.md
rename to content/en/docs/developers/demo-system.md
index 3227427..de0dbda 100644
--- a/docs/8-3-demo-system-architecture.md
+++ b/content/en/docs/developers/demo-system.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "8.3. Demo System Architecture"
-parent: "8. For Developers"
-grand_parent: Documentation
-nav_order: 3
-lang: en
-permalink: /docs/developers/demo-system/
+title: Demo System Architecture
+url: /docs/developers/demo-system/
+translationKey: docs-developers-demo-system
+type: guide
+docs_section: developers
---
-# Demo System Architecture
+# Demo System Architecture {#demo-system-architecture}
This page describes how a Telar site fetches its demo content, merges it into the site's data, and marks it on the page, and how the demo bundles are produced. For what demo content looks like to a site's author, see [Demo Content](/docs/customization/demo-content/).
-## Overview
+## Overview {#overview}
Demo content is published as one JSON file per Telar release and language, the demo bundle, at [content.telar.org](https://content.telar.org). The site is served by GitHub Pages from the [demo content repository](https://github.com/UCSB-AMPLab/demo-content). A site downloads the bundle during its build, merges it into the JSON files in `_data/`, and the collection generator writes demo stories, objects and glossary entries as pages flagged `demo: true`.
@@ -27,7 +25,7 @@ The parts involved are:
| `_demo_content/telar-demo-bundle.json` | The downloaded bundle; gitignored |
| `_data/demo-glossary.json` | The bundle's glossary entries, for the glossary page generator; gitignored |
-## Build Sequence
+## Build Sequence {#build-sequence}
The build workflow has no separate step for demo content. The fetch runs inside the **Convert CSV to JSON** step, which runs `python scripts/csv_to_json.py`.
@@ -40,9 +38,9 @@ When `csv_to_json.py` runs:
The next workflow step, **Generate Jekyll collections**, runs `generate_collections.py`, which writes the pages.
-## Fetching the Bundle
+## Fetching the Bundle {#fetching-the-bundle}
-### Settings
+### Settings {#settings}
`load_config()` in `fetch_demo_content.py` reads three settings from `_config.yml`:
@@ -56,7 +54,7 @@ The version may carry a `v` or `V` prefix and a `-beta` suffix (for example `v1.
If `include_demo_content` is `false`, `cleanup_demo_content()` deletes `_demo_content/` and the script exits. If it is `true`, the script deletes `_demo_content/` first and then fetches, so a failed fetch leaves no bundle from an earlier build behind.
-### Version Matching
+### Version Matching {#version-matching}
`fetch_versions_index()` downloads `https://content.telar.org/demos/versions.json`, which lists the published bundle versions:
@@ -82,7 +80,7 @@ If `include_demo_content` is `false`, `cleanup_demo_content()` deletes `_demo_co
If no listed version is less than or equal to the site's version, the script prints the available versions and exits without fetching. If `versions.json` cannot be read, the script tries a bundle for the site's own version.
-### Download and Checks
+### Download and Checks {#download-and-checks}
`fetch_bundle(version, language)` downloads:
@@ -105,7 +103,7 @@ The size limits are `MAX_VERSIONS_BYTES` and `MAX_BUNDLE_BYTES` in `scripts/pipe
Before saving, `save_bundle()` checks that the bundle has the keys `_meta`, `objects`, `stories` and `project`; that `objects`, `stories` and `project` are each a list or an object; and that `objects` and `stories` have no more than 10,000 entries each. A bundle that fails any check is not saved. A bundle that passes is written to `_demo_content/telar-demo-bundle.json`.
-## Bundle Format
+## Bundle Format {#bundle-format}
A bundle has these top-level keys:
@@ -169,11 +167,11 @@ Each step in a story's `steps` list has `step`, `object`, `x`, `y` and `zoom`, a
A glossary entry has `term` (its title) and `content` (markdown), and may have `kind` and `related_terms`. The `kind` value is written as in the source spreadsheet, for example `source` in the English bundle and `fuente` in the Spanish one; the site's build resolves both to the same kind.
-## Merging into `_data/`
+## Merging into `_data/` {#merging-into-_data}
`merge_demo_content(bundle)` runs four functions in order. Each catches its own errors and prints a `[WARN]` line, so a failure in one does not stop the others.
-### Stories in `project.json`
+### Stories in `project.json` {#stories-in-projectjson}
`_merge_demo_projects()` turns each `project` entry into a story record and puts the demo stories before the site's own in `stories` of the first entry in `_data/project.json`. It runs only when `_data/project.json` exists and the bundle's `project` list is not empty.
@@ -187,7 +185,7 @@ A glossary entry has `term` (its title) and `content` (markdown), and may have `
No other field is carried. In the v1.8.0 bundles, `colonial-landscapes` and `paisajes` set `show_sections` to `true`, so their intro cards list their sections.
-### Objects in `objects.json`
+### Objects in `objects.json` {#objects-in-objectsjson}
`_merge_demo_objects()` appends the bundle's objects to `_data/objects.json`. An object whose ID is already in the site's objects is skipped, and the site's object is kept.
@@ -199,7 +197,7 @@ Each demo object gets `object_id`, `title`, `description`, `source_url`, `iiif_m
- `alt_text` is added only when the bundle object has a value for it
- `media_type` is computed from `source_url` by `detect_media_type()`, as for the site's own objects; a `media_type` in the bundle is not read
-### Story Files
+### Story Files {#story-files}
`_write_demo_stories()` writes one `_data/{story_id}.json` per bundle story. Each step becomes:
@@ -218,11 +216,11 @@ Layer content goes through the same steps as a site's own panels: `process_widge
Glossary links in a demo story resolve against a link map built by `_demo_link_terms()` from the bundle's glossary and the site's own glossary pages together.
-### Glossary
+### Glossary {#glossary}
`_write_demo_glossary()` writes the bundle's glossary to `_data/demo-glossary.json` as a list. Each entry has `term_id`, `title` (from `term`), `content` and `_demo: true`, plus `kind` and `related_terms` when the bundle entry has them. A `related_terms` value written as a string is split on `|` into a list.
-## Writing the Pages
+## Writing the Pages {#writing-the-pages}
`generate_collections.py` reads the merged data and writes the Jekyll collection files:
@@ -232,7 +230,7 @@ Glossary links in a demo story resolve against a link map built by `_demo_link_t
Two glossary entries whose IDs produce the same page address cannot both be published. `place_demo_terms()` decides which demo entries are written: a demo entry whose address already belongs to a site entry, or to an earlier demo entry, is skipped with a warning, and links to its ID go to the page that holds the address. The same function decides the glossary links in demo stories, so the links and the pages agree. All demo entry IDs begin with `demo-`.
-## Marking Demo Content
+## Marking Demo Content {#marking-demo-content}
The layouts read the `demo` front matter flag, and the story engine reads the layer flags:
@@ -255,7 +253,7 @@ The layouts read the `demo` front matter flag, and the story engine reads the la
| `demo.panel_badge` | Demo content | Contenido de demostración |
| `story.demo_label` | Demo content | Contenido de demostración |
-## Files on Disk
+## Files on Disk {#files-on-disk}
| Path | Written by | Removed |
|------|------------|---------|
@@ -266,11 +264,11 @@ The layouts read the `demo` front matter flag, and the story engine reads the la
`.gitignore` lists `_demo_content/` and `_data/demo-glossary.json`.
-## The Demo Content Repository
+## The Demo Content Repository {#the-demo-content-repository}
The bundles are built in the [demo content repository](https://github.com/UCSB-AMPLab/demo-content), which content.telar.org serves.
-### Layout
+### Layout {#layout}
The repository holds:
@@ -296,7 +294,7 @@ A language directory holds these sources:
The v1.8.0 bundles hold two stories: `allegorical-woman` (10 steps) and `colonial-landscapes` (22 steps) in English, and `mujer-alegorica` and `paisajes` in Spanish. Each language has 12 objects and 24 glossary entries.
-### The Generator
+### The Generator {#the-generator}
The generator builds a bundle from a language directory's sources and writes it next to them. It reads the following columns:
@@ -332,9 +330,9 @@ To rebuild the v1.8.0 bundles without regenerating tiles:
python generator/build-demos.py --version 1.8.0 --bundle-only
```
-## Troubleshooting
+## Troubleshooting {#troubleshooting}
-### Run the Fetch on Its Own
+### Run the Fetch on Its Own {#run-the-fetch-on-its-own}
From the root of a site, run:
@@ -344,11 +342,11 @@ python3 scripts/fetch_demo_content.py
The script prints the site version and language it read, the bundle version it chose, the bundle's URL and `_meta` fields, and a count of the projects, objects, stories and glossary entries it saved.
-### Check the Merge
+### Check the Merge {#check-the-merge}
After `python3 scripts/csv_to_json.py`, the merge prints a line for each part: `Merged 2 demo project(s) into project.json`, a `Merged … demo object(s)` line, a `Created demo story:` line for each story, and `Created _data/demo-glossary.json (24 demo terms)` for the v1.8.0 bundles. A failure in a part prints a `[WARN]` line instead. Each demo record in `_data/project.json` and `_data/objects.json` has `"_demo": true`.
-### Check the Published Files
+### Check the Published Files {#check-the-published-files}
To see which versions are published, and to check that a bundle is reachable:
@@ -357,7 +355,7 @@ curl https://content.telar.org/demos/versions.json
curl -I https://content.telar.org/demos/v1.8.0/en/telar-demo-bundle.json
```
-## Related Documentation
+## Related Documentation {#related-documentation}
- [Demo Content](/docs/customization/demo-content/): demo content for site authors
- [GitHub Actions](/docs/developers/github-actions/): the build workflow
diff --git a/docs/8-4-embedding-system.md b/content/en/docs/developers/embedding-system.md
similarity index 81%
rename from docs/8-4-embedding-system.md
rename to content/en/docs/developers/embedding-system.md
index 3a1a9b3..778adfc 100644
--- a/docs/8-4-embedding-system.md
+++ b/content/en/docs/developers/embedding-system.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "8.4. Embedding System"
-parent: "8. For Developers"
-grand_parent: Documentation
-nav_order: 4
-lang: en
-permalink: /docs/developers/embedding-system/
+title: Embedding System Reference
+url: /docs/developers/embedding-system/
+translationKey: docs-developers-embedding-system
+type: guide
+docs_section: developers
---
-# Embedding System Reference
+# Embedding System Reference {#embedding-system-reference}
Technical reference for Telar's iframe embedding system.
-## Architecture Overview
+## Architecture Overview {#architecture-overview}
Telar's embedding system allows stories to be displayed inside iframes on external websites and LMS platforms. The system is designed around these principles:
@@ -31,9 +29,9 @@ Telar's embedding system allows stories to be displayed inside iframes on extern
- No special integration required
- No LMS-specific APIs or dependencies
-## Embed Mode Detection
+## Embed Mode Detection {#embed-mode-detection}
-### URL Parameter
+### URL Parameter {#url-parameter}
Embed mode activates via the `?embed=true` URL parameter:
@@ -46,7 +44,7 @@ https://yoursite.com/stories/story-1/?embed=true
- Stored in `window.telarEmbed.enabled`
- Available to all JavaScript modules
-### JavaScript Implementation
+### JavaScript Implementation {#javascript-implementation}
**File:** `assets/js/embed.js`
@@ -87,9 +85,9 @@ https://yoursite.com/stories/story-1/?embed=true
- Uses DOMContentLoaded to ensure body element exists
- Body class applied before navigation initialization
-## CSS Modifications
+## CSS Modifications {#css-modifications}
-### Embed Mode Styles
+### Embed Mode Styles {#embed-mode-styles}
**File:** `assets/css/telar.scss`
@@ -145,30 +143,30 @@ body.embed-mode {
}
```
-## Navigation System
+## Navigation System {#navigation-system}
-### Embed Mode Navigation
+### Embed Mode Navigation {#embed-mode-navigation}
**File:** `assets/js/telar-story/main.js`
Embedded stories always use button navigation, at every width — iframe scroll events do not propagate reliably, so the scroll engine is never engaged inside an embed. Outside embeds, navigation mode follows the layout mode: horizontal layout uses the Lenis-driven scroll engine, and vertical layout (viewports at or below 1024px wide, or narrower than 3:4) uses the same prev/next buttons. The boundary is declared once in `_sass/_responsive.scss` (`$telar-vertical-min-width`) and read at runtime by `layout-mode.js`.
-### Navigation Modes
+### Navigation Modes {#navigation-modes}
- **Embeds (all widths):** button navigation; wide embeds center the buttons over the narrative column, narrow embeds stack them on the right edge
- **Non-embed, horizontal layout:** Lenis-driven scroll engine
- **Non-embed, vertical layout:** the same button navigation
- **Keyboard navigation** works in every mode
-### Button Creation
+### Button Creation {#button-creation}
**File:** `assets/js/telar-story/navigation.js`
`initializeButtonNavigation()` builds the `.mobile-nav` container with its `.mobile-prev` and `.mobile-next` buttons and wires them to step navigation; it returns early if the container already exists.
-## "View Full Site" Banner
+## "View Full Site" Banner {#view-full-site-banner}
-### Banner Creation
+### Banner Creation {#banner-creation}
**File:** `assets/js/embed.js`
@@ -204,7 +202,7 @@ function createEmbedBanner() {
}
```
-### Banner Styling
+### Banner Styling {#banner-styling}
```scss
.embed-banner {
@@ -231,9 +229,9 @@ function createEmbedBanner() {
- No sessionStorage persistence
- Links to site homepage (not story page)
-## Share & Embed Panel
+## Share & Embed Panel {#share--embed-panel}
-### Embed Code Generation
+### Embed Code Generation {#embed-code-generation}
**File:** `assets/js/share-panel.js`
@@ -266,7 +264,7 @@ function generateEmbedCode() {
}
```
-### URL Cleaning
+### URL Cleaning {#url-cleaning}
```javascript
function addEmbedParameter(url) {
@@ -292,7 +290,7 @@ function addEmbedParameter(url) {
- Adds clean `?embed=true` parameter
- Ensures embed always starts at step 1
-### Dimension Presets
+### Dimension Presets {#dimension-presets}
**File:** `assets/js/share-panel.js`
@@ -308,7 +306,7 @@ const presets = {
};
```
-### Dimension Normalization
+### Dimension Normalization {#dimension-normalization}
```javascript
function normalizeDimension(value) {
@@ -325,9 +323,9 @@ function normalizeDimension(value) {
- `800px` → `800px`
- `800` → `800px` (auto-adds px)
-## Multilingual Support
+## Multilingual Support {#multilingual-support}
-### Language String Injection
+### Language String Injection {#language-string-injection}
**File:** `_layouts/story.html`
@@ -335,8 +333,8 @@ function normalizeDimension(value) {
<script>
window.telarLang = window.telarLang || {};
window.telarLang.embedBanner = {
- text: {{ site.data.languages[site.telar_language].embed_banner.text | jsonify }},
- link: {{ site.data.languages[site.telar_language].embed_banner.link | jsonify }}
+ text: null,
+ link: null
};
</script>
```
@@ -347,7 +345,7 @@ function normalizeDimension(value) {
3. JavaScript reads from `window.telarLang.embedBanner`
4. Fallback to English if language data missing
-### Language Files
+### Language Files {#language-files}
**English:** `_data/languages/en.yml`
```yaml
@@ -363,9 +361,9 @@ embed_banner:
link: "Ver el sitio completo"
```
-## Browser Compatibility
+## Browser Compatibility {#browser-compatibility}
-### Supported Browsers
+### Supported Browsers {#supported-browsers}
Telar embed mode works in all modern browsers:
@@ -374,7 +372,7 @@ Telar embed mode works in all modern browsers:
- **Safari** 14+
- **Mobile browsers** (iOS Safari, Chrome Android)
-### Iframe Considerations
+### Iframe Considerations {#iframe-considerations}
**Same-origin vs cross-origin:**
- Telar embeds are cross-origin (different domain than host)
@@ -392,9 +390,9 @@ Telar embed mode works in all modern browsers:
- IIIF tile loading not affected by iframe context
- Bootstrap modals (glossary, share panel) work correctly
-## Testing Embed Mode
+## Testing Embed Mode {#testing-embed-mode}
-### Local Testing
+### Local Testing {#local-testing}
**Test file structure:**
```html
@@ -427,7 +425,7 @@ Telar embed mode works in all modern browsers:
- [ ] Home and share buttons are hidden
- [ ] Responsive behavior at different widths
-### Production Testing
+### Production Testing {#production-testing}
1. Deploy site to production (GitHub Pages or custom domain)
2. Test embed code in actual Canvas LMS course
@@ -435,9 +433,9 @@ Telar embed mode works in all modern browsers:
4. Test on mobile devices (iOS, Android)
5. Check console for JavaScript errors
-## Security Considerations
+## Security Considerations {#security-considerations}
-### Content Security Policy
+### Content Security Policy {#content-security-policy}
If your site uses CSP headers, ensure iframes are allowed:
@@ -450,7 +448,7 @@ Content-Security-Policy: frame-ancestors 'self' https://canvas.instructure.com h
- Embeddable on any site
- Consider this when hosting sensitive content
-### Cross-Origin Resource Sharing (CORS)
+### Cross-Origin Resource Sharing (CORS) {#cross-origin-resource-sharing-cors}
**IIIF tiles:**
- Served from same origin as story
@@ -461,7 +459,7 @@ Content-Security-Policy: frame-ancestors 'self' https://canvas.instructure.com h
- Most IIIF providers include proper CORS headers
- Test external manifests before embedding
-### iframe Sandbox Attribute
+### iframe Sandbox Attribute {#iframe-sandbox-attribute}
**Not recommended for Telar:**
@@ -477,9 +475,9 @@ Content-Security-Policy: frame-ancestors 'self' https://canvas.instructure.com h
- Disables navigation and modals
- Use standard iframe without sandbox attribute
-## Customizing Embed Behavior
+## Customizing Embed Behavior {#customizing-embed-behavior}
-### Custom Embed Styles
+### Custom Embed Styles {#custom-embed-styles}
Add custom CSS for embed mode in `assets/css/telar.scss`:
@@ -494,7 +492,7 @@ body.embed-mode {
}
```
-### Detecting Embed Mode in Custom Code
+### Detecting Embed Mode in Custom Code {#detecting-embed-mode-in-custom-code}
```javascript
if (window.telarEmbed?.enabled) {
@@ -503,7 +501,7 @@ if (window.telarEmbed?.enabled) {
}
```
-### Modifying Banner Appearance
+### Modifying Banner Appearance {#modifying-banner-appearance}
Override banner styles in `telar.scss`:
@@ -519,32 +517,22 @@ Override banner styles in `telar.scss`:
}
```
-## Known Limitations
+## Known Limitations {#known-limitations}
**No dynamic height resizing:**
- Fixed heights only
- No Canvas `lti.frameResize` postMessage
- Intentional: Telar uses internal scrolling
-**No deep linking (v0.5.0):**
-- Embed always starts at step 1
-- `?section=` parameter not implemented
-- Planned for future release
+<span class="anchor-alias" id="future-enhancements"></span>
-**Viewer state not preserved:**
-- Embed URL strips hash coordinates
-- Each embed load starts fresh
-- Users must navigate to desired view
+## Deep links and embed state {#deep-links-and-embed-state}
-## Future Enhancements
+The Share panel's generated embed code removes the current query and fragment and adds the embed parameter, so that code opens the story from its introduction. It does not preserve a reader's temporary pan and zoom.
-**Planned for future releases:**
-- Deep linking via `?section=` parameter
-- Optional banner auto-hide timeout
-- Embed analytics tracking
-- LMS-specific optimizations
+The story engine also supports step and panel fragments: <code>#s3</code> opens the third content step, <code>#s3l1</code> opens its first panel, and <code>#s3l1g1</code> targets its first glossary link. These are distinct from the unsupported <code>?section=</code> parameter. Test a manually constructed embedded link in the host environment before sharing it.
-## Related Documentation
+## Related Documentation {#related-documentation}
- **Educator Guide**: [Embedding in LMS & Websites](/docs/site-features/embedding/)
- **Development Setup**: [Local Development](/docs/developers/local-development/)
diff --git a/docs/8-2-github-actions.md b/content/en/docs/developers/github-actions.md
similarity index 86%
rename from docs/8-2-github-actions.md
rename to content/en/docs/developers/github-actions.md
index c5db843..35ba390 100644
--- a/docs/8-2-github-actions.md
+++ b/content/en/docs/developers/github-actions.md
@@ -1,22 +1,20 @@
---
-layout: docs
-title: "8.2. GitHub Actions"
-parent: "8. For Developers"
-grand_parent: Documentation
-nav_order: 2
-lang: en
-permalink: /docs/developers/github-actions/
+title: GitHub Actions Workflow
+url: /docs/developers/github-actions/
+translationKey: docs-developers-github-actions
+type: guide
+docs_section: developers
---
-# GitHub Actions Workflow
+# GitHub Actions Workflow {#github-actions-workflow}
Telar uses GitHub Actions to automatically build and deploy your site. Understanding this workflow helps you troubleshoot issues and optimize your development process.
-## What GitHub Actions Does
+## What GitHub Actions Does {#what-github-actions-does}
When you deploy via GitHub Pages, the build process is **fully automated**. No manual steps required!
-### User Actions (You)
+### User Actions (You) {#user-actions-you}
Edit content directly on GitHub or push from local:
@@ -25,7 +23,7 @@ Edit content directly on GitHub or push from local:
3. **Add images** to `telar-content/objects/`
4. **Commit and push** to main branch
-### Automated Actions (GitHub)
+### Automated Actions (GitHub) {#automated-actions-github}
The workflow (`.github/workflows/build.yml`) automatically:
@@ -72,7 +70,7 @@ The workflow (`.github/workflows/build.yml`) automatically:
- Publishes `_site/` directory
- Site goes live at your GitHub Pages URL
-## Build Triggers
+## Build Triggers {#build-triggers}
The workflow runs automatically when:
@@ -80,11 +78,11 @@ The workflow runs automatically when:
- **CSV or markdown changes**: Content updates deploy immediately
- **Config changes**: `_config.yml` modifications rebuild site
-## Manual Build Trigger
+## Manual Build Trigger {#manual-build-trigger}
Sometimes you need to rebuild without making code changes (e.g., after editing Google Sheets).
-### How to Manually Trigger
+### How to Manually Trigger {#how-to-manually-trigger}
1. Go to your repository on GitHub
2. Click **Actions** tab
@@ -94,14 +92,14 @@ Sometimes you need to rebuild without making code changes (e.g., after editing G
6. Click green **Run workflow** button
7. Wait 2-5 minutes for completion
-### When to Trigger Manually
+### When to Trigger Manually {#when-to-trigger-manually}
- After editing Google Sheets content
- After adding objects or story steps in Google Sheets
- To rebuild without code changes
- To force a clean build
-## Workflow File
+## Workflow File {#workflow-file}
The workflow is defined in `.github/workflows/build.yml`. The following is a simplified outline — the actual file contains caching logic and conditional steps:
@@ -172,25 +170,25 @@ jobs:
On a manual run, the **force_iiif** and **force_audio** checkboxes decide whether IIIF tiles and audio are regenerated. Both are ticked by default. Untick one to take that part from the cache instead, and the build finishes sooner.
-## Build Status
+## Build Status {#build-status}
-### Checking Build Status
+### Checking Build Status {#checking-build-status}
1. Go to **Actions** tab in your repository
2. See list of recent workflow runs
3. Green checkmark = successful build
4. Red X = failed build
-### Viewing Build Logs
+### Viewing Build Logs {#viewing-build-logs}
1. Click on a workflow run
2. Click on the job name (e.g., "build-and-deploy")
3. Expand steps to see detailed logs
4. Use logs to troubleshoot errors
-## Common Build Errors
+## Common Build Errors {#common-build-errors}
-### CSV Parsing Error
+### CSV Parsing Error {#csv-parsing-error}
**Error:** `Failed to parse story-1.csv`
@@ -199,7 +197,7 @@ On a manual run, the **force_iiif** and **force_audio** checkboxes decide whethe
- Ensure all required columns are present
- Verify no special characters breaking CSV format
-### Spreadsheet Refused
+### Spreadsheet Refused {#spreadsheet-refused}
**Error:** `Two columns in this spreadsheet mean the same thing: ...` (fails at the "Convert CSV to JSON" step; the message names the file)
@@ -212,7 +210,7 @@ On a manual run, the **force_iiif** and **force_audio** checkboxes decide whethe
**Solution:**
- Rename the `_metadata` column and rebuild. Telar keeps that name for its own use: if a row has anything in that column, Telar reads it as its own data and leaves the row off the published site.
-### IIIF Generation Error
+### IIIF Generation Error {#iiif-generation-error}
**Error:** `Failed to process image textile-001.jpg`
@@ -222,7 +220,7 @@ On a manual run, the **force_iiif** and **force_audio** checkboxes decide whethe
- Check image isn't corrupted
- Ensure image format is supported (JPG, PNG, TIFF)
-### Jekyll Build Error
+### Jekyll Build Error {#jekyll-build-error}
**Error:** `Liquid syntax error`
@@ -231,7 +229,7 @@ On a manual run, the **force_iiif** and **force_audio** checkboxes decide whethe
- Verify frontmatter is properly formatted
- Look for unclosed tags or brackets
-### Google Sheets Fetch Error
+### Google Sheets Fetch Error {#google-sheets-fetch-error}
**Error:** `Failed to fetch Google Sheets`
@@ -240,7 +238,7 @@ On a manual run, the **force_iiif** and **force_audio** checkboxes decide whethe
- Ensure sheet is published to web (not just shared)
- Check sheet has proper permissions
-### Private Story Build Failure
+### Private Story Build Failure {#private-story-build-failure}
**Error:** `story/stories are marked protected but no story_key is set` (fails at the "Convert CSV
to JSON" step)
@@ -263,7 +261,7 @@ before "Upload artifact")
have been encrypted away. This is a bug, not a configuration issue — [report
it](https://github.com/UCSB-AMPLab/telar/issues) with the workflow run link.
-## Build Performance
+## Build Performance {#build-performance}
Typical build times:
@@ -271,15 +269,15 @@ Typical build times:
- **Medium sites** (10-50 objects, multiple stories): 3-5 minutes
- **Large sites** (50+ objects, many stories): 5-10 minutes
-### Optimizing Build Time
+### Optimizing Build Time {#optimizing-build-time}
- **Use external IIIF** for large images (skips tile generation)
- **Commit fewer images** at once (split large uploads)
- **Clean repository** periodically (remove unused files)
-## Troubleshooting
+## Troubleshooting {#troubleshooting}
-### Build Fails Every Time
+### Build Fails Every Time {#build-fails-every-time}
1. Check recent commits for errors
2. Review build logs for specific error messages
@@ -289,21 +287,21 @@ Typical build times:
Reference](/docs/developers/local-development/))
4. Revert to last working commit if needed
-### Build Succeeds But Site Not Updating
+### Build Succeeds But Site Not Updating {#build-succeeds-but-site-not-updating}
1. Clear browser cache (hard refresh: Cmd+Shift+R or Ctrl+Shift+R)
2. Wait 5 minutes for CDN propagation
3. Check GitHub Pages settings (Settings → Pages)
4. Verify correct branch is set for Pages deployment
-### Google Sheets Not Updating
+### Google Sheets Not Updating {#google-sheets-not-updating}
1. Manually trigger workflow (see above)
2. Verify the published URL in `_config.yml`
3. Check the sheet is published to web
4. Review fetch logs in Actions tab
-## Next Steps
+## Next Steps {#next-steps}
- [Local Development Reference](/docs/developers/local-development/)
- [Configuration Guide](/docs/configure/configuration/)
diff --git a/docs/8-1-local-development.md b/content/en/docs/developers/local-development.md
similarity index 87%
rename from docs/8-1-local-development.md
rename to content/en/docs/developers/local-development.md
index 521ae4b..9c15f48 100644
--- a/docs/8-1-local-development.md
+++ b/content/en/docs/developers/local-development.md
@@ -1,25 +1,23 @@
---
-layout: docs
-title: "8.1. Local Dev Setup"
-parent: "8. For Developers"
-grand_parent: Documentation
-nav_order: 1
-lang: en
-permalink: /docs/developers/local-development/
+title: Local Development
+url: /docs/developers/local-development/
+translationKey: docs-developers-local-development
+type: guide
+docs_section: developers
---
-# Local Development
+# Local Development {#local-development}
Complete reference for local development, build commands, and troubleshooting.
-## Prerequisites
+## Prerequisites {#prerequisites}
-### Required Software
+### Required Software {#required-software}
- **Ruby 3.2+**: Jekyll runtime
- **Bundler**: Ruby dependency management
-- **Python 3.9+**: IIIF generation and CSV processing
-- **Node.js 18+**: JavaScript bundling (esbuild)
+- **Python 3.12**: IIIF generation and CSV processing
+- **Node.js 22**: JavaScript bundling (esbuild)
- **Git**: Version control
Telar needs Ruby 3.2 or newer, and continuous integration builds with 3.2.11.
@@ -28,7 +26,7 @@ version managers such as rbenv, chruby and asdf pick it up on their own. On an
older Ruby, `bundle install` stops and says which version it expected, rather
than continuing with a different set of gems.
-### Installation Guides
+### Installation Guides {#installation-guides}
**macOS (Homebrew):**
```bash
@@ -48,7 +46,7 @@ gem install bundler
- Install [Node.js](https://nodejs.org/) (LTS version recommended)
- Install [Git for Windows](https://gitforwindows.org/)
-### Optional (Recommended)
+### Optional (Recommended) {#optional-recommended}
- **libvips**: Fast image processing for IIIF tile generation. Telar falls back to pure Python if not installed, but libvips is roughly 28x faster.
@@ -62,26 +60,25 @@ brew install vips
sudo apt-get install libvips-dev
```
-### Optional (Audio Objects Only)
+### Optional (Audio Objects Only) {#optional-audio-objects-only}
-If your site includes audio objects, two additional tools enable clip extraction and waveform peak data generation. Sites without audio objects do not need these tools.
+If your site includes audio objects, audiowaveform prepares waveform peak data; clip boundaries are applied in the browser. Sites without audio objects do not need these tools.
-- **ffmpeg**: Audio clip extraction
- **audiowaveform**: Waveform peak data for the WaveSurfer player
**macOS:**
```bash
-brew install ffmpeg audiowaveform
+brew install audiowaveform
```
**Ubuntu/Debian:**
```bash
-sudo apt install ffmpeg audiowaveform
+sudo apt install audiowaveform
```
-## Project Setup
+## Project Setup {#project-setup}
-### Initial Setup
+### Initial Setup {#initial-setup}
```bash
# Clone repository
@@ -98,7 +95,7 @@ pip install -r requirements.txt
npm install
```
-### Configuration
+### Configuration {#configuration}
Edit `_config.yml` for local development:
@@ -107,9 +104,9 @@ baseurl: "" # Empty for local development
url: "http://localhost:4001"
```
-## Build Commands
+## Build Commands {#build-commands}
-### Quick Start: Build Script (Recommended)
+### Quick Start: Build Script (Recommended) {#quick-start-build-script-recommended}
The easiest way to build and serve your Telar site locally is with the all-in-one build script:
@@ -135,7 +132,7 @@ python3 scripts/build_local_site.py --skip-audio
This script runs all necessary build steps in sequence, mimicking what GitHub Actions does during deployment. It automatically kills any running Jekyll instances before starting.
-### Core Commands (Manual)
+### Core Commands (Manual) {#core-commands-manual}
If you prefer to run individual scripts:
@@ -149,10 +146,10 @@ python3 scripts/csv_to_json.py
# 3. Generate Jekyll collection files
python3 scripts/generate_collections.py
-# 4. Process audio files (if any — requires ffmpeg and audiowaveform)
+# 4. Process audio files (if any — requires audiowaveform)
# Note: basic audio detection works without this step (csv_to_json.py
# generates the audio manifest automatically). This script is only
-# needed for waveform peak data and clip extraction.
+# needed for precomputed waveform peak data.
python3 scripts/process_audio.py
# 5. Generate IIIF tiles
@@ -172,7 +169,7 @@ bundle exec jekyll build
bundle exec jekyll clean
```
-### Command Options
+### Command Options {#command-options}
**Jekyll Serve Options:**
```bash
@@ -201,9 +198,9 @@ python3 scripts/generate_iiif.py --base-url https://mysite.org
python3 scripts/generate_iiif.py --image textile-001.jpg
```
-## Development Workflow
+## Development Workflow {#development-workflow}
-### Daily Workflow
+### Daily Workflow {#daily-workflow}
**Using the build script (recommended):**
@@ -240,7 +237,7 @@ python3 scripts/generate_iiif.py
# Site updates automatically
```
-### Working with Google Sheets Locally
+### Working with Google Sheets Locally {#working-with-google-sheets-locally}
For local development with Google Sheets:
@@ -266,7 +263,7 @@ For local development with Google Sheets:
See [`docs/google_sheets_integration/README.md`](https://github.com/UCSB-AMPLab/telar/blob/main/docs/google_sheets_integration/README.md) in the main Telar repository for details.
-## Directory Structure
+## Directory Structure {#directory-structure}
```
your-telar-site/
@@ -300,14 +297,14 @@ your-telar-site/
│ ├── fetch_google_sheets.py
│ ├── csv_to_json.py
│ ├── generate_collections.py
-│ ├── process_audio.py # Audio clip and peak data
+│ ├── process_audio.py # Audio waveform peak data
│ └── generate_iiif.py
└── _site/ # Built site (don't edit!)
```
-## Troubleshooting
+## Troubleshooting {#troubleshooting}
-### Common Issues
+### Common Issues {#common-issues}
**Jekyll won't start:**
```bash
@@ -351,7 +348,7 @@ ls -la telar-content/texts/stories/
python3 scripts/csv_to_json.py --verbose
```
-### Dependency Issues
+### Dependency Issues {#dependency-issues}
**Bundle install fails:**
```bash
@@ -374,7 +371,7 @@ source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt
```
-### Performance Issues
+### Performance Issues {#performance-issues}
**Slow build times:**
```bash
@@ -397,7 +394,7 @@ rm -rf _site/
# Restart Jekyll server
```
-### Embedding Issues
+### Embedding Issues {#embedding-issues}
**Navigation buttons not working in iframe:**
@@ -502,9 +499,9 @@ When changing width/height inputs:
3. Check if preset dropdown is interfering (select "Custom" preset)
4. Verify JavaScript is running without errors
-## Testing
+## Testing {#testing}
-### Local Testing Checklist
+### Local Testing Checklist {#local-testing-checklist}
Before deploying:
@@ -517,7 +514,7 @@ Before deploying:
- [ ] Mobile responsive
- [ ] Cross-browser compatible
-### Browser Testing
+### Browser Testing {#browser-testing}
Test in:
- Chrome/Edge (latest)
@@ -525,7 +522,7 @@ Test in:
- Safari (latest)
- Mobile browsers (iOS Safari, Chrome Mobile)
-### Validation
+### Validation {#validation}
```bash
# Check HTML validity
@@ -535,7 +532,7 @@ bundle exec htmlproofer ./_site --disable-external
bundle exec jekyll doctor
```
-### Automated Tests
+### Automated Tests {#automated-tests}
Telar includes automated tests for Python scripts and JavaScript modules. Running tests is optional for storytellers but recommended for developers contributing to the framework.
@@ -576,9 +573,9 @@ python3 -m pytest tests/e2e/ -v
Tests run automatically on GitHub via the `telar-tests.yml` workflow whenever you push to main or open a pull request.
-## Publishing
+## Publishing {#publishing}
-### Prepare for Publishing
+### Prepare for Publishing {#prepare-for-publishing}
```bash
# 1. Test locally
@@ -598,7 +595,7 @@ git push origin main
# 5. GitHub Actions builds automatically
```
-### Manual Publishing
+### Manual Publishing {#manual-publishing}
If not using GitHub Actions:
@@ -609,7 +606,7 @@ JEKYLL_ENV=production bundle exec jekyll build
# Publish _site/ directory to your host
```
-## Best Practices
+## Best Practices {#best-practices}
1. **Commit frequently**: Small, focused commits
2. **Test locally first**: Always preview before pushing
@@ -619,13 +616,13 @@ JEKYLL_ENV=production bundle exec jekyll build
6. **Version control**: Track all content in git
7. **Clean builds**: Periodic `jekyll clean` helps
-## Getting Help
+## Getting Help {#getting-help}
- [GitHub Issues](https://github.com/UCSB-AMPLab/telar/issues)
- [Jekyll Documentation](https://jekyllrb.com/docs/)
- [IIIF Documentation](https://iiif.io/get-started/)
-## Next Steps
+## Next Steps {#next-steps}
- [GitHub Actions Reference](/docs/developers/github-actions/)
- [Customization Guide](/docs/customization/)
diff --git a/docs/8-6-mobile.md b/content/en/docs/developers/mobile.md
similarity index 87%
rename from docs/8-6-mobile.md
rename to content/en/docs/developers/mobile.md
index c8e29b6..e68e03d 100644
--- a/docs/8-6-mobile.md
+++ b/content/en/docs/developers/mobile.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "8.6. Layouts and Small Screens"
-parent: "8. For Developers"
-grand_parent: Documentation
-nav_order: 6
-lang: en
-permalink: /docs/developers/mobile/
+title: Layouts and Small Screens
+url: /docs/developers/mobile/
+translationKey: docs-developers-mobile
+type: guide
+docs_section: developers
---
-# Layouts and Small Screens
+# Layouts and Small Screens {#layouts-and-small-screens}
A story page has two layouts, horizontal and vertical, and chooses between them from the size and shape of the window rather than from the kind of device. This page describes what each layout does and how the rest of the site adapts to small and short windows. The terms it uses are defined in [8.7 Story Engine Vocabulary](/docs/developers/story-engine/).
-## The Two Layouts
+## The Two Layouts {#the-two-layouts}
In the horizontal layout, the text card sits beside the object as a side card, and the reader moves through the story by scrolling. In the vertical layout, the text card sits below the object as a bottom card, and the reader moves with previous and next buttons.
@@ -25,7 +23,7 @@ The page uses the vertical layout when any of these is true of the window:
Otherwise it uses the horizontal layout. The layout follows the window as it is resized.
-### The text card
+### The text card {#the-text-card}
In the horizontal layout, the side card is between 37% and 52% of the window's width, set by the window's height, and white, over the object. In the vertical layout, the bottom card is anchored to the bottom of the window and white, up to 40% of the window's height (35% for a video or audio object).
@@ -33,7 +31,7 @@ On a window 480px tall or shorter, such as a phone on its side, the card returns
The text inside a card also sizes itself to the card: when the card is 480px wide or narrower, and again at 360px, its padding and type get smaller. An answer longer than 15 lines is set at 90% of the card's answer size, so that an answer at the 18-line limit fits the side card without scrolling.
-### Navigation
+### Navigation {#navigation}
How the reader moves is decided once, when the story loads:
@@ -44,38 +42,38 @@ Because the choice is made at load, a window opened wide and then narrowed keeps
In the vertical layout, the back button becomes a 44px round icon, the step counter moves to the center of the top edge, and the credits badge shrinks to one line.
-### Loading
+### Loading {#loading}
Both layouts load objects the same way: the viewers for the next `preload_steps` steps (6 by default) and the previous 2, up to `max_viewer_cards`. See [3.2 Configuration](/docs/configure/configuration/). When a story has `loading_threshold` or more distinct objects (5 by default), a shimmer shows while the first viewers load; in button navigation it also shows when the reader reaches an object that is not ready yet.
-## Compact Type Size
+## Compact Type Size {#compact-type-size}
On any window 600px tall or shorter, whatever its width, Telar uses a compact type size: smaller type and tighter spacing in page content, the objects gallery, the navigation bar, the panels and their titles, and the story's navigation buttons, which become 45px.
-## iOS Safari and Notches
+## iOS Safari and Notches {#ios-safari-and-notches}
- **Stable heights:** layout heights use dynamic viewport units (`dvh`) with a `vh` fallback, so the layout does not jump when Safari's address bar appears or disappears.
- **Notch safe areas:** the credits badge, the navigation buttons, the bottom card and the panels keep clear of the device notch and home indicator.
- **Hover:** hover styles apply only on devices with a fine pointer (`@media (hover: hover) and (pointer: fine)`), so they do not stick after a tap on a touchscreen.
- **Reduced motion:** when the operating system asks for reduced motion, smooth scrolling is off, the camera moves to each framing at once, and card and panel transitions are off.
-## Panels
+## Panels {#panels}
Panels slide in from the right in both layouts. In the horizontal layout, layer 1 takes 65% of the window (at most 800px), layer 2 55% (at most 750px) and the glossary 50% (at most 700px); on windows between 1025px and 1200px wide they take 80%, 75% and 70%. In the vertical layout they take nearly the whole width (98%, 96% and 94%) and 76% of the height, show only the close button, and use less padding.
Panel type gets smaller only in the compact type size: titles go from 2rem to 1.4rem, body text from 1.05rem to 0.9rem, and line height from 1.8 to 1.35.
-## Objects Gallery
+## Objects Gallery {#objects-gallery}
The gallery fills the width with columns at least 250px wide. In the vertical layout it shows two columns, and on windows 441px wide or narrower, one.
-## Glossary Index
+## Glossary Index {#glossary-index}
In the vertical layout, the glossary index tightens its spacing: letter headings get smaller and their margins shrink by a third, and the space between terms is halved.
-## Testing Your Site on Small Screens
+## Testing Your Site on Small Screens {#testing-your-site-on-small-screens}
-### Browser DevTools
+### Browser DevTools {#browser-devtools}
Use your browser's developer tools to try different window sizes:
@@ -92,14 +90,14 @@ Use your browser's developer tools to try different window sizes:
Resize the window across the layout thresholds: 1024px wide, a 3:4 aspect ratio, and 480px and 600px tall. Reload after a resize to see the navigation a reader with that window would get.
-### Real Devices
+### Real Devices {#real-devices}
Test on real devices when you can:
- **iOS**: Safari on iPhone and iPad
- **Android**: Chrome on a phone and a tablet
-### Common Screen Sizes
+### Common Screen Sizes {#common-screen-sizes}
- **iPhone SE**: 375 × 667px
- **iPhone 12/13/14**: 390 × 844px
@@ -108,27 +106,27 @@ Test on real devices when you can:
- **Samsung Galaxy S**: 360 × 740px
- **Samsung Galaxy Note**: 412 × 915px
-## Content on Small Screens
+## Content on Small Screens {#content-on-small-screens}
-### Images
+### Images {#images}
- Make sure IIIF images have enough detail when zoomed.
- Check that the features a step points to are visible on a small screen.
- Check how your framings look in both layouts.
-### Text
+### Text {#text}
- Keep answer paragraphs short (3 to 5 sentences).
- Use lists to break up long passages.
- Put essential information in layer 1 and supplementary detail in layer 2, since readers on phones may not open every layer.
-### Widgets
+### Widgets {#widgets}
- **Carousels:** 3 to 5 images, with short captions.
- **Tabs:** 2 or 3 tabs with short labels; on narrow screens the tab row scrolls sideways.
- **Accordions:** work well on small screens; use clear titles.
-## Performance
+## Performance {#performance}
Readers on phones often have slow or metered connections:
@@ -136,32 +134,32 @@ Readers on phones often have slow or metered connections:
- Choose external IIIF sources with fast servers, and test how quickly their manifests load.
- Keep images in panels to the ones the text needs.
-## Accessibility
+## Accessibility {#accessibility}
- Most controls are at least 44 × 44px, the WCAG 2.1 minimum touch target; the story's navigation buttons are 66px, or 45px in the compact type size.
- Navigation buttons and other controls carry ARIA labels.
-## Troubleshooting
+## Troubleshooting {#troubleshooting}
-### Content overflowing
+### Content overflowing {#content-overflowing}
- Check custom CSS for fixed-width elements.
- Make sure images have `max-width: 100%`.
- Try the page in your browser's responsive mode.
-### Navigation not working
+### Navigation not working {#navigation-not-working}
- Clear the browser cache, or try a private window.
- Check the JavaScript console for errors.
- Check that custom code does not block touch or wheel events.
-### Slow performance
+### Slow performance {#slow-performance}
- Reduce image file sizes.
- Check how quickly IIIF manifests respond.
- Test on a throttled connection in DevTools.
-## Testing Checklist
+## Testing Checklist {#testing-checklist}
- [ ] The home page loads and displays correctly
- [ ] The objects gallery shows two columns in the vertical layout, and one on a narrow phone
diff --git a/docs/8-7-story-engine.md b/content/en/docs/developers/story-engine.md
similarity index 93%
rename from docs/8-7-story-engine.md
rename to content/en/docs/developers/story-engine.md
index 4f1b7db..29150ac 100644
--- a/docs/8-7-story-engine.md
+++ b/content/en/docs/developers/story-engine.md
@@ -1,20 +1,18 @@
---
-layout: docs
-title: "8.7. Story Engine Vocabulary"
-parent: "8. For Developers"
-grand_parent: Documentation
-nav_order: 7
-lang: en
-permalink: /docs/developers/story-engine/
+title: Story Engine Vocabulary
+url: /docs/developers/story-engine/
+translationKey: docs-developers-story-engine
+type: guide
+docs_section: developers
---
-# Story Engine Vocabulary
+# Story Engine Vocabulary {#story-engine-vocabulary}
The story engine is the code that runs a story page: it lays out the cards and the object, moves between steps, and decides what to keep loaded. Its code lives in `assets/js/telar-story/` and is built into `assets/js/telar-story.js`. This page defines the terms the code, its comments and these docs use for the parts of a story and the ways it moves, so that each term names one thing.
CSS classes, `data-*` attributes and the `max_viewer_cards` setting keep their older names, because sites and the Compositor read them. Where an older name differs from a term on this page, the entry says so.
-## The Parts of a Story
+## The Parts of a Story {#the-parts-of-a-story}
A story is built from these parts:
@@ -27,7 +25,7 @@ A story is built from these parts:
- **Viewer**: the image viewer (OpenSeadragon) on an image plate.
- **Player**: the video or audio player on a media plate.
-## Moving Between Steps
+## Moving Between Steps {#moving-between-steps}
These terms describe what happens when the reader goes from one step to the next:
@@ -43,7 +41,7 @@ These terms describe what happens when the reader goes from one step to the next
Developers can tune the move duration for testing with `?nav=base,perUnit,maxSeconds` in the page URL. `?nav=1.2,0` gives every move the base duration, whatever the camera travels.
-## Layouts
+## Layouts {#layouts}
A story page uses one of two layouts.
@@ -68,7 +66,7 @@ The terms for the cards and the space around them:
- **Button navigation**: previous and next buttons move the story one step at a time. It runs in the vertical layout, in embedded stories, and on iOS in either layout. Its buttons keep the class `.mobile-nav`.
- **Scroll navigation**: the reader's scroll moves the story. It runs in the horizontal layout everywhere but iOS.
-## What Stays Loaded
+## What Stays Loaded {#what-stays-loaded}
The engine keeps a capped number of objects loaded, so a long story does not hold every image and player in memory:
@@ -77,6 +75,6 @@ The engine keeps a capped number of objects loaded, so a long story does not hol
These are the only uses of "pool" in the engine.
-## Stacking
+## Stacking {#stacking}
Each scene's cards and plate use their own block of `z-index` values, its **z-range**, so a later scene covers an earlier one as a unit.
diff --git a/docs/8-5-styling.md b/content/en/docs/developers/styling.md
similarity index 84%
rename from docs/8-5-styling.md
rename to content/en/docs/developers/styling.md
index adb874d..ab11441 100644
--- a/docs/8-5-styling.md
+++ b/content/en/docs/developers/styling.md
@@ -1,20 +1,18 @@
---
-layout: docs
-title: "8.5. Advanced Styling"
-parent: "8. For Developers"
-grand_parent: Documentation
-nav_order: 5
-lang: en
-permalink: /docs/developers/styling/
+title: Advanced Styling
+url: /docs/developers/styling/
+translationKey: docs-developers-styling
+type: guide
+docs_section: developers
---
-# Advanced Styling
+# Advanced Styling {#advanced-styling}
Go beyond themes with custom CSS, layout modifications, and component styling.
-## Custom CSS
+## Custom CSS {#custom-css}
-### Method 1: Add to telar.scss
+### Method 1: Add to telar.scss {#method-1-add-to-telarscss}
Edit `assets/css/telar.scss` to add custom styles:
@@ -35,7 +33,7 @@ Edit `assets/css/telar.scss` to add custom styles:
}
```
-### Method 2: Create Custom Stylesheet
+### Method 2: Create Custom Stylesheet {#method-2-create-custom-stylesheet}
Create `assets/css/custom.css`:
@@ -54,10 +52,10 @@ Create `assets/css/custom.css`:
Then include it in your `_layouts/default.html`:
```html
-<link rel="stylesheet" href="{{ '/assets/css/custom.css' | relative_url }}">
+<link rel="stylesheet" href="/assets/css/custom.css">
```
-## CSS Variables
+## CSS Variables {#css-variables}
Telar uses CSS custom properties that you can override:
@@ -86,9 +84,9 @@ Telar uses CSS custom properties that you can override:
Override these in your custom CSS to make global changes.
-## Layout Customization
+## Layout Customization {#layout-customization}
-### Modify Layouts
+### Modify Layouts {#modify-layouts}
Edit files in `_layouts/` directory:
@@ -98,7 +96,7 @@ Edit files in `_layouts/` directory:
- `glossary.html`: Glossary term page
- `home.html`: Homepage layout
-### Modify Includes
+### Modify Includes {#modify-includes}
Edit reusable components in `_includes/`:
@@ -107,9 +105,9 @@ Edit reusable components in `_includes/`:
- `story-step.html`: Individual story step
- `object-card.html`: Object grid card
-## Component Styling
+## Component Styling {#component-styling}
-### Story Steps
+### Story Steps {#story-steps}
```scss
.story-step {
@@ -128,7 +126,7 @@ Edit reusable components in `_includes/`:
}
```
-### Layered Panels
+### Layered Panels {#layered-panels}
```scss
.layer-panel {
@@ -144,7 +142,7 @@ Edit reusable components in `_includes/`:
}
```
-### Object Cards
+### Object Cards {#object-cards}
```scss
.object-card {
@@ -163,7 +161,7 @@ Edit reusable components in `_includes/`:
}
```
-## Responsive Design
+## Responsive Design {#responsive-design}
Telar's story layout switches to its vertical layout when the viewport is narrower than 1024px or has an aspect ratio narrower than 3:4 (see [Mobile Optimization](/docs/developers/mobile/) for details). When you add responsive rules to your own components, match those breakpoints so your styles change in step with the layout:
@@ -185,7 +183,7 @@ Telar's story layout switches to its vertical layout when the viewport is narrow
}
```
-## Cascade Layers
+## Cascade Layers {#cascade-layers}
As of v1.4.0, Telar's styles are organized into CSS cascade layers, declared in this order:
@@ -197,9 +195,9 @@ Bootstrap loads into the `third-party` layer and Telar's own styles load into th
This also helps your own customizations: **unlayered CSS always wins over layered CSS**, regardless of selector specificity. Any plain CSS rule you add outside of these layers takes precedence over Telar's styles, so you can usually override appearance without reaching for `!important`. If a custom rule unexpectedly fails to apply, check that it isn't being pulled into one of Telar's layers.
-## JavaScript Customization
+## JavaScript Customization {#javascript-customization}
-### Modify Story Behavior
+### Modify Story Behavior {#modify-story-behavior}
The story engine's source lives in `assets/js/telar-story/` (one module per concern — scroll engine, navigation, card pool, panels) and is bundled into `assets/js/telar-story.js`, which is the file pages actually load. To change story behavior, edit the modules and rebuild the bundle:
@@ -209,7 +207,7 @@ npm run build:js
Never edit `assets/js/telar-story.js` directly — it is generated, and the next rebuild overwrites it. The directory map in `assets/js/README.md` describes what each module does and where to make which kind of change.
-### Add Custom Interactions
+### Add Custom Interactions {#add-custom-interactions}
Create `assets/js/custom.js`:
@@ -239,9 +237,9 @@ document.addEventListener('DOMContentLoaded', function() {
});
```
-## Typography Customization
+## Typography Customization {#typography-customization}
-### Heading Styles
+### Heading Styles {#heading-styles}
```scss
h1, h2, h3, h4, h5, h6 {
@@ -257,7 +255,7 @@ h2 { font-size: 2rem; }
h3 { font-size: 1.75rem; }
```
-### Body Text
+### Body Text {#body-text}
```scss
body {
@@ -272,7 +270,7 @@ p {
}
```
-## Animation
+## Animation {#animation}
Add subtle animations:
@@ -304,7 +302,7 @@ Add subtle animations:
}
```
-## Best Practices
+## Best Practices {#best-practices}
1. **Use CSS variables** for values that repeat
2. **Test responsive** on multiple screen sizes
@@ -313,7 +311,7 @@ Add subtle animations:
5. **Comment your code** for future reference
6. **Test in multiple browsers** (Chrome, Firefox, Safari)
-## Performance Optimization
+## Performance Optimization {#performance-optimization}
```scss
// Use will-change for animations
@@ -332,7 +330,7 @@ Add subtle animations:
}
```
-## Next Steps
+## Next Steps {#next-steps}
- [Learn about Themes](/docs/customization/themes/)
- [View Example Sites](https://ampl.clair.ucsb.edu/telar)
diff --git a/content/en/docs/getting-started/_index.md b/content/en/docs/getting-started/_index.md
new file mode 100644
index 0000000..2b2fb12
--- /dev/null
+++ b/content/en/docs/getting-started/_index.md
@@ -0,0 +1,14 @@
+---
+title: Get started
+url: /docs/getting-started/
+translationKey: docs-getting-started
+type: guide
+docs_hub: true
+docs_section: guides
+---
+
+<span class="anchor-alias" id="getting-started" aria-hidden="true"></span>
+
+<span class="anchor-alias" id="after-setup" aria-hidden="true"></span>
+
+<h1>Choose how to build your exhibition</h1><p class="lede">Start with a question and your sources, then choose the authoring method that suits your work.</p>{{< build-options >}}
diff --git a/content/en/docs/getting-started/add-content.md b/content/en/docs/getting-started/add-content.md
new file mode 100644
index 0000000..485c2ae
--- /dev/null
+++ b/content/en/docs/getting-started/add-content.md
@@ -0,0 +1,71 @@
+---
+title: Add an object and a first story
+url: /docs/getting-started/add-content/
+translationKey: docs-getting-started-add-content
+type: guide
+docs_section: sheets
+---
+
+# Add an object and a first story {#add-an-object-and-a-first-story}
+
+Start with one object and a short sequence. Once the full route works, extend it with more sources and optional layers.
+
+<span class="anchor-alias" id="add-detail-panels"></span>
+<span class="anchor-alias" id="add-your-content"></span>
+<span class="anchor-alias" id="add-your-media"></span>
+## Add the source {#add-the-source}
+
+In the **objects** tab, add an ID, title, source address and useful metadata. For an external IIIF source, put the manifest URL in `source_url`.
+
+Use this example if you need a source for practice:
+
+```text
+https://juancobo.com/138la/iiif/khipu/p7/manifest.json
+```
+
+Choose the ID `khipu` and a title such as “Haptic khipu”. Add a description of the visible activity and retain the source's catalogue information and credit.
+
+For a file you host yourself, upload it to `telar-content/objects/` in your repository, use its filename as the object ID and leave `source_url` blank. Read [self-hosted images](/docs/your-content/self-hosted-images/) for supported formats and processing.
+
+<span class="anchor-alias" id="register-your-objects"></span>
+<span class="anchor-alias" id="register-your-stories"></span>
+<span class="anchor-alias" id="structure-your-story"></span>
+## Register the story {#register-the-story}
+
+In **project**, add a story row with an order, stable story ID and title. For example:
+
+| order | story_id | title |
+|---|---|---|
+| 1 | khipu-story | Examining a khipu |
+
+Create or rename the story tab to `khipu-story`. The ID and tab name must match. Keep the template's column headers.
+
+## Add the first step {#add-the-first-step}
+
+Fill one row:
+
+| Column | Example |
+|---|---|
+| `step` | `1` |
+| `object` | `khipu` |
+| `x`, `y`, `zoom` | `0.5`, `0.5`, `1` |
+| `question` | Which activity does this image document? |
+| `answer` | Sampling a khipu for radiocarbon dating in spring 2025. |
+| `alt_text` | Gloved hands working with knotted cords on a white surface. |
+
+Add another numbered row for the next observation. You can use the same object with a different framing. For multi-page objects, the optional `page` column chooses the page first.
+
+For recordings, use `clip_start` and `clip_end` in seconds and `loop` where needed. Read [video](/docs/your-content/video-objects/) and [audio](/docs/your-content/audio-objects/) before using a provider with different playback behaviour.
+
+## Add optional depth {#add-optional-depth}
+
+Write additional context in `layer1_content`. Give the opening button a useful name in `layer1_button`. A second panel uses `layer2_content` and opens from the first.
+
+For longer texts, use a Markdown file reference. Add glossary terms in the **glossary** tab and insert `[[term-id]]` links in supported text fields.
+
+<span class="anchor-alias" id="build-your-site"></span>
+## Build the first edition {#build-the-first-edition}
+
+Save the sheet changes. In your repository, open **Actions**, select **Build and Deploy**, then **Run workflow**. The build fetches the published sheet.
+
+Wait for that run to complete, then open the site. Next, [capture the framing and review the result](/docs/getting-started/review-refine/).
diff --git a/docs/1-1-compositor.md b/content/en/docs/getting-started/compositor.md
similarity index 60%
rename from docs/1-1-compositor.md
rename to content/en/docs/getting-started/compositor.md
index 644866a..5c1e078 100644
--- a/docs/1-1-compositor.md
+++ b/content/en/docs/getting-started/compositor.md
@@ -1,38 +1,41 @@
---
-layout: docs
-title: "1.1. Option A: Use the Compositor"
-parent: 1. Getting Started
-grand_parent: Documentation
-nav_order: 1
-lang: en
-permalink: /docs/getting-started/compositor/
+title: Use the Compositor
+url: /docs/getting-started/compositor/
+translationKey: docs-getting-started-compositor
+type: guide
+docs_section: compositor
---
-# Use the Compositor
+# Use the Compositor {#use-the-compositor}
The Telar Compositor is a visual tool for building exhibitions. You can add objects, write stories, arrange steps, and preview your site — all in your browser, with no coding required.
When you're ready, the Compositor publishes a complete Telar site to GitHub Pages.
-## What you'll need
+## What you'll need {#what-youll-need}
- A [GitHub account](https://github.com/join) (free)
- Images, videos, or audio files for your exhibition
-## Get started
+## Get started {#get-started}
Go to [compositor.telar.org](https://compositor.telar.org) and sign in with your GitHub account. The Compositor will ask you to install the Telar Compositor GitHub App — this gives it permission to create and manage repositories on your behalf.
Once signed in, you have two options:
-### Create a new site
+### Create a new site {#create-a-new-site}
-Click **Create new site**, type a name for your repository — **use lowercase letters and hyphens** (e.g., `my-exhibition`) — and the Compositor will set everything up for you: it creates the repository from the Telar template, configures GitHub Pages, and gets your site ready to edit.
+Open the project menu and choose **Add or create a repo**, then **A Telar site**. Enter a repository name, a visible title, a language and a theme. Use a short repository name with lowercase letters and hyphens, such as `my-exhibition`.
-{: .warning }
-> **Your repository will be public.** GitHub Pages requires a public repository unless you have a paid GitHub plan.
+Choose **Create site** when those details are ready. The Compositor creates the repository from the Telar template and prepares the site for editing.
-### Connect an existing repository
+{{< callout "warning" >}}
+**Your repository will be public.** GitHub Pages requires a public repository unless you have a paid GitHub plan.
+{{< /callout >}}
+
+{{< media id="create-site" >}}
+
+### Connect an existing repository {#connect-an-existing-repository}
If you already created a repository from the [Telar template](https://github.com/UCSB-AMPLab/telar) or have an existing Telar site, select it from the list and the Compositor will import your content.
@@ -62,7 +65,7 @@ Once that's done, return to [compositor.telar.org](https://compositor.telar.org)
</details>
-## What the Compositor can do
+## What the Compositor can do {#what-the-compositor-can-do}
- **Edit stories visually** — add steps, write text, set image coordinates, and preview your narrative in real time
- **Upload images** — drag and drop images directly; IIIF tiles are generated automatically
@@ -71,9 +74,13 @@ Once that's done, return to [compositor.telar.org](https://compositor.telar.org)
For the full guide, see [The Compositor](/docs/the-compositor/).
-## Next steps
+{{< media id="editor-overview" >}}
+
+## Next steps {#next-steps}
-Once your site is live, continue with the tutorial to learn more about Telar's narrative model and how to refine your exhibition:
+Continue with the visual authoring workflow:
-- **[Plan Your Narrative](/docs/getting-started/narrative-structure/)** — Understand how stories, steps, and panels fit together
-- **[Review and Refine](/docs/getting-started/review-refine/)** — Set image coordinates, review your site, and polish
+- [Objects](/docs/the-compositor/objects/) — Add sources and review their metadata.
+- [Use an IIIF object in a story](/docs/the-compositor/iiif-to-story/) — Follow the illustrated khipu example.
+- [Story Editor](/docs/the-compositor/story-editor/) — Write steps, capture views and develop panels.
+- [Publishing](/docs/the-compositor/publishing/) — Review changes and check the built site.
diff --git a/docs/1-2-google-sheets-option.md b/content/en/docs/getting-started/google-sheets.md
similarity index 91%
rename from docs/1-2-google-sheets-option.md
rename to content/en/docs/getting-started/google-sheets.md
index 77b494f..4774507 100644
--- a/docs/1-2-google-sheets-option.md
+++ b/content/en/docs/getting-started/google-sheets.md
@@ -1,20 +1,14 @@
---
-layout: docs
-title: "1.2. Option B: Set Up with Google Sheets"
-parent: 1. Getting Started
-grand_parent: Documentation
-nav_order: 2
-lang: en
-permalink: /docs/getting-started/google-sheets/
+title: Set Up with Google Sheets
+url: /docs/getting-started/google-sheets/
+translationKey: docs-getting-started-google-sheets
+type: guide
extra_css:
- - config-tools
-tutorial_next:
- title: "Plan Your Narrative"
- url: /docs/getting-started/narrative-structure/
-tutorial_hide_top: true
+- config-tools
+docs_section: sheets
---
-# Set Up with Google Sheets
+# Set Up with Google Sheets {#set-up-with-google-sheets}
This guide walks you through setting up a Telar exhibition using Google Sheets to manage your content. Interactive tools on this page generate your configuration file automatically.
@@ -24,12 +18,13 @@ You will need:
- A [GitHub account](https://github.com/join) (free)
- A [Google account](https://accounts.google.com/) for Google Sheets (free)
-{: .tip }
-> **Already familiar with GitHub Pages and YAML?** You can configure everything manually with the [Manual Setup guide](/docs/setup/manual/).
+{{< callout "tip" >}}
+**Already familiar with GitHub Pages and YAML?** You can configure everything manually with the [Manual Setup guide](/docs/setup/manual/).
+{{< /callout >}}
The setup might feel like a lot of steps, but you only have to do it once. After that, everything happens in your Google Sheets spreadsheet.
-## Create Your Repository
+## Create Your Repository {#create-your-repository}
A repository is your project's home on GitHub — it holds your configuration and image files.
@@ -42,8 +37,9 @@ A repository is your project's home on GitHub — it holds your configuration an
-{: .warning }
-> **Keep your repository public.** Private repositories will not work with GitHub Pages unless you have a paid GitHub plan.
+{{< callout "warning" >}}
+**Keep your repository public.** Private repositories will not work with GitHub Pages unless you have a paid GitHub plan.
+{{< /callout >}}
Enter your GitHub details below. These are used to build your site's web address and to generate your configuration file at the end.
@@ -73,7 +69,7 @@ Enter your GitHub details below. These are used to build your site's web address
</div>
</div>
-## Enable GitHub Pages
+## Enable GitHub Pages {#enable-github-pages}
GitHub Pages turns your repository into a live website for free.
@@ -83,7 +79,7 @@ GitHub Pages turns your repository into a live website for free.
-## Duplicate the Google Sheets Template
+## Duplicate the Google Sheets Template {#duplicate-the-google-sheets-template}
Your Google Sheets spreadsheet is where you manage all your content — objects, stories, and text.
@@ -91,7 +87,7 @@ Your Google Sheets spreadsheet is where you manage all your content — objects,
2. Click **File** → **Make a copy**
3. Save to your Google Drive with a name you will remember (e.g., "My Telar Exhibition")
-## Publish Your Sheet
+## Publish Your Sheet {#publish-your-sheet}
Your spreadsheet needs to be published so Telar can read your content during builds.
@@ -112,7 +108,7 @@ Your spreadsheet needs to be published so Telar can read your content during bui
</div>
</div>
-## Generate Your Configuration
+## Generate Your Configuration {#generate-your-configuration}
Fill in the remaining details and this page will create your configuration file.
@@ -188,7 +184,7 @@ Once generated:
2. Select all the existing content and replace it with what you copied or downloaded
3. Click **Commit changes** to save
-## Verify Your Setup
+## Verify Your Setup {#verify-your-setup}
After committing, GitHub Actions will automatically build and publish your site. This takes 2–5 minutes.
@@ -198,14 +194,15 @@ After committing, GitHub Actions will automatically build and publish your site.
-{: .warning }
-> **Build problems?** Check that your Google Sheets published URL is correct — it should come from File → Share → Publish to web. If your site does not appear at all, check the Actions tab for error details. You can also paste your `_config.yml` into the [Telar Config Validator](/docs/configure/config-validator/) to check for errors.
+{{< callout "warning" >}}
+**Build problems?** Check that your Google Sheets published URL is correct — it should come from File → Share → Publish to web. If your site does not appear at all, check the Actions tab for error details. You can also paste your `_config.yml` into the [Telar Config Validator](/docs/configure/config-validator/) to check for errors.
+{{< /callout >}}
---
-## Next Steps
+## Next Steps {#next-steps}
-Your Telar site is up and running. Follow this tutorial to learn how Telar stories work and add your own content, or jump ahead to any section:
+The connection is ready. Continue with [the spreadsheet model](/docs/your-data/google-sheets/), then add an object and your first story. Use [the planning guide](/docs/plan/) if you have not yet drafted the narrative.
- **[Plan Your Narrative](/docs/getting-started/narrative-structure/)** — Understand how stories, steps, and panels fit together
- **[Add Your Content](/docs/getting-started/add-content/)** — Upload images, fill in your spreadsheet, and create your first story
@@ -522,8 +519,8 @@ show_drafts: false
# Telar Settings (version information)
telar:
- version: "{{ site.telar_version }}"
- release_date: "{{ site.telar_release_date }}"
+ version: "{{< site-value "telar_version" >}}"
+ release_date: "{{< site-value "telar_release_date" >}}"
# Plugins
plugins:
diff --git a/content/en/docs/getting-started/how-telar-works.md b/content/en/docs/getting-started/how-telar-works.md
new file mode 100644
index 0000000..6a3cf09
--- /dev/null
+++ b/content/en/docs/getting-started/how-telar-works.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/getting-started/how-telar-works/
+translationKey: redirects-en-gs-how-telar-works-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/getting-started/narrative-structure/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/getting-started/local-dev.md b/content/en/docs/getting-started/local-dev.md
new file mode 100644
index 0000000..24dbe91
--- /dev/null
+++ b/content/en/docs/getting-started/local-dev.md
@@ -0,0 +1,112 @@
+---
+title: Install and run Telar locally
+url: /docs/getting-started/local-dev/
+translationKey: docs-getting-started-local-dev
+type: guide
+docs_section: local
+---
+
+# Install and run Telar locally {#install-and-run-telar-locally}
+
+<span class="anchor-alias" id="step-by-step-workflow"></span>
+
+<span class="anchor-alias" id="step-7-add-glossary-terms-optional"></span>
+
+<span class="anchor-alias" id="step-5-find-coordinates-for-story-moments"></span>
+
+<span class="anchor-alias" id="step-3-catalog-your-objects"></span>
+
+<span class="anchor-alias" id="step-2-write-your-narrative-text"></span>
+
+<span class="anchor-alias" id="step-1-gather-your-images"></span>
+
+<span class="anchor-alias" id="overview"></span>
+
+<span class="anchor-alias" id="next-steps"></span>
+
+<span class="anchor-alias" id="local-development"></span>
+
+<span class="anchor-alias" id="installation"></span>
+
+<span class="anchor-alias" id="deploying-to-github-pages"></span>
+
+<span class="anchor-alias" id="daily-development-workflow"></span>
+
+<span class="anchor-alias" id="core-commands"></span>
+
+<span class="anchor-alias" id="clone-and-setup"></span>
+
+Build an exhibition from CSV and Markdown files on your computer. This route gives you control of the source files, build process and hosting. You can also preview a site whose content comes from Google Sheets.
+
+## Prerequisites {#prerequisites}
+
+The current Telar build uses Ruby 3.2, Python 3.12 and Node.js 22. Use Ruby 3.2 or newer within the 3.x series and Bundler. The template's dependency files are the authority for the version you are building.
+
+Check the programs in the terminal:
+
+```bash
+ruby -v
+bundle -v
+python3 --version
+node --version
+npm --version
+git --version
+```
+
+Install missing programs with the package manager or version manager you use on your operating system. On macOS, the system Ruby may be too old; check the version rather than assuming the preinstalled program is suitable.
+
+## Get your own source copy {#get-your-own-source-copy}
+
+Create a repository from the [Telar template](https://github.com/UCSB-AMPLab/telar), then clone your repository. Replace the example address with your own:
+
+```bash
+git clone https://github.com/YOUR-ACCOUNT/YOUR-REPOSITORY.git
+cd YOUR-REPOSITORY
+```
+
+You can also download a source archive if you do not plan to use Git. Keep a separate backup of your editable files.
+
+<span class="anchor-alias" id="install-ruby-and-bundler"></span>
+## Install dependencies {#install-dependencies}
+
+Use a Python virtual environment so the project's packages remain separate from other Python work:
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python3 -m pip install -r requirements.txt
+bundle install
+npm ci
+```
+
+On Windows, activate with `.venv\Scripts\Activate.ps1` in PowerShell. Reopen and activate the same environment when returning to the project. If dependency installation fails, check the program versions before changing the lockfiles.
+
+<span class="anchor-alias" id="configure-site-settings"></span>
+For audio objects, install the system tool audiowaveform to prepare waveform data. Clip boundaries are applied in the browser; the audio-processing script does not extract separate clip files.
+
+## Configure the site {#configure-the-site}
+
+Edit the author-facing section of `_config.yml`: title, description, author, language and theme. If editing CSV files directly, set:
+
+```yaml
+google_sheets:
+ enabled: false
+```
+
+Keep the template's build settings below the author-facing section. For a site served at a domain root, `baseurl` is empty; for a project site it is the repository path.
+
+<span class="anchor-alias" id="step-4-preview-your-objects"></span>
+<span class="anchor-alias" id="step-6-build-your-story"></span>
+## Build the first preview {#build-the-first-preview}
+
+From the repository root, with the environment active:
+
+```bash
+python3 scripts/build_local_site.py
+```
+
+The helper processes content, audio and IIIF tiles, bundles JavaScript and starts Jekyll on port 4001. Open the address with the configured base path, for example `http://127.0.0.1:4001/my-exhibition/`.
+
+Stop the server with Ctrl+C. Use `--port 4003` if another site already uses 4001.
+
+**Check your work:** the homepage and a sample object should load. Next, [edit the content files](/docs/local-authoring/content/).
diff --git a/content/en/docs/getting-started/narrative-structure.md b/content/en/docs/getting-started/narrative-structure.md
new file mode 100644
index 0000000..62381e4
--- /dev/null
+++ b/content/en/docs/getting-started/narrative-structure.md
@@ -0,0 +1,53 @@
+---
+title: Sketch the narrative arc
+url: /docs/getting-started/narrative-structure/
+translationKey: docs-getting-started-narrative-structure
+type: guide
+docs_draft: true
+docs_section: planning
+---
+
+# Sketch the narrative arc {#sketch-the-narrative-arc}
+
+<span class="anchor-alias" id="the-questionanswerinvitation-pattern"></span>
+
+<span class="anchor-alias" id="planning-your-story"></span>
+
+<span class="anchor-alias" id="plan-your-narrative"></span>
+
+<span class="anchor-alias" id="layered-panels"></span>
+
+A story leads visitors from an opening to an ending through a sequence of close looks. Its steps should develop the guiding question in your exhibition brief.
+
+## Give the opening a job {#give-the-opening-a-job}
+
+Introduce the source, the question and the context visitors need to begin. Offer a first view that helps them orient themselves. Save details that matter later for the steps where they become useful.
+
+The opening square in the [narrative planner](/assets/templates/telar-worksheet.pdf) marks this introduction. It is not an extra question to squeeze into the first step.
+
+## Build a string of questions {#build-a-string-of-questions}
+
+Write one question or observation for each circle. Move from something visitors can recognise towards the relationships or interpretation you want them to understand.
+
+For a painting, a possible sequence is: What do we see? Which details identify the place? Why were those details included? What does their arrangement suggest? These are prompts to investigate, not claims the image proves by itself.
+
+Put a source or source detail beside each question. If you cannot show the evidence for an answer, revise the answer, add a source or acknowledge the uncertainty.
+
+{{< story-arc >}}
+
+## Write an ending that follows from the steps {#write-an-ending-that-follows-from-the-steps}
+
+The upward triangle marks the ending. Return to the guiding question and draw together what the visitor has examined. Do not introduce the source on which the whole interpretation depends only at the end.
+
+Ask whether the ending would make sense to someone who read only the main route. Optional panels can enrich the argument, but the central thread should remain understandable without them.
+
+## Try the sequence aloud {#try-the-sequence-aloud}
+
+Read just the questions and short answers in order. Then ask a colleague to do the same while looking at the proposed views.
+
+- Remove repeated explanations.
+- Divide a step that asks visitors to make two unrelated observations.
+- Add a transition where a change of source, place or time is hard to follow.
+- Move specialist context into a panel when it interrupts the main route.
+
+**Your result:** an opening, a numbered sequence of questions with sources, and a provisional ending. Next, [choose the framing for each step](/docs/plan/sources-and-framing/).
diff --git a/content/en/docs/getting-started/quick-start.md b/content/en/docs/getting-started/quick-start.md
new file mode 100644
index 0000000..6f8e8bc
--- /dev/null
+++ b/content/en/docs/getting-started/quick-start.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/getting-started/quick-start/
+translationKey: redirects-en-gs-quick-start-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/getting-started/google-sheets/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/getting-started/review-refine.md b/content/en/docs/getting-started/review-refine.md
new file mode 100644
index 0000000..71aafa5
--- /dev/null
+++ b/content/en/docs/getting-started/review-refine.md
@@ -0,0 +1,58 @@
+---
+title: Frame, review and publish from Sheets
+url: /docs/getting-started/review-refine/
+translationKey: docs-getting-started-review-refine
+type: guide
+docs_section: sheets
+---
+
+# Frame, review and publish from Sheets {#frame-review-and-publish-from-sheets}
+
+<span class="anchor-alias" id="review-and-refine"></span>
+
+<span class="anchor-alias" id="next-steps"></span>
+
+<span class="anchor-alias" id="keep-building"></span>
+
+Use the first build to choose precise views and test the narrative. Keep the sheet as your source while you revise.
+
+<span class="anchor-alias" id="set-your-image-coordinates"></span>
+## Set each image's framing {#set-each-images-framing}
+
+1. Open the intended object's page on the built site.
+2. Choose **Identify coordinates**.
+3. Select the document page if it has more than one.
+4. Pan and zoom to the detail for your step.
+5. Copy the X, Y and Zoom values into that step's row.
+6. Rebuild and revisit the step.
+
+For the khipu example, frame the khipu image itself. Do not substitute a view from another object just because its coordinate tool is already open.
+
+{{< media id="coordinates" >}}
+
+<span class="anchor-alias" id="make-stories-private-optional"></span>
+## Check the main story and optional routes {#check-the-main-story-and-optional-routes}
+
+Read the questions and short answers in sequence. Verify that the source and view support each observation.
+
+Open every first and second panel, follow glossary links and return to the story. Check the ending, the homepage story order and the menu. Test a narrow window and keyboard navigation.
+
+Use [the reader-testing guide](/docs/plan/review/) for a structured review with another person.
+
+## Publish a sheet revision {#publish-a-sheet-revision}
+
+A sheet edit does not trigger the repository workflow by itself. Run **Build and Deploy** from **Actions** when you want to publish the latest sheet content.
+
+Open the run's log if it fails. Confirm the published spreadsheet address and that the required tabs remain published. If the site loads but a source does not, check the object ID and source URL rather than changing unrelated configuration.
+
+## Handle private or unfinished work {#handle-private-or-unfinished-work}
+
+A private story uses the `private` project column and a `story_key` in the configuration. Read [private stories](/docs/site-features/private-stories/) before using it. A key does not make externally hosted images private.
+
+Keep unfinished work out of the published story list until it is ready. The Compositor's draft flag is an editor workflow; do not assume that marking a row private removes it from publication.
+
+## Complete the exhibition {#complete-the-exhibition}
+
+Edit the homepage introduction and supporting pages, review credits and disable demo content when the examples no longer belong. Rebuild and inspect the public result once more.
+
+Keep the spreadsheet, repository and public-site addresses together. Record which one is the editing source so collaborators know where to make the next change.
diff --git a/content/en/docs/google-sheets.md b/content/en/docs/google-sheets.md
new file mode 100644
index 0000000..95ab869
--- /dev/null
+++ b/content/en/docs/google-sheets.md
@@ -0,0 +1,9 @@
+---
+title: Google Sheets manual
+url: /docs/google-sheets/
+translationKey: docs-google-sheets
+type: guide
+docs_section: sheets
+---
+
+{{< section-overview >}}
diff --git a/content/en/docs/iiif-integration.md b/content/en/docs/iiif-integration.md
new file mode 100644
index 0000000..09216b4
--- /dev/null
+++ b/content/en/docs/iiif-integration.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/iiif-integration/
+translationKey: redirects-en-iiif-integration-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/your-content/self-hosted-images/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/iiif/_index.md b/content/en/docs/iiif/_index.md
new file mode 100644
index 0000000..c26b95b
--- /dev/null
+++ b/content/en/docs/iiif/_index.md
@@ -0,0 +1,5 @@
+---
+build:
+ list: never
+ render: never
+---
diff --git a/content/en/docs/iiif/demo-content.md b/content/en/docs/iiif/demo-content.md
new file mode 100644
index 0000000..dc23277
--- /dev/null
+++ b/content/en/docs/iiif/demo-content.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/iiif/demo-content/
+translationKey: redirects-en-iiif-demo-content-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/customization/demo-content/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/local-authoring/_index.md b/content/en/docs/local-authoring/_index.md
new file mode 100644
index 0000000..db3d1a0
--- /dev/null
+++ b/content/en/docs/local-authoring/_index.md
@@ -0,0 +1,9 @@
+---
+title: Local authoring & builds
+url: /docs/local-authoring/
+translationKey: docs-local-authoring
+type: guide
+docs_section: local
+---
+
+{{< section-overview >}}
diff --git a/content/en/docs/local-authoring/content.md b/content/en/docs/local-authoring/content.md
new file mode 100644
index 0000000..b03d8cf
--- /dev/null
+++ b/content/en/docs/local-authoring/content.md
@@ -0,0 +1,64 @@
+---
+title: Edit objects, stories and text files
+url: /docs/local-authoring/content/
+translationKey: docs-local-authoring-content
+type: guide
+docs_draft: true
+docs_section: local
+---
+
+# Edit objects, stories and text files {#edit-objects-stories-and-text-files}
+
+The editable content lives in `telar-content/`. Generated JSON, collections and the built `_site/` directory are outputs; changes made only there disappear at the next build.
+
+## Know the source folders {#know-the-source-folders}
+
+| Location | What to edit |
+|---|---|
+| `telar-content/spreadsheets/` | Object catalogue, story list, story steps and glossary CSV files |
+| `telar-content/objects/` | Images, PDFs and audio hosted by your site |
+| `telar-content/texts/stories/` | Longer panel texts referenced from story rows |
+| `telar-content/texts/glossary/` | Glossary text files where used |
+| `_config.yml` | Site identity and configuration |
+| `_data/navigation.yml` | Published menu |
+
+## Register one object {#register-one-object}
+
+For a local file, use a simple filename such as `khipu.jpg` and put it in the objects folder. Match that name with the object ID.
+
+For an external IIIF object, add its manifest to `source_url`. No image download is required. A minimal `objects.csv` example is:
+
+```csv
+object_id,title,source_url,alt_text
+khipu,Haptic khipu,https://juancobo.com/138la/iiif/khipu/p7/manifest.json,Gloved hands working with knotted cords on a white surface
+```
+
+Keep catalogue information and credits in the other supported columns. See [object columns](/docs/your-data/csv-objects/) for the complete schema.
+
+{{< media id="public-object" >}}
+
+## Connect a story and its steps {#connect-a-story-and-its-steps}
+
+Add a story to `project.csv`:
+
+```csv
+order,story_id,title
+1,khipu-story,Examining a khipu
+```
+
+Create `khipu-story.csv` in the same folder. Its filename matches the story ID:
+
+```csv
+step,object,x,y,zoom,question,answer
+1,khipu,0.5,0.5,1,Which activity is shown?,The photograph documents sampling for radiocarbon dating.
+```
+
+Use the object page's coordinate tool to refine the starting view. A new row can return to the same object at another view. Keep steps numbered in order.
+
+## Add panels and glossary links {#add-panels-and-glossary-links}
+
+Use `layer1_content` and `layer2_content` for inline panel text or a Markdown file path relative to the stories text folder. Use the matching button columns to describe what opens.
+
+Glossary definitions can live in `glossary.csv`; link them as `[[term-id]]`. Read [story columns](/docs/your-data/csv-stories/) and [glossary columns](/docs/your-data/csv-glossary/) before adding more complex content.
+
+Next, [rebuild and inspect the result](/docs/local-authoring/preview/).
diff --git a/content/en/docs/local-authoring/preview.md b/content/en/docs/local-authoring/preview.md
new file mode 100644
index 0000000..8b18fb1
--- /dev/null
+++ b/content/en/docs/local-authoring/preview.md
@@ -0,0 +1,59 @@
+---
+title: Rebuild and inspect the local site
+url: /docs/local-authoring/preview/
+translationKey: docs-local-authoring-preview
+type: guide
+docs_draft: true
+docs_section: local
+---
+
+# Rebuild and inspect the local site {#rebuild-and-inspect-the-local-site}
+
+The local helper prepares content before it starts Jekyll. Jekyll's file watcher alone does not rerun every preprocessing step.
+
+## Rebuild after content changes {#rebuild-after-content-changes}
+
+Stop the running server with Ctrl+C, then run:
+
+```bash
+python3 scripts/build_local_site.py
+```
+
+After changing CSV files, the conversion and collection-generation steps must run again. After adding or replacing an image or PDF, regenerate its IIIF tiles. The helper handles these stages.
+
+If images and the Google Sheet have not changed, use:
+
+```bash
+python3 scripts/build_local_site.py --skip-iiif --skip-fetch
+```
+
+Do not skip a stage whose inputs changed. For Markdown or styling work, Jekyll can update some output while serving, but use the helper again when checking the complete result.
+
+## Check the actual source in each step {#check-the-actual-source-in-each-step}
+
+Open the objects gallery, the object page and the story. For the khipu example, all three should show the khipu. Check the framing, alt text, credits, panels and glossary links.
+
+Test with a smaller browser window and keyboard navigation. Use the [reader-review guide](/docs/plan/review/) to check the narrative as well as the build.
+
+{{< media id="coordinates" >}}
+
+## Test private stories separately {#test-private-stories-separately}
+
+The development server shows private-story content in plaintext. It continually regenerates pages, so its output does not stay encrypted.
+
+To test the locked behaviour, stop Jekyll. Temporarily set `baseurl: ""` in your configuration so the static server can serve the output at its root, then run:
+
+```bash
+python3 scripts/build_local_site.py --port 4003 --build-only
+python3 -m http.server 4003 --directory _site
+```
+
+Restore your production base path after this test. This build runs the post-build encryption step. Open the story from the static server and check both locked and unlocked views. Treat the live development preview as local working material.
+
+## Read failures at the stage that reports them {#read-failures-at-the-stage-that-reports-them}
+
+A missing image may come from an object ID mismatch, an unreachable source or a tile-generation failure. A missing story may come from a mismatched filename and story ID. The terminal output helps identify which stage failed.
+
+Fix the source and rebuild. Avoid editing generated JSON or HTML to conceal a source problem.
+
+Next, [publish and maintain the site](/docs/local-authoring/publish/).
diff --git a/content/en/docs/local-authoring/publish.md b/content/en/docs/local-authoring/publish.md
new file mode 100644
index 0000000..4a688b0
--- /dev/null
+++ b/content/en/docs/local-authoring/publish.md
@@ -0,0 +1,49 @@
+---
+title: Publish and maintain a local project
+url: /docs/local-authoring/publish/
+translationKey: docs-local-authoring-publish
+type: guide
+docs_draft: true
+docs_section: local
+---
+
+# Publish and maintain a local project {#publish-and-maintain-a-local-project}
+
+Keep the editable source and the published output distinct. Your source lets you revise the exhibition; the generated site is the edition visitors read.
+
+## Publish through GitHub Actions {#publish-through-github-actions}
+
+Confirm `url` and `baseurl` in the configuration. Enable GitHub Pages with **GitHub Actions** as its source.
+
+Review the files you changed, commit the intended source files and push them to your repository. The template's deployment workflow processes content, generates media assets, builds the site and applies private-story encryption before deploying.
+
+Open **Actions**, inspect the run and wait for successful deployment. Then test the public address. A local preview is not evidence that deployment finished.
+
+Keep virtual environments, dependencies and temporary output out of the source commit. Review `git status` before committing.
+
+## Publish to another static host {#publish-to-another-static-host}
+
+The local helper generates IIIF addresses for its local preview. Do not upload that preview unchanged to a public host.
+
+For a standalone deployment, first run the complete build pipeline, then regenerate hosted-image addresses with the full public site address and rebuild:
+
+```bash
+python3 scripts/build_local_site.py --build-only
+python3 scripts/generate_iiif.py --base-url https://example.org/my-exhibition
+bundle exec jekyll build
+python3 scripts/encrypt_protected_stories.py
+```
+
+Replace the example address with the actual domain and path. Set `url` and `baseurl` to match. Upload the resulting `_site/` directory to your host after the encryption command succeeds. Check any destination-conflict warnings before treating the build as ready.
+
+If you rebuild Jekyll afterwards, run encryption again before publishing private stories. See [private stories](/docs/site-features/private-stories/) for the full model.
+
+## Keep a reproducible source copy {#keep-a-reproducible-source-copy}
+
+Back up configuration, content, media and custom themes. Keep the dependency files and a note of the Telar version. External IIIF sources remain external dependencies; retain their catalogue and manifest addresses.
+
+## Upgrade in a separate step {#upgrade-in-a-separate-step}
+
+Back up or commit your current work, read the release notes and follow [upgrading Telar](/docs/setup/upgrading/). Review changes before publishing, then retest a representative image, story, panel, glossary entry and any private story.
+
+Separate an upgrade from a large content revision where possible. That makes a failure easier to trace.
diff --git a/content/en/docs/plan/_index.md b/content/en/docs/plan/_index.md
new file mode 100644
index 0000000..ad758f4
--- /dev/null
+++ b/content/en/docs/plan/_index.md
@@ -0,0 +1,34 @@
+---
+title: Plan an exhibition
+url: /docs/plan/
+translationKey: docs-plan
+type: guide
+docs_draft: true
+docs_section: planning
+---
+
+<p class="eyebrow">Chapter 1 · Purpose, audience and sources</p>
+<h1>Begin with what you want people to notice.</h1>
+<p class="lede">An exhibition brings sources and interpretation together. Before choosing an editor, decide what you want visitors to explore and which materials can help them do it.</p>
+<div class="chapter-outcome"><strong>By the end of this chapter</strong><p>You will have a short exhibition brief: a guiding question, an intended audience and a small set of sources to examine.</p></div>
+<h2 id="purpose">1. Turn a topic into a question</h2>
+<p>A topic gives your exhibition a subject. A question gives visitors a reason to look closely. Start with something that can be explored through your materials.</p>
+<div class="worked-example"><p class="eyebrow">An example to think with</p><div class="example-pair"><div><span>Topic</span><p>A painting of the Bogotá savanna.</p></div><div><span>Possible guiding question</span><p>What can this painting help us understand about people and land?</p></div></div><p class="example-note">This is a possible starting question, not a finished interpretation. The details you examine will shape the argument.</p></div>
+<p>Write the idea you want visitors to leave with, even if it is provisional. Then consider which questions could help them reach it. The opening should give them a way in; the ending should return to what the exhibition has helped them see.</p>
+<h2 id="audience">2. Picture your visitors</h2>
+<p>Imagine someone arriving without the knowledge you bring to the material. What can they recognise? What will need an introduction? Which words or assumptions could get in the way?</p>
+<ul><li>For whom are you making this exhibition?</li><li>What context will they need before the first close look?</li><li>What should they be able to notice or explain afterwards?</li></ul>
+<p>Use those answers to choose your opening, your language and the amount of context you offer. A glossary can explain recurring terms; a panel can develop the context of a particular step.</p>
+<h2 id="sources">3. Read your sources before arranging them</h2>
+<p>Choose a manageable starting set: an image, a document, an audio recording, a video, or a few related items. You can return to the same source in more than one step.</p>
+<p>Look and listen closely. Note significant elements, how they relate to one another, the questions they raise and what remains uncertain. Connect each possible observation to a detail you can actually show.</p>
+<div class="prompt-grid"><div><h3>What is there?</h3><p>People, words, symbols, sounds, gestures, arrangements and absences.</p></div><div><h3>What does it raise?</h3><p>Questions about making, use, audience, time, place and interpretation.</p></div></div>
+<p>Keep the source address, catalogue information and credit alongside your notes. Identify what can be shared and what needs further checking. Mark uncertain interpretations as questions to investigate.</p>
+<h2 id="exercise">4. Draft a brief you can build from</h2>
+<p>On paper or in a document, finish these four prompts:</p>
+<ol class="exercise-list"><li><strong>My exhibition asks…</strong><span>State one guiding question.</span></li><li><strong>I am making it for…</strong><span>Name your intended audience and the context they will need.</span></li><li><strong>I will work with…</strong><span>List a small starting set of sources and the details worth examining.</span></li><li><strong>By the end, visitors should…</strong><span>Describe an understanding or observation your exhibition can help develop.</span></li></ol>
+<div class="chapter-note"><strong>Keep this provisional.</strong><p>Planning is iterative. As you examine the sources and try the story with readers, revise the question, the sequence and the conclusion.</p></div>
+<h2 id="next">Next: sketch the narrative arc</h2>
+<p>Turn your brief into an opening, a sequence of questions and an ending. Continue with <a href='/docs/getting-started/narrative-structure/'>the narrative arc</a>, then connect each step to a source view, plan optional layers and arrange the whole exhibition.</p>
+<p>The <a href="/assets/templates/telar-worksheet.pdf">narrative planner</a> gives you a beginning and ending to build between. The <a href="https://telar.org/workshop/">workshop slides</a> demonstrate how to add questions, sources and layers.</p>
+<a class="button" href="/docs/getting-started/narrative-structure/">Sketch the narrative arc →</a>
diff --git a/content/en/docs/plan/exhibition-layout.md b/content/en/docs/plan/exhibition-layout.md
new file mode 100644
index 0000000..e085281
--- /dev/null
+++ b/content/en/docs/plan/exhibition-layout.md
@@ -0,0 +1,44 @@
+---
+title: Arrange the whole exhibition
+url: /docs/plan/exhibition-layout/
+translationKey: docs-plan-exhibition-layout
+type: guide
+docs_draft: true
+docs_section: planning
+---
+
+# Arrange the whole exhibition {#arrange-the-whole-exhibition}
+
+An exhibition includes its homepage, stories, objects, glossary and supporting pages. Plan how someone will find a route through them before polishing individual screens.
+
+## Decide what the homepage introduces {#decide-what-the-homepage-introduces}
+
+State the exhibition's subject, its guiding question and who made it. Offer enough context to choose a story without reproducing the whole introduction to every story.
+
+Give story cards distinct titles and useful subtitles. Put the suggested starting story first when order matters. If stories can be read independently, make that clear.
+
+{{< media id="public-home" >}}
+
+## Decide how stories relate {#decide-how-stories-relate}
+
+Use one story for a continuous argument or guided examination. Split material into several stories when each has a distinct question, audience or source group.
+
+Write a one-sentence description of each story's role. If two descriptions are interchangeable, reconsider the division. If a later story depends on earlier knowledge, explain or link that relationship.
+
+## Offer other ways into the sources {#offer-other-ways-into-the-sources}
+
+The objects gallery supports browsing beyond the guided narratives. Meaningful titles, credits, descriptions and consistent metadata help visitors understand what they find there.
+
+The glossary provides recurring context. An About or methodology page can explain contributors, research choices, source selection and acknowledgements without interrupting every story.
+
+## Sketch the navigation {#sketch-the-navigation}
+
+List the menu entries and the page each should open. Keep the list short enough to understand at a glance. Use names that describe the destination.
+
+In the Compositor, arrange the menu in **Home and Pages** and adjust homepage and collection display in **Site settings**. With files, the navigation lives in `_data/navigation.yml`; see [navigation reference](/docs/customization/navigation-menu/).
+
+## Choose a manageable first version {#choose-a-manageable-first-version}
+
+Build one complete route through the exhibition first: homepage → story → source or panel → ending. Then add the other stories and supporting pages.
+
+**Your result:** a simple site map, ordered story list and homepage outline. Next, [test the exhibition with readers](/docs/plan/review/).
diff --git a/content/en/docs/plan/layers-and-glossary.md b/content/en/docs/plan/layers-and-glossary.md
new file mode 100644
index 0000000..e664570
--- /dev/null
+++ b/content/en/docs/plan/layers-and-glossary.md
@@ -0,0 +1,42 @@
+---
+title: Plan panels and glossary links
+url: /docs/plan/layers-and-glossary/
+translationKey: docs-plan-layers-and-glossary
+type: guide
+docs_draft: true
+docs_section: planning
+---
+
+# Plan panels and glossary links {#plan-panels-and-glossary-links}
+
+Keep the main route readable, then offer further context where readers may want it. Panels belong to a particular step; glossary entries explain terms that can recur across the exhibition.
+
+## Write the short answer first {#write-the-short-answer-first}
+
+Answer the step's question in a sentence or two. Keep the observation and the inference distinct: what does the source show, and what do you argue it means?
+
+Read the questions and answers without opening anything else. If an essential explanation is missing, bring it into this main route before adding optional detail.
+
+## Give each panel a purpose {#give-each-panel-a-purpose}
+
+A first panel might explain the source's making, introduce a comparison or show the evidence behind an interpretation. A second panel opens from the first and can develop that discussion further.
+
+In the planner, draw the first branch from its question and the second branch from the first panel. This represents how readers encounter them: step → first panel → second panel.
+
+Choose a button label that tells visitors what they will find. “How the sample was taken” is more informative than repeating “More” everywhere. A panel need not contain every piece of research you collected.
+
+{{< media id="panels" >}}
+
+## Use the glossary for recurring context {#use-the-glossary-for-recurring-context}
+
+Define a term when its explanation will help more than one passage. Keep the definition understandable on its own; link related entries where useful.
+
+For example, a story about a khipu may need a short explanation of the term and a panel about the particular activity shown in one photograph. These serve different purposes.
+
+The link syntax is `[[term-id]]`, or `[[term-id|visible text]]` when the sentence needs different wording. The Compositor also provides an insertion control.
+
+## Review optional routes {#review-optional-routes}
+
+Open each panel and glossary link in the order a reader would encounter them. Check that the title, button and first paragraph agree. Make it clear which source supports a claim and where a comparison comes from.
+
+**Your result:** short answers, purposeful panel outlines and a list of shared terms. Next, [arrange the exhibition as a whole](/docs/plan/exhibition-layout/).
diff --git a/content/en/docs/plan/review.md b/content/en/docs/plan/review.md
new file mode 100644
index 0000000..029ca3e
--- /dev/null
+++ b/content/en/docs/plan/review.md
@@ -0,0 +1,43 @@
+---
+title: Test the exhibition with readers
+url: /docs/plan/review/
+translationKey: docs-plan-review
+type: guide
+docs_draft: true
+docs_section: planning
+---
+
+# Test the exhibition with readers {#test-the-exhibition-with-readers}
+
+A successful build shows that the site was generated. A reader test shows whether the exhibition makes sense to someone encountering it for the first time. Do both before sharing it widely.
+
+## Rehearse the main route {#rehearse-the-main-route}
+
+Start at the homepage without using your editor bookmarks. Choose a story, follow every step and reach the ending.
+
+Check that each source appears at the intended page, framing or time segment. Read the question and answer against that view. Open all panels and glossary links, then return to the story.
+
+## Ask someone to try it {#ask-someone-to-try-it}
+
+Give a reader a small task: find the first story, explain what changed between two views, or locate the source behind a claim. Observe before explaining the interface.
+
+Ask what they noticed, what they understood and where they lost the thread. Separate an interface problem from an interpretation that needs rewriting. Revise, then try the changed passage again.
+
+## Test other ways of reading {#test-other-ways-of-reading}
+
+- Use a narrow window and a phone if one is available.
+- Navigate with the keyboard and check that links and controls have a visible focus.
+- Read alternative text and transcripts alongside the visual and audio material.
+- Check text size, contrast and button wording.
+- Follow external source links and verify credits.
+- Check the interface language and any text the site supplies automatically.
+
+If a source fails, test its catalogue page and manifest independently. If the framing is wrong, return to that step and capture or copy the intended view again.
+
+## Prepare the version you will share {#prepare-the-version-you-will-share}
+
+Remove unfinished material from the publication route. In the Compositor, a draft is excluded from publication; making a story private is a different choice and uses a key. Verify the published result, not only the editor.
+
+Record the public address, the date tested and any known limitations. Keep the source files and a short note explaining how to rebuild the exhibition.
+
+**Your result:** a tested first edition and a short list of improvements for the next one. Choose the [Compositor](/docs/the-compositor/), [Google Sheets](/docs/google-sheets/) or [local authoring](/docs/local-authoring/) manual for the build process.
diff --git a/content/en/docs/plan/sources-and-framing.md b/content/en/docs/plan/sources-and-framing.md
new file mode 100644
index 0000000..49f21bf
--- /dev/null
+++ b/content/en/docs/plan/sources-and-framing.md
@@ -0,0 +1,42 @@
+---
+title: Choose sources and framing
+url: /docs/plan/sources-and-framing/
+translationKey: docs-plan-sources-and-framing
+type: guide
+docs_draft: true
+docs_section: planning
+---
+
+# Choose sources and framing {#choose-sources-and-framing}
+
+Choose a view because it helps visitors examine the question in that step. A closer view is useful when it reveals evidence; an overview is useful when the relationship between details matters.
+
+## Keep a source register {#keep-a-source-register}
+
+For each object, record its title, creator when known, date or period, holding institution, catalogue address and credit. Keep the IIIF manifest address separately from the catalogue page: the former supplies the image; the latter gives readers its context.
+
+Note what you can publish and any uncertainties in attribution or interpretation. For your own material, keep the original file as well as the copy prepared for the exhibition.
+
+## Pair each step with a view {#pair-each-step-with-a-view}
+
+Add three notes to each question in your plan:
+
+1. Which object, page or time segment will visitors see?
+2. Which detail should they notice?
+3. What does the short answer help them understand about it?
+
+You can return to the same object several times. Changing the framing can build an argument without introducing a new source at every step. Use a wider view when moving between distant details so visitors can understand their relationship.
+
+## Plan images, documents and recordings {#plan-images-documents-and-recordings}
+
+For a multi-page document, choose the page before choosing the framing. For video or audio, identify a segment and write down the proposed start and end. Check whether the segment needs a transcript or other explanation.
+
+The [khipu walkthrough](/docs/the-compositor/iiif-to-story/) demonstrates the full image workflow: add the manifest, select that khipu in a story step, frame the khipu and capture the position. The source shown in the framing step must match the object you added.
+
+## Write the description alongside the interpretation {#write-the-description-alongside-the-interpretation}
+
+Describe the relevant visible or audible details in the step's alternative text or accompanying prose. Do not rely on “look here” or colour alone to identify the evidence.
+
+Test the view at a smaller window size. A tiny label that you can read on your own monitor may need a closer view, a transcription or an explanation in text.
+
+**Your result:** a source register and a proposed view or segment for every step. Next, [decide what belongs in panels and the glossary](/docs/plan/layers-and-glossary/).
diff --git a/content/en/docs/reference/_index.md b/content/en/docs/reference/_index.md
new file mode 100644
index 0000000..726fbc4
--- /dev/null
+++ b/content/en/docs/reference/_index.md
@@ -0,0 +1,9 @@
+---
+title: Reference
+url: /docs/reference/
+translationKey: docs-reference
+type: guide
+docs_section: reference
+---
+
+{{< section-overview >}}
diff --git a/content/en/docs/reference/config-generator.md b/content/en/docs/reference/config-generator.md
new file mode 100644
index 0000000..557fb1f
--- /dev/null
+++ b/content/en/docs/reference/config-generator.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/reference/config-generator/
+translationKey: redirects-en-ref-config-generator-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/configure/config-generator/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/reference/config-validator.md b/content/en/docs/reference/config-validator.md
new file mode 100644
index 0000000..729dacc
--- /dev/null
+++ b/content/en/docs/reference/config-validator.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/reference/config-validator/
+translationKey: redirects-en-ref-config-validator-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/configure/config-validator/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/reference/configuration.md b/content/en/docs/reference/configuration.md
new file mode 100644
index 0000000..82d1512
--- /dev/null
+++ b/content/en/docs/reference/configuration.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/reference/configuration/
+translationKey: redirects-en-ref-configuration-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/configure/configuration/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/reference/csv-project-objects.md b/content/en/docs/reference/csv-project-objects.md
new file mode 100644
index 0000000..9698b96
--- /dev/null
+++ b/content/en/docs/reference/csv-project-objects.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/reference/csv-project-objects/
+translationKey: redirects-en-ref-csv-project-objects-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/your-data/csv-project/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/reference/csv-stories-glossary.md b/content/en/docs/reference/csv-stories-glossary.md
new file mode 100644
index 0000000..7a9bce0
--- /dev/null
+++ b/content/en/docs/reference/csv-stories-glossary.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/reference/csv-stories-glossary/
+translationKey: redirects-en-ref-csv-stories-glossary-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/your-data/csv-stories/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/reference/markdown-syntax.md b/content/en/docs/reference/markdown-syntax.md
new file mode 100644
index 0000000..d745a57
--- /dev/null
+++ b/content/en/docs/reference/markdown-syntax.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/reference/markdown-syntax/
+translationKey: redirects-en-ref-markdown-syntax-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/your-content/markdown-syntax/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/docs/2-0-setup.md b/content/en/docs/setup/_index.md
similarity index 64%
rename from docs/2-0-setup.md
rename to content/en/docs/setup/_index.md
index 5af4126..066b523 100644
--- a/docs/2-0-setup.md
+++ b/content/en/docs/setup/_index.md
@@ -1,25 +1,23 @@
---
-layout: docs
-title: 2. Set Up Your Site
-parent: Documentation
-nav_order: 2
-has_children: true
-lang: en
-permalink: /docs/setup/
+title: Set Up Your Site
+url: /docs/setup/
+translationKey: docs-setup
+type: guide
+docs_section: reference
---
-# Set Up Your Site
+# Set Up Your Site {#set-up-your-site}
Looking for setup instructions? Head to **[Getting Started](/docs/getting-started/)** to choose between the Compositor, Google Sheets, or local development.
This section covers manual configuration and maintenance for existing sites.
-### Manual Setup
+### Manual Setup {#manual-setup}
The step-by-step manual approach for users already comfortable with GitHub and YAML. Build a complete exhibition in your browser with no software to install.
-[Manual Setup](/docs/setup/manual/){: .btn .btn-primary }
+<a href="/docs/setup/manual/" class="btn btn-primary">Manual Setup</a>
-## Maintenance
+## Maintenance {#maintenance}
- [Upgrading Telar](/docs/setup/upgrading/) — Keep your site up to date with the latest features
diff --git a/content/en/docs/setup/local-dev.md b/content/en/docs/setup/local-dev.md
new file mode 100644
index 0000000..778c78e
--- /dev/null
+++ b/content/en/docs/setup/local-dev.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/setup/local-dev/
+translationKey: redirects-en-setup-local-dev-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/getting-started/local-dev/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/docs/2-1-manual-setup.md b/content/en/docs/setup/manual.md
similarity index 68%
rename from docs/2-1-manual-setup.md
rename to content/en/docs/setup/manual.md
index 07e060f..cd62380 100644
--- a/docs/2-1-manual-setup.md
+++ b/content/en/docs/setup/manual.md
@@ -1,14 +1,12 @@
---
-layout: docs
-title: 2.1. Manual Setup
-parent: 2. Set Up Your Site
-grand_parent: Documentation
-nav_order: 1
-lang: en
-permalink: /docs/setup/manual/
+title: Manual Setup
+url: /docs/setup/manual/
+translationKey: docs-setup-manual
+type: guide
+docs_section: sheets
---
-# Manual Setup
+# Manual Setup {#manual-setup}
Build a complete Telar exhibition in your browser using GitHub and Google Sheets. No software to install.
@@ -18,11 +16,11 @@ You will need:
---
-## Part 1: Set Up All the Technical Bits
+## Part 1: Set Up All the Technical Bits {#part-1-set-up-all-the-technical-bits}
This part might feel daunting, but you only have to do it once. Once everything is set up, you won't need to come back here — everything else is creative work in your spreadsheet.
-### Create Your Repository
+### Create Your Repository {#create-your-repository}
A repository is your project's home on GitHub — it holds your images and configuration files.
@@ -34,7 +32,7 @@ A repository is your project's home on GitHub — it holds your images and confi
-### Enable GitHub Pages
+### Enable GitHub Pages {#enable-github-pages}
GitHub Pages turns your repository into a live website for free.
@@ -44,7 +42,7 @@ GitHub Pages turns your repository into a live website for free.
-### Duplicate the Google Sheets Template
+### Duplicate the Google Sheets Template {#duplicate-the-google-sheets-template}
Your Google Sheets spreadsheet is where you manage all your content — objects, stories, and text.
@@ -52,7 +50,7 @@ Your Google Sheets spreadsheet is where you manage all your content — objects,
2. Click **File** → **Make a copy**
3. Save to your Google Drive with a descriptive name (e.g., "My Telar Exhibition")
-### Publish Your Sheet
+### Publish Your Sheet {#publish-your-sheet}
Your spreadsheet needs to be published so Telar can read it during builds.
@@ -60,10 +58,11 @@ Your spreadsheet needs to be published so Telar can read it during builds.
2. Click **Publish**
3. Copy the published URL
-{: .note }
-> **Simplified in v0.9.0.** Previous versions required both a shared URL and a published URL. From v0.9.0, only the published URL is needed. If your `_config.yml` still has a `shared_url` line, it is safely ignored.
+{{< callout "note" >}}
+**Simplified in v0.9.0.** Previous versions required both a shared URL and a published URL. From v0.9.0, only the published URL is needed. If your `_config.yml` still has a `shared_url` line, it is safely ignored.
+{{< /callout >}}
-### Configure Your Site
+### Configure Your Site {#configure-your-site}
Edit the `_config.yml` file in your repository to connect everything:
@@ -86,7 +85,7 @@ Edit the `_config.yml` file in your repository to connect everything:
Your site will be available at `https://yourgithubusername.github.io/your-repository-name`.
- {: .warning }
+{.warning}
> It is very important that your baseurl matches the name of your repository exactly. Baseurl must be in all lowercase, so if you gave your repository a name with capitals please go and change it now.
4. **Google Sheets** — paste in the published URL you copied:
@@ -108,7 +107,7 @@ Edit the `_config.yml` file in your repository to connect everything:
-### Verify Your Setup
+### Verify Your Setup {#verify-your-setup}
After committing, GitHub Actions will automatically build and publish your site. This takes 2–5 minutes.
@@ -118,19 +117,20 @@ After committing, GitHub Actions will automatically build and publish your site.
-{: .warning }
-> If the build fails or your site doesn't look right, double-check your `_config.yml` carefully. Common mistakes:
-> - **Unclosed quotes** — every `"` needs a matching `"`
-> - **Missing space after colon** — write `title: "My Site"`, not `title:"My Site"`
-> - **Wrong indentation** — nested settings like `published_url` must be indented with spaces, not tabs
-> - **Mismatched baseurl** — must match your repository name exactly, in all lowercase
-> - **Wrong Google Sheets URL** — make sure you use the published URL from File → Share → Publish to web
->
-> See the [Configuration Reference](/docs/configure/configuration/) for the full list of settings. You can also paste your `_config.yml` into the [Telar Config Validator](/docs/configure/config-validator/) to check for errors, or use the [Config Generator and Editor](/docs/configure/config-generator/) to build one from scratch.
+{{< callout "warning" >}}
+If the build fails or your site doesn't look right, double-check your `_config.yml` carefully. Common mistakes:
+- **Unclosed quotes** — every `"` needs a matching `"`
+- **Missing space after colon** — write `title: "My Site"`, not `title:"My Site"`
+- **Wrong indentation** — nested settings like `published_url` must be indented with spaces, not tabs
+- **Mismatched baseurl** — must match your repository name exactly, in all lowercase
+- **Wrong Google Sheets URL** — make sure you use the published URL from File → Share → Publish to web
+See the [Configuration Reference](/docs/configure/configuration/) for the full list of settings. You can also paste your `_config.yml` into the [Telar Config Validator](/docs/configure/config-validator/) to check for errors, or use the [Config Generator and Editor](/docs/configure/config-generator/) to build one from scratch.
+{{< /callout >}}
-## Next Steps
+
+## Next Steps {#next-steps}
Your site is configured and running. Continue with the Getting Started tutorial:
diff --git a/docs/2-3-upgrading.md b/content/en/docs/setup/upgrading.md
similarity index 83%
rename from docs/2-3-upgrading.md
rename to content/en/docs/setup/upgrading.md
index be898b5..b20e9e3 100644
--- a/docs/2-3-upgrading.md
+++ b/content/en/docs/setup/upgrading.md
@@ -1,32 +1,31 @@
---
-layout: docs
-title: 2.3. Upgrading Telar
-parent: 2. Set Up Your Site
-grand_parent: Documentation
-nav_order: 3
-lang: en
-permalink: /docs/setup/upgrading/
+title: Upgrading Telar
+url: /docs/setup/upgrading/
+translationKey: docs-setup-upgrading
+type: guide
+docs_section: reference
---
-# Upgrading Telar
+# Upgrading Telar {#upgrading-telar}
Keep your Telar site up to date with the latest features, bug fixes, and improvements.
-{: .note }
-> **Using the Telar Compositor?** If you manage your site through the [Telar Compositor](https://compositor.telar.org), you can upgrade with one click from its Upgrade screen — the manual steps below aren't needed. If it asks you to approve updated GitHub permissions first, accept them and retry. The instructions below are for upgrading directly on GitHub instead.
+{{< callout "note" >}}
+**Using the Telar Compositor?** If you manage your site through the [Telar Compositor](https://compositor.telar.org), you can upgrade with one click from its Upgrade screen — the manual steps below aren't needed. If it asks you to approve updated GitHub permissions first, accept them and retry. The instructions below are for upgrading directly on GitHub instead.
+{{< /callout >}}
-## Overview
+## Overview {#overview}
Telar v0.3.4 introduced an automated upgrade system that makes updating your site simple and safe. The upgrade process depends on which version you're currently running:
- **v0.3.4 or later**: Use the automated upgrade workflow (one-click upgrades)
- **v0.2.0 to v0.3.3**: Manual setup required first (one-time only)
-## Automated Upgrades (v0.3.4+)
+## Automated Upgrades (v0.3.4+) {#automated-upgrades-v034}
If your site is already running Telar v0.3.4 or later, upgrading is fully automated.
-### How It Works
+### How It Works {#how-it-works}
The upgrade system:
1. Detects your current Telar version from `_config.yml`
@@ -35,10 +34,11 @@ The upgrade system:
4. Creates an upgrade branch and issue with detailed summary
5. Highlights any manual steps you need to complete
-### Running an Automated Upgrade
+### Running an Automated Upgrade {#running-an-automated-upgrade}
-{: .note }
-> **Forked repositories only**: If you forked your site from another repository, you'll need to enable issues in your repository settings (**Settings** → **General** → check **Issues**). Sites created using the "Use this template" button already have issues enabled.
+{{< callout "note" >}}
+**Forked repositories only**: If you forked your site from another repository, you'll need to enable issues in your repository settings (**Settings** → **General** → check **Issues**). Sites created using the "Use this template" button already have issues enabled.
+{{< /callout >}}
1. Go to your repository on GitHub
2. Click the **Actions** tab
@@ -50,11 +50,12 @@ The upgrade system:
8. Click the link in the issue to create a pull request
9. Review changes and merge the pull request to complete the upgrade
-{: .note }
-> **Safe and Reversible**
-> The upgrade creates an issue and branch, giving you full control. Review the changes via the compare link, create a PR when ready, and merge only after verification.
+{{< callout "note" >}}
+**Safe and Reversible**
+The upgrade creates an issue and branch, giving you full control. Review the changes via the compare link, create a PR when ready, and merge only after verification.
+{{< /callout >}}
-### After Upgrading
+### After Upgrading {#after-upgrading}
1. Visit your site to verify it's working correctly
2. **Check the upgrade issue** for any manual steps (visible in the "After Merging" section)
@@ -62,13 +63,13 @@ The upgrade system:
4. **Close the upgrade issue** once everything is working - this marks the upgrade as complete
5. If you encounter issues, check the [GitHub Issues](https://github.com/UCSB-AMPLab/telar/issues) or report a bug
-### v1.8.3 Upgrade Notes
+### v1.8.3 Upgrade Notes {#v183-upgrade-notes}
**Upgrade with the "Upgrade Telar" workflow or through the Telar Compositor.** It takes a site from v1.8.2 to v1.8.3, and chains through from earlier versions. No manual steps: only the Telar files that changed are installed, and your site's content and settings are left as they are.
The upgrade installs a `Gemfile.lock` that includes the `x86_64-linux` platform. If your site's build has been failing on GitHub's Ubuntu 26.04 runners while installing `google-protobuf`, the first build after the upgrade installs prebuilt gems and succeeds.
-### v1.8.2 Upgrade Notes
+### v1.8.2 Upgrade Notes {#v182-upgrade-notes}
**Upgrade with the "Upgrade Telar" workflow or through the Telar Compositor.** It takes a site from v1.8.1 to v1.8.2, and chains through from earlier versions.
@@ -78,13 +79,13 @@ On sites that upgrade with `scripts/upgrade.py`, the upgrade also deletes the ol
If you upgrade with the workflow or from your own computer, you can delete `.github/workflows/telar-tests.yml`. It runs Telar's own tests, which are always skipped on your site. An upgrade through the Compositor deletes it for you.
-### v1.8.1 Upgrade Notes
+### v1.8.1 Upgrade Notes {#v181-upgrade-notes}
**Upgrade with the "Upgrade Telar" workflow or through the Telar Compositor.** It takes a site from v1.8.0 to v1.8.1, and chains through from earlier versions. No manual steps: only the Telar files that changed are installed, and your site's content and settings are left as they are.
The upgrade does not add the new [`hide_warnings`](/docs/configure/configuration/#hide_warnings) setting to `_config.yml`, so your site keeps showing warnings as before. To hide them, add `hide_warnings: true` to the `development-features` block.
-### v1.8.0 Upgrade Notes
+### v1.8.0 Upgrade Notes {#v180-upgrade-notes}
**Upgrade with the "Upgrade Telar" workflow.** It takes a site from v1.7.0 to v1.8.0, and chains through from earlier versions. Before your first build, the upgrade repairs a sheet whose duplicate columns would now stop the build (one column holds the values, the others are empty) and lists the answers the build will shorten.
@@ -94,7 +95,7 @@ The upgrade does not add the new [`hide_warnings`](/docs/configure/configuration
**If your site reads a Google Sheet**, delete from the sheet any column the upgrade summary names: the upgrade fixed your local copy, but the build reads the sheet again.
-### v1.7.0 Upgrade Notes
+### v1.7.0 Upgrade Notes {#v170-upgrade-notes}
**Upgrading on GitHub is unchanged.** If you use the **Upgrade Telar** workflow, run it as usual — there is nothing new to do.
@@ -109,7 +110,7 @@ The upgrade does not add the new [`hide_warnings`](/docs/configure/configuration
After either, your site's `scripts/upgrade.py` is the new launcher and no manual step is needed again.
-### v1.6.0 Upgrade Notes
+### v1.6.0 Upgrade Notes {#v160-upgrade-notes}
v1.6.0 changes how private stories are built. Existing stories, objects, and general configuration
continue to work unchanged — but **if your site has any story marked `private: yes` (or
@@ -135,14 +136,15 @@ has (or might ever have) a private story, you must add the new encryption step t
4. Select all and replace with the copied contents
5. Commit the change
-{: .warning }
-> If you skip this step and mark a story `private: yes`, your build will fail at the "Convert CSVs
-> to JSON" step with an error telling you the workflow doesn't run the encryption script. This is
-> intentional — without the new step, your site would otherwise publish the "private" story as
-> plaintext.
->
-> If your site has no private stories, nothing breaks if you skip this step — but you won't be
-> able to add one later without applying this update first.
+{{< callout "warning" >}}
+If you skip this step and mark a story `private: yes`, your build will fail at the "Convert CSVs
+to JSON" step with an error telling you the workflow doesn't run the encryption script. This is
+intentional — without the new step, your site would otherwise publish the "private" story as
+plaintext.
+
+If your site has no private stories, nothing breaks if you skip this step — but you won't be
+able to add one later without applying this update first.
+{{< /callout >}}
**Testing locally:** neither `bundle exec jekyll serve` nor `scripts/build_local_site.py`'s default
serve mode encrypts anything — private stories preview as plaintext under both. To test the
@@ -156,7 +158,7 @@ The automated upgrade handles all other framework file replacements. If you have
any private story, you must still copy the updated `build.yml` as described above — this one is
not optional.
-### v1.5.0 Upgrade Notes
+### v1.5.0 Upgrade Notes {#v150-upgrade-notes}
v1.5.0 is a robustness and security release. It is runtime and tooling only — existing stories, objects, and configuration continue to work unchanged, with no CSV edits and no config changes. The automated upgrade handles all framework file replacements; two optional manual steps are described below.
@@ -171,8 +173,9 @@ For security, GitHub does not allow the automated upgrade to modify workflow fil
To apply them, use the copy-from-Raw steps in the "Manual Setup for Earlier Versions" section below, once for each file. If you skip this, your site keeps building and deploying normally — these changes only harden your workflows.
-{: .warning }
-> **If you update `build.yml`, also add `package-lock.json`.** The new `build.yml` installs Node dependencies with `npm ci`, which requires a committed `package-lock.json`. Copy it from the Telar repository (open [package-lock.json](https://github.com/UCSB-AMPLab/telar/blob/main/package-lock.json), click **Copy raw contents**) into your repository's root, or the build will fail. New sites created from the template already include it.
+{{< callout "warning" >}}
+**If you update `build.yml`, also add `package-lock.json`.** The new `build.yml` installs Node dependencies with `npm ci`, which requires a committed `package-lock.json`. Copy it from the Telar repository (open [package-lock.json](https://github.com/UCSB-AMPLab/telar/blob/main/package-lock.json), click **Copy raw contents**) into your repository's root, or the build will fail. New sites created from the template already include it.
+{{< /callout >}}
**Language pack — new protected-story sharing keys:**
@@ -182,7 +185,7 @@ This release adds keys to the built-in language files (`en.yml` and `es.yml`) fo
The automated upgrade handles all framework file replacements. The workflow updates above are optional hardening; if you apply the `build.yml` update, remember the `package-lock.json` note.
-### v1.4.0 Upgrade Notes
+### v1.4.0 Upgrade Notes {#v140-upgrade-notes}
v1.4.0 is a runtime-only upgrade. Existing stories, objects, and configuration continue to work unchanged — no CSV edits, no config changes, and no workflow updates are required.
@@ -200,7 +203,7 @@ If you have a customized language file (a copy of `en.yml` or `es.yml` with your
No manual steps are required. The upgrade handles all file replacements automatically.
-### v1.3.0 Upgrade Notes
+### v1.3.0 Upgrade Notes {#v130-upgrade-notes}
v1.3.0 fixes i18n coverage across the site and introduces a sister-file convention for localizing user pages. No CSV changes are required.
@@ -216,13 +219,13 @@ Two new keys are added to the built-in language files. If you have a customized
No manual steps are required beyond reviewing the automatically created upgrade issue for any files flagged as not matching the default (meaning your customizations were detected and preserved).
-### v1.2.1 Upgrade Notes
+### v1.2.1 Upgrade Notes {#v121-upgrade-notes}
v1.2.1 is a patch release. No manual steps are required.
The upgrade fixes a silent failure in the demo content fetch script that affected sites whose `_config.yml` carried a v-prefixed version string (e.g. `version: "v1.2.0"`). If your site showed no demo content after a previous upgrade, this patch resolves it. No config edits are needed; the fix is in the build script.
-### v1.2.0 Upgrade Notes
+### v1.2.0 Upgrade Notes {#v120-upgrade-notes}
v1.2.0 adds a section table of contents, a Back to Start button, and in-story navigation. No manual steps are required.
@@ -232,7 +235,7 @@ All new features activate automatically. The section TOC is opt-in per story: ad
No action required.
-### v1.1.0 Upgrade Notes
+### v1.1.0 Upgrade Notes {#v110-upgrade-notes}
v1.1.0 adds deep linking, title cards, collection mode, bibliography styling, and a share panel position tab. No manual steps are required.
@@ -242,7 +245,7 @@ Deep linking and the updated share panel activate automatically. Collection mode
No action required.
-### v1.0.0-beta Upgrade Notes
+### v1.0.0-beta Upgrade Notes {#v100-beta-upgrade-notes}
v1.0.0-beta adds multimedia support (video and audio objects), an updated build pipeline, and renames the `object_type` CSV column to `medium`.
@@ -276,7 +279,7 @@ The `object_type` column in `objects.csv` has been renamed to `medium`. This cha
**If you only use GitHub's web interface:**
- Copy the updated `build.yml` as described above. No other manual steps are required.
-### v0.7.0 Upgrade Notes
+### v0.7.0 Upgrade Notes {#v070-upgrade-notes}
v0.7.0 adds Node.js as a requirement for local development builds:
@@ -293,15 +296,15 @@ v0.7.0 adds Node.js as a requirement for local development builds:
**If you only use GitHub's web interface:**
- No action required — your site will continue to build automatically
-## Manual Setup for Earlier Versions
+## Manual Setup for Earlier Versions {#manual-setup-for-earlier-versions}
If your site is running **v0.2.0 through v0.3.3**, you'll need to add the upgrade workflow files to your repository first. This is a **one-time setup**—after this, all future upgrades will be automated.
-### Step 1: Add the Upgrade Workflow File
+### Step 1: Add the Upgrade Workflow File {#step-1-add-the-upgrade-workflow-file}
You need to add **two files** to enable automated upgrades: the upgrade workflow and the updated build workflow. The upgrade workflow will automatically fetch all necessary scripts when it runs.
-#### Method A: GitHub Web Interface (Recommended)
+#### Method A: GitHub Web Interface (Recommended) {#method-a-github-web-interface-recommended}
Work entirely in the browser without installing anything:
@@ -318,7 +321,7 @@ Work entirely in the browser without installing anything:
- Add commit message: "Add automated upgrade workflow"
- Click **Commit changes**
-#### Method B: Desktop/Local Development
+#### Method B: Desktop/Local Development {#method-b-desktoplocal-development}
If you have your repository cloned locally:
@@ -334,14 +337,15 @@ If you have your repository cloned locally:
git push
```
-{: .note }
-> **That's it!** The workflow automatically downloads the latest upgrade scripts from the Telar repository each time it runs, so you don't need to copy any Python files manually.
+{{< callout "note" >}}
+**That's it!** The workflow automatically downloads the latest upgrade scripts from the Telar repository each time it runs, so you don't need to copy any Python files manually.
+{{< /callout >}}
-### Step 2: Replace the Build Workflow File
+### Step 2: Replace the Build Workflow File {#step-2-replace-the-build-workflow-file}
If you're upgrading from **v0.2.0 through v0.3.3**, you also need to replace your `.github/workflows/build.yml` file with the latest version. This removes deprecated features (cron schedule and git push step) that are no longer needed in v0.3.4+.
-#### Method A: GitHub Web Interface (Recommended)
+#### Method A: GitHub Web Interface (Recommended) {#method-a-github-web-interface-recommended-1}
Work entirely in the browser:
@@ -359,7 +363,7 @@ Work entirely in the browser:
- Add commit message: "Update build workflow to v0.3.4"
- Click **Commit changes**
-#### Method B: Desktop/Local Development
+#### Method B: Desktop/Local Development {#method-b-desktoplocal-development-1}
If you have your repository cloned locally:
@@ -375,10 +379,11 @@ If you have your repository cloned locally:
git push
```
-{: .note }
-> **Optional Step**: If you skip this step now, the upgrade summary will include instructions to update build.yml manually after your first upgrade. However, doing it now ensures a smoother upgrade experience.
+{{< callout "note" >}}
+**Optional Step**: If you skip this step now, the upgrade summary will include instructions to update build.yml manually after your first upgrade. However, doing it now ensures a smoother upgrade experience.
+{{< /callout >}}
-### Step 3: Run Your First Automated Upgrade
+### Step 3: Run Your First Automated Upgrade {#step-3-run-your-first-automated-upgrade}
That's all the setup needed! Now follow the [Automated Upgrades](#automated-upgrades-v034) instructions above to upgrade to the latest version.
@@ -388,9 +393,9 @@ The workflow will automatically:
3. Apply all necessary migrations
4. Create a pull request with the upgraded files
-## Troubleshooting
+## Troubleshooting {#troubleshooting}
-### Upgrade Workflow Not Appearing
+### Upgrade Workflow Not Appearing {#upgrade-workflow-not-appearing}
**Problem**: The "Upgrade Telar" workflow doesn't appear in the Actions tab.
@@ -399,7 +404,7 @@ The workflow will automatically:
- Refresh the Actions tab in your browser
- Check that the YAML file is valid (no syntax errors)
-### Upgrade Fails with Error
+### Upgrade Fails with Error {#upgrade-fails-with-error}
**Problem**: The upgrade workflow fails with an error message.
@@ -409,7 +414,7 @@ The workflow will automatically:
- The workflow downloads scripts automatically, so network issues could cause failures
- If the error persists, [report an issue](https://github.com/UCSB-AMPLab/telar/issues) with the error message
-### Issue Not Created
+### Issue Not Created {#issue-not-created}
**Problem**: The upgrade completes but no issue is created.
@@ -419,7 +424,7 @@ The workflow will automatically:
- Check that issues are enabled in your repository settings
- Try running the workflow again
-### Merge Conflicts
+### Merge Conflicts {#merge-conflicts}
**Problem**: The upgrade PR has merge conflicts.
@@ -429,12 +434,12 @@ The workflow will automatically:
- If conflicts are in framework files, the upgrade version should usually be preferred
- If unsure, [ask for help](https://github.com/UCSB-AMPLab/telar/issues)
-## Version History
+## Version History {#version-history}
For a complete list of changes in each version, see the [Changelog](https://github.com/UCSB-AMPLab/telar/blob/main/CHANGELOG.md) in the Telar repository.
-## Need Help?
+## Need Help? {#need-help}
- **Documentation**: [telar.org/docs](https://telar.org/docs)
-- **Example Site**: [telar.org/demo](https://telar.org/demo)
+- **Example Site**: [telar.org/demo](https://landscapes.telar.org/)
- **Report Issues**: [GitHub Issues](https://github.com/UCSB-AMPLab/telar/issues)
diff --git a/docs/6-0-site-features.md b/content/en/docs/site-features/_index.md
similarity index 84%
rename from docs/6-0-site-features.md
rename to content/en/docs/site-features/_index.md
index 20068e6..7cbcd94 100644
--- a/docs/6-0-site-features.md
+++ b/content/en/docs/site-features/_index.md
@@ -1,14 +1,12 @@
---
-layout: docs
-title: 6. Site Features
-parent: Documentation
-nav_order: 6
-lang: en
-permalink: /docs/site-features/
-has_children: true
+title: Site Features
+url: /docs/site-features/
+translationKey: docs-site-features
+type: guide
+docs_section: reference
---
-# Site Features
+# Site Features {#site-features}
Telar includes several built-in features that enhance your exhibition beyond the core story experience.
diff --git a/docs/6-4-custom-pages.md b/content/en/docs/site-features/custom-pages.md
similarity index 83%
rename from docs/6-4-custom-pages.md
rename to content/en/docs/site-features/custom-pages.md
index fb6b152..ca84a02 100644
--- a/docs/6-4-custom-pages.md
+++ b/content/en/docs/site-features/custom-pages.md
@@ -1,18 +1,19 @@
---
-layout: docs
-title: "6.4. Custom Pages"
-parent: "6. Site Features"
-grand_parent: Documentation
-nav_order: 4
-lang: en
-permalink: /docs/site-features/custom-pages/
+title: Custom Pages
+url: /docs/site-features/custom-pages/
+translationKey: docs-site-features-custom-pages
+type: guide
+docs_section: reference
---
-# Custom Pages
+# Custom Pages {#custom-pages}
Create custom pages for credits, methodology, team information, or any other content that doesn't fit into the story structure.
-## What are Custom Pages?
+
+For visual authoring, see [homepage and pages](/docs/the-compositor/pages/).
+
+## What are Custom Pages? {#what-are-custom-pages}
Custom pages are standalone pages that appear in your site's navigation menu but aren't part of the story viewer. Unlike story layers, which are tightly integrated with IIIF objects and step navigation, custom pages are flexible containers for any content you want to share.
@@ -23,9 +24,9 @@ Custom pages are standalone pages that appear in your site's navigation menu but
- **Bibliography**: List sources and further reading
- **Contact**: Provide ways to get in touch
-## Creating a Custom Page
+## Creating a Custom Page {#creating-a-custom-page}
-### Step 1: Create the Markdown File
+### Step 1: Create the Markdown File {#step-1-create-the-markdown-file}
Add a new `.md` file in the `telar-content/texts/pages/` directory:
@@ -36,7 +37,7 @@ telar-content/texts/pages/
└── methodology.md # Your custom methodology page
```
-### Step 2: Write Your Content
+### Step 2: Write Your Content {#step-2-write-your-content}
Custom pages use standard markdown with full widget and glossary support:
@@ -70,25 +71,26 @@ This project was made possible by...
</details>
```
-{: .note }
-> The frontmatter (`---`) lines are required but can be empty. They tell Jekyll to process the file.
+{{< callout "note" >}}
+The frontmatter (`---`) lines are required but can be empty. They tell Jekyll to process the file.
+{{< /callout >}}
-### Step 3: Add to Navigation
+### Step 3: Add to Navigation {#step-3-add-to-navigation}
Update `_data/navigation.yml` to include your new page in the menu. See [Navigation Configuration](/docs/customization/navigation-menu/) for details.
-## Supported Features
+## Supported Features {#supported-features}
Custom pages support the same markdown features as story layers:
-### Markdown Formatting
+### Markdown Formatting {#markdown-formatting}
- **Headings** (h1-h6)
- **Bold**, *italic*, and other text formatting
- Lists (bulleted and numbered)
- Links and images
- Blockquotes
-### Widgets
+### Widgets {#widgets}
All Telar widgets work on custom pages:
- **Accordion**: Collapsible sections
@@ -97,7 +99,7 @@ All Telar widgets work on custom pages:
See [Markdown Syntax Reference](/docs/your-content/markdown-syntax/) for complete widget documentation.
-### Glossary Links
+### Glossary Links {#glossary-links}
Glossary auto-linking works the same way:
@@ -107,7 +109,7 @@ The [[encomienda]] system was a key institution...
When users click the link, the glossary panel opens with the definition.
-## Layout and Styling
+## Layout and Styling {#layout-and-styling}
Custom pages use the `user-page` layout, which provides:
@@ -118,7 +120,7 @@ Custom pages use the `user-page` layout, which provides:
Jekyll's conventional `layout: page` is also available if you add your own markdown files with front matter: a minimal centered prose column with the site header and footer, without widget processing or glossary integration.
-## File Naming
+## File Naming {#file-naming}
File names determine the page URL:
@@ -134,7 +136,7 @@ File names determine the page URL:
- Use hyphens for spaces (not underscores)
- Use descriptive names (the filename becomes the URL)
-## Example: Credits Page
+## Example: Credits Page {#example-credits-page}
Here's a complete example showing credits with an accordion for detailed acknowledgments:
@@ -187,7 +189,7 @@ We are grateful to the following individuals and institutions:
</div>
```
-## Differences from Story Layers
+## Differences from Story Layers {#differences-from-story-layers}
| Feature | Story Layers | Custom Pages |
|---------|--------------|--------------|
@@ -199,7 +201,7 @@ We are grateful to the following individuals and institutions:
| Navigation | Via story interface | Via site menu |
| URL structure | `/story-name/` | `/page-name/` |
-## Next Steps
+## Next Steps {#next-steps}
- Learn how to [configure navigation](/docs/customization/navigation-menu/) to add pages to your menu
- Explore [widget syntax](/docs/your-content/markdown-syntax/) for accordion, tabs, and carousels
diff --git a/docs/6-5-embedding.md b/content/en/docs/site-features/embedding.md
similarity index 75%
rename from docs/6-5-embedding.md
rename to content/en/docs/site-features/embedding.md
index 0ed8e41..1defb2a 100644
--- a/docs/6-5-embedding.md
+++ b/content/en/docs/site-features/embedding.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "6.5. Embedding in Canvas"
-parent: "6. Site Features"
-grand_parent: Documentation
-nav_order: 5
-lang: en
-permalink: /docs/site-features/embedding/
+title: Embedding Telar Stories in LMS & Websites
+url: /docs/site-features/embedding/
+translationKey: docs-site-features-embedding
+type: guide
+docs_section: reference
---
-# Embedding Telar Stories in LMS & Websites
+# Embedding Telar Stories in LMS & Websites {#embedding-telar-stories-in-lms--websites}
Embed individual Telar stories into Canvas, Moodle, WordPress, or any website that supports iframes.
-## What is Embedding?
+## What is Embedding? {#what-is-embedding}
Embedding lets you display a Telar story inside another website or learning management system (LMS). Your story appears as part of the host page, allowing students or visitors to explore it without leaving the platform.
@@ -22,7 +20,7 @@ Embedding lets you display a Telar story inside another website or learning mana
- Maintain consistent navigation and branding
- No separate login or external links required
-## When to Use Embedding
+## When to Use Embedding {#when-to-use-embedding}
**Best for:**
- Canvas LMS course modules
@@ -35,7 +33,7 @@ Embedding lets you display a Telar story inside another website or learning mana
- Sharing direct links (use the share link feature instead)
- Full-site integration (link to your Telar homepage)
-## Prerequisites
+## Prerequisites {#prerequisites}
Before embedding:
@@ -43,9 +41,9 @@ Before embedding:
- You need edit access to the destination platform (Canvas, WordPress, etc.)
- The platform must support HTML/iframe embedding
-## How to Embed a Story
+## How to Embed a Story {#how-to-embed-a-story}
-### Step 1: Open the Share & Embed Panel
+### Step 1: Open the Share & Embed Panel {#step-1-open-the-share--embed-panel}
**On a story page:**
@@ -59,12 +57,12 @@ Before embedding:
1. Go to your Telar site homepage
2. Click the **Share** button in the navigation bar (top right)
-### Step 2: Switch to Embed Code Tab
+### Step 2: Switch to Embed Code Tab {#step-2-switch-to-embed-code-tab}
1. In the share panel, click the **Embed Code** tab
2. Read the introductory text for platform-specific guidance
-### Step 3: Select a Story (Homepage Only)
+### Step 3: Select a Story (Homepage Only) {#step-3-select-a-story-homepage-only}
If you opened the share panel from the homepage:
@@ -72,11 +70,11 @@ If you opened the share panel from the homepage:
2. Choose the story you want to embed
3. The embed code will update automatically
-### Step 4: Choose Dimensions
+### Step 4: Choose Dimensions {#step-4-choose-dimensions}
Select a preset that matches your platform, or enter custom dimensions.
-#### Dimension Presets
+#### Dimension Presets {#dimension-presets}
| Preset | Width | Height | Best For |
|--------|-------|--------|----------|
@@ -89,11 +87,12 @@ Select a preset that matches your platform, or enter custom dimensions.
| **Fixed** | 800px | 600px | Fixed-size containers |
| **Custom** | Your choice | Your choice | Manual control |
-{: .tip }
-> **Tip: Start with the preset**
-> Use the preset for your platform, then adjust if needed. Most platforms work best with 100% width and 600-800px height.
+{{< callout "tip" >}}
+**Tip: Start with the preset**
+Use the preset for your platform, then adjust if needed. Most platforms work best with 100% width and 600-800px height.
+{{< /callout >}}
-#### Custom Dimensions
+#### Custom Dimensions {#custom-dimensions}
For the **Custom** preset or to modify a preset:
@@ -104,13 +103,14 @@ For the **Custom** preset or to modify a preset:
- Usually pixels: `600` or `600px`
- Percentage works but may behave unexpectedly in iframes
-{: .note }
-> **Understanding Width and Height**
-> - **Width: 100%** fills the available horizontal space (recommended for most uses)
-> - **Height: Fixed pixels** provides consistent display across devices
-> - The embed code will automatically add "px" to plain numbers
+{{< callout "note" >}}
+**Understanding Width and Height**
+- **Width: 100%** fills the available horizontal space (recommended for most uses)
+- **Height: Fixed pixels** provides consistent display across devices
+- The embed code will automatically add "px" to plain numbers
+{{< /callout >}}
-### Step 5: Copy the Embed Code
+### Step 5: Copy the Embed Code {#step-5-copy-the-embed-code}
1. Review the generated code in the text box
2. Click the **Copy Embed Code** button
@@ -127,12 +127,13 @@ The embed code looks like this:
</iframe>
```
-{: .tip }
-> To start an embedded story at a specific step, append a deep link fragment to the embed URL — for example, `?embed=true#s3` opens at step 3. See [Sharing and deep linking](/docs/your-content/stories-panels/#sharing-and-deep-linking) for the fragment format.
+{{< callout "tip" >}}
+To start an embedded story at a specific step, append a deep link fragment to the embed URL — for example, `?embed=true#s3` opens at step 3. See [Sharing and deep linking](/docs/your-content/stories-panels/#sharing-and-deep-linking) for the fragment format.
+{{< /callout >}}
-## Platform-Specific Instructions
+## Platform-Specific Instructions {#platform-specific-instructions}
-### Canvas LMS
+### Canvas LMS {#canvas-lms}
**To embed in a Canvas course page:**
@@ -145,9 +146,10 @@ The embed code looks like this:
7. Click **Save** or **Update**
8. View the page to see your embedded story
-{: .note }
-> **Canvas Embed Confirmation**
-> Canvas may show a blank box in the editor. This is normal—the story will display correctly when you view the published page.
+{{< callout "note" >}}
+**Canvas Embed Confirmation**
+Canvas may show a blank box in the editor. This is normal—the story will display correctly when you view the published page.
+{{< /callout >}}
**Testing your embed:**
@@ -157,7 +159,7 @@ The embed code looks like this:
4. Ensure the IIIF image viewer works
5. Check that the "View full site" banner appears (it's dismissible)
-### WordPress
+### WordPress {#wordpress}
**To embed in a WordPress post or page:**
@@ -176,7 +178,7 @@ The Custom HTML block is the recommended approach. Do not use the "Embed" block
**Classic Editor:**
Switch to the **Text** tab (not Visual), paste the code, then switch back to **Visual** to see a preview.
-### Moodle
+### Moodle {#moodle}
**To embed in a Moodle course:**
@@ -189,7 +191,7 @@ Switch to the **Text** tab (not Visual), paste the code, then switch back to **V
Alternatively, use the **Page** resource type and paste the embed code in HTML mode.
-### Other Platforms
+### Other Platforms {#other-platforms}
Most website builders and CMS platforms support iframe embedding:
@@ -200,9 +202,9 @@ Most website builders and CMS platforms support iframe embedding:
Consult your platform's documentation for instructions on adding custom HTML or iframes.
-## What Users Will See
+## What Users Will See {#what-users-will-see}
-### Embed Mode Features
+### Embed Mode Features {#embed-mode-features}
When a story is embedded, users experience:
@@ -228,7 +230,7 @@ When a story is embedded, users experience:
- Home button (not shown in embed mode)
- Share button (not shown in embed mode)
-### Accessibility
+### Accessibility {#accessibility}
Embedded stories maintain full accessibility:
@@ -237,9 +239,9 @@ Embedded stories maintain full accessibility:
- Screen reader compatible
- Text content remains accessible
-## Tips for Successful Embedding
+## Tips for Successful Embedding {#tips-for-successful-embedding}
-### Choose Appropriate Dimensions
+### Choose Appropriate Dimensions {#choose-appropriate-dimensions}
**For LMS platforms (Canvas, Moodle):**
- Use 100% width to fill the content area
@@ -256,7 +258,7 @@ Embedded stories maintain full accessibility:
- Or use 100% width with 500-600px height
- Test on actual mobile devices
-### Test Before Publishing
+### Test Before Publishing {#test-before-publishing}
1. Preview the embedded story before making it public
2. Test navigation (buttons, keyboard, scroll)
@@ -264,7 +266,7 @@ Embedded stories maintain full accessibility:
4. Check on mobile devices and tablets
5. Ensure the embedded story doesn't break page layout
-### Multiple Stories on One Page
+### Multiple Stories on One Page {#multiple-stories-on-one-page}
You can embed multiple stories on a single page:
@@ -273,7 +275,7 @@ You can embed multiple stories on a single page:
3. Add text or headings between embedded stories
4. Consider page length and loading time
-### Security Considerations
+### Security Considerations {#security-considerations}
**Embed URLs are public:**
- Anyone with the embed code can view your story
@@ -285,7 +287,7 @@ You can embed multiple stories on a single page:
- Students can view the story even outside the course by accessing the URL directly
- Consider this when embedding sensitive content
-## Updating Embedded Stories
+## Updating Embedded Stories {#updating-embedded-stories}
**Changes to your Telar site automatically appear in embeds:**
@@ -301,11 +303,12 @@ If you need to change the width or height:
2. Replace the old code in your platform
3. Save/publish the update
-{: .tip }
-> **Tip: Version Compatibility**
-> As long as you keep the embed URL format (`?embed=true`), embedded stories will work across Telar version updates.
+{{< callout "tip" >}}
+**Tip: Version Compatibility**
+As long as you keep the embed URL format (`?embed=true`), embedded stories will work across Telar version updates.
+{{< /callout >}}
-## Troubleshooting
+## Troubleshooting {#troubleshooting}
**iframe not displaying:**
- Check that `?embed=true` parameter is included in URL
@@ -321,7 +324,7 @@ If you need to change the width or height:
- Increase iframe height (recommended: 800px minimum)
- Set `width: 100%` for responsive behavior
-## Next Steps
+## Next Steps {#next-steps}
- **Share Links**: Use the Share Link tab for direct links instead of embedding
- **Customization**: Learn about [customizing your Telar site](/docs/customization/)
diff --git a/docs/6-2-glossary.md b/content/en/docs/site-features/glossary.md
similarity index 78%
rename from docs/6-2-glossary.md
rename to content/en/docs/site-features/glossary.md
index 3e6cb8c..734bfa4 100644
--- a/docs/6-2-glossary.md
+++ b/content/en/docs/site-features/glossary.md
@@ -1,22 +1,23 @@
---
-layout: docs
-title: "6.2. Glossary"
-parent: "6. Site Features"
-grand_parent: Documentation
-nav_order: 2
-lang: en
-permalink: /docs/site-features/glossary/
+title: Glossary
+url: /docs/site-features/glossary/
+translationKey: docs-site-features-glossary
+type: guide
+docs_section: reference
---
-# Glossary
+# Glossary {#glossary}
The glossary lets you define terms that viewers can look up without leaving a story. When a viewer clicks a glossary link, the definition appears in a slide-over panel.
-## Creating a Glossary
+
+For visual authoring, see [create and link glossary entries](/docs/the-compositor/glossary/).
+
+## Creating a Glossary {#creating-a-glossary}
There are two ways to define glossary terms. The CSV format (new in v0.8.0) is recommended for most projects.
-### CSV Format (Recommended)
+### CSV Format (Recommended) {#csv-format-recommended}
Add a `glossary.csv` file to `telar-content/spreadsheets/`:
@@ -34,9 +35,9 @@ Each row defines one term:
- **`definition`** — The definition text (supports basic markdown)
- **`related_terms`** — Other `term_id` values, separated by `|`, for cross-referencing
-The CSV format works with Google Sheets — the glossary tab is fetched automatically like your other CSVs. Column names can be in English or Spanish (see [CSV Reference: Glossary](/docs/your-data/csv-glossary/#glossary-csv-aliases) for aliases).
+The CSV format works with Google Sheets — the glossary tab is fetched automatically like your other CSVs. Column names can be in English or Spanish (see [CSV Reference: Glossary](/docs/your-data/csv-glossary/#column-aliases) for aliases).
-### Markdown Format (Legacy)
+### Markdown Format (Legacy) {#markdown-format-legacy}
Individual markdown files in `telar-content/texts/glossary/`:
@@ -55,14 +56,15 @@ European colonizers in the late 15th century...
Each file defines one term. The body of the file is the definition. In these files, `related_terms` is written as a YAML list, not with the `|` that separates values in the CSV: Telar does not reinterpret the frontmatter of a markdown file.
-{: .note }
-> If both a CSV glossary and markdown glossary files exist, Telar uses the CSV and ignores the markdown files (with a build warning).
+{{< callout "note" >}}
+If both a CSV glossary and markdown glossary files exist, Telar uses the CSV and ignores the markdown files (with a build warning).
+{{< /callout >}}
-## Linking to Glossary Terms
+## Linking to Glossary Terms {#linking-to-glossary-terms}
Link to glossary terms from your story text and panels using double-bracket syntax:
-### Shorthand
+### Shorthand {#shorthand}
Uses the term's `title` as the link text:
@@ -72,7 +74,7 @@ The [[loom]] was central to textile production.
Renders as: The <u>Loom</u> was central to textile production.
-### Custom Display Text
+### Custom Display Text {#custom-display-text}
Use a pipe separator to specify different link text:
@@ -82,7 +84,7 @@ The [[loom|weaving device]] was central to textile production.
Renders as: The <u>weaving device</u> was central to textile production.
-### Where Links Work
+### Where Links Work {#where-links-work}
Glossary auto-links work in:
@@ -94,10 +96,11 @@ The step **question** is a heading, so glossary links there are intentionally le
If a `term_id` is not found in the glossary, a warning icon and error message appear in the build output and in the story panel.
-{: .note }
-> Term matching is case-insensitive. `[[loom]]`, `[[Loom]]`, and `[[LOOM]]` all resolve to the same entry, so you can write a term however reads best — for example an acronym as `[[IIIF]]`.
+{{< callout "note" >}}
+Term matching is case-insensitive. `[[loom]]`, `[[Loom]]`, and `[[LOOM]]` all resolve to the same entry, so you can write a term however reads best — for example an acronym as `[[IIIF]]`.
+{{< /callout >}}
-## Viewer Experience
+## Viewer Experience {#viewer-experience}
When a viewer clicks a glossary link:
@@ -111,14 +114,14 @@ The viewer stays on the current story step throughout — glossary lookups don't
-## Tips
+## Tips {#tips}
- **Keep definitions concise** — Viewers are reading them mid-story. A sentence or two is ideal; save extended explanations for story panels.
- **Use related terms** to build a network of cross-references. This helps viewers explore connected concepts.
- **Prefix demo terms** with `demo-` (e.g., `demo-loom`) to tag them as demo content.
- **Test your links** by building the site and checking for glossary warnings in the build output.
-## See Also
+## See Also {#see-also}
- [CSV Reference: Glossary](/docs/your-data/csv-glossary/) — Complete glossary CSV column reference and aliases
- [Stories & Panels](/docs/your-content/stories-panels/) — Where glossary links are used
diff --git a/docs/6-1-objects-gallery.md b/content/en/docs/site-features/objects-gallery.md
similarity index 86%
rename from docs/6-1-objects-gallery.md
rename to content/en/docs/site-features/objects-gallery.md
index d07cdec..7725934 100644
--- a/docs/6-1-objects-gallery.md
+++ b/content/en/docs/site-features/objects-gallery.md
@@ -1,22 +1,20 @@
---
-layout: docs
-title: "6.1. Objects Gallery"
-parent: "6. Site Features"
-grand_parent: Documentation
-nav_order: 1
-lang: en
-permalink: /docs/site-features/objects-gallery/
+title: Objects Gallery
+url: /docs/site-features/objects-gallery/
+translationKey: docs-site-features-objects-gallery
+type: guide
+docs_section: reference
---
-# Objects Gallery
+# Objects Gallery {#objects-gallery}
The objects gallery provides a browsable, searchable interface for your collection at `/objects/`.
-## Gallery Page
+## Gallery Page {#gallery-page}
There are two modes, controlled by the `browse_and_search` setting in your `_config.yml`:
-### Browse and Search Mode
+### Browse and Search Mode {#browse-and-search-mode}
When `browse_and_search` is `true` (the default), the gallery includes a **filter sidebar** and a **search bar** for exploring your collection.
@@ -54,11 +52,11 @@ Video and audio objects display icon placeholder thumbnails in the gallery grid
Active filters and search terms appear as removable chips above the grid. Click **Clear all** to reset.
-### Simple Grid Mode
+### Simple Grid Mode {#simple-grid-mode}
When `browse_and_search` is `false`, the gallery shows a plain grid of object cards without filtering or search.
-### Populating Gallery Metadata
+### Populating Gallery Metadata {#populating-gallery-metadata}
For the best gallery experience, fill in these columns in your `objects.csv`:
@@ -70,10 +68,11 @@ For the best gallery experience, fill in these columns in your `objects.csv`:
Without these columns, the gallery still works but filtering and sorting options are limited.
-{: .note }
-> Objects added or uploaded via the Compositor appear in the gallery after publishing.
+{{< callout "note" >}}
+Objects added or uploaded via the Compositor appear in the gallery after publishing.
+{{< /callout >}}
-## Featured Objects on the Homepage
+## Featured Objects on the Homepage {#featured-objects-on-the-homepage}
You can showcase a selection of objects on your homepage by marking them as featured:
@@ -88,7 +87,7 @@ collection_interface:
The homepage displays up to `featured_count` objects (default: 4). If you mark fewer objects as featured than the count allows, the remaining slots are filled randomly from your collection.
-### Homepage Objects Link
+### Homepage Objects Link {#homepage-objects-link}
The "View the objects" link on the homepage is controlled separately:
@@ -99,7 +98,7 @@ collection_interface:
Even when the link is hidden, the gallery page remains accessible through the navigation menu.
-## Configuration
+## Configuration {#configuration}
All gallery settings live under `collection_interface` in `_config.yml`:
@@ -113,7 +112,7 @@ collection_interface:
See [Configuration Reference](/docs/configure/configuration/#collection-interface-settings) for full details on each setting.
-## See Also
+## See Also {#see-also}
- [Objects](/docs/your-content/objects/) — Defining objects and object pages
- [Object Columns](/docs/your-data/csv-objects/) — Complete column reference for objects.csv
diff --git a/docs/6-3-private-stories.md b/content/en/docs/site-features/private-stories.md
similarity index 85%
rename from docs/6-3-private-stories.md
rename to content/en/docs/site-features/private-stories.md
index a07554b..1a76ec6 100644
--- a/docs/6-3-private-stories.md
+++ b/content/en/docs/site-features/private-stories.md
@@ -1,14 +1,12 @@
---
-layout: docs
-title: "6.3. Private Stories"
-parent: "6. Site Features"
-grand_parent: Documentation
-nav_order: 3
-lang: en
-permalink: /docs/site-features/private-stories/
+title: Private Stories
+url: /docs/site-features/private-stories/
+translationKey: docs-site-features-private-stories
+type: guide
+docs_section: reference
---
-# Private Stories
+# Private Stories {#private-stories}
Private stories are encrypted so that only viewers with the correct key can read them. Use this
feature to share work-in-progress stories with collaborators, restrict access to classroom
@@ -16,7 +14,7 @@ materials, or keep sensitive content from public view.
**New in v0.8.0.**
-## How It Works
+## How It Works {#how-it-works}
Telar builds every story — private or not — through the same templates. A private story renders
exactly like an open one during the Jekyll build. Only after the build finishes does a separate
@@ -39,11 +37,11 @@ content is encrypted.
-## Setup
+## Setup {#setup}
Two things are needed: a key in your config and a flag on each story you want to protect.
-### 1. Set the Story Key
+### 1. Set the Story Key {#1-set-the-story-key}
Add `story_key` to your `_config.yml`:
@@ -54,7 +52,7 @@ story_key: "your-secret-key"
This key is used to encrypt all private stories. Choose something memorable but not easily
guessed.
-### 2. Mark Stories as Private
+### 2. Mark Stories as Private {#2-mark-stories-as-private}
In your `project.csv`, set the `private` column to `yes` for each story you want to encrypt:
@@ -66,12 +64,13 @@ order,story_id,title,subtitle,private
Stories without `private: yes` remain public.
-{: .note }
-> `protected` (and the Spanish `protegida`) also work as column names — Telar treats them the
-> same as `private`/`privada`. New sites and the examples in this documentation use
-> `private`/`privada`.
+{{< callout "note" >}}
+`protected` (and the Spanish `protegida`) also work as column names — Telar treats them the
+same as `private`/`privada`. New sites and the examples in this documentation use
+`private`/`privada`.
+{{< /callout >}}
-## Testing Locally
+## Testing Locally {#testing-locally}
Plain `bundle exec jekyll serve`, and `scripts/build_local_site.py` in its default (serve) mode,
never encrypt anything — Jekyll regenerates `_site` continuously while serving, and encryption is
@@ -89,17 +88,17 @@ Then serve the resulting `_site/` directory with a static file server (for examp
`python3 -m http.server` run from inside `_site/`). This runs the same encryption step the GitHub
Actions build runs, so it can also fail the way a real build would — see Build Failures below.
-## Sharing Protected Stories
+## Sharing Protected Stories {#sharing-protected-stories}
There are two ways viewers can unlock a protected story:
-### Key Entry Form
+### Key Entry Form {#key-entry-form}
When a viewer opens a protected story, they see an overlay with a key entry field. They type the key and press **Enter**. If the key is correct, the overlay fades away and the story appears.
If the key is wrong, the form displays an error message and lets them try again.
-### Link with Key Parameter
+### Link with Key Parameter {#link-with-key-parameter}
You can share a direct link that includes the key as a URL parameter:
@@ -109,14 +108,15 @@ https://your-site.com/stories/draft-analysis/?key=your-secret-key
Viewers who open this link skip the entry form — the story decrypts automatically.
-{: .warning }
-> The key is visible in the URL when shared this way. Anyone who sees the link (in browser history, chat logs, or email) will have access to the story.
+{{< callout "warning" >}}
+The key is visible in the URL when shared this way. Anyone who sees the link (in browser history, chat logs, or email) will have access to the story.
+{{< /callout >}}
-### Session Caching
+### Session Caching {#session-caching}
Once a viewer unlocks a story, it stays unlocked for the rest of their browser session. Navigating away and returning to the story does not require re-entering the key. Closing the browser clears the cache.
-## Security Considerations
+## Security Considerations {#security-considerations}
Story protection is a **weak privacy guard**, not a security measure. It deters casual access — visitors cannot simply open browser DevTools and read the story content. It does not protect content from a determined person.
@@ -144,7 +144,7 @@ site nor its files are publicly reachable, so only people you have granted repos
view anything at all. Story protection alone is not a substitute for a private repository when the
content genuinely must not be read by unauthorized people.
-## Build Failures
+## Build Failures {#build-failures}
Telar refuses to publish a private story as plaintext. The build can fail in two places rather
than deploy unprotected content:
@@ -158,7 +158,7 @@ than deploy unprotected content:
Either failure prints a message identifying which one happened, in English and Spanish.
-## Configuration Reference
+## Configuration Reference {#configuration-reference}
| Setting | Location | Purpose |
|---------|----------|---------|
@@ -168,7 +168,7 @@ Either failure prints a message identifying which one happened, in English and S
See [Configuration](/docs/configure/configuration/#story-protection) for details on the
`story_key` setting.
-## See Also
+## See Also {#see-also}
- [Stories & Panels](/docs/your-content/stories-panels/) — How to build stories
- [CSV Reference: Project](/docs/your-data/csv-project/) — The `private` column in project.csv
diff --git a/content/en/docs/teaching/_index.md b/content/en/docs/teaching/_index.md
new file mode 100644
index 0000000..b4b2d76
--- /dev/null
+++ b/content/en/docs/teaching/_index.md
@@ -0,0 +1,11 @@
+---
+title: Teaching with Telar
+url: /docs/teaching/
+translationKey: docs-teaching
+type: guide
+extra_css:
+- teaching-contact
+docs_section: teaching
+---
+
+{{< section-overview >}}
diff --git a/content/en/docs/teaching/request-access.md b/content/en/docs/teaching/request-access.md
new file mode 100644
index 0000000..8772430
--- /dev/null
+++ b/content/en/docs/teaching/request-access.md
@@ -0,0 +1,13 @@
+---
+title: Request teaching-mode access
+url: /docs/teaching/request-access/
+translationKey: docs-teaching-request-access
+type: guide
+docs_hub: true
+extra_css:
+- showcase
+- teaching-contact
+docs_section: teaching
+---
+
+{{< teaching-request >}}
diff --git a/content/en/docs/the-compositor/_index.md b/content/en/docs/the-compositor/_index.md
new file mode 100644
index 0000000..2bcabde
--- /dev/null
+++ b/content/en/docs/the-compositor/_index.md
@@ -0,0 +1,48 @@
+---
+title: Compositor manual
+url: /docs/the-compositor/
+translationKey: docs-the-compositor
+type: guide
+docs_section: compositor
+---
+
+# Compositor manual {#compositor-manual}
+
+<span class="anchor-alias" id="the-compositor"></span>
+
+<span class="anchor-alias" id="what-is-the-compositor"></span>
+
+The Telar Compositor is a visual authoring tool for creating and managing Telar exhibitions. It runs in your browser at [compositor.telar.org](https://compositor.telar.org), where you can bring images, video, audio and text together into layered visual narratives without writing code.
+
+You can use it for digital scholarship, public exhibitions, community storytelling and classroom projects, working on your own or with collaborators. The interface is available in English and Spanish.
+
+Telar provides the framework for the exhibition your visitors explore. The Compositor gives you a workspace to assemble its content, preview your stories and publish the site. Your published site's content and configuration are kept as files in a GitHub repository.
+
+## The parts of an exhibition {#the-parts-of-an-exhibition}
+
+- **Objects** are your source materials: images, video or audio, with their descriptions, sources and credits.
+- **Stories** guide visitors through those materials in a sequence of **steps**. Each step combines narrative text with a view of an object or a media clip.
+- **Panels and glossary entries** offer further context that visitors can open as they explore.
+- **The homepage and supporting pages** introduce the exhibition and help visitors find their way around it.
+
+You can manage all of these in the Compositor, along with the site's appearance and navigation.
+
+## How it works {#how-it-works}
+
+1. **Start a site.** Create a new Telar site or connect one you already have.
+2. **Compose your exhibition.** Add your sources, write stories, choose the details each step will show and develop the surrounding context.
+3. **Review and publish.** Check your work and publish the changes to GitHub. Telar then builds the public website.
+
+Your work is saved as you edit. Publishing is a separate action, so you can develop a draft before updating the public site. After publishing, check the website once its build has finished.
+
+<span class="anchor-alias" id="requirements"></span>
+
+## Before you begin {#before-you-begin}
+
+You need a GitHub account. The [first-site guide](/docs/getting-started/compositor/) takes you through signing in, granting the Telar GitHub App access and creating a site. If you already have a Telar repository, follow [Connect an existing site](/docs/the-compositor/getting-started/).
+
+If you are still developing your idea, start with [Plan an exhibition](/docs/plan/). For a practical first exercise, the illustrated [khipu walkthrough](/docs/the-compositor/iiif-to-story/) takes one image from an IIIF collection into a story step and shows how to save its framing.
+
+<span class="anchor-alias" id="in-this-section"></span>
+
+{{< manual-contents >}}
diff --git a/content/en/docs/the-compositor/courses.md b/content/en/docs/the-compositor/courses.md
new file mode 100644
index 0000000..c3d43f0
--- /dev/null
+++ b/content/en/docs/the-compositor/courses.md
@@ -0,0 +1,50 @@
+---
+title: Run a course with student sites
+url: /docs/the-compositor/courses/
+translationKey: docs-the-compositor-courses
+type: guide
+docs_draft: true
+docs_section: compositor
+---
+
+# Run a course with student sites {#run-a-course-with-student-sites}
+
+A course shares an object collection with sites made by student groups. Each group works on its own exhibition; course staff can enter its site through the course screen.
+
+Course creation appears only for accounts with course access. If the option is absent, you can still create a normal exhibition site.
+
+## Create the course collection {#create-the-course-collection}
+
+When creating a project, choose the course option. Add the objects the class will work with and review their titles, credits and source addresses.
+
+Prepare a small sample narrative and the [workshop quick guide](/start/) before the session. Students need both a technical route and a question they can investigate with the materials.
+
+Open the course's management screen with its access password when prompted. Keep that password separate from the join codes you give students.
+
+## Give students a class code {#give-students-a-class-code}
+
+Open **Course**, choose **New code** and select the class-code option. Add a label so you can distinguish sections and set an expiry where needed.
+
+Students enter this code when creating their site. The convenor of an existing site can also enter it in that site's settings. Joining attaches the site to the course and brings in its collection.
+
+A student group should join with its site, rather than treating a staff code as a class code.
+
+## Add teaching staff {#add-teaching-staff}
+
+Create a separate staff code for instructors. Whoever enters it joins as an instructor, so share it only with the intended teaching team.
+
+The course screen lists enrolled sites and their members. Open a site from that list to review its stories and help with authoring. Instructor access is tied to course membership.
+
+## Manage the course over time {#manage-the-course-over-time}
+
+Deactivate a code when it should admit no one else. Deactivation does not remove sites or staff who already joined.
+
+Removing a site from a course lets the group continue independently. The site keeps the objects it received as ordinary objects, and course staff lose their course-derived membership in that site. Review the confirmation before removing it.
+
+## Understand what a code protects {#understand-what-a-code-protects}
+
+A join code controls course membership. It does not restrict access to externally hosted images. Those images remain on the servers their manifests point to; a class code or story key does not make a public image private.
+
+Check the material's publication conditions before sharing it through a course.
+
+**Before the workshop:** test the join process with a teaching example, confirm the object collection and give students the short guide link. Use [planning an exhibition](/docs/plan/) for the narrative exercise.
diff --git a/content/en/docs/the-compositor/dashboard.md b/content/en/docs/the-compositor/dashboard.md
new file mode 100644
index 0000000..f219712
--- /dev/null
+++ b/content/en/docs/the-compositor/dashboard.md
@@ -0,0 +1,67 @@
+---
+title: Start and navigation
+url: /docs/the-compositor/dashboard/
+translationKey: docs-the-compositor-dashboard
+type: guide
+docs_section: compositor
+---
+
+<span class="anchor-alias" id="dashboard" aria-hidden="true"></span>
+
+# Start and navigation {#start-and-navigation}
+
+The **Start** page introduces the active project, shows its recent activity and links to the main parts of the Compositor. Use the navigation across the top to move between **Objects**, **Stories**, **Glossary**, **Home and Pages**, **Site settings** and **Publish**.
+
+## Site preview {#site-preview}
+
+Edit your exhibition's landing-page content in **Home and Pages**. The **Start** page is a project overview; it is not the editor for the public homepage.
+
+## Welcome message {#welcome-message}
+
+Open **Home and Pages** to edit the introduction that visitors see on your site. Review the site's title, description and interface language in **Site settings**. Publish when you want these changes to reach the public site.
+
+## Stories {#stories}
+
+The **Stories** page lists the narratives in your exhibition.
+
+### View and open stories {#view-and-open-stories}
+
+Choose **Edit** on a story to open the [Story Editor](/docs/the-compositor/story-editor/). Each row shows its title and number of steps.
+
+### Create a new story {#create-a-new-story}
+
+1. Choose **+ New Story**.
+2. Enter a title and, if needed, a subtitle and byline.
+3. Choose **Save** to create the story and open its editor.
+
+### Reorder stories {#reorder-stories}
+
+Drag a story by its handle to change the order in which stories appear on the public site. The new order is included when you publish.
+
+### Delete a story {#delete-a-story}
+
+Use **Delete story** and read the confirmation before continuing. Your public site changes when the deletion is published. Check the available **Undo** control if you removed something by mistake.
+
+### Draft and private toggles {#draft-and-private-toggles}
+
+- **Draft** excludes a story from the public exhibition. Use it while preparing work that should not appear.
+- **Private** controls access to the story's content. Read [Private Stories](/docs/site-features/private-stories/) before relying on this for a project.
+
+{{< media id="stories" >}}
+
+## Project switching {#project-switching}
+
+Use the project name in the header to switch between connected sites. Each site has its own collection, stories and unpublished changes.
+
+## Status bar {#status-bar}
+
+The header shows the connection state and whether the active project has unpublished changes. Wait for the connection to be ready before editing. Use **Publish** to review the changes and follow the resulting site build.
+
+The collaboration control opens information about the project's team and activity. Your user menu leads to **Account**, where **Interface language** changes the Compositor's labels. It does not translate your exhibition's text; the public site's interface language is a separate setting.
+
+## See also {#see-also}
+
+- [Workshop quick guide](/start/) — A short path through the first story
+- [Objects](/docs/the-compositor/objects/) — Add and manage sources
+- [Story Editor](/docs/the-compositor/story-editor/) — Compose steps and panels
+- [Publishing](/docs/the-compositor/publishing/) — Review and publish
diff --git a/docs/9-1-getting-started.md b/content/en/docs/the-compositor/getting-started.md
similarity index 53%
rename from docs/9-1-getting-started.md
rename to content/en/docs/the-compositor/getting-started.md
index a21153f..1667fa2 100644
--- a/docs/9-1-getting-started.md
+++ b/content/en/docs/the-compositor/getting-started.md
@@ -1,18 +1,18 @@
---
-layout: docs
-title: "9.1. Getting Started"
-parent: "9. The Compositor"
-grand_parent: Documentation
-nav_order: 1
-lang: en
-permalink: /docs/the-compositor/getting-started/
+title: Connect an existing site
+url: /docs/the-compositor/getting-started/
+translationKey: docs-the-compositor-getting-started
+type: guide
+docs_section: compositor
---
-# Getting started with the Compositor
+<span class="anchor-alias" id="getting-started-with-the-compositor" aria-hidden="true"></span>
-This page walks you through signing in to the Compositor, connecting a repository, and importing your content. By the end, you will have your exhibition loaded in the Compositor and ready to edit.
+# Connect an existing site {#connect-an-existing-site}
-## Prerequisites
+Use this guide when your Telar repository already exists. To start a new project, follow [Create your first site](/docs/getting-started/compositor/).
+
+## Prerequisites {#prerequisites}
Before you begin, make sure you have:
@@ -20,7 +20,7 @@ Before you begin, make sure you have:
- A **Telar repository** — create one from the [Telar template](https://github.com/UCSB-AMPLab/telar) (see [Use the Compositor](/docs/getting-started/compositor/) for step-by-step instructions)
- **GitHub Pages enabled** — in your repository settings, set the Pages source to **GitHub Actions**
-## Sign in
+## Sign in {#sign-in}
The Compositor uses your GitHub account for authentication and publishing. No separate account is needed.
@@ -28,7 +28,7 @@ The Compositor uses your GitHub account for authentication and publishing. No se
2. Click **Sign in with GitHub**
3. Authorize the Telar Compositor when GitHub prompts you
-## Install the GitHub App
+## Install the GitHub App {#install-the-github-app}
On your first sign-in, the Compositor asks you to install the Telar GitHub App. This app gives the Compositor permission to read and write to your repositories.
@@ -36,10 +36,11 @@ On your first sign-in, the Compositor asks you to install the Telar GitHub App.
2. Choose whether to grant access to all repositories or only specific ones
3. Confirm the installation
-{: .tip }
-> If you only want the Compositor to access one repository, select **Only select repositories** and choose it from the list. You can change this later in your GitHub settings under **Applications**.
+{{< callout "tip" >}}
+If you only want the Compositor to access one repository, select **Only select repositories** and choose it from the list. You can change this later in your GitHub settings under **Applications**.
+{{< /callout >}}
-## Connect a repository
+## Connect a repository {#connect-a-repository}
After signing in, you select which repository to work with.
@@ -49,20 +50,15 @@ After signing in, you select which repository to work with.
If the repository was created from the Telar template and has content in `telar-content/`, the Compositor imports it automatically.
-## Import from Google Sheets
-
-If your Telar site uses Google Sheets as its data source, the Compositor can import directly from your spreadsheet.
+## Import from Google Sheets {#import-from-google-sheets}
-1. When the Compositor detects a Google Sheets URL in your site configuration, it offers to import from Sheets
-2. Confirm the import to pull your current content into the Compositor
-3. After your first publish through the Compositor, you can optionally disable the Google Sheets connection — the Compositor becomes your primary editor
+If the site uses Google Sheets, follow the import and settings checks shown by the Compositor. Review the content that is imported and any request to switch off the Sheets connection before proceeding with visual authoring.
-{: .note }
-> Importing from Google Sheets does not delete or modify your spreadsheet. It copies the data into the Compositor so you can edit it visually.
+Your spreadsheet is not deleted by importing it. Decide which authoring method will manage future changes; do not assume edits in the Compositor automatically update the original sheet.
-## After import
+## After import {#after-import}
-Once the import completes, you land on the [Dashboard](/docs/the-compositor/dashboard/). From here you can:
+After import and the setup checks, use the [main navigation](/docs/the-compositor/dashboard/) to:
- View and manage your stories
- Browse and edit your objects
@@ -70,8 +66,8 @@ Once the import completes, you land on the [Dashboard](/docs/the-compositor/dash
Your imported content is saved on the server. Changes you make are not sent to GitHub until you publish — so you can explore and experiment freely.
-## See also
+## See also {#see-also}
-- [Dashboard](/docs/the-compositor/dashboard/) — Navigate your project and manage stories
+- [Start and navigation](/docs/the-compositor/dashboard/) — Navigate your project and manage stories
- [Objects](/docs/the-compositor/objects/) — Browse, edit, and add objects
- [Use the Compositor](/docs/getting-started/compositor/) — Create a repository and enable GitHub Pages
diff --git a/content/en/docs/the-compositor/glossary.md b/content/en/docs/the-compositor/glossary.md
new file mode 100644
index 0000000..83d185e
--- /dev/null
+++ b/content/en/docs/the-compositor/glossary.md
@@ -0,0 +1,53 @@
+---
+title: Create and link glossary entries
+url: /docs/the-compositor/glossary/
+translationKey: docs-the-compositor-glossary
+type: guide
+docs_draft: true
+docs_section: compositor
+---
+
+# Create and link glossary entries {#create-and-link-glossary-entries}
+
+Use the glossary for definitions and context that readers may need in more than one place. A term has an ID used in links, a title readers see, a kind and a definition.
+
+## Add an entry {#add-an-entry}
+
+1. Open **Glossary** in the main navigation.
+2. If you are the site's convenor, choose **+ New Term**.
+3. Write a useful title and a definition that can stand on its own.
+4. Choose the kind: key term, primary source, person or entity, or place.
+5. Check **How readers see this**.
+
+The convenor adds and deletes entries and changes their IDs. Other team members can work on the content of existing entries. If the creation control is absent, ask your convenor to add the term.
+
+{{< media id="glossary" >}}
+
+## Link it from a story {#link-it-from-a-story}
+
+In a panel's text editor, use **Insert glossary link** and search for the term. Choose custom link text when the sentence needs a different form.
+
+You can also write the link directly:
+
+```text
+[[khipu]]
+[[khipu|knotted cords]]
+```
+
+The text before the vertical bar is the term ID, not its display title. Use the ID of the entry you created. Check the link in the preview and again on the published site.
+
+## Review where a term is used {#review-where-a-term-is-used}
+
+The **Used in** list shows references in stories, pages and other terms. Open a reference to inspect its context before changing a definition that several passages rely on.
+
+A short definition works best when it answers the reader's immediate question. Place a longer discussion of one source in that step's panel and link to the glossary where shared context is needed.
+
+## Change an ID or a kind carefully {#change-an-id-or-a-kind-carefully}
+
+The convenor can change a term ID. The Compositor updates its internal links, but the public address changes on the next publication. Links shared outside the project will still point to the old address.
+
+**Edit kinds** lets the convenor add site-specific categories with an ID, a label shown in the panel and a heading for the glossary page. These labels should be in the exhibition's language.
+
+Deleting an entry leaves references to it unresolved. Use **Used in** first and replace or remove the links before publishing.
+
+**Check your work:** open the term from a story panel, verify the displayed wording and return to the same step. Then [arrange the homepage and pages](/docs/the-compositor/pages/).
diff --git a/content/en/docs/the-compositor/iiif-to-story.md b/content/en/docs/the-compositor/iiif-to-story.md
new file mode 100644
index 0000000..820a1ae
--- /dev/null
+++ b/content/en/docs/the-compositor/iiif-to-story.md
@@ -0,0 +1,115 @@
+---
+title: Use an IIIF object in a story
+url: /docs/the-compositor/iiif-to-story/
+translationKey: docs-the-compositor-iiif-to-story
+type: guide
+docs_section: compositor
+---
+
+# Use an IIIF object in a story {#use-an-iiif-object-in-a-story}
+
+<p class="lede">Connect an image held elsewhere to your exhibition, choose it for a story step and capture the view you want visitors to see.</p>
+
+<div class="manual-meta"><span>Before you begin: a site and a story you can edit</span><span>Example: a khipu IIIF manifest</span></div>
+
+<p>If the khipu is already in your collection, go straight to <a href="#choose">Use it in a step</a>.</p>
+
+<div class="manual-note"><p><strong>Three separate actions:</strong> adding an object makes it available in the Compositor. Choosing it in a step brings it into your story. Publishing sends your changes to the repository so your site can rebuild.</p></div>
+
+<nav class="manual-toc" aria-label="On this page"><strong>In this guide</strong><ol>
+<li><a href="#open-import">Open the import dialog</a></li><li><a href="#fetch">Fetch the manifest</a></li><li><a href="#metadata">Review the object</a></li><li><a href="#choose">Use it in a step</a></li><li><a href="#frame">Capture the framing</a></li><li><a href="#context">Add context</a></li><li><a href="#publish">Publish and check</a></li><li><a href="#problems">If something goes wrong</a></li>
+</ol></nav>
+
+## 1. Open the import dialog {#open-import}
+
+Open **Objects**, choose **+ Add object**, then select **IIIF manifest**.
+
+An IIIF manifest describes an object and tells the viewer where to load its images. Use the manifest address supplied by the collection.
+
+## 2. Fetch the manifest {#fetch}
+
+Paste this example into **IIIF manifest URL**, then choose **Fetch manifest**.
+
+<pre class="manifest-code" id="manifest-url">https://juancobo.com/138la/iiif/khipu/p7/manifest.json</pre>
+<button class="copy-button" type="button" data-copy="manifest-url">Copy manifest URL</button>
+
+
+
+Wait for the preview to load. This example is labelled “Haptic khipu — Taking a sample from the khipu for radio-carbon dating, Spring 2025”.
+
+## 3. Review the object {#metadata}
+
+Review **Title**, **Creator**, **Year**, **Description**, **Source** and **Credit**. The provider may supply only some of them. Retain the source and credit information and fill any gaps from reliable cataloguing information.
+
+Scroll within the dialog to review the remaining fields.
+
+The interface language does not translate the metadata supplied by a manifest. You can review the wording for your exhibition.
+
+{{< media id="import" >}}
+
+Choose **Add object**. The object should appear in your collection. Open its record to check the image and add a **Description for accessibility**.
+
+
+
+## 4. Use it in a step {#choose}
+
+1. Open **Stories** and choose the story you want to edit.
+2. Choose **+ Add step**.
+3. If the new-step dialog offers to keep the previous object, choose **Choose another object**.
+4. Select the khipu from the object picker. You can also use **Change object** on an existing step.
+
+The step should now show the imported image. Write a question and a short answer. For this exercise, you could use:
+
+**Question:** Which activity does this image document?
+
+**Answer:** Sampling a khipu for radiocarbon dating in spring 2025.
+
+These sentences describe this example. Your own story should develop the questions you want your visitors to explore.
+
+{{< media id="editor-overview" >}}
+
+## 5. Capture the framing {#frame}
+
+1. Pan and zoom to the detail you want to show.
+2. Use the framing guides to understand the area the step will preserve.
+3. Choose **Capture position**.
+4. Check that the control confirms **Captured**.
+
+<div class="manual-note"><p><strong>Capture after framing.</strong> Moving the viewer lets you explore the object. Capture position records the view for this step. Capture it again if you change the framing you want to preserve.</p></div>
+
+Move to another step and return. Check that the saved framing is the one you intended.
+
+{{< media id="framing" >}}
+
+## 6. Add context {#context}
+
+On the step card, choose **+ Add panel**. If the step already has a panel, open it using its panel button. Use the editing icons for the panel title and text to write your content.
+
+For example, explain how the image supports your question and link to the object's source.
+
+Keep the brief answer readable on the step card. Use panels for the detail that helps visitors understand the evidence.
+
+## 7. Publish and check {#publish}
+
+Open **Publish** and review the changes. Resolve any errors that block publication and review the warnings before publishing.
+
+Once the site build completes, open the published story and check:
+
+- The correct object appears in the new step.
+- Its framing shows the detail you captured.
+- The question, answer and panel read correctly.
+- The object's source, credit and accessibility description are appropriate.
+
+## If something goes wrong {#problems}
+
+**The manifest does not load.** Check the complete address and try opening it in a browser. The address should return an IIIF manifest. A catalogue-page URL or an image-file URL is a different resource.
+
+**Metadata is missing.** Review the collection's catalogue and complete the relevant fields. Imported metadata depends on what the provider supplies.
+
+**The image works in Objects but is absent from the story.** Open the step and check its selected object.
+
+**The published framing is different.** Reframe the step, choose **Capture position**, then publish and check the completed build.
+
+**The live site still shows the previous content.** Check the publishing and build status. Editing the draft and publishing it are separate operations.
+
+<p><a href="/manual/review/">Review the proposed screencast and its exact captions →</a></p>
diff --git a/content/en/docs/the-compositor/objects.md b/content/en/docs/the-compositor/objects.md
new file mode 100644
index 0000000..bbb6a79
--- /dev/null
+++ b/content/en/docs/the-compositor/objects.md
@@ -0,0 +1,106 @@
+---
+title: Objects
+url: /docs/the-compositor/objects/
+translationKey: docs-the-compositor-objects
+type: guide
+docs_section: compositor
+---
+
+# Objects {#objects}
+
+The Objects page in the Compositor lets you browse, edit, and add the visual items that make up your exhibition. Every object you manage here — images, IIIF manifests, videos, audio files — is tracked in your repository's `objects.csv` file. The Compositor handles that file for you, so you never need to edit it directly.
+
+## Object list {#object-list}
+
+The object list shows all objects in your exhibition as a list with thumbnails. Each object displays:
+
+- A **thumbnail** preview of the image or media
+- The object's **title**
+- A **status indicator** showing its current state
+
+### Status indicators {#status-indicators}
+
+The status reports availability; it does not mean the catalogue description has been fully reviewed.
+
+- **Ready** — The object has a title and passes the image-availability check where that check applies.
+- **No metadata** — The title is missing. Review the record and add its title and other useful catalogue information.
+- **Needs tiles** — The image is not yet available. For a hosted file, check its build and generated tiles; for an external source, check the manifest.
+- **Missing from repo** — The record has been flagged as absent from the repository. Review the repository comparison before deciding what to keep.
+
+### Featured toggle {#featured-toggle}
+
+You can mark any object as featured. Featured objects appear prominently on your site's home page and in the objects gallery.
+
+To toggle an object's featured status, click the featured indicator on the object row.
+
+{{< media id="objects" >}}
+
+## Edit metadata {#edit-metadata}
+
+Select an object to open its metadata editor. Here you can fill in or update the information that describes the object in your exhibition.
+
+The metadata fields are:
+
+| Field | Description |
+|---|---|
+| **Title** | The name of the object as it appears on your site |
+| **Creator** | The person or organization that created the object |
+| **Year** | When the object was created or published |
+| **Description** | A short summary of what the object depicts or contains |
+| **Source** | Where the object comes from — a collection, archive, or URL |
+| **Alt text** | A description for screen readers and accessibility |
+| **Genre / Medium** | The type of object — photograph, painting, map, manuscript, etc. |
+
+{{< callout "tip" >}}
+Alt text is important for accessibility. Write a brief, descriptive sentence that conveys what the image shows to someone who cannot see it.
+{{< /callout >}}
+
+{{< media id="object-metadata" >}}
+
+## Add external IIIF {#add-external-iiif}
+
+1. Open **Objects** and choose **+ Add object**.
+2. Select **IIIF manifest**.
+3. Paste the manifest URL and choose **Fetch manifest**.
+4. Review the preview, title, source, credit and any other supplied metadata.
+5. Choose **Add object**.
+
+Adding the object makes it available in the collection. Select it separately in a story step using **Change object**.
+
+Follow [Use an IIIF object in a story](/docs/the-compositor/iiif-to-story/) for the complete illustrated khipu example. See [External IIIF Images](/docs/your-content/external-iiif/) for background.
+
+{{< media id="import" >}}
+
+## Upload images {#upload-images}
+
+You can upload your own images directly through the Compositor. Uploaded images are committed to your repository and IIIF tiles are generated automatically during the next build.
+
+1. Click **Add object** and select the upload option
+2. Drag files into the upload area, or click to select files from your computer
+3. Fill in metadata while the upload processes
+4. Save the object to your project
+
+Supported formats are JPG, PNG, and TIFF, with a maximum file size of 25 MB per image.
+
+{{< callout "note" >}}
+After uploading, the object's status may show **Needs tiles** until you publish and the GitHub Actions build generates the IIIF tiles. The object is still usable in the Compositor — tiles will be available on your live site after the build completes.
+{{< /callout >}}
+
+## Save to repository {#save-to-repository}
+
+When you save changes to objects — whether editing metadata, adding IIIF, or uploading images — those changes are saved in the Compositor draft. To send them to GitHub, you need to publish.
+
+Publishing commits an updated `objects.csv` to your repository along with any uploaded image files. See [Publishing](/docs/the-compositor/publishing/) for the full workflow.
+
+## Sync {#sync}
+
+When objects change outside the Compositor, use the project's **Changes on GitHub** review. Read the differences and choose which version to keep before applying them. See [Sync and Updates](/docs/the-compositor/sync-updates/).
+
+Unpublished editing and publishing are separate. Review the consequences shown for the affected object rather than re-importing the entire project.
+
+## See also {#see-also}
+
+- [Start and navigation](/docs/the-compositor/dashboard/) — Return to the project overview
+- [Objects](/docs/your-content/objects/) — How objects work in Telar
+- [External IIIF Images](/docs/your-content/external-iiif/) — Background on IIIF manifests and sources
+- [Self-Hosted Images](/docs/your-content/self-hosted-images/) — How uploaded images become IIIF tiles
diff --git a/content/en/docs/the-compositor/pages.md b/content/en/docs/the-compositor/pages.md
new file mode 100644
index 0000000..f433dab
--- /dev/null
+++ b/content/en/docs/the-compositor/pages.md
@@ -0,0 +1,53 @@
+---
+title: Arrange the homepage and pages
+url: /docs/the-compositor/pages/
+translationKey: docs-the-compositor-pages
+type: guide
+docs_draft: true
+docs_section: compositor
+---
+
+# Arrange the homepage and pages {#arrange-the-homepage-and-pages}
+
+Open **Home and Pages** to edit the exhibition's introduction, arrange its menu and create supporting pages.
+
+## Edit the homepage {#edit-the-homepage}
+
+Select the pinned **Home** entry. Edit the site title and description, welcome text, and headings or introductions for the stories and objects sections.
+
+These fields describe the whole exhibition. Explain what visitors can explore and give them a clear starting point. Keep the longer introduction to an individual story inside that story.
+
+Arrange story cards in the order you want readers to encounter them. Story drafts remain excluded from publication. The collection's display settings live in **Site settings**, while the objects' featured status and metadata are edited in **Objects**.
+
+{{< media id="homepage" >}}
+
+## Add a supporting page {#add-a-supporting-page}
+
+1. Choose **Add page**.
+2. Add a title, such as About, Team or Methodology.
+3. Write the page's content using the text editor.
+4. Check its URL and the menu preview.
+
+A page is useful for information that should remain available outside a story: credits, contributors, research methods or acknowledgements. It does not have the sequence of framed steps that a story has.
+
+If the Compositor finds existing pages in the repository, it offers to import them. Review the imported content before replacing or duplicating it.
+
+{{< media id="pages" >}}
+
+## Arrange the menu {#arrange-the-menu}
+
+Use the navigation preview to reorder the menu items and choose the page you want to edit. Keep destination names short and recognisable.
+
+The pinned Home entry in the editing sidebar does not force Home to be first in the published menu. Check the menu preview itself to confirm the public order.
+
+## Check page addresses {#check-page-addresses}
+
+A page's URL must be unique and cannot use an address reserved by the site. The Compositor explains collisions beside the field.
+
+Changing an address affects the next publication. Existing links to the old address will no longer reach the page. Update links in your content and any places where you have shared it.
+
+## Review the complete route {#review-the-complete-route}
+
+After publishing, begin at the homepage, open each menu item and check that the intended title, content and story order appear. A change saved in the editor is not yet a change to the public site.
+
+Next, [adjust appearance and site settings](/docs/the-compositor/settings/).
diff --git a/docs/9-6-publishing.md b/content/en/docs/the-compositor/publishing.md
similarity index 76%
rename from docs/9-6-publishing.md
rename to content/en/docs/the-compositor/publishing.md
index b09c0c7..89b624b 100644
--- a/docs/9-6-publishing.md
+++ b/content/en/docs/the-compositor/publishing.md
@@ -1,24 +1,22 @@
---
-layout: docs
-title: "9.6. Publishing"
-parent: "9. The Compositor"
-grand_parent: Documentation
-nav_order: 6
-lang: en
-permalink: /docs/the-compositor/publishing/
+title: Publishing
+url: /docs/the-compositor/publishing/
+translationKey: docs-the-compositor-publishing
+type: guide
+docs_section: compositor
---
-# Publishing
+# Publishing {#publishing}
Publishing sends your changes from the Compositor to your GitHub repository. Until you publish, all edits — to objects, stories, and settings — are saved on the server. Publishing creates a single commit in your repository, triggers a GitHub Pages build, and makes your changes live on your site.
-## Change summary
+## Change summary {#change-summary}
Before publishing, the Compositor shows a summary of everything that has changed since your last publish. This lets you review your work before committing.
The change summary lists additions, modifications, and deletions across your project — new objects, edited story steps, updated metadata, and any other changes you have made. Review this summary carefully to make sure it reflects what you intend to publish.
-## Pre-publish validation
+## Pre-publish validation {#pre-publish-validation}
The Compositor validates your project before allowing you to publish. Validation catches issues that could cause problems on your live site.
@@ -27,13 +25,15 @@ There are two levels of validation:
- **Errors** — Critical issues that block publishing. For example, a required field might be missing or a story might reference an object that does not exist. You must fix errors before you can publish.
- **Warnings** — Non-critical issues that do not block publishing but are worth reviewing. For example, an object might be missing alt text or a story might have only one step. You can publish with warnings, but addressing them improves your exhibition.
-## Publish
+{{< media id="upgrade" >}}
-When you are ready, click the publish button. The Compositor creates a single atomic commit in your GitHub repository containing all your changes. The commit is attributed to your GitHub account — your name and email appear in the repository's commit history, not the Compositor's.
+## Publish {#publish}
-Publishing triggers a GitHub Pages build automatically. You do not need to visit GitHub or run any additional steps.
+When you are ready, use the publish control. The Compositor sends the reviewed changes to your repository through its installed GitHub App. The commit body records **Published by @your-github-login**.
-## Build tracking
+Publishing and completing the site build are separate stages. Follow the build status before checking the public site.
+
+## Build tracking {#build-tracking}
After publishing, the Compositor tracks the progress of your GitHub Pages build in real time. A progress indicator shows the current status:
@@ -44,11 +44,11 @@ After publishing, the Compositor tracks the progress of your GitHub Pages build
If a build fails, the Compositor displays the error information so you can diagnose the issue. Common causes include invalid YAML in configuration files or missing required files. You can fix the issue and publish again.
-## Post-publish
+## Post-publish {#post-publish}
Once the build completes successfully, the Compositor provides a direct link to your live site. Click it to see your published changes immediately.
-## Config editor
+## Config editor {#config-editor}
The Compositor includes a configuration editor for essential site settings. Instead of editing your `_config.yml` file directly through GitHub, you can update key fields through a form in the Compositor.
@@ -56,12 +56,13 @@ The config editor lets you change settings like your site title, theme options,
If your site's `_config.yml` is written in a way that doesn't let the Compositor save your **Site settings** in it, the **Publish** page tells you and offers to rewrite the file. Click **Review the rewrite** to see what will happen. The Compositor rebuilds `_config.yml` from the template for the version of Telar your site uses and keeps the settings from your file as they are. The review lists the settings that will take their value from **Site settings** or from the template, and any lines the Compositor can't read, which will be removed. Comments between settings aren't kept. When you click **Accept the rewrite**, the Compositor writes the new file the next time you publish; the old one stays in your site's history on GitHub. Anyone who can edit **Site settings** can accept the rewrite.
-{: .note }
-> The config editor covers the most commonly used settings. For advanced configuration options, you can still edit `_config.yml` directly in your repository. See [Configuration](/docs/configuration/) for the full reference.
+{{< callout "note" >}}
+The config editor covers the most commonly used settings. For advanced configuration options, you can still edit `_config.yml` directly in your repository. See [Configuration](/docs/configure/configuration/) for the full reference.
+{{< /callout >}}
-## See also
+## See also {#see-also}
- [Story Editor](/docs/the-compositor/story-editor/) — Building and editing your stories
- [Objects](/docs/the-compositor/objects/) — Managing objects in the Compositor
- [Sync and Updates](/docs/the-compositor/sync-updates/) — Keeping your project in sync with your repository
-- [Dashboard](/docs/the-compositor/dashboard/) — Return to the project overview
+- [Start and navigation](/docs/the-compositor/dashboard/) — Return to the project overview
diff --git a/content/en/docs/the-compositor/settings.md b/content/en/docs/the-compositor/settings.md
new file mode 100644
index 0000000..ffd3a4f
--- /dev/null
+++ b/content/en/docs/the-compositor/settings.md
@@ -0,0 +1,53 @@
+---
+title: Adjust appearance and site settings
+url: /docs/the-compositor/settings/
+translationKey: docs-the-compositor-settings
+type: guide
+docs_draft: true
+docs_section: compositor
+---
+
+# Adjust appearance and site settings {#adjust-appearance-and-site-settings}
+
+Use **Site settings** for the exhibition's identity, language, theme, display options and hosting address. The page distinguishes settings that every editor can change from those reserved for the convenor.
+
+## Set the identity and language {#set-the-identity-and-language}
+
+Review the site title, description, author and contact email. The title and description should agree with the homepage introduction.
+
+The site's language controls interface text supplied by Telar. Your account's language controls the Compositor interface. Changing either setting does not translate the content you wrote.
+
+Choose a theme from those available in your repository. The convenor can refresh the list when themes have changed on GitHub. Preview the result with your actual text and images.
+
+{{< media id="theme-language" >}}
+
+## Decide what the homepage shows {#decide-what-the-homepage-shows}
+
+Story settings control story visibility on the homepage, the step indicator and object credits. Collection settings control browsing, the collection link, featured objects and whether objects or stories appear first.
+
+Use a story-led homepage when a guided route is the main invitation. Use collection mode when visitors should first explore a set of objects. Check the resulting homepage after publication.
+
+## Understand the convenor's settings {#understand-the-convenors-settings}
+
+Only the convenor can change the hosting URL and base path, the story key, Google Sheets integration and inclusion of demo content. Other members can change editorial settings such as titles, theme and display options.
+
+- **Site URL** is the domain, such as `https://example.github.io`.
+- **Base URL** is the path, such as `/my-exhibition`; leave it empty for a domain-root site.
+- The story key is used for stories marked private. It is separate from the draft flag.
+- Demo content is sample material; turn it off when it no longer belongs in your exhibition.
+
+An address change affects links throughout the site. Confirm the address and hosting arrangement before publishing it.
+
+## Choose one content source {#choose-one-content-source}
+
+If Google Sheets remains enabled, a build can fetch the sheet and replace the objects and stories you edited visually. Read the notice in settings. The Compositor's object-saving workflow switches the project to Compositor-managed content.
+
+Before switching methods, review the latest sheet content and the unpublished editor changes. The Compositor does not write your edits back to Google Sheets.
+
+{{< media id="preferences" >}}
+
+## Save and publish {#save-and-publish}
+
+Use **Save Changes** on the settings page and wait for confirmation. Then review the publication separately. Check the live homepage, menu and a story after the build completes.
+
+See [publishing](/docs/the-compositor/publishing/) for the complete process.
diff --git a/content/en/docs/the-compositor/story-editor.md b/content/en/docs/the-compositor/story-editor.md
new file mode 100644
index 0000000..985240c
--- /dev/null
+++ b/content/en/docs/the-compositor/story-editor.md
@@ -0,0 +1,90 @@
+---
+title: Story Editor
+url: /docs/the-compositor/story-editor/
+translationKey: docs-the-compositor-story-editor
+type: guide
+docs_section: compositor
+---
+
+# Story Editor {#story-editor}
+
+Open a story from **Stories** to write its questions, brief answers and optional panels. The editor combines the story outline, editable text and the view visitors will see.
+
+The sidebar uses a **square** for the title card, **circles** for steps and an **upward triangle** for the final step. A step's first panel branches from it; a second panel branches from the first.
+
+{{< media id="editor-overview" >}}
+
+## Title card {#title-card}
+
+Select the title card at the top of the outline. Click its title, subtitle or byline, or the corresponding editing icon, to change the field. Your edits are saved as you work.
+
+<span class="anchor-alias" id="object-picker" aria-hidden="true"></span>
+
+## IIIF viewer {#iiif-viewer}
+
+Select an image step and choose **Change object** to pick its source. Pan and zoom to the detail you want visitors to see.
+
+To save the view:
+
+1. Select the step.
+2. Pan and zoom to the intended framing.
+3. Choose **Capture position**.
+4. Check the **Captured** confirmation.
+5. Move to the title card or another step, then return and check the saved view.
+
+{{< callout "note" >}}
+Panning and zooming explore the object. **Capture position** records the framing for the selected step. Capture again if you change the view you want to preserve.
+{{< /callout >}}
+
+{{< media id="framing" >}}
+
+The guides indicate the frame and the centre of the view. The text-limit guide helps you see how much of the brief answer fits in the public card.
+
+## Step management {#step-management}
+
+- **+ Add step** creates a step. If you are offered the previous object, you can keep it or choose another.
+- **Change object** selects a different source for the current step.
+- Drag a step by its handle to change its position.
+- Use the step's delete control and read the confirmation before removing it.
+- **Add section title** inserts a heading that groups parts of the story.
+
+Write a question and a brief answer on each step card. Click the text or its editing icon. The answer field accepts Markdown; click outside it to review the rendered text.
+
+Video and audio steps have media controls in place of the image viewer. See [Video and Audio](/docs/the-compositor/video-audio/).
+
+## Layer editing {#layer-editing}
+
+Choose **+ Add panel** on a step card, or open an existing panel using its button. Edit the panel's title and content in place using the text or editing icons. The first panel can offer a button to a second panel.
+
+Keep the main answer concise. Use panels for the context, evidence and nuance a reader may choose to explore.
+
+{{< media id="panels" >}}
+
+### Formatting toolbar {#formatting-toolbar}
+
+When editing panel content, use the formatting controls or write Markdown directly. Review the rendered panel after editing. See [Markdown Syntax](/docs/your-content/markdown-syntax/) and [Rich Content](/docs/your-content/rich-content/) for supported content.
+
+{{< media id="panel-editor" >}}
+
+### Keyboard shortcuts {#keyboard-shortcuts}
+
+Standard editing shortcuts depend on the focused field. Keep the text editor focused when applying a formatting command. Use the toolbar when you are unsure which command is available.
+
+### Image insertion {#image-insertion}
+
+Use the panel editor's image controls to add an image, and supply the information the dialog requests. A panel image is part of the explanation; the step's main source is selected separately through **Change object**.
+
+### Rich paste {#rich-paste}
+
+When bringing text from another application, check the resulting formatting, links and spacing in the rendered panel before publishing.
+
+### Embed preservation {#embed-preservation}
+
+For embedded media and interactive content inside panels, follow [Rich Content](/docs/your-content/rich-content/) and [Widgets](/docs/your-content/widgets/). Check the actual published result as well as the editor preview.
+
+## See also {#see-also}
+
+- [Use an IIIF object in a story](/docs/the-compositor/iiif-to-story/)
+- [Start and navigation](/docs/the-compositor/dashboard/)
+- [Video and Audio](/docs/the-compositor/video-audio/)
+- [Publishing](/docs/the-compositor/publishing/)
diff --git a/content/en/docs/the-compositor/sync-updates.md b/content/en/docs/the-compositor/sync-updates.md
new file mode 100644
index 0000000..7d9e0d8
--- /dev/null
+++ b/content/en/docs/the-compositor/sync-updates.md
@@ -0,0 +1,55 @@
+---
+title: Sync and Updates
+url: /docs/the-compositor/sync-updates/
+translationKey: docs-the-compositor-sync-updates
+type: guide
+docs_section: compositor
+---
+
+# Sync and Updates {#sync-and-updates}
+
+The Compositor checks for changes made on GitHub as well as available Telar updates. A change made outside the editor needs review before it is applied to your draft.
+
+## On return detection {#on-return-detection}
+
+When you open a connected project, the Compositor checks its repository. If GitHub has changed, follow the review prompt. The review covers the affected objects, stories, settings, glossary terms and pages.
+
+## Re-sync {#re-sync}
+
+The **Changes on GitHub** review shows what differs and asks which version to keep where a choice is needed.
+
+1. Read each change and its consequence.
+2. Choose GitHub's version or the Compositor's version, as appropriate.
+3. Resolve the choices the review requires.
+4. Choose **Apply these choices** when the result is the one you intend.
+
+Keeping the Compositor's version means the next publish sends that version to GitHub. Taking GitHub's version applies the corresponding content to the Compositor. Unpublished changes made only in the Compositor are kept.
+
+{{< callout "note" >}}
+Sync review and publishing are separate actions. Review the consequences shown for each item; do not use re-importing as a routine way to undo a small editing mistake.
+{{< /callout >}}
+
+If files cannot be read or the repository changes while you are reviewing, follow the message and refresh the comparison before applying it.
+
+## Version detection {#version-detection}
+
+The Compositor checks the version of Telar used by your site and may ask you to upgrade before continuing.
+
+## Upgrade page {#upgrade-page}
+
+Review the current and target versions, release notes and grouped file changes. An upgrade can update framework files and migrate settings needed by the new version. Read the proposed changes before accepting them.
+
+{{< media id="upgrade" >}}
+
+## One-click upgrade {#one-click-upgrade}
+
+Follow the upgrade controls, wait for the operation and site build to complete, then follow the return link. Check the site before continuing with the work that prompted the upgrade.
+
+Your repository's history records the changes made by the upgrade. If something does not look right, use the build information and the proposed file list to understand what changed.
+
+## See also {#see-also}
+
+- [Publishing](/docs/the-compositor/publishing/)
+- [Start and navigation](/docs/the-compositor/dashboard/)
+- [Connect an existing site](/docs/the-compositor/getting-started/)
+- [Upgrading Telar](/docs/setup/upgrading/) — Framework upgrade reference
diff --git a/content/en/docs/the-compositor/team.md b/content/en/docs/the-compositor/team.md
new file mode 100644
index 0000000..bb895a7
--- /dev/null
+++ b/content/en/docs/the-compositor/team.md
@@ -0,0 +1,44 @@
+---
+title: Work with a team
+url: /docs/the-compositor/team/
+translationKey: docs-the-compositor-team
+type: guide
+docs_draft: true
+docs_section: compositor
+---
+
+# Work with a team {#work-with-a-team}
+
+Team members work on the same project in the Compositor. The project role and GitHub repository access are related but separate: someone may be able to edit in the Compositor while a GitHub invitation still needs attention.
+
+## Invite a collaborator {#invite-a-collaborator}
+
+The convenor can use the project's team controls to choose **+ Invite Collaborator** and enter a GitHub username.
+
+If that person already has a Compositor account, the project can be added to their account. Otherwise, the Compositor supplies an invitation link for you to share within 48 hours. Check the pending invitations list if they have not joined.
+
+Invite the account the person actually uses to sign in. A display name or email address is not a GitHub username.
+
+## Understand project roles {#understand-project-roles}
+
+- The **convenor** manages project membership and structural settings.
+- A **collaborator** edits content and can publish, upload files and run an upgrade.
+- An **instructor** receives editorial access through a course and has the same publishing rights.
+
+Some structural controls, including creating glossary entries and changing their IDs, belong to the convenor. Deletion controls also consider who created an item. The interface explains when your role cannot perform an action.
+
+## Check repository access {#check-repository-access}
+
+Open **Repository access** to see the GitHub status for each member. A pending invitation needs acceptance; an expired invitation can be reissued by the convenor.
+
+Members can accept their own invitation from this page or follow the GitHub invitation link if the Compositor cannot accept it. The convenor can add or withdraw repository access for other members where the controls allow it.
+
+Publishing uses the installed GitHub App. A successful Compositor publish does not by itself confirm that every member has accepted personal GitHub access.
+
+## Coordinate edits and publication {#coordinate-edits-and-publication}
+
+Wait for the collaboration connection to settle before starting. Agree who will edit a passage and who will publish the shared changes. Review the publication list together when several people have been working.
+
+Removing a collaborator takes away project access. Course instructors are managed through the course and cannot be removed individually while the site remains attached to it.
+
+**Check your work:** ask the collaborator to sign in, open the intended project and confirm their role. Continue with [course projects](/docs/the-compositor/courses/) if you are teaching a class.
diff --git a/content/en/docs/the-compositor/troubleshooting.md b/content/en/docs/the-compositor/troubleshooting.md
new file mode 100644
index 0000000..fc01ba7
--- /dev/null
+++ b/content/en/docs/the-compositor/troubleshooting.md
@@ -0,0 +1,44 @@
+---
+title: Resolve problems and recover stories
+url: /docs/the-compositor/troubleshooting/
+translationKey: docs-the-compositor-troubleshooting
+type: guide
+docs_draft: true
+docs_section: compositor
+---
+
+# Resolve problems and recover stories {#resolve-problems-and-recover-stories}
+
+First identify which version you are looking at: the editor's saved content, the files on GitHub or the built public site. Each has a different route to a correction.
+
+## The editor changed but the site did not {#the-editor-changed-but-the-site-did-not}
+
+Saving content keeps it in the Compositor. Publish the changes, then wait for the site's build to finish. If the publication succeeded but the build failed, read the build error rather than repeatedly publishing the same changes.
+
+Check the repository and language in the header, then open the public address from the project. A browser tab may still show an older page; reload it after the successful build.
+
+## An object or framing is wrong {#an-object-or-framing-is-wrong}
+
+Open the object and check its source address. A catalogue page is not an IIIF manifest. Use **Fetch Manifest** to check the address and verify the preview before adding a new object.
+
+If the story shows the wrong image, select the intended object in that step. If it shows the right image at the wrong view, choose the correct document page where relevant, adjust the framing and use **Capture position**. Wait for the captured confirmation, then revisit the step.
+
+## GitHub has different content {#github-has-different-content}
+
+Use [Changes on GitHub](/docs/the-compositor/sync-updates/) and review the affected items. Choose which version to keep for each one. The review preserves editor-only unpublished work; it is not a command to discard everything in the editor.
+
+If Google Sheets is enabled, check whether a build fetched content from the sheet. Decide which authoring method will supply future builds before editing both copies again.
+
+## Restore an unlisted story {#restore-an-unlisted-story}
+
+When story files exist on GitHub but are missing from the Compositor, **Start** can offer the convenor **Restore as drafts**.
+
+Restoration reads those files and brings the stories into the editor as drafts. Read any warnings, open the restored story and inspect its steps and panel references before making it publishable.
+
+**Ignore** dismisses this recovery route for the detected stories. It is not the same as deleting their files from GitHub.
+
+## A control is missing or an action is refused {#a-control-is-missing-or-an-action-is-refused}
+
+Check your project role and the [team and repository access guide](/docs/the-compositor/team/). Some controls belong to the convenor, and course membership controls come from the course.
+
+For help, record the project address, the action you attempted, the visible error and whether the problem affects the editor, publication or build. Share those details with the maintainer or in a [Telar issue](https://github.com/UCSB-AMPLab/telar/issues). Exclude access keys and private content.
diff --git a/docs/9-5-video-audio.md b/content/en/docs/the-compositor/video-audio.md
similarity index 79%
rename from docs/9-5-video-audio.md
rename to content/en/docs/the-compositor/video-audio.md
index c7ec73d..0a41430 100644
--- a/docs/9-5-video-audio.md
+++ b/content/en/docs/the-compositor/video-audio.md
@@ -1,20 +1,18 @@
---
-layout: docs
-title: "9.5. Video and Audio"
-parent: "9. The Compositor"
-grand_parent: Documentation
-nav_order: 5
-lang: en
-permalink: /docs/the-compositor/video-audio/
+title: Video and Audio
+url: /docs/the-compositor/video-audio/
+translationKey: docs-the-compositor-video-audio
+type: guide
+docs_section: compositor
---
-# Video and Audio
+# Video and Audio {#video-and-audio}
The Compositor supports video and audio objects alongside images. When a story step references a video or audio object, the viewer column shows the appropriate media player — an embedded video player or a waveform audio player — and provides tools for setting clip times and loop behavior.
For background on how video and audio objects work in Telar, see [Video Objects](/docs/your-content/video-objects/) and [Audio Objects](/docs/your-content/audio-objects/).
-## Media type detection
+## Media type detection {#media-type-detection}
The Compositor detects the media type of each object automatically based on its source URL. You do not need to configure the type manually — the Compositor reads the URL and determines whether the object is an image, a video, or an audio file.
@@ -24,7 +22,7 @@ Each step in the sidebar displays a media type badge to help you identify what k
- **Audio** — A music icon for audio objects
- **Text** — A text icon for steps with no media object
-## Supported video sources
+## Supported video sources {#supported-video-sources}
The Compositor recognizes video URLs from three platforms:
@@ -34,17 +32,19 @@ The Compositor recognizes video URLs from three platforms:
When a step references a video object, an inline video player appears in the viewer column with standard playback controls.
-## Audio objects
+{{< media id="external-media" >}}
+
+## Audio objects {#audio-objects}
Audio objects use self-hosted files stored in your repository at `telar-content/objects/`. The Compositor supports MP3, OGG, and M4A formats.
When a step references an audio object, the viewer column displays a WaveSurfer waveform player. The waveform provides a visual representation of the audio and includes play and pause controls.
-## Clip range
+## Clip range {#clip-range}
A clip is the segment of a video or audio file that plays during one step. You set it visually in the viewer rather than typing timestamps into a spreadsheet.
-### Video
+### Video {#video}
A clip timeline sits in the bar below the video. It spans the whole file, showing the clip as a highlighted region, with a thin marker that follows playback.
@@ -54,35 +54,37 @@ A clip timeline sits in the bar below the video. It spans the whole file, showin
The times at either end of the bar are where the clip begins and ends, and between them the bar gives the clip's length as **0:07 clip**. A brief **Clip saved** confirmation takes its place each time you change the range.
-### Audio
+### Audio {#audio}
Audio has no separate timeline. The waveform carries the clip region directly — drag its handles to set the start and end.
-### Checking a clip
+### Checking a clip {#checking-a-clip}
Below the player, the current clip reads as `clip 0:05 → 0:12`, or **No clip set** when the step plays the whole file.
**Preview clip** plays the clip on its own, so you can check exactly what a visitor will get without sitting through the rest of the file.
-{: .note }
-> Google Drive videos cannot be clipped. In place of the clip times, the viewer shows **Google Drive does not support clipping**.
+{{< callout "note" >}}
+Google Drive videos cannot be clipped. In place of the clip times, the viewer shows **Google Drive does not support clipping**.
+{{< /callout >}}
-{: .tip }
-> The Compositor sets the same `clip_start` and `clip_end` values described in [Video Objects](/docs/your-content/video-objects/) and [Audio Objects](/docs/your-content/audio-objects/). The two are interchangeable, so you can set a clip here and edit it later in your spreadsheet, or the other way round.
+{{< callout "tip" >}}
+The Compositor sets the same `clip_start` and `clip_end` values described in [Video Objects](/docs/your-content/video-objects/) and [Audio Objects](/docs/your-content/audio-objects/). The two are interchangeable, so you can set a clip here and edit it later in your spreadsheet, or the other way round.
+{{< /callout >}}
-## Loop toggle
+## Loop toggle {#loop-toggle}
Each step has a **Loop** switch that controls whether the clip repeats continuously when the audience reaches that step. When it is on, the clip plays in a loop until the audience advances to the next step.
The loop setting persists when you save and applies to both video and audio steps.
-## Genre and medium
+## Genre and medium {#genre-and-medium}
Objects have a type field that maps to the `medium_genre` column in `objects.csv`. The Compositor manages this field through the [Objects](/docs/the-compositor/objects/) metadata editor — you can set it when adding or editing an object.
The genre or medium value helps the objects gallery organize items by type and provides additional context for your audience when browsing the exhibition.
-## See also
+## See also {#see-also}
- [Story Editor](/docs/the-compositor/story-editor/) — Building stories with the visual editor
- [Publishing](/docs/the-compositor/publishing/) — Review and publish your changes
diff --git a/content/en/docs/workflows/_index.md b/content/en/docs/workflows/_index.md
new file mode 100644
index 0000000..4d4db6b
--- /dev/null
+++ b/content/en/docs/workflows/_index.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/workflows/
+translationKey: redirects-en-wf-workflows-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/setup/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/workflows/embedding.md b/content/en/docs/workflows/embedding.md
new file mode 100644
index 0000000..d50b95e
--- /dev/null
+++ b/content/en/docs/workflows/embedding.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/workflows/embedding/
+translationKey: redirects-en-wf-embedding-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/site-features/embedding/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/workflows/github-web.md b/content/en/docs/workflows/github-web.md
new file mode 100644
index 0000000..3104a25
--- /dev/null
+++ b/content/en/docs/workflows/github-web.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/workflows/github-web/
+translationKey: redirects-en-wf-github-web-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/setup/manual/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/workflows/google-sheets.md b/content/en/docs/workflows/google-sheets.md
new file mode 100644
index 0000000..03f61e8
--- /dev/null
+++ b/content/en/docs/workflows/google-sheets.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/workflows/google-sheets/
+translationKey: redirects-en-wf-google-sheets-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/your-data/google-sheets/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/workflows/guided-quickstart.md b/content/en/docs/workflows/guided-quickstart.md
new file mode 100644
index 0000000..3eb351b
--- /dev/null
+++ b/content/en/docs/workflows/guided-quickstart.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/workflows/guided-quickstart/
+translationKey: redirects-en-wf-guided-quickstart-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/getting-started/google-sheets/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/workflows/hybrid.md b/content/en/docs/workflows/hybrid.md
new file mode 100644
index 0000000..da81c78
--- /dev/null
+++ b/content/en/docs/workflows/hybrid.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/workflows/hybrid/
+translationKey: redirects-en-wf-hybrid-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/your-content/rich-content/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/workflows/local-dev.md b/content/en/docs/workflows/local-dev.md
new file mode 100644
index 0000000..6d6012c
--- /dev/null
+++ b/content/en/docs/workflows/local-dev.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/workflows/local-dev/
+translationKey: redirects-en-wf-local-dev-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/getting-started/local-dev/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/docs/workflows/upgrading.md b/content/en/docs/workflows/upgrading.md
new file mode 100644
index 0000000..86d83c1
--- /dev/null
+++ b/content/en/docs/workflows/upgrading.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /docs/workflows/upgrading/
+translationKey: redirects-en-wf-upgrading-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/setup/upgrading/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/docs/4-0-your-content.md b/content/en/docs/your-content/_index.md
similarity index 64%
rename from docs/4-0-your-content.md
rename to content/en/docs/your-content/_index.md
index 9ece51b..8b68c84 100644
--- a/docs/4-0-your-content.md
+++ b/content/en/docs/your-content/_index.md
@@ -1,16 +1,14 @@
---
-layout: docs
-title: "4. Your Content"
-parent: Documentation
-nav_order: 4
-has_children: true
-lang: en
-permalink: /docs/your-content/
+title: Your Content
+url: /docs/your-content/
+translationKey: docs-your-content
+type: guide
+docs_section: reference
---
-# Your Content
+# Your Content {#your-content}
-Your exhibition is built from several types of content — objects, images, stories, and supporting pages. All source content lives in the `telar-content/` folder of your repository. You define the structure through spreadsheet files (via [Google Sheets](/docs/your-data/google-sheets/) or [CSV](/docs/your-data/csv-project/)), and write longer narrative content in markdown files.
+Objects, stories, panels and supporting pages make up an exhibition. This reference describes their source files and formats. Use the [Compositor manual](/docs/the-compositor/) for visual editing, the [Sheets manual](/docs/google-sheets/) for spreadsheet authoring or the [local manual](/docs/local-authoring/) for CSV and Markdown files. All three routes produce a static site.
- [Objects](/docs/your-content/objects/) — The visual items your stories explore — images, maps, documents, photographs
- [Self-Hosted Images](/docs/your-content/self-hosted-images/) — Upload your own images and Telar generates zoomable tiles automatically
diff --git a/docs/4-10-audio-objects.md b/content/en/docs/your-content/audio-objects.md
similarity index 77%
rename from docs/4-10-audio-objects.md
rename to content/en/docs/your-content/audio-objects.md
index 48c16e0..3cddcc5 100644
--- a/docs/4-10-audio-objects.md
+++ b/content/en/docs/your-content/audio-objects.md
@@ -1,26 +1,24 @@
---
-layout: docs
-title: "4.10. Audio Objects"
-parent: "4. Your Content"
-grand_parent: Documentation
-nav_order: 10
-lang: en
-permalink: /docs/your-content/audio-objects/
+title: Audio Objects
+url: /docs/your-content/audio-objects/
+translationKey: docs-your-content-audio-objects
+type: guide
+docs_section: reference
---
-# Audio Objects
+# Audio Objects {#audio-objects}
Telar can display self-hosted audio files as objects in your exhibition. Audio works just like images and videos — you can build stories around recordings, focus on specific moments with clip control, and include them alongside your other objects.
Unlike video objects (which embed from external platforms), audio files live directly in your repository. Place your MP3, OGG, or M4A files in `telar-content/objects/` and Telar handles the rest.
-## Adding an audio object
+## Adding an audio object {#adding-an-audio-object}
To add an audio file, place it in `telar-content/objects/` with a filename matching the `object_id` in your objects spreadsheet.
For example, if your spreadsheet has an object with `object_id` = `field-recording-01`, name your file `field-recording-01.mp3`.
-### Supported formats
+### Supported formats {#supported-formats}
Telar recognizes three audio formats:
@@ -28,21 +26,21 @@ Telar recognizes three audio formats:
- **OGG** — open format with good compression
- **M4A** — common format from Apple devices and professional recorders
-## How audio appears
+## How audio appears {#how-audio-appears}
-### In stories
+### In stories {#in-stories}
When a story step references an audio object, a WaveSurfer waveform visualisation fills the viewer area with play/pause controls. If you set `clip_start` and `clip_end` values in your story spreadsheet, the player plays only the specified segment. This is useful for drawing attention to a particular moment in a longer recording.
-### On object pages
+### On object pages {#on-object-pages}
Each audio object has its own page (`/objects/{object-id}/`) with a full waveform player. Below the waveform, a clip picker lets you select start and end times by dragging region edges on the waveform — useful when building story steps. Copy the values directly into your story spreadsheet.
-### In the gallery
+### In the gallery {#in-the-gallery}
Audio objects appear in the objects gallery with a waveform icon on a grey background. The gallery's **Type** filter lets visitors browse by media type (Image, Video, or Audio).
-## Clip control
+## Clip control {#clip-control}
Story steps can specify a start time, end time, and loop setting for audio objects. The columns work exactly the same way as they do for video — see [Video Objects: Clip control](/docs/your-content/video-objects/#clip-control) for the full column reference and examples.
@@ -52,14 +50,15 @@ Story steps can specify a start time, end time, and loop setting for audio objec
| `clip_end` | `fin_clip` | End time in seconds |
| `loop` | `bucle` | Loop the clip (`true`, `yes`, or `sí`) |
-{: .tip }
-> You can also set clip times visually in the Compositor. See [Video and Audio in the Compositor](/docs/the-compositor/video-audio/) for details.
+{{< callout "tip" >}}
+You can also set clip times visually in the Compositor. See [Video and Audio in the Compositor](/docs/the-compositor/video-audio/) for details.
+{{< /callout >}}
-## Audio build pipeline
+## Audio build pipeline {#audio-build-pipeline}
Telar processes audio files during the build to extract clips and generate peak data for the waveform display. This is handled by `process_audio.py`, which runs automatically as part of the build.
-### Optional dependencies
+### Optional dependencies {#optional-dependencies}
Audio processing requires two external tools. These are only needed if your site includes audio objects — sites without audio do not need them.
@@ -80,10 +79,11 @@ brew install ffmpeg audiowaveform
sudo apt install ffmpeg audiowaveform
```
-{: .note }
-> **GitHub Actions handles this automatically.** The `build.yml` workflow detects audio files in your repository and installs these tools during the build. No manual setup is needed for deployed sites.
+{{< callout "note" >}}
+**GitHub Actions handles this automatically.** The `build.yml` workflow detects audio files in your repository and installs these tools during the build. No manual setup is needed for deployed sites.
+{{< /callout >}}
-## See also
+## See also {#see-also}
- [Video Objects](/docs/your-content/video-objects/) — Embedding video from external platforms
- [Objects](/docs/your-content/objects/) — Defining objects in your spreadsheet
diff --git a/docs/4-3-external-iiif.md b/content/en/docs/your-content/external-iiif.md
similarity index 82%
rename from docs/4-3-external-iiif.md
rename to content/en/docs/your-content/external-iiif.md
index 95dfa61..4b1a79f 100644
--- a/docs/4-3-external-iiif.md
+++ b/content/en/docs/your-content/external-iiif.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "4.3. External IIIF Images"
-parent: "4. Your Content"
-grand_parent: Documentation
-nav_order: 3
-lang: en
-permalink: /docs/your-content/external-iiif/
+title: External IIIF Images
+url: /docs/your-content/external-iiif/
+translationKey: docs-your-content-external-iiif
+type: guide
+docs_section: reference
---
-# External IIIF Images
+# External IIIF Images {#external-iiif-images}
Many museums, libraries, and archives make their collections available through a technology called [IIIF](https://iiif.io/) (International Image Interoperability Framework). This means you can build Telar stories around high-resolution images from institutions worldwide — without downloading or hosting the images yourself.
-## Finding IIIF images
+## Finding IIIF images {#finding-iiif-images}
Look for IIIF resources at:
@@ -23,7 +21,7 @@ Look for IIIF resources at:
When an institution supports IIIF, you'll typically find a manifest URL — a link that describes the image and its metadata. It usually ends in `info.json` or `manifest.json`.
-## Adding an external image
+## Adding an external image {#adding-an-external-image}
In your objects spreadsheet (Google Sheet or `objects.csv`):
@@ -35,7 +33,7 @@ In your objects spreadsheet (Google Sheet or `objects.csv`):
That's it. Telar will fetch the image directly from the institution's server when viewers visit your site.
-### Manifest URL formats
+### Manifest URL formats {#manifest-url-formats}
IIIF URLs typically look like:
@@ -44,7 +42,7 @@ IIIF URLs typically look like:
Telar supports both formats, and both IIIF versions (2.0 and 3.0).
-## Mixing self-hosted and external images
+## Mixing self-hosted and external images {#mixing-self-hosted-and-external-images}
You can use both your own images and external IIIF images in the same project. Leave `source_url` blank for objects that use self-hosted images:
@@ -55,7 +53,7 @@ museum-map,Museum Map,...,https://example.org/iiif/manifest.json
my-ceramic,My Ceramic,,,
```
-## Multi-page documents
+## Multi-page documents {#multi-page-documents}
Some IIIF manifests describe multi-page documents — digitized books, manuscripts, legal records, or maps with multiple sheets. These manifests contain multiple canvases, one per page.
@@ -66,11 +64,11 @@ object_id,title,source_url
new-laws,Recopilación de leyes,https://example.org/iiif/presentation/3/new-laws/manifest.json
```
-### Object pages
+### Object pages {#object-pages}
On object pages, the viewer shows the full document with page navigation controls — forward/back arrows and a page selector — so visitors can browse through all pages.
-### Stories
+### Stories {#stories}
In stories, each step can reference a specific page using the `page` column:
@@ -82,10 +80,11 @@ step,object,x,y,zoom,page,question,answer
The `page` column specifies which canvas (page) of the manifest to display. Page numbers start at 1.
-{: .tip }
-> **Finding coordinates for a specific page.** Navigate to the object page for your multi-page document. Use the page navigation controls to go to the page you want. Then use the coordinate picker — it automatically includes the current page number in the copied values.
+{{< callout "tip" >}}
+**Finding coordinates for a specific page.** Navigate to the object page for your multi-page document. Use the page navigation controls to go to the page you want. Then use the coordinate picker — it automatically includes the current page number in the copied values.
+{{< /callout >}}
-### Finding multi-page manifests
+### Finding multi-page manifests {#finding-multi-page-manifests}
Multi-page IIIF manifests are common at institutions that have digitized books and manuscripts:
@@ -96,11 +95,11 @@ Multi-page IIIF manifests are common at institutions that have digitized books a
Look for a "IIIF manifest" link on the item's page, or check the institution's IIIF documentation.
-## Automatic metadata extraction
+## Automatic metadata extraction {#automatic-metadata-extraction}
When you provide a `source_url`, Telar can automatically fill in metadata from the IIIF manifest — title, description, creator, period, location, and credit. This saves you from typing information that the institution has already recorded.
-### How to use it
+### How to use it {#how-to-use-it}
Add the IIIF manifest URL to your spreadsheet and leave the metadata fields blank:
@@ -116,7 +115,7 @@ When your site builds, Telar will:
3. Fill in any fields you left blank
4. Keep any values you entered yourself
-### Your data always takes priority
+### Your data always takes priority {#your-data-always-takes-priority}
You have full control over what gets extracted:
@@ -132,18 +131,18 @@ map-001,My Custom Title,,https://example.org/manifest.json,,,,
Telar will use "My Custom Title" (your value) and extract the description, creator, period, location, and credit from the manifest.
-### Language detection
+### Language detection {#language-detection}
Metadata extraction respects your site's language setting (`telar_language` in `_config.yml`):
- **English sites** (`en`) — Prioritizes English metadata, falls back to other languages
- **Spanish sites** (`es`) — Prioritizes Spanish metadata, then English, then others
-### Smart credit detection
+### Smart credit detection {#smart-credit-detection}
For the `credit` field, Telar filters out legal boilerplate (Creative Commons URLs, generic rights statements) and looks for meaningful attribution lines — the institution name, the rights holder, or the credit line.
-### What Telar looks for
+### What Telar looks for {#what-telar-looks-for}
Different institutions label their metadata differently. Telar searches for common variations:
@@ -156,7 +155,7 @@ Different institutions label their metadata differently. Telar searches for comm
| location | Repository, Holding Institution, Current Location |
| credit | Attribution, Rights Holder, Credit Line, Provider |
-### When to override
+### When to override {#when-to-override}
You might want to enter your own values when:
@@ -165,14 +164,14 @@ You might want to enter your own values when:
- The description is too technical for your audience
- You want a shorter or simpler version of a field
-### Build-time processing
+### Build-time processing {#build-time-processing}
Metadata extraction happens automatically during the site build:
- **GitHub Pages**: Runs during deployment — no action needed
- **Local development**: Run `python3 scripts/csv_to_json.py` when you add or update manifest URLs
-### Validation
+### Validation {#validation}
During the build, Telar checks each manifest:
@@ -182,33 +181,33 @@ During the build, Telar checks each manifest:
Check your build logs for extraction status.
-### Limitations
+### Limitations {#limitations}
- Only works with **external IIIF manifests** (self-hosted images don't have manifests to extract from)
- Manifests must be publicly accessible (no login required)
- HTML tags are removed from extracted text
- Some manifests may not include metadata fields
-## Troubleshooting
+## Troubleshooting {#troubleshooting}
-### Image not loading
+### Image not loading {#image-not-loading}
- Verify the manifest URL is correct — try opening it directly in your browser
- Make sure the resource is publicly accessible (no authentication required)
- Check that you pasted the full URL including `info.json` or `manifest.json`
-### Metadata not appearing
+### Metadata not appearing {#metadata-not-appearing}
- Check your build logs for extraction warnings
- The manifest may not include the fields you expect
- Try entering the values manually in your spreadsheet
-### Slow loading
+### Slow loading {#slow-loading}
- External images load from the institution's server — speed depends on their infrastructure
- Some institutions may throttle requests from unfamiliar sites
-## See also
+## See also {#see-also}
- [Self-Hosted Images](/docs/your-content/self-hosted-images/) — Upload your own images instead of using external sources
- [PDF Documents](/docs/your-content/pdf-documents/) — Self-hosting multi-page PDF documents
diff --git a/docs/4-6-markdown-syntax.md b/content/en/docs/your-content/markdown-syntax.md
similarity index 75%
rename from docs/4-6-markdown-syntax.md
rename to content/en/docs/your-content/markdown-syntax.md
index dc6b3ae..454e00e 100644
--- a/docs/4-6-markdown-syntax.md
+++ b/content/en/docs/your-content/markdown-syntax.md
@@ -1,22 +1,21 @@
---
-layout: docs
-title: "4.6. Markdown Syntax"
-parent: "4. Your Content"
-grand_parent: Documentation
-nav_order: 6
-lang: en
-permalink: /docs/your-content/markdown-syntax/
+title: Markdown Syntax Reference
+url: /docs/your-content/markdown-syntax/
+translationKey: docs-your-content-markdown-syntax
+type: guide
katex: true
+docs_section: reference
---
-# Markdown Syntax Reference
+# Markdown Syntax Reference {#markdown-syntax-reference}
Panel content in Telar supports rich markdown formatting. This reference covers the syntax most useful for narrative content.
-{: .note }
-> **This reference covers panel content**: these options apply to `layer1_content` and `layer2_content`, and to the markdown files they point to. A step's `question` and `answer` work differently. The question is a heading, so it is plain text with no markdown processing. Answers are reduced to plain prose, and Telar cuts any answer over 18 lines. See [Answers Are Plain Prose](/docs/your-data/csv-stories/#answers-are-plain-prose).
+{{< callout "note" >}}
+**This reference covers panel content**: these options apply to `layer1_content` and `layer2_content`, and to the markdown files they point to. A step's `question` and `answer` work differently. The question is a heading, so it is plain text with no markdown processing. Answers are reduced to plain prose, and Telar cuts any answer over 18 lines. See [Answers Are Plain Prose](/docs/your-data/csv-stories/#answers-are-plain-prose).
+{{< /callout >}}
-## What is Markdown?
+## What is Markdown? {#what-is-markdown}
Markdown is a lightweight markup language that lets you format text using simple, readable syntax. Instead of complex HTML tags, you write in plain text with special characters like `*` for emphasis or `#` for headings. Markdown is:
@@ -25,7 +24,7 @@ Markdown is a lightweight markup language that lets you format text using simple
- **Portable**: Plain text files work everywhere
- **Convertible**: Automatically converted to HTML for display
-### Learning Resources
+### Learning Resources {#learning-resources}
New to markdown? These resources will help:
@@ -37,14 +36,15 @@ In case you're wondering, Telar uses the [Python Markdown](https://python-markdo
---
-## Panel Content Methods
+## Panel Content Methods {#panel-content-methods}
You can provide panel content in three ways. For full details, see the [CSV Reference: Stories](/docs/your-data/csv-stories/#layer-content).
-{: .note }
-> The three methods that follow describe authoring in a spreadsheet. In the Compositor, the panel title has its own field, and anything pasted into the **Content** field — a `---` block included — is published as part of the panel's text, not read as a title.
+{{< callout "note" >}}
+The three methods that follow describe authoring in a spreadsheet. In the Compositor, the panel title has its own field, and anything pasted into the **Content** field — a `---` block included — is published as part of the panel's text, not read as a title.
+{{< /callout >}}
-### Method 1: Entering Text Directly
+### Method 1: Entering Text Directly {#method-1-entering-text-directly}
Type panel text directly in your spreadsheet's `layer1_content` column:
@@ -54,7 +54,7 @@ Type panel text directly in your spreadsheet's `layer1_content` column:
Line breaks in your spreadsheet cell create paragraph breaks. The panel title defaults to the button text.
-### Method 2: Pasting Markdown Text
+### Method 2: Pasting Markdown Text {#method-2-pasting-markdown-text}
Paste text from a plain text editor. You can include headings, widgets, and a custom panel title using YAML frontmatter:
@@ -71,10 +71,11 @@ weaving technique that was common in the colonial period.
These patterns were created using...
```
-{: .warning }
-> If you copy and paste from Microsoft Word, Google Docs, or similar applications, formatting will **not** be preserved. Write in markdown syntax instead.
+{{< callout "warning" >}}
+If you copy and paste from Microsoft Word, Google Docs, or similar applications, formatting will **not** be preserved. Write in markdown syntax instead.
+{{< /callout >}}
-### Method 3: Referencing a Markdown File
+### Method 3: Referencing a Markdown File {#method-3-referencing-a-markdown-file}
For complex content, reference a markdown file saved in `telar-content/texts/stories/`:
@@ -91,9 +92,9 @@ The file uses frontmatter for the panel title and supports all markdown features
---
-## Basic Formatting
+## Basic Formatting {#basic-formatting}
-### Headings
+### Headings {#headings}
```markdown
## Second Level Heading
@@ -101,10 +102,11 @@ The file uses frontmatter for the panel title and supports all markdown features
#### Fourth Level Heading
```
-{: .note }
-> **Tip**: Don't use `# First Level` in panels — each panel already has a title.
+{{< callout "note" >}}
+**Tip**: Don't use `# First Level` in panels — each panel already has a title.
+{{< /callout >}}
-### Text Styling
+### Text Styling {#text-styling}
```markdown
**Bold text** for emphasis
@@ -112,7 +114,7 @@ The file uses frontmatter for the panel title and supports all markdown features
***Bold and italic*** for maximum emphasis
```
-### Lists
+### Lists {#lists}
Unordered lists:
```markdown
@@ -130,14 +132,14 @@ Ordered lists:
3. Third step
```
-### Links
+### Links {#links}
```markdown
[Link text](https://example.com)
[Internal link](/objects/textile-001/)
```
-### Blockquotes
+### Blockquotes {#blockquotes}
```markdown
> This is a blockquote.
@@ -146,17 +148,17 @@ Ordered lists:
---
-## Images
+## Images {#images}
Telar provides special syntax for controlling image sizes in panels.
-### Basic Syntax
+### Basic Syntax {#basic-syntax}
```markdown
{size}
```
-### Size Options
+### Size Options {#size-options}
| Size | Keyword | Max Width | Use Case |
|------|---------|-----------|----------|
@@ -165,7 +167,7 @@ Telar provides special syntax for controlling image sizes in panels.
| Large | `{lg}` or `{large}` | 700px | Featured images, detailed views |
| Full | `{full}` | 100% | Panoramas, full-width visuals |
-### Image Paths
+### Image Paths {#image-paths}
**Relative paths** (no leading slash) automatically load from `/telar-content/objects/`:
@@ -186,7 +188,7 @@ Telar provides special syntax for controlling image sizes in panels.
{lg}
```
-### Examples
+### Examples {#examples}
```markdown
{small}
@@ -195,10 +197,11 @@ Telar provides special syntax for controlling image sizes in panels.
{full}
```
-{: .tip }
-> **Default Size**: Images without a size tag default to medium (450px). Always include size tags for clarity.
+{{< callout "tip" >}}
+**Default Size**: Images without a size tag default to medium (450px). Always include size tags for clarity.
+{{< /callout >}}
-### Image Captions
+### Image Captions {#image-captions}
Add a caption to any image by placing text on the line immediately after the image:
@@ -222,9 +225,9 @@ The `caption:` prefix is stripped from the displayed text.
---
-## Rich Media
+## Rich Media {#rich-media}
-### YouTube Videos
+### YouTube Videos {#youtube-videos}
Embed responsive YouTube videos using iframe HTML:
@@ -242,7 +245,7 @@ Replace `VIDEO_ID` with your YouTube video ID.
The `padding-bottom: 56.25%` creates a 16:9 aspect ratio container.
-### Other Iframes
+### Other Iframes {#other-iframes}
Any iframe-embeddable content works:
@@ -256,9 +259,9 @@ Any iframe-embeddable content works:
---
-## Code
+## Code {#code}
-### Inline Code
+### Inline Code {#inline-code}
Use backticks for `inline code` references:
@@ -266,7 +269,7 @@ Use backticks for `inline code` references:
The `object_id` field must match the filename.
```
-### Code Blocks
+### Code Blocks {#code-blocks}
Use triple backticks for code blocks:
@@ -289,7 +292,7 @@ description: A compelling narrative
---
-## Footnotes
+## Footnotes {#footnotes}
Create footnotes with `[^1]` syntax:
@@ -305,15 +308,15 @@ Footnotes work in panel content only. If you put one in a step's `answer`, Telar
---
-## Math and Science Notation (LaTeX)
+## Math and Science Notation (LaTeX) {#math-and-science-notation-latex}
Telar supports LaTeX math rendering via [KaTeX](https://katex.org/). You can include mathematical formulas, chemical equations, and scientific notation anywhere markdown appears: story panels, glossary definitions, object descriptions, and custom pages.
-### How It Works
+### How It Works {#how-it-works}
Telar automatically detects LaTeX in your content at build time. No configuration is needed — if your text contains LaTeX notation, it will render as formatted math.
-### Inline Math
+### Inline Math {#inline-math}
Wrap expressions in single dollar signs to display math inline with surrounding text:
@@ -323,10 +326,11 @@ The coefficient is $C = \frac{8}{35}$ and the polynomial is $P_4(x)$.
<p><strong>Renders as:</strong> The coefficient is $C = \frac{8}{35}$ and the polynomial is $P_4(x)$.</p>
-{: .warning }
-> **Dollar sign heuristic**: To avoid false positives with currency (e.g. "$50"), Telar only treats `$...$` as math when the content contains LaTeX-like characters such as `\`, `^`, `_`, or `{`. Double dollar signs (`$$...$$`) are always treated as math.
+{{< callout "warning" >}}
+**Dollar sign heuristic**: To avoid false positives with currency (e.g. "$50"), Telar only treats `$...$` as math when the content contains LaTeX-like characters such as `\`, `^`, `_`, or `{`. Double dollar signs (`$$...$$`) are always treated as math.
+{{< /callout >}}
-### Display Math
+### Display Math {#display-math}
Wrap expressions in double dollar signs for centered, standalone equations:
@@ -343,7 +347,7 @@ You can also use `\[...\]` delimiters:
\[E = mc^2\]
```
-### Multi-line Equations
+### Multi-line Equations {#multi-line-equations}
Use `\begin{align}...\end{align}` for aligned multi-line equations. Use `&` to mark alignment points and `\\` for line breaks:
@@ -358,7 +362,7 @@ P_2(x) &= \frac{1}{2}(3x^2 - 1)
<p><strong>Renders as:</strong></p>
<p>$$\begin{align} P_0(x) &= 1\\ P_1(x) &= x\\ P_2(x) &= \frac{1}{2}(3x^2 - 1) \end{align}$$</p>
-### Supported Environments
+### Supported Environments {#supported-environments}
| Environment | Purpose |
|------------|---------|
@@ -368,7 +372,7 @@ P_2(x) &= \frac{1}{2}(3x^2 - 1)
| `pmatrix` | Parenthesized matrices |
| `bmatrix` | Bracketed matrices |
-### Chemical Formulas
+### Chemical Formulas {#chemical-formulas}
Telar includes the [mhchem](https://mhchem.github.io/MathJax-mhchem/) extension for chemical notation:
@@ -381,7 +385,7 @@ $$\ce{CO2 + C -> 2CO}$$
<p><strong>Renders as:</strong> The reaction $\ce{2H2 + O2 -> 2H2O}$ produces water.</p>
<p>$$\ce{CO2 + C -> 2CO}$$</p>
-### Where LaTeX Works
+### Where LaTeX Works {#where-latex-works}
| Content type | How it loads |
|-------------|-------------|
@@ -392,15 +396,15 @@ $$\ce{CO2 + C -> 2CO}$$
| Custom pages | Always available |
| Encrypted stories | Loaded automatically after decryption |
-### Full Syntax Reference
+### Full Syntax Reference {#full-syntax-reference}
For the complete list of supported LaTeX commands, see the [KaTeX function support table](https://katex.org/docs/supported).
---
-## Best Practices
+## Best Practices {#best-practices}
-### Alt Text for Accessibility
+### Alt Text for Accessibility {#alt-text-for-accessibility}
Always provide descriptive alt text for images:
@@ -409,7 +413,7 @@ Always provide descriptive alt text for images:
❌ {lg}
```
-### Image Organization
+### Image Organization {#image-organization}
Keep panel images in `/telar-content/objects/` for easy reference:
@@ -421,14 +425,14 @@ telar-content/objects/
└── ...
```
-### Content Length
+### Content Length {#content-length}
- **Layer 1**: 2-3 paragraphs of context
- **Layer 2**: Longer scholarly content, citations, extended analysis
Break up long text with headings, lists, and images for better readability.
-### File Naming
+### File Naming {#file-naming}
Use descriptive, lowercase filenames with hyphens:
@@ -439,17 +443,17 @@ Use descriptive, lowercase filenames with hyphens:
---
-## Quick Reference
+## Quick Reference {#quick-reference}
Copy-paste examples for the most common formatting tasks:
-### Add an image with caption
+### Add an image with caption {#add-an-image-with-caption}
```markdown
{lg}
Detail of the warp threads, circa 1650.
```
-### Add a YouTube video
+### Add a YouTube video {#add-a-youtube-video}
```html
<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; margin: 1.5rem 0;">
<iframe style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"
@@ -458,31 +462,31 @@ Detail of the warp threads, circa 1650.
</div>
```
-### Add a citation with footnote
+### Add a citation with footnote {#add-a-citation-with-footnote}
```markdown
Recent scholarship challenges this interpretation.[^1]
[^1]: García, M. (2023). *Rethinking Colonial Textiles*. University Press.
```
-### Link to a glossary term
+### Link to a glossary term {#link-to-a-glossary-term}
```markdown
The [[encomienda]] system structured colonial tributary relations.
```
-### Link to another object
+### Link to another object {#link-to-another-object}
```markdown
Compare with the [Lima textile](/objects/textile-lima/).
```
-### Add inline and display math
+### Add inline and display math {#add-inline-and-display-math}
```markdown
The coefficient is $C = \frac{8}{35}$ and the result is:
$$x^4 = \frac{8}{35}P_4(x) + \frac{4}{7}P_2(x) + \frac{1}{5}P_0(x)$$
```
-### Create a blockquote
+### Create a blockquote {#create-a-blockquote}
```markdown
> "The patterns speak to a sophisticated understanding of geometry."
> — Author
@@ -490,7 +494,7 @@ $$x^4 = \frac{8}{35}P_4(x) + \frac{4}{7}P_2(x) + \frac{1}{5}P_0(x)$$
---
-## Limitations
+## Limitations {#limitations}
- **No JavaScript**: Markdown is converted to static HTML
- **No custom HTML attributes**: Use the provided size syntax instead of custom classes
@@ -499,8 +503,8 @@ $$x^4 = \frac{8}{35}P_4(x) + \frac{4}{7}P_2(x) + \frac{1}{5}P_0(x)$$
---
-## Next Steps
+## Next Steps {#next-steps}
- [Your Content Guide](/docs/your-content/) - Learn how to organize your markdown files
- [Rich Content with Markdown](/docs/your-content/rich-content/) - Create and edit markdown files
-- [Advanced Styling](/docs/developers/styling/) - Customize panel appearance
\ No newline at end of file
+- [Advanced Styling](/docs/developers/styling/) - Customize panel appearance
diff --git a/docs/4-1-objects.md b/content/en/docs/your-content/objects.md
similarity index 81%
rename from docs/4-1-objects.md
rename to content/en/docs/your-content/objects.md
index 6134cbd..fb297d7 100644
--- a/docs/4-1-objects.md
+++ b/content/en/docs/your-content/objects.md
@@ -1,21 +1,20 @@
---
-layout: docs
-title: "4.1. Objects"
-parent: "4. Your Content"
-grand_parent: Documentation
-nav_order: 1
-lang: en
-permalink: /docs/your-content/objects/
+title: Objects
+url: /docs/your-content/objects/
+translationKey: docs-your-content-objects
+type: guide
+docs_section: reference
---
-# Objects
+# Objects {#objects}
Objects are the materials at the center of your Telar site — images, videos, audio recordings, documents, and other materials that your stories explore.
-{: .tip }
-> The [Compositor](/docs/the-compositor/objects/) provides a visual interface for managing objects — including IIIF manifest auto-fetch, image upload, and metadata editing.
+{{< callout "tip" >}}
+The [Compositor](/docs/the-compositor/objects/) provides a visual interface for managing objects — including IIIF manifest auto-fetch, image upload, and metadata editing.
+{{< /callout >}}
-## Defining Objects
+## Defining Objects {#defining-objects}
Every object in your site is defined as a row in your objects spreadsheet — either in the objects tab of your Google Sheet, or in `objects.csv` (or `objetos.csv`) in `telar-content/spreadsheets/`.
@@ -31,7 +30,7 @@ map-lima,Map of Lima
- **`title`** — The display name
- **`alt_text`** — Alternative text for accessibility (optional). Falls back to `title` if left empty.
-### Media type detection
+### Media type detection {#media-type-detection}
Telar automatically determines whether an object is an image, video, or audio file based on its source — no additional configuration is needed:
@@ -47,10 +46,11 @@ For videos and audio, see [Video Objects](/docs/your-content/video-objects/) and
You can add richer metadata for each object — description, creator, period, year, `medium` (the genre or medium of the object, e.g. "Photograph", "Oil painting", "Oral history"), dimensions, source, credit, and more. See the [Object Columns](/docs/your-data/csv-objects/) reference for the complete column list.
-{: .note }
-> The `medium` column (previously `object_type`) describes the genre or medium of the object — not the media type (Image, Video, Audio), which Telar detects automatically. The column name `object_type` still works for backward compatibility.
+{{< callout "note" >}}
+The `medium` column (previously `object_type`) describes the genre or medium of the object — not the media type (Image, Video, Audio), which Telar detects automatically. The column name `object_type` still works for backward compatibility.
+{{< /callout >}}
-## Object Pages
+## Object Pages {#object-pages}
Each object gets its own page at `/objects/{object_id}/`. The page shows:
@@ -62,13 +62,13 @@ Each object gets its own page at `/objects/{object_id}/`. The page shows:
-### Coordinate Picker
+### Coordinate Picker {#coordinate-picker}
The coordinate picker is a development tool on each object page. Click or zoom on the image, then read the normalized coordinates (0–1 range) displayed below the viewer. Use the **Copy** buttons to copy coordinates directly into your story CSV.
-## See Also
+## See Also {#see-also}
- [Objects Gallery](/docs/site-features/objects-gallery/) — Browse, search, and filter your collection
- [Object Columns](/docs/your-data/csv-objects/) — Complete column reference for objects.csv
diff --git a/docs/4-8-pdf-documents.md b/content/en/docs/your-content/pdf-documents.md
similarity index 71%
rename from docs/4-8-pdf-documents.md
rename to content/en/docs/your-content/pdf-documents.md
index b595011..c866893 100644
--- a/docs/4-8-pdf-documents.md
+++ b/content/en/docs/your-content/pdf-documents.md
@@ -1,20 +1,18 @@
---
-layout: docs
-title: "4.8. PDF Documents"
-parent: "4. Your Content"
-grand_parent: Documentation
-nav_order: 8
-lang: en
-permalink: /docs/your-content/pdf-documents/
+title: PDF Documents
+url: /docs/your-content/pdf-documents/
+translationKey: docs-your-content-pdf-documents
+type: guide
+docs_section: reference
---
-# PDF Documents
+# PDF Documents {#pdf-documents}
Telar can display multi-page PDF documents — books, legal records, manuscripts, maps — as zoomable, high-resolution objects. Each page of a PDF becomes a deep-zoom image, just like a photograph or scan.
This means you can build stories that zoom into specific pages and regions of a document, guiding your audience through details that might otherwise go unnoticed.
-## Adding a PDF
+## Adding a PDF {#adding-a-pdf}
Adding a PDF works the same way as adding an image. Place the file in `telar-content/objects/` with a filename matching the `object_id` in your spreadsheet.
@@ -36,10 +34,11 @@ For example, if your spreadsheet has an object with `object_id` = `new-laws`, na
python3 scripts/generate_iiif.py --base-url http://localhost:4001
```
-{: .note }
-> Telar renders every page of the PDF as a high-resolution image during the build process. A 40-page PDF will produce 40 separate page images, each with its own set of zoom tiles. Build times increase with page count.
+{{< callout "note" >}}
+Telar renders every page of the PDF as a high-resolution image during the build process. A 40-page PDF will produce 40 separate page images, each with its own set of zoom tiles. Build times increase with page count.
+{{< /callout >}}
-## How it works
+## How it works {#how-it-works}
When you add a PDF and build your site:
@@ -49,7 +48,7 @@ When you add a PDF and build your site:
4. On object pages, the viewer shows the full document with page navigation
5. In stories, each step can reference a specific page
-## Object pages vs. stories
+## Object pages vs. stories {#object-pages-vs-stories}
PDFs behave differently depending on the context:
@@ -57,7 +56,7 @@ PDFs behave differently depending on the context:
- **Stories** show one page at a time. Each story step specifies which page to display using the `page` column in your spreadsheet. The viewer zooms to the coordinates you set for that page, just like it does for a photograph.
-## Linking to a page
+## Linking to a page {#linking-to-a-page}
To send someone straight to a particular page of a document, open the object page, go to that page with the page navigation controls, and copy the address from your browser's address bar. It ends in `?page=` and the page number:
@@ -75,7 +74,7 @@ This works the same way for any multi-page object, including one from a multi-pa
You can use this address in any link on your site, for example in a glossary entry or a panel.
-## Using PDFs in stories
+## Using PDFs in stories {#using-pdfs-in-stories}
To reference a specific page of a PDF in a story step, add a `page` column to your story spreadsheet. The value is the page number (starting from 1).
@@ -89,17 +88,18 @@ step,object,x,y,zoom,page,question,answer
- Steps 1 and 2 reference pages 1 and 10 of the `new-laws` PDF
- Step 3 references a regular image (`textile-001`) with no `page` value — the column is left empty for single-image objects
-{: .tip }
-> **Finding coordinates for a specific page.** Navigate to the object page for your PDF (`/objects/new-laws/`). Use the page navigation controls to go to the page you want. Then use the coordinate picker — it automatically includes the current page number in the copied values.
+{{< callout "tip" >}}
+**Finding coordinates for a specific page.** Navigate to the object page for your PDF (`/objects/new-laws/`). Use the page navigation controls to go to the page you want. Then use the coordinate picker — it automatically includes the current page number in the copied values.
+{{< /callout >}}
-### The `page` column
+### The `page` column {#the-page-column}
- **Page numbers start at 1** (page 1 is the first page of the PDF)
- **Must be a positive integer** — decimal or negative values produce a warning
- **Leave empty for single-image objects** — Telar ignores empty `page` values
- **Bilingual column names**: `page` (English) or `pagina` / `página` (Spanish)
-## Supported PDF types
+## Supported PDF types {#supported-pdf-types}
Telar renders PDFs using PyMuPDF, which handles most standard PDF files:
@@ -107,10 +107,11 @@ Telar renders PDFs using PyMuPDF, which handles most standard PDF files:
- **Native PDFs** — Documents with embedded text and vector graphics
- **Mixed PDFs** — Documents combining scanned images and native text
-{: .note }
-> PDF rendering quality depends on the source document. Scanned pages at 300 DPI or higher produce the best deep-zoom results. Low-resolution scans may appear blurry when zoomed in.
+{{< callout "note" >}}
+PDF rendering quality depends on the source document. Scanned pages at 300 DPI or higher produce the best deep-zoom results. Low-resolution scans may appear blurry when zoomed in.
+{{< /callout >}}
-## Size considerations
+## Size considerations {#size-considerations}
PDFs produce more data than single images because every page generates its own tile pyramid:
@@ -118,33 +119,35 @@ PDFs produce more data than single images because every page generates its own t
- A 100-page document can add significant build time and repository size
- Consider using only the pages you need rather than including the entire document
-{: .note }
-> **If your site is hosted on GitHub Pages** (the default for most Telar sites), keep in mind that GitHub does not allow individual files larger than 100 MB, and recommends keeping the total repository size under 1 GB. A large PDF plus all the zoom tiles it generates can add up quickly.
+{{< callout "note" >}}
+**If your site is hosted on GitHub Pages** (the default for most Telar sites), keep in mind that GitHub does not allow individual files larger than 100 MB, and recommends keeping the total repository size under 1 GB. A large PDF plus all the zoom tiles it generates can add up quickly.
+{{< /callout >}}
-{: .tip }
-> **For very large documents** (100+ pages), check whether a library or archive already hosts a digitized version with a IIIF manifest. If so, you can use the manifest URL in your `source_url` column instead of self-hosting the PDF. See [External IIIF Images](/docs/your-content/external-iiif/) for how to find and use these manifests.
+{{< callout "tip" >}}
+**For very large documents** (100+ pages), check whether a library or archive already hosts a digitized version with a IIIF manifest. If so, you can use the manifest URL in your `source_url` column instead of self-hosting the PDF. See [External IIIF Images](/docs/your-content/external-iiif/) for how to find and use these manifests.
+{{< /callout >}}
-## Troubleshooting
+## Troubleshooting {#troubleshooting}
-### PDF not loading
+### PDF not loading {#pdf-not-loading}
- Check that the file exists in `telar-content/objects/`
- Make sure the filename (without `.pdf`) matches the `object_id` in your spreadsheet
- Verify the object has a blank `source_url` column
- Make sure IIIF tiles have been generated (check that `iiif/objects/{object-id}/` exists)
-### Wrong page displayed in story
+### Wrong page displayed in story {#wrong-page-displayed-in-story}
- Check the `page` value in your story spreadsheet — it should be a positive integer
- Page numbers start at 1, not 0
- Use the coordinate picker on the object page to verify the correct page number
-### Build errors
+### Build errors {#build-errors}
- Make sure PyMuPDF is installed (`pip install pymupdf`)
- If PyMuPDF is not available, Telar skips PDF files with an info message — other objects still process normally
-## See also
+## See also {#see-also}
- [Self-Hosted Images](/docs/your-content/self-hosted-images/) — Adding photographs and scans
- [Objects](/docs/your-content/objects/) — Defining objects in your spreadsheet
diff --git a/docs/4-5-rich-content.md b/content/en/docs/your-content/rich-content.md
similarity index 70%
rename from docs/4-5-rich-content.md
rename to content/en/docs/your-content/rich-content.md
index f9ff58d..7daac3b 100644
--- a/docs/4-5-rich-content.md
+++ b/content/en/docs/your-content/rich-content.md
@@ -1,21 +1,23 @@
---
-layout: docs
-title: "4.5. Rich Content with Markdown"
-parent: "4. Your Content"
-grand_parent: Documentation
-nav_order: 5
-lang: en
-permalink: /docs/your-content/rich-content/
+title: Rich Content with Markdown
+url: /docs/your-content/rich-content/
+translationKey: docs-your-content-rich-content
+type: guide
+docs_section: reference
---
-# Rich Content with Markdown
+# Rich Content with Markdown {#rich-content-with-markdown}
Your site is running and your stories are in the spreadsheet. Now you want richer panels — this guide shows you how to add markdown files for story panels that need more than a few paragraphs of text.
-{: .note }
-> This guide builds on the setup guides. Complete one of the [Getting Started](/docs/getting-started/) setup options first if you haven't already.
+{{< callout "note" >}}
+This guide builds on the setup guides. Complete one of the [Getting Started](/docs/getting-started/) setup options first if you haven't already.
+{{< /callout >}}
-## When to Add Markdown Files
+
+This page explains panel content in files and spreadsheets. In the Compositor, edit a panel's title in its title field and its content in the panel editor; the same formatting reference applies to its body.
+
+## When to Add Markdown Files {#when-to-add-markdown-files}
The spreadsheet handles most Telar exhibitions well. Consider adding markdown files when you need:
@@ -27,13 +29,13 @@ The spreadsheet handles most Telar exhibitions well. Consider adding markdown fi
If your panels are mostly 1-2 paragraphs, you probably do not need this workflow. Stay with Google Sheets and come back here if your needs grow.
-## How It Works
+## How It Works {#how-it-works}
The hybrid approach is simple: your story structure stays in Google Sheets, but instead of writing panel text in a spreadsheet cell, you point to a markdown file in your repository.
Telar auto-detects the difference. If the value in a `layer1_content` or `layer2_content` cell ends in `.md`, Telar loads the file. Otherwise, it treats the value as inline text. You can mix both approaches freely — some steps with inline text, others with file references.
-## Step 1: Create Your Markdown File
+## Step 1: Create Your Markdown File {#step-1-create-your-markdown-file}
1. In your GitHub repository, navigate to `telar-content/texts/stories/`
2. If your story is `story-1`, create a folder called `story-1/` (or any name you like)
@@ -48,24 +50,24 @@ Telar auto-detects the difference. If the value in a `layer1_content` or `layer2
-{: .tip }
-
-> **File Organization**
-> A common pattern is one folder per story, with files named by step and topic:
->
-> ```
-> telar-content/texts/stories/
-> story-1/
-> step1-techniques.md
-> step2-materials.md
-> step3-history.md
-> story-2/
-> step1-overview.md
-> ```
->
-> But any organization works — Telar only cares about the path you put in the spreadsheet.
-
-## Step 2: Link the File from Your Spreadsheet
+{{< callout "tip" >}}
+**File Organization**
+A common pattern is one folder per story, with files named by step and topic:
+
+```
+telar-content/texts/stories/
+ story-1/
+ step1-techniques.md
+ step2-materials.md
+ step3-history.md
+ story-2/
+ step1-overview.md
+```
+
+But any organization works — Telar only cares about the path you put in the spreadsheet.
+{{< /callout >}}
+
+## Step 2: Link the File from Your Spreadsheet {#step-2-link-the-file-from-your-spreadsheet}
In your Google Sheet, put the file path in the `layer1_content` or `layer2_content` column. The path is relative to `telar-content/texts/stories/`:
@@ -77,9 +79,9 @@ In your Google Sheet, put the file path in the `layer1_content` or `layer2_conte
Notice how step 2 uses inline text while steps 1 and 3 reference files. You can mix and match freely.
-## Writing Markdown Content
+## Writing Markdown Content {#writing-markdown-content}
-### Basic Structure
+### Basic Structure {#basic-structure}
A markdown file for a story panel looks like this:
@@ -99,7 +101,7 @@ that predates European contact by thousands of years.
The `title` in the frontmatter (the section between `---` lines) becomes the panel heading. If you leave it out, Telar uses the button text instead.
-### Formatting Basics
+### Formatting Basics {#formatting-basics}
Markdown uses simple characters for formatting:
@@ -113,12 +115,12 @@ Markdown uses simple characters for formatting:
| `[text](url)` | A clickable link |
| `> quote` | A blockquote |
-{: .tip }
+{{< callout "tip" >}}
+**New to Markdown?**
+Try the [CommonMark Tutorial](https://commonmark.org/help/) — it takes about 10 minutes and covers everything you need for Telar panels.
+{{< /callout >}}
-> **New to Markdown?**
-> Try the [CommonMark Tutorial](https://commonmark.org/help/) — it takes about 10 minutes and covers everything you need for Telar panels.
-
-### What Markdown Files Can Do That Inline Text Cannot
+### What Markdown Files Can Do That Inline Text Cannot {#what-markdown-files-can-do-that-inline-text-cannot}
Markdown files support the full range of Telar's content features:
@@ -129,7 +131,7 @@ Markdown files support the full range of Telar's content features:
These features work best in files because they use multi-line syntax that is hard to manage inside a spreadsheet cell.
-## Editing Markdown Files on GitHub
+## Editing Markdown Files on GitHub {#editing-markdown-files-on-github}
You do not need to install anything to edit markdown files. GitHub has a built-in editor:
@@ -140,11 +142,11 @@ You do not need to install anything to edit markdown files. GitHub has a built-i
GitHub also shows a **Preview** tab so you can check your formatting before committing.
-{: .note }
-
-> **After editing files, remember to rebuild.** Go to **Actions** → **Build and Deploy** → **Run workflow** to see your changes on the live site.
+{{< callout "note" >}}
+**After editing files, remember to rebuild.** Go to **Actions** → **Build and Deploy** → **Run workflow** to see your changes on the live site.
+{{< /callout >}}
-## Next Steps
+## Next Steps {#next-steps}
- [Markdown Syntax Reference](/docs/your-content/markdown-syntax/) — full formatting guide with widgets and media
- [Your Content](/docs/your-content/) — how Telar organizes files
diff --git a/docs/4-2-self-hosted-images.md b/content/en/docs/your-content/self-hosted-images.md
similarity index 63%
rename from docs/4-2-self-hosted-images.md
rename to content/en/docs/your-content/self-hosted-images.md
index be8ab0b..ac1c8ef 100644
--- a/docs/4-2-self-hosted-images.md
+++ b/content/en/docs/your-content/self-hosted-images.md
@@ -1,14 +1,12 @@
---
-layout: docs
-title: "4.2. Self-Hosted Images"
-parent: "4. Your Content"
-grand_parent: Documentation
-nav_order: 2
-lang: en
-permalink: /docs/your-content/self-hosted-images/
+title: Self-Hosted Images
+url: /docs/your-content/self-hosted-images/
+translationKey: docs-your-content-self-hosted-images
+type: guide
+docs_section: reference
---
-# Self-Hosted Images
+# Self-Hosted Images {#self-hosted-images}
If you have your own images — photographs, scans of documents, maps — you can upload them directly to your Telar site. Telar automatically converts them into zoomable, high-resolution tiles so viewers can explore every detail.
@@ -16,7 +14,7 @@ You can also host audio files (MP3, OGG, M4A) in the same directory. Telar auto-
This process uses a technology called [IIIF](https://iiif.io/) (International Image Interoperability Framework) behind the scenes for images, but you don't need to understand IIIF to use self-hosted files. Just upload your files and Telar handles the rest.
-## Adding images
+## Adding images {#adding-images}
Each image needs to match an object defined in your spreadsheet. The filename (without its extension) must match the object's `object_id`.
@@ -38,10 +36,11 @@ For example, if your spreadsheet has an object with `object_id` = `textile-001`,
python3 scripts/generate_iiif.py --base-url http://localhost:4001
```
-{: .note }
-> Telar only generates tiles for objects listed in your spreadsheet that don't already have an external IIIF source. This is automatic — just add your images and they'll be processed during the next build.
+{{< callout "note" >}}
+Telar only generates tiles for objects listed in your spreadsheet that don't already have an external IIIF source. This is automatic — just add your images and they'll be processed during the next build.
+{{< /callout >}}
-## Supported file formats
+## Supported file formats {#supported-file-formats}
- **JPG, PNG, HEIC, WebP, TIFF, GIF, BMP** — all common image formats work
- **SVG** — vector drawings, maps and diagrams. Telar renders these to images when it builds your site (see below)
@@ -51,16 +50,19 @@ For example, if your spreadsheet has an object with `object_id` = `textile-001`,
- **Resolution**: Higher is better — at least 2000px on the longest side is recommended for good zoom quality
- **Size limits**: Individual images up to 100 MB; keep the total repository under 1 GB for GitHub
-{: .tip }
-> **iPhone photos work directly.** HEIC photos from iPhones are supported natively — no need to convert them first. Telar converts them to JPEG automatically during tile generation while keeping your originals.
+{{< callout "tip" >}}
+**iPhone photos work directly.** HEIC photos from iPhones are supported natively — no need to convert them first. Telar converts them to JPEG automatically during tile generation while keeping your originals.
+{{< /callout >}}
-{: .tip }
-> **SVG drawings become images.** When Telar builds the site it renders each SVG to an image 4000 pixels on its longest side and generates the tiles from that. Your original file is kept, but zoom stops at that resolution, so a drawing with very fine detail may look soft at full zoom. If you need more detail, export the drawing to PNG or TIFF at a larger size and upload that instead.
+{{< callout "tip" >}}
+**SVG drawings become images.** When Telar builds the site it renders each SVG to an image 4000 pixels on its longest side and generates the tiles from that. Your original file is kept, but zoom stops at that resolution, so a drawing with very fine detail may look soft at full zoom. If you need more detail, export the drawing to PNG or TIFF at a larger size and upload that instead.
+{{< /callout >}}
-{: .tip }
-> **Naming tip.** Use simple, descriptive IDs without spaces or special characters: `textile-001.jpg`, `ceramic-bowl-blue.jpg`
+{{< callout "tip" >}}
+**Naming tip.** Use simple, descriptive IDs without spaces or special characters: `textile-001.jpg`, `ceramic-bowl-blue.jpg`
+{{< /callout >}}
-## How it works
+## How it works {#how-it-works}
When you add an image and build your site:
@@ -71,10 +73,11 @@ When you add an image and build your site:
This allows smooth zooming even on very large images.
-{: .note }
-> **Fast tile generation with libvips.** Telar uses [libvips](https://www.libvips.org/) for IIIF tile generation when available, which is roughly 28x faster than the pure-Python fallback. If libvips is not installed, Telar falls back to the Python `iiif` library automatically. See [Local Development](/docs/developers/local-development/) for installation instructions.
+{{< callout "note" >}}
+**Fast tile generation with libvips.** Telar uses [libvips](https://www.libvips.org/) for IIIF tile generation when available, which is roughly 28x faster than the pure-Python fallback. If libvips is not installed, Telar falls back to the Python `iiif` library automatically. See [Local Development](/docs/developers/local-development/) for installation instructions.
+{{< /callout >}}
-## Coordinate system
+## Coordinate system {#coordinate-system}
Telar uses normalized coordinates (values from 0 to 1) to describe positions within an image:
@@ -84,7 +87,7 @@ Telar uses normalized coordinates (values from 0 to 1) to describe positions wit
You use these coordinates in your story steps to tell Telar where to zoom in on each image.
-### Finding coordinates
+### Finding coordinates {#finding-coordinates}
Each object page includes a built-in coordinate picker:
@@ -94,29 +97,30 @@ Each object page includes a built-in coordinate picker:
4. Copy the X, Y, and Zoom values
5. Paste them into your story spreadsheet or CSV
-{: .tip }
-> The coordinate tool has a **Copy entire row** button that copies a complete row template with the coordinates already filled in — ready to paste into your spreadsheet.
+{{< callout "tip" >}}
+The coordinate tool has a **Copy entire row** button that copies a complete row template with the coordinates already filled in — ready to paste into your spreadsheet.
+{{< /callout >}}
-## Troubleshooting
+## Troubleshooting {#troubleshooting}
-### Image not loading
+### Image not loading {#image-not-loading}
- Check that the file exists in `telar-content/objects/`
- Make sure the filename (without extension) matches the `object_id` in your spreadsheet
- Verify the object has a blank `source_url` column (otherwise Telar expects an external image)
- Make sure IIIF tiles have been generated (check that `iiif/objects/{object-id}/` exists)
-### Low quality display
+### Low quality display {#low-quality-display}
- Use higher resolution source images (at least 2000px on the longest side)
- Very small images won't look good when zoomed in
-### Slow loading
+### Slow loading {#slow-loading}
- Optimize file sizes before uploading (large TIFFs can be converted to high-quality JPEGs)
- GitHub Pages has bandwidth limits — for high-traffic sites, consider alternative hosting
-## See also
+## See also {#see-also}
- [External IIIF Images](/docs/your-content/external-iiif/) — Use images from museums and libraries instead of uploading your own
- [Objects](/docs/your-content/objects/) — How to define objects in your spreadsheet
diff --git a/docs/4-4-stories-panels.md b/content/en/docs/your-content/stories-panels.md
similarity index 80%
rename from docs/4-4-stories-panels.md
rename to content/en/docs/your-content/stories-panels.md
index b3290de..c3ebcac 100644
--- a/docs/4-4-stories-panels.md
+++ b/content/en/docs/your-content/stories-panels.md
@@ -1,21 +1,20 @@
---
-layout: docs
-title: "4.4. Stories & Panels"
-parent: "4. Your Content"
-grand_parent: Documentation
-nav_order: 4
-lang: en
-permalink: /docs/your-content/stories-panels/
+title: Stories & Panels
+url: /docs/your-content/stories-panels/
+translationKey: docs-your-content-stories-panels
+type: guide
+docs_section: reference
---
-# Stories & Panels
+# Stories & Panels {#stories--panels}
Stories are scrollable narratives built around your objects. Each story guides your audience through a sequence of steps — focusing on specific regions of images, moments in videos, or segments of audio recordings — with question-and-answer pairs and expandable detail panels.
-{: .tip }
-> The [Compositor's story editor](/docs/the-compositor/story-editor/) provides a visual alternative to editing story spreadsheets directly. You can build and reorder steps, set coordinates, and preview your story without leaving your browser.
+{{< callout "tip" >}}
+The [Compositor's story editor](/docs/the-compositor/story-editor/) provides a visual alternative to editing story spreadsheets directly. You can build and reorder steps, set coordinates, and preview your story without leaving your browser.
+{{< /callout >}}
-## How the scroll experience works
+## How the scroll experience works {#how-the-scroll-experience-works}
A story fills the viewport. The object, whether an image in the IIIF viewer, a video player or an audio player, fills the entire background, and as you scroll the text cards pass over it one after another, rather than stacking.
@@ -31,7 +30,7 @@ Each step:
2. Displays a **question** and a brief **answer** in the text card
3. Optionally offers up to two layers of additional detail via expandable buttons
-## Registering stories
+## Registering stories {#registering-stories}
Before building a story's steps, register it in `project.csv`:
@@ -46,7 +45,7 @@ If you omit `story_id`, Telar uses `story-{order}` (e.g., `story-1.csv` for orde
See the [CSV Reference: Project](/docs/your-data/csv-project/#project-csv-projectcsv--proyectocsv) for all project.csv columns.
-## Building story steps
+## Building story steps {#building-story-steps}
Each story has its own CSV file in `telar-content/spreadsheets/`. The file defines steps in sequence:
@@ -57,7 +56,7 @@ step,object,x,y,zoom,question,answer,layer1_content
3,map-lima,0.5,0.5,1.0,Where were these textiles found?,In the historic center of Lima,Archaeological excavations in the 1990s...
```
-### Required fields
+### Required fields {#required-fields}
Every step needs:
@@ -67,7 +66,7 @@ Every step needs:
- **`question`** — The heading displayed in the text card
- **`answer`** — A brief answer shown below the question
-### Coordinates
+### Coordinates {#coordinates}
Coordinates tell the viewer where to focus for each step. `x` and `y` run from 0 to 1:
@@ -79,7 +78,7 @@ To find coordinates, use the **coordinate picker** on any object page: zoom and
-## Title cards
+## Title cards {#title-cards}
Title cards are text-only steps with no associated object. They work well as chapter headings, section breaks, or thematic transitions within a story.
@@ -94,24 +93,25 @@ step,object,x,y,zoom,question,answer
Title cards participate fully in navigation — scroll, keyboard, and [deep linking](#sharing-and-deep-linking) all work as expected. Layer panels are not available on title cards — the `layer` columns are ignored, like `x`, `y`, and `zoom`.
-### Section table of contents
+### Section table of contents {#section-table-of-contents}
If your story uses title cards as chapter headings, you can display a navigable table of contents on the intro card. Enable it by adding `show_sections: yes` (or `mostrar_secciones: si`) to the story's row in `project.csv`.
When enabled, the intro card scans the story for title cards and lists each one as a clickable link. Clicking a link jumps directly to that section. The intro card also switches to a darker background (the layer 2 panel color) to visually distinguish it.
-{: .tip }
-> If your first chapter starts immediately after the intro, create a title card for it too. The TOC only lists title cards that exist in your story CSV — if chapter 1 has no title card, it won't appear in the table of contents.
+{{< callout "tip" >}}
+If your first chapter starts immediately after the intro, create a title card for it too. The TOC only lists title cards that exist in your story CSV — if chapter 1 has no title card, it won't appear in the table of contents.
+{{< /callout >}}
See [Project Columns](/docs/your-data/csv-project/) for the `show_sections` column reference.
-### Back to Start button
+### Back to Start button {#back-to-start-button}
When a reader scrolls past the intro card, the "Back to Home" button in the top-left corner switches to "Back to Start". Clicking it returns to the intro card. On the intro card, the button reverts to "Back to Home" and links to the homepage.
This is automatic — no configuration needed.
-## Layer panels
+## Layer panels {#layer-panels}
Each step can carry up to two layers of additional detail, following the QAI pattern (question, answer, invitation). The question and answer appear in the text card itself. The invitation is the set of panel trigger buttons that let readers open expandable panels for deeper content:
@@ -127,14 +127,15 @@ For each layer, add two columns to your story spreadsheet:
If a layer has no content, its button is hidden automatically. Layer 2 is accessed from inside Layer 1 — its trigger button is rendered at the bottom of the Layer 1 panel, not on the main text card.
-## Writing panel content
+## Writing panel content {#writing-panel-content}
You can provide panel content in three ways. Choose based on complexity:
-{: .note }
-> The three methods that follow describe authoring in a spreadsheet. In the Compositor, the panel title has its own field, and anything pasted into the **Content** field — a `---` block included — is published as part of the panel's text, not read as a title.
+{{< callout "note" >}}
+The three methods that follow describe authoring in a spreadsheet. In the Compositor, the panel title has its own field, and anything pasted into the **Content** field — a `---` block included — is published as part of the panel's text, not read as a title.
+{{< /callout >}}
-### Method 1: Enter text directly
+### Method 1: Enter text directly {#method-1-enter-text-directly}
Type your text directly in the spreadsheet cell. Best for short panels (1–2 paragraphs).
@@ -150,14 +151,15 @@ For line breaks within a cell:
- **CSV files**: Use actual newlines inside quoted text
- **Alternative**: Use HTML `<br>` tags
-### Method 2: Paste markdown text
+### Method 2: Paste markdown text {#method-2-paste-markdown-text}
Paste text written in a plain text editor. This supports the full range of markdown features including headings, widgets (accordion, carousel, tabs), images with size controls, and a custom panel title using YAML frontmatter.
-{: .warning }
-> If you copy and paste from Microsoft Word, Google Docs, or similar applications, formatting will **not** be preserved. Write in markdown syntax instead — see the [Markdown Syntax Guide](/docs/your-content/markdown-syntax/).
+{{< callout "warning" >}}
+If you copy and paste from Microsoft Word, Google Docs, or similar applications, formatting will **not** be preserved. Write in markdown syntax instead — see the [Markdown Syntax Guide](/docs/your-content/markdown-syntax/).
+{{< /callout >}}
-### Method 3: Reference a markdown file
+### Method 3: Reference a markdown file {#method-3-reference-a-markdown-file}
Point to a markdown file in your repository. Best for complex panels — especially those with widgets or content you want to reuse across steps.
@@ -170,7 +172,7 @@ Save markdown files in `telar-content/texts/stories/`. In your spreadsheet, ente
**How Telar decides**: If what you enter ends in `.md` and the file exists, it loads the file. Otherwise, it treats the value as content.
-### Choosing the right method
+### Choosing the right method {#choosing-the-right-method}
| Scenario | Recommended method |
|----------|-------------------|
@@ -180,7 +182,7 @@ Save markdown files in `telar-content/texts/stories/`. In your spreadsheet, ente
| Same content used in multiple places | Method 3: File reference |
| Quick edits without leaving the spreadsheet | Method 1 or 2 |
-## Story markdown files
+## Story markdown files {#story-markdown-files}
When using Method 3 (file references), your story markdown files live in `telar-content/texts/stories/`:
@@ -198,7 +200,7 @@ telar-content/texts/stories/
Organizing files into subfolders by story keeps things manageable as your site grows.
-### Panel title
+### Panel title {#panel-title}
Add a custom panel title using YAML frontmatter:
@@ -213,10 +215,11 @@ weaving technique that was common in the colonial period.
If you omit the frontmatter, the panel has no title — the content starts immediately.
-{: .note }
-> This applies to panels written in a spreadsheet or a markdown file. In the Compositor, the panel title has its own field, and a `---` block pasted into the **Content** field is published as part of the panel's text, not read as a title.
+{{< callout "note" >}}
+This applies to panels written in a spreadsheet or a markdown file. In the Compositor, the panel title has its own field, and a `---` block pasted into the **Content** field is published as part of the panel's text, not read as a title.
+{{< /callout >}}
-### What you can use in panels
+### What you can use in panels {#what-you-can-use-in-panels}
Story panels support:
@@ -225,7 +228,7 @@ Story panels support:
- [Glossary auto-links](/docs/site-features/glossary/) (`[[term-id]]`)
- Images with size controls (see [Markdown Syntax Guide](/docs/your-content/markdown-syntax/))
-## Multimedia steps
+## Multimedia steps {#multimedia-steps}
Story steps can reference any object type — not just images. When a step references a video or audio object, the image viewer gives way to the appropriate player.
@@ -234,7 +237,7 @@ Story steps can reference any object type — not just images. When a step refer
No additional configuration is needed. Telar detects the object type from your objects spreadsheet and loads the correct player.
-## Clip control
+## Clip control {#clip-control}
For video and audio steps, you can specify a start time, end time, and loop setting. Add these columns to your story spreadsheet:
@@ -252,12 +255,13 @@ step,object,clip_start,clip_end,loop,question,answer
2,field-recording,0,30,true,What sounds surround the workshop?,The rhythmic clatter of the loom fills the space.
```
-{: .tip }
-> You can also set clip times visually in the Compositor. See [Video and Audio in the Compositor](/docs/the-compositor/video-audio/) for details.
+{{< callout "tip" >}}
+You can also set clip times visually in the Compositor. See [Video and Audio in the Compositor](/docs/the-compositor/video-audio/) for details.
+{{< /callout >}}
See the [CSV Reference: Stories](/docs/your-data/csv-stories/) for the full column reference including clip columns.
-## Alt text
+## Alt text {#alt-text}
Each step can include an `alt_text` column with a description of what is visible or audible at that point in the story. This text is used by screen readers and other assistive technologies.
@@ -266,16 +270,17 @@ step,object,x,y,zoom,alt_text,question,answer
1,textile-001,0.5,0.3,0.8,Close-up of interlocking warp threads in red and gold,What is this textile?,A colonial fragment showing complex weaving patterns.
```
-{: .tip }
-> Alt text for each step can also be set in the [Compositor's step editor](/docs/the-compositor/story-editor/).
+{{< callout "tip" >}}
+Alt text for each step can also be set in the [Compositor's step editor](/docs/the-compositor/story-editor/).
+{{< /callout >}}
-## Keyboard navigation
+## Keyboard navigation {#keyboard-navigation}
Stories support keyboard navigation. Arrow keys, Space, and Page Up/Down scroll through the story, and the magnetic waypoints ensure each keypress lands on the next or previous step.
When a panel is open, keyboard behavior changes: Arrow Up/Down and Page Up/Down scroll the panel content instead of navigating between steps. Space scrolls the panel forward, and Shift+Space scrolls it backward.
-## Sharing and deep linking
+## Sharing and deep linking {#sharing-and-deep-linking}
Telar automatically updates the URL in the browser address bar as readers move through a story. The URL encodes the current step and any open panel layer, so you can copy it and share a link that opens directly to a specific point in the story.
@@ -288,12 +293,13 @@ The URL fragment uses a compact format:
When someone opens a deep link, the story jumps directly to the encoded step and opens the panel if one is specified. This works with both scroll navigation and button navigation.
-{: .note }
-> The browser back button returns to the previous page — not the previous step. Deep links are designed for sharing positions, not for navigating within a story.
+{{< callout "note" >}}
+The browser back button returns to the previous page — not the previous step. Deep links are designed for sharing positions, not for navigating within a story.
+{{< /callout >}}
-## Controlling story display
+## Controlling story display {#controlling-story-display}
-### Hiding stories from the homepage
+### Hiding stories from the homepage {#hiding-stories-from-the-homepage}
If you want objects on the homepage but prefer stories to be accessed through navigation or direct links:
@@ -304,7 +310,7 @@ story_interface:
Stories remain accessible at their URLs — only the homepage cards are hidden.
-### Hiding step indicators
+### Hiding step indicators {#hiding-step-indicators}
The "Step 1", "Step 2" indicators in the top-left corner of the story page can be hidden for a cleaner experience:
@@ -315,7 +321,7 @@ story_interface:
Readers can still navigate through steps normally.
-## See also
+## See also {#see-also}
- [CSV Reference: Stories](/docs/your-data/csv-stories/) — Complete column reference for story spreadsheets
- [Objects](/docs/your-content/objects/) — Defining the objects used in stories
diff --git a/docs/4-9-video-objects.md b/content/en/docs/your-content/video-objects.md
similarity index 78%
rename from docs/4-9-video-objects.md
rename to content/en/docs/your-content/video-objects.md
index a0be63b..0ebc6fb 100644
--- a/docs/4-9-video-objects.md
+++ b/content/en/docs/your-content/video-objects.md
@@ -1,20 +1,18 @@
---
-layout: docs
-title: "4.9. Video Objects"
-parent: "4. Your Content"
-grand_parent: Documentation
-nav_order: 9
-lang: en
-permalink: /docs/your-content/video-objects/
+title: Video Objects
+url: /docs/your-content/video-objects/
+translationKey: docs-your-content-video-objects
+type: guide
+docs_section: reference
---
-# Video Objects
+# Video Objects {#video-objects}
Telar can display videos from YouTube, Vimeo, and Google Drive as objects in your exhibition. Videos work just like images — you can build stories around them, focus on specific moments with clip control, and include them alongside your other objects.
Videos are not stored in your repository — Telar embeds them directly from the platform where they are already hosted.
-## Adding a video object
+## Adding a video object {#adding-a-video-object}
To add a video, put the video's URL in the `source_url` column of your objects spreadsheet. Telar detects the media type automatically from the URL — no additional configuration is needed.
@@ -25,7 +23,7 @@ object_id,title,source_url
interview-01,Oral history interview,https://www.youtube.com/watch?v=dQw4w9WgXcQ
```
-### Supported platforms
+### Supported platforms {#supported-platforms}
Telar recognizes video URLs from three platforms:
@@ -33,26 +31,27 @@ Telar recognizes video URLs from three platforms:
- **Vimeo** — `vimeo.com/123456789`
- **Google Drive** — `drive.google.com/file/d/.../view` (the video must be shared publicly or with "Anyone with the link")
-{: .note }
-> Telar does not support self-hosted video files. Videos must be hosted on one of the supported platforms. For self-hosted media, see [Audio Objects](/docs/your-content/audio-objects/).
+{{< callout "note" >}}
+Telar does not support self-hosted video files. Videos must be hosted on one of the supported platforms. For self-hosted media, see [Audio Objects](/docs/your-content/audio-objects/).
+{{< /callout >}}
-## How videos appear
+## How videos appear {#how-videos-appear}
-### In stories
+### In stories {#in-stories}
When a story step references a video object, the video player fills the viewer area. The player includes standard playback controls (play, pause, seek) and responds to any clip settings you define for that step.
If you set `clip_start` and `clip_end` values in your story spreadsheet, the video plays only the specified segment. This is useful for drawing attention to a particular moment without requiring your audience to watch the full recording.
-### On object pages
+### On object pages {#on-object-pages}
Each video object has its own page (`/objects/{object-id}/`) with an embedded player. Below the player, a clip time picker lets you play to a position and capture timestamps — useful when building story steps.
-### In the gallery
+### In the gallery {#in-the-gallery}
Video objects appear in the objects gallery with a play icon on a grey background. The gallery's **Type** filter lets visitors browse by media type (Image, Video, or Audio).
-## Clip control
+## Clip control {#clip-control}
Story steps can specify a start time, end time, and loop setting for video objects. Add these columns to your story spreadsheet:
@@ -70,7 +69,7 @@ step,object,clip_start,clip_end,loop,question,answer
2,interview-01,120,145,true,A recurring motif,Notice how the pattern repeats — this clip loops to highlight the repetition.
```
-### Finding clip times
+### Finding clip times {#finding-clip-times}
The object page for each video includes a clip time picker:
@@ -79,10 +78,11 @@ The object page for each video includes a clip time picker:
3. Click the timestamp capture buttons to record start and end times
4. Copy the values into your story spreadsheet
-{: .tip }
-> You can also set clip times visually in the Compositor. See [Video and Audio in the Compositor](/docs/the-compositor/video-audio/) for details.
+{{< callout "tip" >}}
+You can also set clip times visually in the Compositor. See [Video and Audio in the Compositor](/docs/the-compositor/video-audio/) for details.
+{{< /callout >}}
-## See also
+## See also {#see-also}
- [Audio Objects](/docs/your-content/audio-objects/) — Adding self-hosted audio files
- [Objects](/docs/your-content/objects/) — Defining objects in your spreadsheet
diff --git a/docs/4-7-widgets.md b/content/en/docs/your-content/widgets.md
similarity index 85%
rename from docs/4-7-widgets.md
rename to content/en/docs/your-content/widgets.md
index 250313b..d731445 100644
--- a/docs/4-7-widgets.md
+++ b/content/en/docs/your-content/widgets.md
@@ -1,20 +1,18 @@
---
-layout: docs
-title: "4.7. Widgets"
-parent: "4. Your Content"
-grand_parent: Documentation
-nav_order: 7
-lang: en
-permalink: /docs/your-content/widgets/
+title: Widgets
+url: /docs/your-content/widgets/
+translationKey: docs-your-content-widgets
+type: guide
+docs_section: reference
---
-# Widgets
+# Widgets {#widgets}
Telar includes an interactive widget system for rich content in story panels and custom pages. Widgets let you embed image carousels, tabbed content, and collapsible sections directly in your markdown.
**Available since v0.4.0.**
-## Available Widgets
+## Available Widgets {#available-widgets}
| Widget | Purpose |
|--------|---------|
@@ -23,7 +21,7 @@ Telar includes an interactive widget system for rich content in story panels and
| **Accordion** | Collapsible sections for sequential or hierarchical content |
| **Bibliography** | Scholarly citations with hanging-indent formatting |
-## Widget Syntax
+## Widget Syntax {#widget-syntax}
Widgets use CommonMark-style container syntax with triple colons:
@@ -33,11 +31,11 @@ widget content here
:::
```
-## Carousel
+## Carousel {#carousel}
Display multiple images with navigation controls, captions, and credits.
-### Syntax
+### Syntax {#syntax}
```markdown
:::carousel
@@ -55,7 +53,7 @@ credit: Archivo General de Indias
:::
```
-### Fields
+### Fields {#fields}
- **`image`** (required) — Path relative to `telar-content/objects/`, or a full URL for external images
- **`alt`** (recommended) — Accessibility description
@@ -65,7 +63,7 @@ credit: Archivo General de Indias
Separate carousel items with `---`.
-### External Images
+### External Images {#external-images}
You can use full URLs for images hosted elsewhere:
@@ -75,11 +73,11 @@ image: https://example.org/images/photo.jpg
When images are hosted elsewhere, declare `width` and `height` so the build does not download each one just to measure it.
-## Tabs
+## Tabs {#tabs}
Organize content into switchable panels — useful for presenting different perspectives, sources, or categories.
-### Syntax
+### Syntax {#syntax-1}
```markdown
:::tabs
@@ -98,18 +96,18 @@ Historians now recognize this event as...
:::
```
-### Structure
+### Structure {#structure}
- Each `## Header` creates a new tab
- Content between headers becomes the tab body
- Standard markdown formatting supported within tabs
- Minimum 2 tabs, maximum 4 tabs
-## Accordion
+## Accordion {#accordion}
Create collapsible panels for chronological sequences, hierarchical information, or optional details that readers can expand on demand.
-### Syntax
+### Syntax {#syntax-2}
```markdown
:::accordion
@@ -126,20 +124,20 @@ Bourbon reforms challenged existing power structures...
:::
```
-### Structure
+### Structure {#structure-1}
- Each `## Header` creates a collapsible panel
- All panels start collapsed
- Standard markdown formatting supported within panels
- Minimum 2 panels, maximum 6 panels
-## Bibliography
+## Bibliography {#bibliography}
Format scholarly citations with standard hanging-indent styling. Each citation is separated by a blank line.
**Available since v1.1.0.**
-### Syntax
+### Syntax {#syntax-3}
```markdown
:::bibliography
@@ -151,14 +149,14 @@ Muñoz-Arbeláez, S. (2025). *The New Kingdom of Granada: The Making and Unmakin
:::
```
-### Structure
+### Structure {#structure-2}
- Each citation is separated by a blank line (double newline)
- Standard markdown formatting works within entries (`*italics*` for titles, `**bold**`, links)
- Renders with hanging-indent styling — the first line is flush left, continuation lines are indented
- An empty bibliography block produces a build warning
-## Where Widgets Work
+## Where Widgets Work {#where-widgets-work}
Widgets can be used in:
@@ -167,12 +165,13 @@ Widgets can be used in:
For story panels, the recommended approach is to save widget content in a markdown file (Method 3: file reference) rather than entering it directly in a spreadsheet cell, since the triple-colon syntax is difficult to manage inline.
-{: .tip }
-> Widgets automatically use contrasting panel colors for visual distinction. Layer 1 widgets appear with Layer 2 styling, and vice versa.
+{{< callout "tip" >}}
+Widgets automatically use contrasting panel colors for visual distinction. Layer 1 widgets appear with Layer 2 styling, and vice versa.
+{{< /callout >}}
-## Images in Widgets
+## Images in Widgets {#images-in-widgets}
-### Local Images
+### Local Images {#local-images}
Place images in `telar-content/objects/` and reference them by filename:
@@ -194,7 +193,7 @@ If your images are in subfolders, include the path relative to `telar-content/ob
image: story1/map.jpg
```
-### External Images
+### External Images {#external-images-1}
Use complete URLs for images hosted elsewhere:
@@ -203,7 +202,7 @@ image: https://digital-collections.library.edu/iiif/image123.jpg
image: https://archive.org/download/item/photo.jpg
```
-## Validation
+## Validation {#validation}
Telar validates widgets during the build process:
@@ -218,9 +217,9 @@ Telar validates widgets during the build process:
Check your build output for widget validation messages.
-## Examples
+## Examples {#examples}
-### Historical Timeline
+### Historical Timeline {#historical-timeline}
```markdown
:::accordion
@@ -236,7 +235,7 @@ The colonial economy based on mining and agriculture became established...
:::
```
-### Comparative Sources
+### Comparative Sources {#comparative-sources}
```markdown
:::tabs
@@ -252,7 +251,7 @@ Excavations at the site revealed...
:::
```
-### Image Comparison
+### Image Comparison {#image-comparison}
```markdown
:::carousel
@@ -270,7 +269,7 @@ credit: National Institute of Anthropology
:::
```
-### Scholarly Citations
+### Scholarly Citations {#scholarly-citations}
```markdown
:::bibliography
@@ -280,7 +279,7 @@ Muñoz-Arbeláez, S. (2025). *The New Kingdom of Granada*. Duke University Press
:::
```
-## See Also
+## See Also {#see-also}
- [Stories & Panels](/docs/your-content/stories-panels/) — Using widgets in story panels
- [Custom Pages](/docs/site-features/custom-pages/) — Using widgets in standalone pages
diff --git a/docs/5-0-your-data.md b/content/en/docs/your-data/_index.md
similarity index 71%
rename from docs/5-0-your-data.md
rename to content/en/docs/your-data/_index.md
index 7a23af1..8959fa9 100644
--- a/docs/5-0-your-data.md
+++ b/content/en/docs/your-data/_index.md
@@ -1,24 +1,23 @@
---
-layout: docs
-title: 5. Your Data
-parent: Documentation
-nav_order: 5
-lang: en
-permalink: /docs/your-data/
-has_children: true
+title: Your Data
+url: /docs/your-data/
+translationKey: docs-your-data
+type: guide
+docs_section: reference
---
-# Your Data
+# Your Data {#your-data}
Telar uses spreadsheet files to define the structure of your exhibition — what stories exist, what objects they contain, where to zoom in each image, and what glossary terms to include.
-You can manage this data in two ways:
+These files are the publication format. Choose how you edit their content:
+- **Compositor** — edit visually; the editor writes the publication files when you publish
- **Google Sheets** — edit a spreadsheet in your browser, and Telar fetches and converts it to CSV files automatically during each build
- **CSV files** — edit the files directly in `telar-content/spreadsheets/`
-Both approaches produce the same result. Most users start with Google Sheets and never touch a CSV file.
+Choose one source for ongoing authoring. If Google Sheets is enabled, the build fetches it and replaces its local CSV copies. The [three manuals](/docs/#build) explain each workflow.
-## Data files
+## Data files {#data-files}
| File | What it defines | Reference |
|------|----------------|-----------|
@@ -27,7 +26,7 @@ Both approaches produce the same result. Most users start with Google Sheets and
| `{story-id}.csv` | Steps, coordinates, panel content | [Story Columns](/docs/your-data/csv-stories/) |
| `glossary.csv` | Glossary terms and definitions | [Glossary Columns](/docs/your-data/csv-glossary/) |
-## Bilingual column support
+## Bilingual column support {#bilingual-column-support}
All spreadsheet files support column names in both English and Spanish. You can use either language, mix them, or include dual headers for bilingual teams:
@@ -39,6 +38,6 @@ orden,id_historia,titulo,subtitulo,firma
Telar automatically detects and skips the second header row. Spanish filenames (`proyecto.csv`, `objetos.csv`) are also supported. See [Project Columns](/docs/your-data/csv-project/#overview) for full details on column normalization.
-## Google Sheets
+## Google Sheets {#google-sheets}
See [Google Sheets](/docs/your-data/google-sheets/) for setup and workflow.
diff --git a/docs/5-5-csv-glossary.md b/content/en/docs/your-data/csv-glossary.md
similarity index 84%
rename from docs/5-5-csv-glossary.md
rename to content/en/docs/your-data/csv-glossary.md
index 8d47f5b..25de67b 100644
--- a/docs/5-5-csv-glossary.md
+++ b/content/en/docs/your-data/csv-glossary.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "5.5. Glossary Columns"
-parent: "5. Your Data"
-grand_parent: Documentation
-nav_order: 5
-lang: en
-permalink: /docs/your-data/csv-glossary/
+title: Glossary Columns
+url: /docs/your-data/csv-glossary/
+translationKey: docs-your-data-csv-glossary
+type: guide
+docs_section: reference
---
-# Glossary Columns
+# Glossary Columns {#glossary-columns}
Complete reference for `glossary.csv` columns with bilingual column name support. For column normalization and dual header support, see [Project Columns](/docs/your-data/csv-project/#overview).
-## Glossary CSV (glossary.csv)
+## Glossary CSV (glossary.csv) {#glossary-csv-glossarycsv}
Defines glossary terms that can be linked from story panels using `[[term_id]]` syntax.
@@ -20,7 +18,7 @@ Defines glossary terms that can be linked from story panels using `[[term_id]]`
**New in v0.8.0.** The CSV format is the preferred method for glossary terms. Legacy markdown files in `telar-content/texts/glossary/` are still supported but CSV takes precedence if both exist.
-### Columns
+### Columns {#columns}
| English | Spanish | Required | Description |
|---------|---------|----------|-------------|
@@ -29,7 +27,7 @@ Defines glossary terms that can be linked from story panels using `[[term_id]]`
| `definition` | `definicion` | No | The term definition text |
| `related_terms` | `terminos_relacionados` | No | Related term IDs, separated by a vertical bar |
-### Example
+### Example {#example}
**English:**
```csv
@@ -47,27 +45,27 @@ urdimbre,Urdimbre,"El conjunto de hilos longitudinales en un telar, a través de
encomienda,Encomienda,"Un sistema de trabajo en la América colonial española, que otorgaba a los colonos autoridad sobre los trabajadores indígenas.",
```
-### Field Notes
+### Field Notes {#field-notes}
-#### term_id / id_termino
+#### term_id / id_termino {#term_id--id_termino}
- Unique across all glossary terms
- Used in inline link syntax: `[[term_id]]` or `[[term_id|display text]]`
- Format: lowercase, hyphens recommended
- Terms prefixed with `demo-` are tagged as demo content
-#### title / titulo
+#### title / titulo {#title--titulo}
- The display name shown in the glossary panel and as link text
- When using `[[term_id]]` shorthand, the title is used as the link text automatically
-#### definition / definicion
+#### definition / definicion {#definition--definicion}
- The definition text shown in the glossary entry
- Supports basic markdown formatting
-#### related_terms / terminos_relacionados
+#### related_terms / terminos_relacionados {#related_terms--terminos_relacionados}
- Other `term_id` values, separated by `|` (for example, `warp|loom`)
- Used for cross-referencing between glossary entries
-### Inline Link Syntax
+### Inline Link Syntax {#inline-link-syntax}
Link to glossary terms from story panels using double-bracket syntax:
@@ -83,7 +81,7 @@ The [[loom|weaving device]] was central to textile production.
If the `term_id` is not found in the glossary, a warning icon and error message appear in the build output and in the story panel.
-### Column Aliases
+### Column Aliases {#column-aliases}
| Normalized | Accepts |
|-----------|---------|
@@ -92,7 +90,7 @@ If the `term_id` is not found in the glossary, a warning icon and error message
| `definition` | `definition`, `definicion`, `definición` |
| `related_terms` | `related_terms`, `terminos_relacionados`, `términos_relacionados` |
-### CSV vs. Markdown Glossary
+### CSV vs. Markdown Glossary {#csv-vs-markdown-glossary}
| Aspect | CSV (preferred) | Markdown (legacy) |
|--------|----------------|-------------------|
@@ -103,13 +101,13 @@ If the `term_id` is not found in the glossary, a warning icon and error message
If both a CSV and markdown glossary exist, the CSV is used and the markdown files are ignored (with a build warning).
-## Validation
+## Validation {#validation}
**Glossary warnings**:
- Missing `term_id` or `title` (row skipped)
- Glossary link `[[term_id]]` references nonexistent term
-## See Also
+## See Also {#see-also}
- [Project Columns](/docs/your-data/csv-project/) — Project CSV column reference
- [Object Columns](/docs/your-data/csv-objects/) — Objects CSV column reference
diff --git a/docs/5-3-csv-objects.md b/content/en/docs/your-data/csv-objects.md
similarity index 86%
rename from docs/5-3-csv-objects.md
rename to content/en/docs/your-data/csv-objects.md
index 1598d25..00f0760 100644
--- a/docs/5-3-csv-objects.md
+++ b/content/en/docs/your-data/csv-objects.md
@@ -1,27 +1,26 @@
---
-layout: docs
-title: "5.3. Object Columns"
-parent: "5. Your Data"
-grand_parent: Documentation
-nav_order: 3
-lang: en
-permalink: /docs/your-data/csv-objects/
+title: Object Columns
+url: /docs/your-data/csv-objects/
+translationKey: docs-your-data-csv-objects
+type: guide
+docs_section: reference
---
-# Object Columns
+# Object Columns {#object-columns}
Complete reference for `objects.csv` columns with bilingual column name support. For column normalization and dual header support, see [Project Columns](/docs/your-data/csv-project/#overview).
-## Objects CSV (objects.csv / objetos.csv)
+## Objects CSV (objects.csv / objetos.csv) {#objects-csv-objectscsv--objetoscsv}
Catalogs all objects used in stories and displayed in the gallery.
**Location**: `telar-content/spreadsheets/objects.csv` or `telar-content/spreadsheets/objetos.csv`
-{: .tip }
-> If you use the [Compositor](/docs/the-compositor/objects/), it manages `objects.csv` visually — you don't need to edit this file directly.
+{{< callout "tip" >}}
+If you use the [Compositor](/docs/the-compositor/objects/), it manages `objects.csv` visually — you don't need to edit this file directly.
+{{< /callout >}}
-### Columns
+### Columns {#columns}
| English | Spanish | Required | Description |
|---------|---------|----------|-------------|
@@ -42,7 +41,7 @@ Catalogs all objects used in stories and displayed in the gallery.
| `subjects` | `temas` | No | Topical subjects, comma-separated (used for gallery filter) |
| `featured` | `destacado` | No | Set to `yes` to feature on homepage |
-### Custom metadata columns
+### Custom metadata columns {#custom-metadata-columns}
Any columns you add beyond the 16 standard columns listed above are automatically displayed on object pages as additional metadata fields. The column name becomes the label and the cell value becomes the displayed text.
@@ -55,7 +54,7 @@ textile-001,Colonial Textile,Cotton and wool blend,Backstrap loom weaving
The values "Cotton and wool blend" and "Backstrap loom weaving" appear as extra metadata on the object page, labeled "material" and "technique" respectively.
-### Example
+### Example {#example}
**English:**
```csv
@@ -71,37 +70,37 @@ textil-001,Textil Colonial,Un fragmento tejido con patrones complejos...,Descono
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
```
-### Field Notes
+### Field Notes {#field-notes}
-#### object_id / id_objeto
+#### object_id / id_objeto {#object_id--id_objeto}
- Unique across all objects
- Referenced in story CSVs
- Used in URLs: `/objects/{object_id}/`
- Format: lowercase, hyphens, underscores
-#### description / descripcion
+#### description / descripcion {#description--descripcion}
- Markdown supported
- Displayed on object pages
- Can include headings, lists, links, emphasis
-#### source_url / url_fuente
+#### source_url / url_fuente {#source_url--url_fuente}
- URL to IIIF Image API info.json or IIIF Presentation API manifest
- Use for objects from external IIIF servers
- Leave empty for self-hosted images (tiles generated automatically)
- **v0.5.0+**: Preferred over the legacy `iiif_manifest` column (which still works)
-#### year / año
+#### year / año {#year--año}
- **New in v0.8.0**
- Used for sorting objects in the gallery (sort by year)
- Flexible format: `1650`, `1685`, `1750`
- Accepts `año` or `ano` (without tilde) as Spanish aliases
-#### source / fuente
+#### source / fuente {#source--fuente}
- **Renamed in v0.8.0** from `location`
- Current location or holding repository
- The old column name `location` (and Spanish aliases `ubicacion`, `locacion`) still works for backward compatibility
-#### medium / medio_genero
+#### medium / medio_genero {#medium--medio_genero}
- **Renamed in v1.0.0** from `object_type` / `tipo_objeto`
- Describes the genre or medium of the object — not the media type (Image, Video, Audio), which is now auto-detected from the object's source
- Examples: `Photograph`, `Oil painting`, `Textile`, `Map`
@@ -109,42 +108,42 @@ mapa-lima,Mapa de Lima,Mapa colonial temprano...,Juan de Cuellar,1685,mapa,"cart
- The old column name `object_type` (and Spanish alias `tipo_objeto`) still works for backward compatibility
- Also accepts `medium_genre` as an English alias
-#### alt_text / texto_alt
+#### alt_text / texto_alt {#alt_text--texto_alt}
- **New in v1.0.0**
- Alt text for the object image, used for accessibility
- Falls back to the object's `title` if left empty
- Displayed in the `alt` attribute of object images across the site
-#### object_type / tipo_objeto
+#### object_type / tipo_objeto {#object_type--tipo_objeto}
- **Deprecated in v1.0.0** — use `medium` / `medio_genero` instead
- Still works as a backward-compatible alias for `medium`
- Object classification used as a facet in the gallery filter sidebar
- Examples: `map`, `textile`, `photograph`, `painting`
- Appears as a filter category when `browse_and_search: true`
-#### subjects / temas
+#### subjects / temas {#subjects--temas}
- **New in v0.8.0**
- Comma-separated topical subjects used as facets in the gallery filter sidebar
- Examples: `"weaving, colonial, textiles"`, `"cartography, Lima, urban planning"`
- Also accepts Spanish aliases: `materias`, `materia`
-#### featured / destacado
+#### featured / destacado {#featured--destacado}
- **New in v0.8.0**
- Set to `yes` to feature this object on the homepage
- Featured objects are prioritized when `show_sample_on_homepage: true` in config
- The number shown is controlled by `featured_count` (default: 4)
-#### credit / credito
+#### credit / credito {#credit--credito}
- Displayed as badge in top-right corner of object images (if `show_object_credits: true`)
- Also shown in metadata table
- Use for attribution: `Public Domain`, `CC BY 4.0`, `Courtesy of National Archive`
-#### thumbnail / miniatura
+#### thumbnail / miniatura {#thumbnail--miniatura}
- Path to a thumbnail image file
- Relative to the repository root
- If omitted, Telar generates thumbnails from the IIIF source
-### Column Aliases
+### Column Aliases {#column-aliases}
| Normalized | Accepts |
|-----------|---------|
@@ -165,7 +164,7 @@ mapa-lima,Mapa de Lima,Mapa colonial temprano...,Juan de Cuellar,1685,mapa,"cart
| `source_url` | `source_url`, `url_fuente` |
| `iiif_manifest` | `iiif_manifest`, `manifiesto_iiif` (legacy) |
-## Gallery Metadata Tips
+## Gallery Metadata Tips {#gallery-metadata-tips}
For the best gallery experience with browse, search, and filter:
@@ -175,7 +174,7 @@ For the best gallery experience with browse, search, and filter:
4. **Mark 4-6 objects as `featured: yes`** for the homepage sample
5. **Write meaningful `description` fields** — the search indexes these for full-text search
-## File Organization
+## File Organization {#file-organization}
```
telar-content/spreadsheets/
@@ -186,9 +185,9 @@ telar-content/spreadsheets/
└── glossary.csv # Glossary terms (optional)
```
-## Migration from v0.7.x to v0.8.0
+## Migration from v0.7.x to v0.8.0 {#migration-from-v07x-to-v080}
-### New columns (optional)
+### New columns (optional) {#new-columns-optional}
Add these to your objects.csv if you want gallery filtering and sorting:
@@ -199,7 +198,7 @@ Add these to your objects.csv if you want gallery filtering and sorting:
| `subjects` | Enables subjects filter in sidebar |
| `featured` | Controls homepage object sample |
-### Renamed columns
+### Renamed columns {#renamed-columns}
| Old (v0.7.x) | New (v0.8.0) | Notes |
|---------------|-------------|-------|
@@ -207,7 +206,7 @@ Add these to your objects.csv if you want gallery filtering and sorting:
**No breaking changes.** All v0.7.x CSVs work without modification.
-## Validation
+## Validation {#validation}
Telar checks object CSV data during build and prints messages to the build log.
@@ -223,7 +222,7 @@ Telar checks object CSV data during build and prints messages to the build log.
All warnings appear in the build log. Review the output for messages marked `[WARN]` to catch data problems before publishing.
-## See Also
+## See Also {#see-also}
- [Project Columns](/docs/your-data/csv-project/) — Project CSV column reference
- [Story Columns](/docs/your-data/csv-stories/) — Story step CSV columns
diff --git a/docs/5-2-csv-project.md b/content/en/docs/your-data/csv-project.md
similarity index 88%
rename from docs/5-2-csv-project.md
rename to content/en/docs/your-data/csv-project.md
index c24e077..d89cb1f 100644
--- a/docs/5-2-csv-project.md
+++ b/content/en/docs/your-data/csv-project.md
@@ -1,22 +1,20 @@
---
-layout: docs
-title: "5.2. Project Columns"
-parent: "5. Your Data"
-grand_parent: Documentation
-nav_order: 2
-lang: en
-permalink: /docs/your-data/csv-project/
+title: Project Columns
+url: /docs/your-data/csv-project/
+translationKey: docs-your-data-csv-project
+type: guide
+docs_section: reference
---
-# Project Columns
+# Project Columns {#project-columns}
Complete reference for `project.csv` columns with bilingual column name support.
-## Overview
+## Overview {#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
+### Column Normalization {#column-normalization}
All column names are normalized during processing:
- Case-insensitive (`Title` = `title` = `TITLE`)
@@ -24,7 +22,7 @@ All column names are normalized during processing:
- Spanish names mapped to English equivalents
- Accented characters supported
-### Dual Header Support
+### Dual Header Support {#dual-header-support}
Include both English and Spanish headers for bilingual teams:
@@ -37,13 +35,13 @@ orden,id_historia,titulo,subtitulo,firma
Telar automatically detects and skips the second header row.
-## Project CSV (project.csv / proyecto.csv)
+## Project CSV (project.csv / proyecto.csv) {#project-csv-projectcsv--proyectocsv}
Defines stories and their display order on the homepage.
**Location**: `telar-content/spreadsheets/project.csv` or `telar-content/spreadsheets/proyecto.csv`
-### Columns
+### Columns {#columns}
| English | Spanish | Required | Description |
|---------|---------|----------|-------------|
@@ -55,7 +53,7 @@ Defines stories and their display order on the homepage.
| `private` | `privada` | No | Set to `yes` to encrypt this story (requires `story_key` in config); `protected`/`protegida` also accepted |
| `show_sections` | `mostrar_secciones` | No | Set to `yes` to display a table of contents on the story's intro card. See [Stories & Panels: Section table of contents](/docs/your-content/stories-panels/#section-table-of-contents). **New in v1.2.0** |
-### Example
+### Example {#example}
**English:**
```csv
@@ -71,33 +69,33 @@ orden,id_historia,titulo,subtitulo,firma,privada,mostrar_secciones
2,rutas-comerciales,Rutas Comerciales,Siguiendo los hilos del comercio,basado en [investigación original](https://ejemplo.com),si,
```
-### Field Notes
+### Field Notes {#field-notes}
-#### order
+#### order {#order}
- Must be unique integers
- Determines card order on homepage
- Gaps allowed (1, 2, 5 works fine)
- Automatically renumbered if demo content is included
-#### story_id
+#### story_id {#story_id}
- **New in v0.6.0**
- Lowercase, hyphens, underscores only
- Used for: story CSV filename, story URL, internal references
- If omitted: defaults to `story-1`, `story-2`, etc. based on order
- Examples: `colonial-textiles`, `paisajes_coloniales`, `story-one`
-#### title
+#### title {#title}
- Displayed on homepage cards and story page headers
- No markdown processing (plain text only)
- Recommended: 2-6 words
-#### subtitle
+#### subtitle {#subtitle}
- Shown below title on homepage cards
- No markdown processing
- Recommended: 5-12 words
- Describes story content briefly
-#### byline
+#### byline {#byline}
- **Supports markdown** (v0.6.0+)
- Homepage: renders as plain text
- Story page: renders markdown links as clickable
@@ -107,7 +105,7 @@ orden,id_historia,titulo,subtitulo,firma,privada,mostrar_secciones
- `based on [original research](https://example.com)`
- `curated by *Digital Archive Project*`
-#### private
+#### private {#private}
- **New in v0.8.0**
- Set to `yes` to encrypt the story after the build finishes (the story renders normally during
the Jekyll build itself; encryption is a separate step that runs afterward)
@@ -119,14 +117,14 @@ orden,id_historia,titulo,subtitulo,firma,privada,mostrar_secciones
Testing Locally](/docs/site-features/private-stories/#testing-locally)
- See [Private Stories](/docs/site-features/private-stories/) for details
-#### show_sections
+#### show_sections {#show_sections}
- **New in v1.2.0**
- Set to `yes` to display a navigable table of contents on the intro card
- The TOC auto-generates links to every title card in the story
- Leave empty or omit to show the intro card without a TOC
- See [Stories & Panels](/docs/your-content/stories-panels/#section-table-of-contents) for details
-### Column Aliases
+### Column Aliases {#column-aliases}
| Normalized | Accepts |
|-----------|---------|
@@ -138,7 +136,7 @@ orden,id_historia,titulo,subtitulo,firma,privada,mostrar_secciones
| `private` | `private`, `privada`, `protected`, `protegida` |
| `show_sections` | `show_sections`, `mostrar_secciones` |
-## See Also
+## See Also {#see-also}
- [Object Columns](/docs/your-data/csv-objects/) — Objects CSV column reference
- [Story Columns](/docs/your-data/csv-stories/) — Story step CSV columns
diff --git a/docs/5-4-csv-stories.md b/content/en/docs/your-data/csv-stories.md
similarity index 88%
rename from docs/5-4-csv-stories.md
rename to content/en/docs/your-data/csv-stories.md
index 1579793..35090a4 100644
--- a/docs/5-4-csv-stories.md
+++ b/content/en/docs/your-data/csv-stories.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "5.4. Story Columns"
-parent: "5. Your Data"
-grand_parent: Documentation
-nav_order: 4
-lang: en
-permalink: /docs/your-data/csv-stories/
+title: Story Columns
+url: /docs/your-data/csv-stories/
+translationKey: docs-your-data-csv-stories
+type: guide
+docs_section: reference
---
-# Story Columns
+# Story Columns {#story-columns}
Complete reference for story CSV columns with bilingual column name support. For column normalization and dual header support, see [Project Columns](/docs/your-data/csv-project/#overview).
-## Story CSV (story-{id}.csv)
+## Story CSV (story-{id}.csv) {#story-csv-story-idcsv}
Defines step-by-step navigation and panel content for each story.
@@ -22,7 +20,7 @@ Defines step-by-step navigation and panel content for each story.
- If `story_id` specified in project.csv: use that name (e.g., `colonial-textiles.csv`)
- If `story_id` omitted: use `story-{order}.csv` (e.g., `story-1.csv`, `story-2.csv`)
-### Columns
+### Columns {#columns}
| English | Spanish | Required | Description |
|---------|---------|----------|-------------|
@@ -45,7 +43,7 @@ Defines step-by-step navigation and panel content for each story.
| `loop` | `bucle` | No | Loop playback (`true`, `false`, `yes`, `no`). Defaults to false |
| `alt_text` | `texto_alt` | No | Per-step alt text for accessibility |
-### Example
+### Example {#example}
**English (with inline content):**
```csv
@@ -63,26 +61,26 @@ paso,objeto,x,y,zoom,pregunta,respuesta,boton_capa1,contenido_capa1,boton_capa2,
Step 1 uses inline content for layer 1, while step 2 uses a file reference. Both approaches work and can be mixed freely.
-### Field Notes
+### Field Notes {#field-notes}
-#### step / paso
+#### step / paso {#step--paso}
- Must be sequential integers starting at 1
- No gaps allowed (1, 2, 3... not 1, 3, 5)
- Determines navigation order
-#### object / objeto
+#### object / objeto {#object--objeto}
- Must match an `object_id` from objects.csv
- Leave empty to create a **title card** — a text-only step with no associated object. See [Stories & Panels](/docs/your-content/stories-panels/#title-cards). **Updated in v1.1.0**
- Multiple steps can reference the same object
-#### x, y, zoom
+#### x, y, zoom {#x-y-zoom}
- `x` and `y` run from 0 to 1
- **x**: 0 = left edge, 1 = right edge, 0.5 = center
- **y**: 0 = top edge, 1 = bottom edge, 0.5 = center
- **zoom**: 1 shows the whole object beside the text card. Higher values move closer, with the point at `x` and `y` in the middle of the view: 2 shows about half as much of the object, 4 about a quarter. Below 1, down to 0.1, the whole object is shown smaller, with space around it. At 1 or below, the object is centered and `x` and `y` do not move it. If the point is near an edge of the object, the view does not go past that edge, so the point may not be in the middle.
- Use the coordinate picker on object pages to find values
-#### page / pagina
+#### page / pagina {#page--pagina}
- Only for objects with more than one page: a PDF hosted on your site, or an external IIIF manifest with several images
- Pages are numbered from 1
- `x`, `y` and `zoom` frame the page this column selects, not the document as a whole
@@ -90,26 +88,26 @@ Step 1 uses inline content for layer 1, while step 2 uses a file reference. Both
- A value that is not a whole number of 1 or more is ignored, and the build says which step it came from
- See [PDF Documents](/docs/your-content/pdf-documents/) and [External IIIF Images](/docs/your-content/external-iiif/)
-#### question / pregunta
+#### question / pregunta {#question--pregunta}
- Displayed as the heading of the text card
- No markdown processing (plain text only)
- Brief question or statement
- Recommended: 3-8 words
-#### answer / respuesta
+#### answer / respuesta {#answer--respuesta}
- Brief answer shown in the text card, below the question
- Plain prose only (see [Answers Are Plain Prose](#answers-are-plain-prose))
- Cut above 18 lines (see [The Answer Limit](#the-answer-limit))
- Recommended: 1-2 sentences
-#### Layer buttons
+#### Layer buttons {#layer-buttons}
- Empty string = default button text
- Custom text: any string (e.g., "See details", "Ver detalles")
- If content exists but button empty: shows default text
- If content empty: button hidden
-#### Layer content
+#### Layer content {#layer-content}
Panel content can be provided in three ways:
@@ -135,8 +133,9 @@ You can use basic formatting: `**bold**`, `*italic*`, `[link text](url)`, and gl
Paste text written in a plain text editor. This supports the full range of formatting features including headings, widgets (accordion, carousel, tabs), images with size controls, and a custom panel title using YAML frontmatter.
-{: .warning }
-> If you copy and paste from Microsoft Word, Google Docs, or similar applications, formatting will **not** be preserved. Write in markdown syntax instead — see the [Markdown Syntax Guide](/docs/your-content/markdown-syntax/).
+{{< callout "warning" >}}
+If you copy and paste from Microsoft Word, Google Docs, or similar applications, formatting will **not** be preserved. Write in markdown syntax instead — see the [Markdown Syntax Guide](/docs/your-content/markdown-syntax/).
+{{< /callout >}}
**Method 3: Reference a markdown file**
@@ -150,27 +149,27 @@ Save markdown files in `telar-content/texts/stories/`. In your spreadsheet, ente
**How Telar decides**: If what you enter ends in `.md` and the file exists, it loads the file. Otherwise, it treats the value as content.
-#### clip_start, clip_end / inicio_clip, fin_clip
+#### clip_start, clip_end / inicio_clip, fin_clip {#clip_start-clip_end--inicio_clip-fin_clip}
- **New in v1.0.0**
- Start and end times in seconds for video and audio objects (e.g., `12.5`, `65`)
- Ignored for image objects
- Leave both empty to play the full media file
- You can set clip values visually in the [Compositor](/docs/the-compositor/video-audio/)
-#### loop / bucle
+#### loop / bucle {#loop--bucle}
- **New in v1.0.0**
- Controls whether video or audio playback loops
- Accepts `true`, `false`, `yes`, `no`, `sí`
- Defaults to `false` if left empty
- Ignored for image objects
-#### alt_text / texto_alt
+#### alt_text / texto_alt {#alt_text--texto_alt}
- **New in v1.0.0**
- Per-step alt text for accessibility
- Falls back to the object's alt text (from `objects.csv`), then to the object's `title`
- Use this to provide context specific to what the step is showing — e.g., a zoomed-in detail that differs from the object's general description
-### Choosing the Right Method
+### Choosing the Right Method {#choosing-the-right-method}
| Scenario | Recommended method |
|----------|-------------------|
@@ -180,7 +179,7 @@ Save markdown files in `telar-content/texts/stories/`. In your spreadsheet, ente
| Same content used in multiple places | Method 3: File reference |
| Quick edits without leaving the spreadsheet | Method 1 or 2 |
-### Column Aliases
+### Column Aliases {#column-aliases}
| Normalized | Accepts |
|-----------|---------|
@@ -203,10 +202,11 @@ Save markdown files in `telar-content/texts/stories/`. In your spreadsheet, ente
| `loop` | `loop`, `bucle` |
| `alt_text` | `alt_text`, `texto_alt` |
-{: .note }
-> The `layer_file` / `archivo_capa` column names are backward-compatible aliases from before v0.6.3. The preferred names are `layer_content` / `contenido_capa`.
+{{< callout "note" >}}
+The `layer_file` / `archivo_capa` column names are backward-compatible aliases from before v0.6.3. The preferred names are `layer_content` / `contenido_capa`.
+{{< /callout >}}
-## Answers Are Plain Prose
+## Answers Are Plain Prose {#answers-are-plain-prose}
The `answer` field appears in the text card beside your object, under the question. On desktop that card is a fixed size and does not scroll, so anything past its edge never reaches your readers.
@@ -235,7 +235,7 @@ Telar removes these completely, along with any text inside them:
- **Code blocks**
- **Horizontal rules**
-### The Answer Limit
+### The Answer Limit {#the-answer-limit}
An answer has to fit on its card without scrolling. Telar therefore measures it in lines rather than words, counting 53 characters to a line and two lines for each paragraph after the first. An answer can have up to 18 lines and five paragraphs: roughly 150 words in a single paragraph, fewer when you split it into paragraphs. An answer longer than 15 lines is set in slightly smaller type.
@@ -243,7 +243,7 @@ Telar cuts any answer over the limit and reports the cut in the build log. The c
Aim for 1-2 sentences. When you need more room, move the detail into a layer panel: panels take the full markdown of the [Markdown Syntax Reference](/docs/your-content/markdown-syntax/), footnotes, tables, images and widgets included.
-## Data Entry Tips
+## Data Entry Tips {#data-entry-tips}
**Coordinates**: Use the coordinate picker on object pages to find x, y, zoom values and copy them directly into your CSV.
@@ -254,7 +254,7 @@ Aim for 1-2 sentences. When you need more room, move the detail into a layer pan
**Panel content**: Use file references (Method 3) for complex content with widgets. Use inline text (Method 1) for short panels.
-## Validation
+## Validation {#validation}
Telar validates story CSV data during build:
@@ -271,7 +271,7 @@ Telar validates story CSV data during build:
Check build output for validation messages.
-## See Also
+## See Also {#see-also}
- [Project Columns](/docs/your-data/csv-project/) — Project CSV column reference
- [Object Columns](/docs/your-data/csv-objects/) — Objects CSV column reference
diff --git a/content/en/docs/your-data/google-sheets.md b/content/en/docs/your-data/google-sheets.md
new file mode 100644
index 0000000..f68b96f
--- /dev/null
+++ b/content/en/docs/your-data/google-sheets.md
@@ -0,0 +1,70 @@
+---
+title: Understand the spreadsheet
+url: /docs/your-data/google-sheets/
+translationKey: docs-your-data-google-sheets
+type: guide
+docs_section: sheets
+---
+
+# Understand the spreadsheet {#understand-the-spreadsheet}
+
+<span class="anchor-alias" id="troubleshooting"></span>
+
+<span class="anchor-alias" id="see-also"></span>
+
+<span class="anchor-alias" id="google-sheets-integration"></span>
+
+<span class="anchor-alias" id="fetching-data-local-dev-only"></span>
+
+<span class="anchor-alias" id="configuring-_configyml"></span>
+
+<span class="anchor-alias" id="column-reference-summary"></span>
+
+Your Google Sheet is the source for a generated edition of your exhibition. Editing a cell does not immediately change the public site: the next build fetches the published sheet and processes it.
+
+## How the tabs connect {#how-the-tabs-connect}
+
+| Tab | Purpose | Connection |
+|---|---|---|
+| `project` | Lists stories and their display order | `story_id` identifies a story tab |
+| `objects` | Describes the shared source collection | `object_id` is used in story rows |
+| A tab for each story | Lists its steps, views, questions and panels | `object` matches an object ID |
+| `glossary` | Defines recurring terms | `term_id` is used in text links |
+
+The template includes guidance and bilingual headers. Keep the machine-readable column names. Rows or columns beginning with `#` are ignored.
+
+<span class="anchor-alias" id="quick-start"></span>
+## Start with the template {#start-with-the-template}
+
+Use the template linked in the [guided setup](/docs/getting-started/google-sheets/). Make your own copy, then publish the spreadsheet through **File → Share → Publish to web**.
+
+The ordinary editing link is different from the published link. The configuration needs the published address:
+
+```yaml
+google_sheets:
+ enabled: true
+ published_url: "YOUR-PUBLISHED-SPREADSHEET-URL"
+```
+
+Publish the tabs Telar must read. Do not put confidential notes in content you publish to the web.
+
+## Keep IDs consistent {#keep-ids-consistent}
+
+Use short, stable IDs with lowercase letters and hyphens. A story ID must match its tab name. An object reference must match an ID in `objects`. A glossary link must match the term ID.
+
+Titles can change without changing these relationships. Renaming an ID requires updating the references that use it.
+
+## Use text and file references {#use-text-and-file-references}
+
+A short panel can be written directly in a `layer1_content` or `layer2_content` cell. Use Markdown syntax for formatting. A path ending in `.md` can refer to a longer text in the repository's stories text folder.
+
+Answers are brief plain prose. Panels are the place for richer formatting and further context. See [story columns](/docs/your-data/csv-stories/) for supported fields.
+
+<span class="anchor-alias" id="sheet-structure"></span>
+## Choose this sheet as the source {#choose-this-sheet-as-the-source}
+
+If you move to the Compositor, review its import process and switch the content source deliberately. The Compositor does not write your visual edits back to the Google Sheet. Leaving Sheets enabled can cause later builds to replace those edits with the sheet's content.
+
+For local work, `python3 scripts/build_local_site.py` fetches Sheets when enabled. The CSV copies in `telar-content/spreadsheets/` are fetched inputs; edit the sheet if it is your chosen source.
+
+Next, [add an object and build a first story](/docs/getting-started/add-content/).
diff --git a/content/en/guide-sketch/_index.md b/content/en/guide-sketch/_index.md
new file mode 100644
index 0000000..c26b95b
--- /dev/null
+++ b/content/en/guide-sketch/_index.md
@@ -0,0 +1,5 @@
+---
+build:
+ list: never
+ render: never
+---
diff --git a/content/en/guide-sketch/en/_index.md b/content/en/guide-sketch/en/_index.md
new file mode 100644
index 0000000..2978a03
--- /dev/null
+++ b/content/en/guide-sketch/en/_index.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guide-sketch/en/
+translationKey: guide-sketch-index-html
+type: redirect
+docs_section: reference
+redirect_to: /docs/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/guide-sketch/en/plan.md b/content/en/guide-sketch/en/plan.md
new file mode 100644
index 0000000..15f1620
--- /dev/null
+++ b/content/en/guide-sketch/en/plan.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guide-sketch/en/plan/
+translationKey: guide-sketch-plan-html
+type: redirect
+docs_section: reference
+redirect_to: /docs/plan/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/guide-sketch/en/quick-start.md b/content/en/guide-sketch/en/quick-start.md
new file mode 100644
index 0000000..54f808d
--- /dev/null
+++ b/content/en/guide-sketch/en/quick-start.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guide-sketch/en/quick-start/
+translationKey: guide-sketch-quick-html
+type: redirect
+docs_section: reference
+redirect_to: /start/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/manual/_index.md b/content/en/manual/_index.md
new file mode 100644
index 0000000..c26b95b
--- /dev/null
+++ b/content/en/manual/_index.md
@@ -0,0 +1,5 @@
+---
+build:
+ list: never
+ render: never
+---
diff --git a/content/en/manual/en/_index.md b/content/en/manual/en/_index.md
new file mode 100644
index 0000000..69fa960
--- /dev/null
+++ b/content/en/manual/en/_index.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /manual/en/
+translationKey: manual-index-html
+type: redirect
+docs_section: reference
+redirect_to: /docs/the-compositor/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/manual/en/iiif-to-story.md b/content/en/manual/en/iiif-to-story.md
new file mode 100644
index 0000000..6beffa7
--- /dev/null
+++ b/content/en/manual/en/iiif-to-story.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /manual/en/iiif-to-story/
+translationKey: manual-iiif-md
+type: redirect
+docs_section: reference
+redirect_to: /docs/the-compositor/iiif-to-story/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/showcase/_index.md b/content/en/showcase/_index.md
new file mode 100644
index 0000000..921e100
--- /dev/null
+++ b/content/en/showcase/_index.md
@@ -0,0 +1,13 @@
+---
+title: Projects built with Telar
+url: /showcase/
+translationKey: showcase
+type: section
+description: Exhibitions, class projects and research made with Telar.
+extra_css:
+- showcase
+section_title: Showcase
+docs_section: reference
+---
+
+{{< section-body "showcase" >}}
diff --git a/content/en/showcase/submit.md b/content/en/showcase/submit.md
new file mode 100644
index 0000000..342b49f
--- /dev/null
+++ b/content/en/showcase/submit.md
@@ -0,0 +1,14 @@
+---
+title: Share your Telar project
+url: /showcase/submit/
+translationKey: showcase-submit
+type: section
+description: Tell us about a site you built with Telar so we can feature it in the
+ showcase.
+extra_css:
+- showcase
+section_title: Showcase
+docs_section: reference
+---
+
+{{< section-body "showcase-submit" >}}
diff --git a/content/en/start.md b/content/en/start.md
new file mode 100644
index 0000000..5370f69
--- /dev/null
+++ b/content/en/start.md
@@ -0,0 +1,10 @@
+---
+title: Workshop quick guide
+url: /start/
+translationKey: empezar
+type: guide
+docs_quick: true
+docs_section: quick
+---
+
+{{< quick-guide >}}
diff --git a/content/en/worksheet.md b/content/en/worksheet.md
new file mode 100644
index 0000000..089bf6e
--- /dev/null
+++ b/content/en/worksheet.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /worksheet/
+translationKey: redirects-en-worksheet-md
+type: redirect
+docs_section: reference
+redirect_to: /assets/templates/telar-worksheet.pdf
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/en/workshop.md b/content/en/workshop.md
new file mode 100644
index 0000000..4ff6a60
--- /dev/null
+++ b/content/en/workshop.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /workshop/
+translationKey: redirects-en-workshop-md
+type: redirect
+docs_section: reference
+redirect_to: https://www.figma.com/deck/NTdWFGoR7rF46va7nLouOc/Intro-to-Telar-V2?node-id=2004-1507&t=uMGqZCQGu2AVmGfY-1
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/_index.md b/content/es/_index.md
new file mode 100644
index 0000000..d90e85a
--- /dev/null
+++ b/content/es/_index.md
@@ -0,0 +1,5 @@
+---
+title: Telar
+type: landing
+translationKey: home
+---
diff --git a/content/es/empezar.md b/content/es/empezar.md
new file mode 100644
index 0000000..67947db
--- /dev/null
+++ b/content/es/empezar.md
@@ -0,0 +1,10 @@
+---
+title: Guía rápida para talleres
+url: /empezar/
+translationKey: empezar
+type: guide
+docs_quick: true
+docs_section: quick
+---
+
+{{< quick-guide >}}
diff --git a/content/es/guia/_index.md b/content/es/guia/_index.md
new file mode 100644
index 0000000..c9b5398
--- /dev/null
+++ b/content/es/guia/_index.md
@@ -0,0 +1,10 @@
+---
+title: Guías
+url: /guia/
+translationKey: docs
+type: guide
+docs_hub: true
+docs_section: guides
+---
+
+{{< guides-hub >}}
diff --git a/content/es/guia/autoria-local/_index.md b/content/es/guia/autoria-local/_index.md
new file mode 100644
index 0000000..a4762a3
--- /dev/null
+++ b/content/es/guia/autoria-local/_index.md
@@ -0,0 +1,9 @@
+---
+title: Autoría local
+url: /guia/autoria-local/
+translationKey: docs-local-authoring
+type: guide
+docs_section: local
+---
+
+{{< section-overview >}}
diff --git a/content/es/guia/autoria-local/contenido.md b/content/es/guia/autoria-local/contenido.md
new file mode 100644
index 0000000..d2569ea
--- /dev/null
+++ b/content/es/guia/autoria-local/contenido.md
@@ -0,0 +1,64 @@
+---
+title: Edita objetos, historias y textos
+url: /guia/autoria-local/contenido/
+translationKey: docs-local-authoring-content
+type: guide
+docs_draft: true
+docs_section: local
+---
+
+# Edita objetos, historias y textos {#edita-objetos-historias-y-textos}
+
+El contenido editable está en `telar-content/`. Los JSON generados, las colecciones y `_site/` son resultados del build: los cambios hechos solo allí desaparecen al volver a generar.
+
+## Ubica los archivos fuente {#ubica-los-archivos-fuente}
+
+| Ubicación | Qué editas |
+|---|---|
+| `telar-content/spreadsheets/` | Catálogo de objetos, lista de historias, pasos y glosario en CSV |
+| `telar-content/objects/` | Imágenes, PDF y audio alojados por el sitio |
+| `telar-content/texts/stories/` | Textos de paneles referenciados desde los pasos |
+| `telar-content/texts/glossary/` | Archivos de texto del glosario, cuando se utilizan |
+| `_config.yml` | Identidad y configuración del sitio |
+| `_data/navigation.yml` | Menú público |
+
+## Registra un objeto {#registra-un-objeto}
+
+Para un archivo local, usa un nombre sencillo como `khipu.jpg` y guárdalo en la carpeta de objetos. Haz corresponder ese nombre con el ID.
+
+Para un objeto IIIF externo, agrega el manifiesto en `source_url`. No necesitas descargar la imagen. Ejemplo mínimo de `objects.csv`:
+
+```csv
+object_id,title,source_url,alt_text
+khipu,Khipu háptico,https://juancobo.com/138la/iiif/khipu/p7/manifest.json,Manos con guantes trabajan con cuerdas anudadas sobre una superficie blanca
+```
+
+Completa la ficha y los créditos en las demás columnas. La referencia de [columnas de objetos](/guia/tus-datos/csv-objetos/) explica el formato completo.
+
+{{< media id="public-object" >}}
+
+## Conecta una historia y sus pasos {#conecta-una-historia-y-sus-pasos}
+
+Agrega la historia en `project.csv`:
+
+```csv
+order,story_id,title
+1,historia-khipu,Examinando un khipu
+```
+
+Crea `historia-khipu.csv` en la misma carpeta. El nombre corresponde al ID:
+
+```csv
+step,object,x,y,zoom,question,answer
+1,khipu,0.5,0.5,1,¿Qué actividad muestra?,La fotografía documenta una toma de muestras para datación por radiocarbono.
+```
+
+Usa la herramienta de coordenadas del objeto para ajustar la vista. Otro paso puede volver al mismo objeto con un encuadre distinto. Numera los pasos en orden.
+
+## Agrega paneles y enlaces al glosario {#agrega-paneles-y-enlaces-al-glosario}
+
+Usa `layer1_content` y `layer2_content` para texto directo o una ruta de Markdown relativa a la carpeta de textos de historias. Describe lo que se abre con las columnas de botones.
+
+Las definiciones pueden estar en `glossary.csv`; enlázalas con `[[id-del-termino]]`. Consulta [las columnas de historias](/guia/tus-datos/csv-historias/) y [del glosario](/guia/tus-datos/csv-glosario/) antes de agregar contenido más complejo.
+
+Sigue con [la generación y revisión](/guia/autoria-local/vista-previa/).
diff --git a/content/es/guia/autoria-local/publicar.md b/content/es/guia/autoria-local/publicar.md
new file mode 100644
index 0000000..6f20180
--- /dev/null
+++ b/content/es/guia/autoria-local/publicar.md
@@ -0,0 +1,49 @@
+---
+title: Publica y mantén un proyecto local
+url: /guia/autoria-local/publicar/
+translationKey: docs-local-authoring-publish
+type: guide
+docs_draft: true
+docs_section: local
+---
+
+# Publica y mantén un proyecto local {#publica-y-mantén-un-proyecto-local}
+
+Distingue los archivos editables del resultado publicado. Las fuentes permiten revisar la exhibición; el sitio generado es la versión que consulta el público.
+
+## Publica mediante GitHub Actions {#publica-mediante-github-actions}
+
+Confirma `url` y `baseurl` en la configuración. Activa GitHub Pages con **GitHub Actions** como fuente.
+
+Revisa los archivos modificados, confirma los cambios de las fuentes previstas y súbelos al repositorio. El flujo de la plantilla procesa contenido, genera recursos, construye el sitio y cifra las historias privadas antes de desplegarlo.
+
+Abre **Actions**, revisa la ejecución y espera la publicación exitosa. Prueba después la dirección pública. La vista previa local no demuestra que terminó el despliegue.
+
+Excluye del commit los entornos virtuales, dependencias y resultados temporales. Revisa `git status` antes de confirmar.
+
+## Publica en otro alojamiento estático {#publica-en-otro-alojamiento-estático}
+
+El script local genera direcciones IIIF para su vista previa. No subas esa vista sin cambios a un servidor público.
+
+Para una publicación independiente, ejecuta primero todo el proceso. Después genera las direcciones de imágenes con la dirección pública completa y reconstruye:
+
+```bash
+python3 scripts/build_local_site.py --build-only
+python3 scripts/generate_iiif.py --base-url https://ejemplo.org/mi-exhibicion
+bundle exec jekyll build
+python3 scripts/encrypt_protected_stories.py
+```
+
+Reemplaza la dirección por el dominio y la ruta reales. Haz corresponder `url` y `baseurl`. Sube `_site/` al alojamiento después de que termine correctamente el cifrado. Revisa los avisos de conflicto de destinos antes de considerar listo el build.
+
+Si vuelves a ejecutar Jekyll, ejecuta de nuevo el cifrado antes de publicar historias privadas. Consulta [las historias privadas](/guia/funciones/historias-privadas/) para entender el modelo completo.
+
+## Conserva una copia reproducible {#conserva-una-copia-reproducible}
+
+Respalda configuración, contenido, medios y temas propios. Conserva los archivos de dependencias y anota la versión de Telar. Las fuentes IIIF externas siguen siendo dependencias externas; guarda sus direcciones de catálogo y manifiesto.
+
+## Actualiza por separado {#actualiza-por-separado}
+
+Respalda o confirma tu trabajo, lee las notas de versión y sigue [la guía de actualización](/guia/configuracion/actualizacion/). Revisa los cambios antes de publicar. Prueba una imagen, historia, panel y entrada del glosario representativos, además de historias privadas si las hay.
+
+Separa la actualización de una revisión extensa del contenido cuando sea posible. Así será más fácil encontrar la causa de una falla.
diff --git a/content/es/guia/autoria-local/vista-previa.md b/content/es/guia/autoria-local/vista-previa.md
new file mode 100644
index 0000000..1b78d06
--- /dev/null
+++ b/content/es/guia/autoria-local/vista-previa.md
@@ -0,0 +1,59 @@
+---
+title: Genera y revisa el sitio local
+url: /guia/autoria-local/vista-previa/
+translationKey: docs-local-authoring-preview
+type: guide
+docs_draft: true
+docs_section: local
+---
+
+# Genera y revisa el sitio local {#genera-y-revisa-el-sitio-local}
+
+El script local prepara el contenido antes de iniciar Jekyll. El observador de archivos de Jekyll no vuelve a ejecutar todo el procesamiento previo.
+
+## Vuelve a generar después de editar contenido {#vuelve-a-generar-después-de-editar-contenido}
+
+Detén el servidor con Ctrl+C y ejecuta:
+
+```bash
+python3 scripts/build_local_site.py
+```
+
+Después de editar CSV hay que convertir los datos y generar las colecciones. Después de agregar o reemplazar una imagen o PDF hay que generar las teselas IIIF. El script realiza estas etapas.
+
+Si no cambiaron las imágenes ni la hoja de Google Sheets:
+
+```bash
+python3 scripts/build_local_site.py --skip-iiif --skip-fetch
+```
+
+No omitas una etapa cuyos insumos cambiaron. Jekyll puede actualizar parte del resultado al editar Markdown o estilos, pero vuelve a usar el script para revisar el sitio completo.
+
+## Comprueba la fuente de cada paso {#comprueba-la-fuente-de-cada-paso}
+
+Abre la galería, la página del objeto y la historia. En el ejemplo del khipu, las tres deben mostrar el khipu. Revisa encuadre, texto alternativo, créditos, paneles y enlaces del glosario.
+
+Prueba una ventana más pequeña y la navegación con teclado. Usa [la revisión con lectores](/guia/planear/revision/) para evaluar también la narrativa.
+
+{{< media id="coordinates" >}}
+
+## Prueba las historias privadas por separado {#prueba-las-historias-privadas-por-separado}
+
+El servidor de desarrollo muestra las historias privadas sin cifrar. Como regenera las páginas continuamente, su resultado no conserva el cifrado.
+
+Para probar el bloqueo, detén Jekyll. Configura temporalmente `baseurl: ""` para que el servidor estático sirva el resultado desde su raíz y ejecuta:
+
+```bash
+python3 scripts/build_local_site.py --port 4003 --build-only
+python3 -m http.server 4003 --directory _site
+```
+
+Restaura la ruta de producción después de esta prueba. Este build ejecuta el cifrado posterior a la generación. Abre la historia en el servidor estático y prueba las vistas bloqueada y desbloqueada. Trata la vista previa de desarrollo como material de trabajo local.
+
+## Revisa la etapa que informa el error {#revisa-la-etapa-que-informa-el-error}
+
+Una imagen ausente puede deberse a un ID distinto, una fuente inaccesible o una falla al generar teselas. Una historia ausente puede deberse a que su ID y el archivo tienen nombres diferentes. La terminal ayuda a identificar la etapa.
+
+Corrige la fuente y vuelve a generar. Evita editar JSON o HTML generados para ocultar el problema.
+
+Sigue con [la publicación y el mantenimiento](/guia/autoria-local/publicar/).
diff --git a/docs/2-0-setup.es.md b/content/es/guia/configuracion/_index.md
similarity index 60%
rename from docs/2-0-setup.es.md
rename to content/es/guia/configuracion/_index.md
index 02e8dd2..12457c8 100644
--- a/docs/2-0-setup.es.md
+++ b/content/es/guia/configuracion/_index.md
@@ -1,25 +1,23 @@
---
-layout: docs
-title: 2. Configura tu sitio
-parent: Documentación
-nav_order: 2
-has_children: true
-lang: es
-permalink: /guia/configuracion/
+title: Configura tu sitio
+url: /guia/configuracion/
+translationKey: docs-setup
+type: guide
+docs_section: reference
---
-# Configura tu sitio
+# Configura tu sitio {#configura-tu-sitio}
¿Buscas instrucciones de configuración? Ve a **[Primeros pasos](/guia/primeros-pasos/)** para elegir entre el Compositor, Google Sheets o desarrollo local.
Esta sección cubre la configuración manual y el mantenimiento de sitios existentes.
-### Configuración manual
+### Configuración manual {#configuración-manual}
El enfoque manual paso a paso para personas que ya se sienten cómodas con GitHub y YAML. Construye una exposición completa desde tu navegador, sin instalar nada.
-[Configuración manual](/guia/configuracion/configuracion-manual/){: .btn .btn-primary }
+<a href="/guia/configuracion/configuracion-manual/" class="btn btn-primary">Configuración manual</a>
-## Mantenimiento
+## Mantenimiento {#mantenimiento}
- [Actualizar Telar](/guia/configuracion/actualizacion/) — Mantén tu sitio al día con las últimas funciones
diff --git a/docs/2-3-upgrading.es.md b/content/es/guia/configuracion/actualizacion.md
similarity index 83%
rename from docs/2-3-upgrading.es.md
rename to content/es/guia/configuracion/actualizacion.md
index c478d01..b46cebd 100644
--- a/docs/2-3-upgrading.es.md
+++ b/content/es/guia/configuracion/actualizacion.md
@@ -1,32 +1,31 @@
---
-layout: docs
-title: 2.3. Actualizar Telar
-parent: 2. Configura tu sitio
-grand_parent: Documentación
-nav_order: 3
-lang: es
-permalink: /guia/configuracion/actualizacion/
+title: Actualizar Telar
+url: /guia/configuracion/actualizacion/
+translationKey: docs-setup-upgrading
+type: guide
+docs_section: reference
---
-# Actualizar Telar
+# Actualizar Telar {#actualizar-telar}
Mantén tu sitio Telar al día con las últimas funciones, correcciones de errores y mejoras.
-{: .note }
-> **¿Usas el Compositor de Telar?** Si administras tu sitio desde el [Compositor de Telar](https://compositor.telar.org), puedes actualizarlo con un clic desde su pantalla de actualización y no necesitas seguir los pasos manuales de abajo. Si primero te pide que apruebes los permisos actualizados en GitHub, acéptalos y vuelve a intentarlo. Los pasos de abajo son para actualizar directamente en GitHub.
+{{< callout "note" >}}
+**¿Usas el Compositor de Telar?** Si administras tu sitio desde el [Compositor de Telar](https://compositor.telar.org), puedes actualizarlo con un clic desde su pantalla de actualización y no necesitas seguir los pasos manuales de abajo. Si primero te pide que apruebes los permisos actualizados en GitHub, acéptalos y vuelve a intentarlo. Los pasos de abajo son para actualizar directamente en GitHub.
+{{< /callout >}}
-## Descripción general
+## Descripción general {#descripción-general}
Telar v0.3.4 introdujo un sistema automatizado de actualización que facilita mantener tu sitio al día de forma sencilla y segura. El proceso de actualización depende de la versión que estés usando en este momento:
- **v0.3.4 o posterior**: Utiliza el flujo de trabajo automatizado de actualización (actualizaciones con un clic)
- **v0.2.0 a v0.3.3**: Requiere una configuración manual inicial (solo una vez)
-## Actualizaciones automatizadas (v0.3.4+)
+## Actualizaciones automatizadas (v0.3.4+) {#actualizaciones-automatizadas-v034}
Si tu sitio ya está en Telar v0.3.4 o posterior, el proceso de actualización es completamente automatizado.
-### Cómo funciona
+### Cómo funciona {#cómo-funciona}
El sistema de actualización:
1. Detecta tu versión actual de Telar desde `_config.yml`
@@ -35,10 +34,11 @@ El sistema de actualización:
4. Crea una rama de actualización y un *issue* con resumen detallado
5. Destaca cualquier paso manual que necesites completar
-### Ejecutar una actualización automatizada
+### Ejecutar una actualización automatizada {#ejecutar-una-actualización-automatizada}
-{: .note }
-> **Solo para repositorios con fork**: Si creaste tu sitio haciendo fork de otro repositorio, necesitarás habilitar los *issues* en la configuración de tu repositorio (**Settings** → **General** → marca **Issues**). Los sitios creados usando el botón "Use this template" ya tienen los *issues* habilitados.
+{{< callout "note" >}}
+**Solo para repositorios con fork**: Si creaste tu sitio haciendo fork de otro repositorio, necesitarás habilitar los *issues* en la configuración de tu repositorio (**Settings** → **General** → marca **Issues**). Los sitios creados usando el botón "Use this template" ya tienen los *issues* habilitados.
+{{< /callout >}}
1. Ve a tu repositorio en GitHub
2. Haz clic en la pestaña **Actions**
@@ -50,11 +50,12 @@ El sistema de actualización:
8. Haz clic en el enlace del *issue* para crear un pull request
9. Revisa los cambios y haz *merge* del pull request para completar la actualización
-{: .note }
-> **Seguro y reversible**
-> La actualización crea un *issue* y una rama, dándote control total. Revisa los cambios usando el enlace de comparación, crea un pull request cuando estés listo y haz *merge* solo después de verificar.
+{{< callout "note" >}}
+**Seguro y reversible**
+La actualización crea un *issue* y una rama, dándote control total. Revisa los cambios usando el enlace de comparación, crea un pull request cuando estés listo y haz *merge* solo después de verificar.
+{{< /callout >}}
-### Después de actualizar
+### Después de actualizar {#después-de-actualizar}
1. Visita tu sitio para verificar que esté funcionando correctamente
2. **Revisa el *issue* de actualización** para ver si hay pasos manuales (visibles en la sección "After Merging")
@@ -63,7 +64,7 @@ El sistema de actualización:
4. **Cierra el *issue* de actualización** una vez que todo esté funcionando - esto marca la actualización como completa
5. Si encuentras problemas, consulta los [GitHub Issues](https://github.com/UCSB-AMPLab/telar/issues) o reporta un problema
-#### Actualización manual del archivo de flujo de trabajo (solo v0.2.0-v0.3.3)
+#### Actualización manual del archivo de flujo de trabajo (solo v0.2.0-v0.3.3) {#actualización-manual-del-archivo-de-flujo-de-trabajo-solo-v020-v033}
Si estás actualizando desde **v0.2.0 hasta v0.3.3**, el resumen de actualización incluirá un paso manual para actualizar tu archivo de flujo de trabajo de GitHub Actions. Esto es necesario porque las restricciones de seguridad de GitHub impiden que los flujos de trabajo modifiquen otros archivos de flujo de trabajo.
@@ -77,13 +78,13 @@ Si estás actualizando desde **v0.2.0 hasta v0.3.3**, el resumen de actualizaci
Esta actualización elimina funciones obsoletas (la programación con cron y el paso de `git push`) que ya no son necesarias en v0.3.4+.
-### Notas de actualización a v1.8.3
+### Notas de actualización a v1.8.3 {#notas-de-actualización-a-v183}
**Actualiza con el workflow «Upgrade Telar» o con el Compositor de Telar.** La actualización lleva un sitio de la v1.8.2 a la v1.8.3; desde versiones anteriores, pasa en orden por cada versión intermedia. No hay pasos manuales: solo se instalan los archivos de Telar que cambiaron, y el contenido y la configuración del sitio quedan como estaban.
La actualización instala un `Gemfile.lock` que incluye la plataforma `x86_64-linux`. Si el *build* de tu sitio venía fallando en los servidores de GitHub con Ubuntu 26.04 al instalar la gema `google-protobuf`, el primer *build* después de la actualización instala gemas ya compiladas y termina sin errores.
-### Notas de actualización a v1.8.2
+### Notas de actualización a v1.8.2 {#notas-de-actualización-a-v182}
**Actualiza con el workflow «Upgrade Telar» o con el Compositor de Telar.** La actualización lleva un sitio de la v1.8.1 a la v1.8.2; desde versiones anteriores, pasa en orden por cada versión intermedia.
@@ -93,13 +94,13 @@ En los sitios que se actualizan con `scripts/upgrade.py`, la actualización tamb
Si actualizas con el workflow o desde tu computador, puedes borrar `.github/workflows/telar-tests.yml`. Ese workflow ejecuta las pruebas del propio Telar, que en tu sitio siempre se omiten. Si actualizas con el Compositor, este lo borra por ti.
-### Notas de actualización a v1.8.1
+### Notas de actualización a v1.8.1 {#notas-de-actualización-a-v181}
**Actualiza con el workflow «Upgrade Telar» o con el Compositor de Telar.** La actualización lleva un sitio de la v1.8.0 a la v1.8.1; desde versiones anteriores, pasa en orden por cada versión intermedia. No hay pasos manuales: solo se instalan los archivos de Telar que cambiaron, y el contenido y la configuración del sitio quedan como estaban.
La actualización no agrega a `_config.yml` la opción nueva [`hide_warnings`](/guia/configurar/configuracion/#hide_warnings), así que el sitio sigue mostrando las advertencias como hasta ahora. Para ocultarlas, pon `hide_warnings: true` en el bloque `development-features`.
-### Notas de actualización a v1.8.0
+### Notas de actualización a v1.8.0 {#notas-de-actualización-a-v180}
**Actualiza con el workflow «Upgrade Telar».** Lleva un sitio de v1.7.0 a v1.8.0, y en cadena desde versiones anteriores. Antes del primer *build*, la actualización corrige las hojas con columnas duplicadas que ahora detendrían el *build* (una columna conserva los valores y las otras quedan vacías) y lista las respuestas que el *build* va a recortar.
@@ -109,7 +110,7 @@ La actualización no agrega a `_config.yml` la opción nueva [`hide_warnings`](/
**Si tu sitio lee una hoja de Google Sheets**, borra de la hoja las columnas que nombre el resumen de la actualización: la actualización corrigió la copia de la hoja que está en el repositorio, pero cada *build* vuelve a leer la hoja de Google.
-### Notas de actualización a v1.7.0
+### Notas de actualización a v1.7.0 {#notas-de-actualización-a-v170}
**Actualizar en GitHub no cambia.** Si usas el flujo de trabajo **"Upgrade Telar"**, ejecútalo como siempre: no hay nada nuevo que hacer.
@@ -124,7 +125,7 @@ La actualización no agrega a `_config.yml` la opción nueva [`hide_warnings`](/
Después de cualquiera de las dos, el `scripts/upgrade.py` de tu sitio es el nuevo lanzador y no vuelve a hacer falta ningún paso manual.
-### Notas de actualización a v1.6.0
+### Notas de actualización a v1.6.0 {#notas-de-actualización-a-v160}
v1.6.0 cambia la forma en que se construyen las historias privadas. Las historias, los objetos y la configuración que ya tienes siguen funcionando sin cambios — pero **si tu sitio tiene alguna historia marcada `private: yes` (o `protected: yes`), tienes que actualizar tu flujo de trabajo Build and Deploy a mano, o el *build* fallará.**
@@ -140,10 +141,11 @@ Por seguridad, GitHub no permite que la actualización automática modifique los
4. Selecciona todo y reemplázalo con el contenido copiado
5. Confirma el cambio
-{: .warning }
-> Si te saltas este paso y marcas una historia con `private: yes`, el *build* fallará en el paso "Convert CSVs to JSON" con un error que dice que el flujo de trabajo no ejecuta el script de cifrado. Es intencional: sin el paso nuevo, tu sitio publicaría la historia "privada" en texto plano.
->
-> Si tu sitio no tiene historias privadas, no se rompe nada si te saltas este paso — pero no podrás agregar una más adelante sin aplicar antes esta actualización.
+{{< callout "warning" >}}
+Si te saltas este paso y marcas una historia con `private: yes`, el *build* fallará en el paso "Convert CSVs to JSON" con un error que dice que el flujo de trabajo no ejecuta el script de cifrado. Es intencional: sin el paso nuevo, tu sitio publicaría la historia "privada" en texto plano.
+
+Si tu sitio no tiene historias privadas, no se rompe nada si te saltas este paso — pero no podrás agregar una más adelante sin aplicar antes esta actualización.
+{{< /callout >}}
**Pruebas locales:** ni `bundle exec jekyll serve` ni el modo de servir por defecto de `scripts/build_local_site.py` cifran nada — con ambos, las historias privadas se previsualizan en texto plano. Para probar el comportamiento bloqueado, ejecuta `python3 scripts/build_local_site.py --build-only` y sirve el directorio `_site/` resultante con un servidor de archivos estáticos. Consulta [Historias privadas: Probar localmente](/guia/funciones/historias-privadas/#probar-localmente).
@@ -151,7 +153,7 @@ Por seguridad, GitHub no permite que la actualización automática modifique los
La actualización automática se encarga de reemplazar todos los demás archivos del marco. Si tienes (o planeas agregar) alguna historia privada, igual tienes que copiar el `build.yml` actualizado como se describe arriba — este paso no es opcional.
-### Notas de actualización a v1.5.0
+### Notas de actualización a v1.5.0 {#notas-de-actualización-a-v150}
v1.5.0 es una versión centrada en la robustez y la seguridad. Solo afecta el motor y las herramientas: las historias, los objetos y la configuración que ya tienes siguen funcionando sin cambios, sin editar los CSV ni cambiar la configuración. La actualización automática reemplaza todos los archivos del marco; los dos pasos manuales opcionales se describen abajo.
@@ -166,8 +168,9 @@ Por seguridad, GitHub no permite que la actualización automática modifique los
Para aplicarlos, usa los pasos de copiar desde «Raw» de la sección "Configuración manual para versiones anteriores" más abajo, una vez por cada archivo. Si te saltas este paso, tu sitio se sigue construyendo y publicando con normalidad; estos cambios solo refuerzan tus flujos de trabajo.
-{: .warning }
-> **Si actualizas `build.yml`, agrega también `package-lock.json`.** El nuevo `build.yml` instala las dependencias de Node con `npm ci`, que necesita un `package-lock.json` incluido en el repositorio. Cópialo desde el repositorio de Telar (abre [package-lock.json](https://github.com/UCSB-AMPLab/telar/blob/main/package-lock.json) y haz clic en **Copy raw contents**) en la raíz de tu repositorio, o el *build* fallará. Los sitios nuevos creados a partir de la plantilla ya lo incluyen.
+{{< callout "warning" >}}
+**Si actualizas `build.yml`, agrega también `package-lock.json`.** El nuevo `build.yml` instala las dependencias de Node con `npm ci`, que necesita un `package-lock.json` incluido en el repositorio. Cópialo desde el repositorio de Telar (abre [package-lock.json](https://github.com/UCSB-AMPLab/telar/blob/main/package-lock.json) y haz clic en **Copy raw contents**) en la raíz de tu repositorio, o el *build* fallará. Los sitios nuevos creados a partir de la plantilla ya lo incluyen.
+{{< /callout >}}
**Paquetes de idioma: nuevas claves para compartir historias protegidas:**
@@ -177,7 +180,7 @@ Esta versión agrega claves a los archivos de idioma incluidos (`en.yml` y `es.y
La actualización automática reemplaza todos los archivos del marco. Las actualizaciones de los flujos de trabajo de arriba son refuerzos opcionales; si aplicas la actualización de `build.yml`, recuerda la nota sobre `package-lock.json`.
-### Notas de actualización a v1.4.0
+### Notas de actualización a v1.4.0 {#notas-de-actualización-a-v140}
v1.4.0 es una actualización que solo afecta el código de ejecución del sitio. Las historias, los objetos y la configuración que ya tienes siguen funcionando sin cambios: no hace falta editar los CSV, ni cambiar la configuración, ni actualizar los flujos de trabajo.
@@ -195,7 +198,7 @@ Si tienes un archivo de idioma personalizado (una copia de `en.yml` o `es.yml` c
No tienes que hacer nada a mano. La actualización se encarga de reemplazar todos los archivos automáticamente.
-### Notas de actualización a v1.3.0
+### Notas de actualización a v1.3.0 {#notas-de-actualización-a-v130}
v1.3.0 mejora la cobertura de internacionalización (i18n) en todo el sitio e introduce una convención de archivos hermanos para traducir las páginas de contenido. No requiere cambios en los CSV.
@@ -211,13 +214,13 @@ Se agregan dos claves nuevas a los archivos de idioma incluidos. Si tienes un ar
No tienes que hacer nada a mano, más allá de revisar el *issue* de actualización que se crea automáticamente, por si marca algún archivo como distinto del predeterminado (lo que significa que se detectaron y conservaron tus personalizaciones).
-### Notas de actualización a v1.2.1
+### Notas de actualización a v1.2.1 {#notas-de-actualización-a-v121}
v1.2.1 es una versión de corrección. No requiere pasos manuales.
La actualización corrige una falla silenciosa en el script que descarga el contenido de demostración, que afectaba a los sitios cuyo `_config.yml` tenía una versión con la "v" delante (por ejemplo, `version: "v1.2.0"`). Si tu sitio quedó sin contenido de demostración después de una actualización anterior, este parche lo soluciona. No hay que editar la configuración; la corrección está en el propio script.
-### Notas de actualización a v1.2.0
+### Notas de actualización a v1.2.0 {#notas-de-actualización-a-v120}
v1.2.0 agrega una tabla de contenidos por secciones, un botón de "Volver al inicio" y navegación dentro de la historia. No requiere pasos manuales.
@@ -227,7 +230,7 @@ Todas las funciones nuevas se activan automáticamente. La tabla de contenidos p
No tienes que hacer nada.
-### Notas de actualización a v1.1.0
+### Notas de actualización a v1.1.0 {#notas-de-actualización-a-v110}
v1.1.0 agrega enlaces profundos (*deep linking*), tarjetas de título, modo colección, estilo para bibliografías y una pestaña de posición para el panel de compartir. No requiere pasos manuales.
@@ -237,7 +240,7 @@ Los enlaces profundos y el panel de compartir actualizado se activan automática
No tienes que hacer nada.
-### Notas de actualización a v1.0.0-beta
+### Notas de actualización a v1.0.0-beta {#notas-de-actualización-a-v100-beta}
v1.0.0-beta agrega soporte multimedia (objetos de video y audio), un *build* actualizado y renombra la columna CSV `object_type` a `medium`.
@@ -271,7 +274,7 @@ La columna `object_type` en `objects.csv` se renombró a `medium`. Este cambio e
**Si solo usas la interfaz web de GitHub:**
- Copia el `build.yml` actualizado como se describe arriba. No se requieren otros pasos manuales.
-### Notas de actualización a v0.7.0
+### Notas de actualización a v0.7.0 {#notas-de-actualización-a-v070}
v0.7.0 agrega Node.js como requisito para construir el sitio localmente:
@@ -288,15 +291,15 @@ v0.7.0 agrega Node.js como requisito para construir el sitio localmente:
**Si solo usas la interfaz web de GitHub:**
- No se requiere ninguna acción — tu sitio se seguirá construyendo automáticamente
-## Configuración manual para versiones anteriores
+## Configuración manual para versiones anteriores {#configuración-manual-para-versiones-anteriores}
Si tu sitio está en la versión **v0.2.0 hasta v0.3.3**, primero necesitas agregar el archivo del flujo de trabajo de actualización a tu repositorio. Esta configuración se hace **una sola vez**; después de eso, todas las actualizaciones futuras serán automatizadas.
-### Paso 1: Agregar el archivo del flujo de trabajo de actualización
+### Paso 1: Agregar el archivo del flujo de trabajo de actualización {#paso-1-agregar-el-archivo-del-flujo-de-trabajo-de-actualización}
Necesitas agregar **dos archivos** para habilitar las actualizaciones automatizadas: el flujo de trabajo de actualización y el flujo de trabajo de *build* actualizado. El flujo de trabajo de actualización descargará automáticamente todos los scripts necesarios cuando se ejecute.
-#### Método A: Interfaz web de GitHub (Recomendado)
+#### Método A: Interfaz web de GitHub (Recomendado) {#método-a-interfaz-web-de-github-recomendado}
Trabaja completamente en el navegador sin instalar nada:
@@ -313,7 +316,7 @@ Trabaja completamente en el navegador sin instalar nada:
- Agrega el mensaje de commit: "Add automated upgrade workflow"
- Haz clic en **Commit changes**
-#### Método B: Desarrollo local (computador)
+#### Método B: Desarrollo local (computador) {#método-b-desarrollo-local-computador}
Si tienes tu repositorio clonado localmente:
@@ -329,14 +332,15 @@ Si tienes tu repositorio clonado localmente:
git push
```
-{: .note }
-> **¡Eso es todo!** El flujo de trabajo descarga automáticamente los scripts de actualización más recientes del repositorio de Telar cada vez que se ejecuta, así que no necesitas copiar ningún archivo de Python manualmente.
+{{< callout "note" >}}
+**¡Eso es todo!** El flujo de trabajo descarga automáticamente los scripts de actualización más recientes del repositorio de Telar cada vez que se ejecuta, así que no necesitas copiar ningún archivo de Python manualmente.
+{{< /callout >}}
-### Paso 2: Reemplazar el archivo del flujo de trabajo de *build*
+### Paso 2: Reemplazar el archivo del flujo de trabajo de *build* {#paso-2-reemplazar-el-archivo-del-flujo-de-trabajo-de-build}
Si estás actualizando desde la **v0.2.0 hasta v0.3.3**, también necesitas reemplazar tu archivo `.github/workflows/build.yml` con la versión más reciente. Esto elimina funciones obsoletas (la programación con cron y el paso de `git push`) que ya no son necesarias en v0.3.4+.
-#### Método A: Interfaz web de GitHub (Recomendado)
+#### Método A: Interfaz web de GitHub (Recomendado) {#método-a-interfaz-web-de-github-recomendado-1}
Trabaja completamente en el navegador:
@@ -354,7 +358,7 @@ Trabaja completamente en el navegador:
- Agrega el mensaje de commit: "Update build workflow to v0.3.4"
- Haz clic en **Commit changes**
-#### Método B: Desarrollo local (computador)
+#### Método B: Desarrollo local (computador) {#método-b-desarrollo-local-computador-1}
Si tienes tu repositorio clonado localmente:
@@ -370,10 +374,11 @@ Si tienes tu repositorio clonado localmente:
git push
```
-{: .note }
-> **Paso opcional**: Si omites este paso ahora, el resumen de actualización incluirá instrucciones para actualizar `build.yml` manualmente después de tu primera actualización. Sin embargo, hacerlo ahora asegura una experiencia de actualización más fluida.
+{{< callout "note" >}}
+**Paso opcional**: Si omites este paso ahora, el resumen de actualización incluirá instrucciones para actualizar `build.yml` manualmente después de tu primera actualización. Sin embargo, hacerlo ahora asegura una experiencia de actualización más fluida.
+{{< /callout >}}
-### Paso 3: Ejecuta tu primera actualización automatizada
+### Paso 3: Ejecuta tu primera actualización automatizada {#paso-3-ejecuta-tu-primera-actualización-automatizada}
Con eso queda lista la configuración. Ahora sigue las instrucciones de [Actualizaciones automatizadas](#actualizaciones-automatizadas-v034) para actualizar a la versión más reciente.
@@ -383,9 +388,9 @@ El flujo de trabajo hará lo siguiente de forma automática:
3. Aplicará todas las migraciones necesarias
4. Creará un pull request con los archivos actualizados
-## Solución de problemas
+## Solución de problemas {#solución-de-problemas}
-### El flujo de trabajo de actualización no aparece
+### El flujo de trabajo de actualización no aparece {#el-flujo-de-trabajo-de-actualización-no-aparece}
**Problema**: El flujo de trabajo "Upgrade Telar" no aparece en la pestaña Actions.
@@ -394,7 +399,7 @@ El flujo de trabajo hará lo siguiente de forma automática:
- Actualiza la pestaña Actions en tu navegador
- Verifica que el archivo YAML sea válido (sin errores de sintaxis)
-### La actualización falla con error
+### La actualización falla con error {#la-actualización-falla-con-error}
**Problema**: El flujo de trabajo de actualización falla con un mensaje de error.
@@ -404,7 +409,7 @@ El flujo de trabajo hará lo siguiente de forma automática:
- El flujo de trabajo descarga scripts automáticamente, así que un problema de red podría causar fallas
- Si el error persiste, [reporta un problema](https://github.com/UCSB-AMPLab/telar/issues) con el mensaje de error
-### No se creó el *issue*
+### No se creó el *issue* {#no-se-creó-el-issue}
**Problema**: La actualización se completa pero no se crea ningún *issue*.
@@ -414,7 +419,7 @@ El flujo de trabajo hará lo siguiente de forma automática:
- Verifica que los *issues* estén habilitados en la configuración de tu repositorio
- Vuelve a ejecutar el workflow
-### Conflictos de *merge*
+### Conflictos de *merge* {#conflictos-de-merge}
**Problema**: El PR de actualización tiene conflictos de *merge*.
@@ -424,12 +429,12 @@ El flujo de trabajo hará lo siguiente de forma automática:
- Si los conflictos están en archivos del marco, suele convenir conservar la versión de la actualización
- Si no estás seguro, [pide ayuda](https://github.com/UCSB-AMPLab/telar/issues)
-## Historial de versiones
+## Historial de versiones {#historial-de-versiones}
Para ver la lista completa de cambios en cada versión, consulta el [Changelog](https://github.com/UCSB-AMPLab/telar/blob/main/CHANGELOG.md) en el repositorio de Telar.
-## ¿Necesitas ayuda?
+## ¿Necesitas ayuda? {#necesitas-ayuda}
- **Documentación:** [telar.org/guia](https://telar.org/guia)
-- **Sitio de ejemplo:** [telar.org/demo](https://telar.org/demo)
+- **Sitio de ejemplo:** [telar.org/demo](https://paisajes.telar.org/)
- **Reportar un problema:** [GitHub Issues](https://github.com/UCSB-AMPLab/telar/issues)
diff --git a/docs/2-1-manual-setup.es.md b/content/es/guia/configuracion/configuracion-manual.md
similarity index 67%
rename from docs/2-1-manual-setup.es.md
rename to content/es/guia/configuracion/configuracion-manual.md
index 92faa76..81ada48 100644
--- a/docs/2-1-manual-setup.es.md
+++ b/content/es/guia/configuracion/configuracion-manual.md
@@ -1,14 +1,12 @@
---
-layout: docs
-title: 2.1. Configuración manual
-parent: 2. Configura tu sitio
-grand_parent: Documentación
-nav_order: 1
-lang: es
-permalink: /guia/configuracion/configuracion-manual/
+title: Configuración manual
+url: /guia/configuracion/configuracion-manual/
+translationKey: docs-setup-manual
+type: guide
+docs_section: sheets
---
-# Configuración manual
+# Configuración manual {#configuración-manual}
Construye una exposición completa de Telar desde tu navegador usando GitHub y Google Sheets. No necesitas instalar nada.
@@ -18,11 +16,11 @@ Vas a necesitar:
---
-## Parte 1: Configura la parte técnica
+## Parte 1: Configura la parte técnica {#parte-1-configura-la-parte-técnica}
Esta parte puede parecer intimidante, pero solo tienes que hacerla una vez. Una vez que todo esté configurado, no tendrás que volver aquí — todo lo demás es trabajo creativo en tu hoja de cálculo.
-### Crea tu repositorio
+### Crea tu repositorio {#crea-tu-repositorio}
Un repositorio es el espacio de tu proyecto en GitHub — almacena tus imágenes y archivos de configuración.
@@ -34,7 +32,7 @@ Un repositorio es el espacio de tu proyecto en GitHub — almacena tus imágenes
-### Habilita GitHub Pages
+### Habilita GitHub Pages {#habilita-github-pages}
GitHub Pages convierte tu repositorio en un sitio web en vivo de forma gratuita.
@@ -44,7 +42,7 @@ GitHub Pages convierte tu repositorio en un sitio web en vivo de forma gratuita.
-### Duplica la plantilla de Google Sheets
+### Duplica la plantilla de Google Sheets {#duplica-la-plantilla-de-google-sheets}
Tu hoja de cálculo de Google Sheets es donde administras todo el contenido — objetos, historias y textos.
@@ -52,7 +50,7 @@ Tu hoja de cálculo de Google Sheets es donde administras todo el contenido —
2. Haz clic en **File** → **Make a copy**
3. Guárdala en tu Google Drive con un nombre descriptivo (ej., "Mi exposición Telar")
-### Publica tu hoja
+### Publica tu hoja {#publica-tu-hoja}
Tu hoja de cálculo necesita estar publicada para que Telar pueda leerla durante el *build*.
@@ -60,10 +58,11 @@ Tu hoja de cálculo necesita estar publicada para que Telar pueda leerla durante
2. Haz clic en **Publish**
3. Copia la URL publicada
-{: .note }
-> **Simplificado en v0.9.0.** Las versiones anteriores requerían tanto una URL compartida como una URL publicada. Desde v0.9.0, solo se necesita la URL publicada. Si tu `_config.yml` todavía tiene una línea `shared_url`, se ignora sin problemas.
+{{< callout "note" >}}
+**Simplificado en v0.9.0.** Las versiones anteriores requerían tanto una URL compartida como una URL publicada. Desde v0.9.0, solo se necesita la URL publicada. Si tu `_config.yml` todavía tiene una línea `shared_url`, se ignora sin problemas.
+{{< /callout >}}
-### Configura tu sitio
+### Configura tu sitio {#configura-tu-sitio}
Edita el archivo `_config.yml` en tu repositorio para conectar todo:
@@ -86,7 +85,7 @@ Edita el archivo `_config.yml` en tu repositorio para conectar todo:
Tu sitio estará disponible en `https://tuusuariogithub.github.io/nombre-de-tu-repositorio`.
- {: .warning }
+{.warning}
> Es muy importante que tu baseurl coincida exactamente con el nombre de tu repositorio. Baseurl debe estar completamente en minúsculas, así que si le pusiste mayúsculas al nombre de tu repositorio, ve y cámbialo ahora.
4. **Google Sheets** — pega la URL publicada que copiaste:
@@ -108,7 +107,7 @@ Edita el archivo `_config.yml` en tu repositorio para conectar todo:
-### Verifica tu configuración
+### Verifica tu configuración {#verifica-tu-configuración}
Después de hacer *commit*, GitHub Actions construirá y publicará tu sitio automáticamente. Esto toma de 2 a 5 minutos.
@@ -118,19 +117,20 @@ Después de hacer *commit*, GitHub Actions construirá y publicará tu sitio aut
-{: .warning }
-> Si el *build* falla o tu sitio no se ve bien, revisa tu `_config.yml` con cuidado. Errores comunes:
-> - **Comillas sin cerrar** — cada `"` necesita su par
-> - **Falta espacio después de los dos puntos** — escribe `title: "Mi sitio"`, no `title:"Mi sitio"`
-> - **Indentación incorrecta** — las opciones anidadas como `published_url` deben indentarse con espacios, no tabulaciones
-> - **baseurl no coincide** — debe coincidir exactamente con el nombre de tu repositorio, todo en minúsculas
-> - **URL de Google Sheets incorrecta** — asegúrate de usar la URL publicada de Archivo → Compartir → Publicar en la Web
->
-> Consulta la [Referencia de configuración](/guia/configurar/configuracion/) para la lista completa de opciones. También puedes pegar tu `_config.yml` en el [Validador de Configuración de Telar](/guia/configurar/validador-de-configuracion/) para buscar errores, o usar el [Generador y editor de configuración](/guia/configurar/generador-de-configuracion/) para crear uno desde cero.
+{{< callout "warning" >}}
+Si el *build* falla o tu sitio no se ve bien, revisa tu `_config.yml` con cuidado. Errores comunes:
+- **Comillas sin cerrar** — cada `"` necesita su par
+- **Falta espacio después de los dos puntos** — escribe `title: "Mi sitio"`, no `title:"Mi sitio"`
+- **Indentación incorrecta** — las opciones anidadas como `published_url` deben indentarse con espacios, no tabulaciones
+- **baseurl no coincide** — debe coincidir exactamente con el nombre de tu repositorio, todo en minúsculas
+- **URL de Google Sheets incorrecta** — asegúrate de usar la URL publicada de Archivo → Compartir → Publicar en la Web
+Consulta la [Referencia de configuración](/guia/configurar/configuracion/) para la lista completa de opciones. También puedes pegar tu `_config.yml` en el [Validador de Configuración de Telar](/guia/configurar/validador-de-configuracion/) para buscar errores, o usar el [Generador y editor de configuración](/guia/configurar/generador-de-configuracion/) para crear uno desde cero.
+{{< /callout >}}
-## Próximos pasos
+
+## Próximos pasos {#próximos-pasos}
Tu sitio está configurado y funcionando. Continúa con el tutorial de Primeros pasos:
diff --git a/content/es/guia/configuracion/desarrollo-local.md b/content/es/guia/configuracion/desarrollo-local.md
new file mode 100644
index 0000000..ab939ab
--- /dev/null
+++ b/content/es/guia/configuracion/desarrollo-local.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/configuracion/desarrollo-local/
+translationKey: redirects-es-conf-desarrollo-local-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/primeros-pasos/desarrollo-local/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/docs/3-0-configure.es.md b/content/es/guia/configurar/_index.md
similarity index 80%
rename from docs/3-0-configure.es.md
rename to content/es/guia/configurar/_index.md
index 603d6c0..691b009 100644
--- a/docs/3-0-configure.es.md
+++ b/content/es/guia/configurar/_index.md
@@ -1,20 +1,18 @@
---
-layout: docs
-title: 3. Configura tu proyecto
-parent: Documentación
-nav_order: 3
-lang: es
-permalink: /guia/configurar/
-has_children: true
+title: Configura tu proyecto
+url: /guia/configurar/
+translationKey: docs-configure
+type: guide
+docs_section: reference
---
-# Configura tu proyecto
+# Configura tu proyecto {#configura-tu-proyecto}
El comportamiento de Telar se controla a través de `_config.yml`, un archivo YAML en la raíz de tu repositorio. Allí se definen el título de tu sitio, el tema, el idioma, la conexión con Google Sheets y las opciones de funciones.
Si usaste la [configuración con Google Sheets](/guia/primeros-pasos/google-sheets/), ya tienes un `_config.yml` funcional. Esta sección te ayuda a entender qué contiene y cómo modificarlo.
-## En esta sección
+## En esta sección {#en-esta-sección}
- [Generador y editor de configuración](/guia/configurar/generador-de-configuracion/) — Crea un nuevo `_config.yml` desde cero o carga uno existente para editarlo
- [Referencia de configuración](/guia/configurar/configuracion/) — Lista completa de cada opción y qué hace
diff --git a/docs/3-2-configuration.es.md b/content/es/guia/configurar/configuracion.md
similarity index 83%
rename from docs/3-2-configuration.es.md
rename to content/es/guia/configurar/configuracion.md
index 55ed103..92c878e 100644
--- a/docs/3-2-configuration.es.md
+++ b/content/es/guia/configurar/configuracion.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "3.2. Referencia de configuración"
-parent: "3. Configura tu proyecto"
-grand_parent: Documentación
-nav_order: 2
-lang: es
-permalink: /guia/configurar/configuracion/
+title: Configuración
+url: /guia/configurar/configuracion/
+translationKey: docs-configure-configuration
+type: guide
+docs_section: reference
---
-# Configuración
+# Configuración {#configuración}
Configura tu sitio Telar usando el archivo `_config.yml` en la raíz de tu repositorio.
-## Ajustes del sitio
+## Ajustes del sitio {#ajustes-del-sitio}
Información básica y apariencia del sitio:
@@ -30,7 +28,7 @@ telar_language: "en" # Opciones: "en" (English), "es" (Español)
collection_mode: false # Ponlo en true para una página principal centrada en objetos
```
-### collection_mode
+### collection_mode {#collection_mode}
Cambia el diseño de la página principal de historias primero (predeterminado) a objetos primero:
@@ -41,7 +39,7 @@ Este es un ajuste de nivel superior — no está anidado dentro de `collection_i
**Nuevo en v1.1.0.**
-### baseurl vs. url
+### baseurl vs. url {#baseurl-vs-url}
- **url**: Dominio base de tu sitio
- **baseurl**: Ruta después del dominio (usa `""` para el dominio raíz, o `/nombre-repo` para GitHub Pages)
@@ -59,7 +57,7 @@ baseurl: ""
# Resultado: https://misitio.org
```
-### Logo del sitio
+### Logo del sitio {#logo-del-sitio}
Agrega un logo para reemplazar el título del sitio en la barra de navegación:
@@ -72,7 +70,7 @@ logo: "/telar-content/objects/mi-logo.png"
- Dimensiones recomendadas: máximo 80px de alto, 200-300px de ancho
- Admite formatos PNG, JPG, SVG
-## Selección de tema
+## Selección de tema {#selección-de-tema}
Telar incluye 4 temas predefinidos:
@@ -80,7 +78,7 @@ Telar incluye 4 temas predefinidos:
telar_theme: "paisajes" # Opciones: paisajes, neogranadina, santa-barbara, austin, o custom
```
-### Temas disponibles
+### Temas disponibles {#temas-disponibles}
- **paisajes** (predeterminado): Tonos tierra con terracota y oliva
- **neogranadina**: Burdeos colonial y dorado
@@ -89,7 +87,7 @@ telar_theme: "paisajes" # Opciones: paisajes, neogranadina, santa-barbara, aust
Consulta [Personalización: Temas](/guia/personalizacion/temas/) para ver detalles y cómo crear temas personalizados.
-## Interfaz multilingüe
+## Interfaz multilingüe {#interfaz-multilingüe}
Telar v0.4.0+ admite interfaces en inglés y español:
@@ -99,7 +97,7 @@ telar_language: "en" # Opciones: "en" (English), "es" (Español)
Esta opción controla el idioma de los elementos de la interfaz, incluyendo navegación, botones, etiquetas, mensajes de error e instrucciones.
-### Qué se traduce
+### Qué se traduce {#qué-se-traduce}
El ajuste `telar_language` cambia el idioma de:
@@ -111,7 +109,7 @@ El ajuste `telar_language` cambia el idioma de:
- **Páginas de objetos**: Etiquetas de manifiestos IIIF, instrucciones de coordenadas
- **Glosario**: Encabezados de panel y elementos de navegación
-### Qué permanece en tu idioma
+### Qué permanece en tu idioma {#qué-permanece-en-tu-idioma}
El ajuste `telar_language` **no** traduce tu contenido:
@@ -121,10 +119,11 @@ El ajuste `telar_language` **no** traduce tu contenido:
- Contenido de la página About
- Título y descripción del sitio
-{: .note }
-> Si necesitas un sitio completamente bilingüe con contenido en múltiples idiomas, deberás crear sitios Telar separados para cada idioma.
+{{< callout "note" >}}
+Si necesitas un sitio completamente bilingüe con contenido en múltiples idiomas, deberás crear sitios Telar separados para cada idioma.
+{{< /callout >}}
-### Detección de idioma en metadatos IIIF
+### Detección de idioma en metadatos IIIF {#detección-de-idioma-en-metadatos-iiif}
Cuando Telar extrae metadatos de manifiestos IIIF, respeta tu ajuste `telar_language`:
@@ -133,7 +132,7 @@ Cuando Telar extrae metadatos de manifiestos IIIF, respeta tu ajuste `telar_lang
Así, los metadatos se muestran en el idioma más adecuado disponible desde la institución fuente.
-## Integración con Google Sheets
+## Integración con Google Sheets {#integración-con-google-sheets}
Gestiona contenido mediante Google Sheets en lugar de editar archivos CSV directamente:
@@ -143,7 +142,7 @@ google_sheets:
published_url: "https://docs.google.com/spreadsheets/d/e/TU_ID_PUBLICADO/pubhtml"
```
-### Pasos de configuración
+### Pasos de configuración {#pasos-de-configuración}
1. **Obtén la plantilla**: Duplica la plantilla en [bit.ly/telar-template](https://bit.ly/telar-template)
2. **Publica tu hoja**: **File** → **Share** → **Publish to web**
@@ -155,12 +154,13 @@ google_sheets:
- **GitHub Pages**: GitHub Actions descubre automáticamente los GIDs de pestañas y obtiene los CSV
- **Desarrollo local**: Ejecuta `python3 scripts/fetch_google_sheets.py` antes de construir el sitio
-{: .note }
-> Solo se necesita la URL publicada. Si tu configuración todavía tiene una línea `shared_url` de una versión anterior, se ignora sin problemas.
+{{< callout "note" >}}
+Solo se necesita la URL publicada. Si tu configuración todavía tiene una línea `shared_url` de una versión anterior, se ignora sin problemas.
+{{< /callout >}}
Consulta [Referencia de Google Sheets](/guia/tus-datos/google-sheets/) para instrucciones completas de configuración.
-## Ajustes de la interfaz de historias
+## Ajustes de la interfaz de historias {#ajustes-de-la-interfaz-de-historias}
Controla cómo se muestran y se comportan las historias:
@@ -172,7 +172,7 @@ story_interface:
include_demo_content: false # Ponlo en true para habilitar historias de demostración
```
-### show_on_homepage
+### show_on_homepage {#show_on_homepage}
Controla si la sección de historias aparece en la página principal:
@@ -181,7 +181,7 @@ Controla si la sección de historias aparece en la página principal:
Úsalo cuando quieras tener objetos en la página principal pero prefieras que las historias se accedan a través de la navegación o enlaces directos en lugar de las tarjetas de la página principal.
-### show_story_steps
+### show_story_steps {#show_story_steps}
Controla si el indicador **Step X** aparece en la esquina superior izquierda de la página de la historia.
@@ -190,7 +190,7 @@ Controla si el indicador **Step X** aparece en la esquina superior izquierda de
Es solo un cambio visual; las personas siguen pudiendo navegar por los pasos normalmente.
-### include_demo_content
+### include_demo_content {#include_demo_content}
Habilita historias de demostración pre-construidas que muestran las funcionalidades de Telar:
@@ -210,7 +210,7 @@ Las historias de demostración aparecen junto con tu propio contenido con una et
Consulta [Contenido de Demostración](/guia/personalizacion/contenido-demostracion/) para detalles completos sobre las demos disponibles.
-### show_object_credits
+### show_object_credits {#show_object_credits}
Controla la etiqueta de atribución de créditos en páginas de objetos:
@@ -219,7 +219,7 @@ Controla la etiqueta de atribución de créditos en páginas de objetos:
La etiqueta de créditos se muestra en la esquina superior derecha de las imágenes de objetos, mostrando la atribución del campo `credit` en tu `objects.csv`.
-## Ajustes de la interfaz de colección
+## Ajustes de la interfaz de colección {#ajustes-de-la-interfaz-de-colección}
Controla cómo se muestra y se comporta la galería de objetos:
@@ -231,28 +231,28 @@ collection_interface:
featured_count: 4 # Cantidad de objetos a mostrar en la página principal
```
-### browse_and_search
+### browse_and_search {#browse_and_search}
Controla la barra lateral de filtrado y la búsqueda de texto completo de la galería:
- **`true` (predeterminado)**: La página de objetos muestra una barra lateral de filtros con facetas (tipo, creador, periodo, temas) y una barra de búsqueda con Lunr.js
- **`false`**: La página de objetos muestra una cuadrícula simple sin filtrado ni búsqueda
-### show_link_on_homepage
+### show_link_on_homepage {#show_link_on_homepage}
Controla el enlace "View the objects" en la página principal:
- **`true` (predeterminado)**: Muestra un enlace a la galería de objetos en la página principal
- **`false`**: Oculta el enlace (la página de objetos sigue accesible a través de la navegación)
-### show_sample_on_homepage
+### show_sample_on_homepage {#show_sample_on_homepage}
Controla si los objetos de muestra aparecen en la página principal:
- **`true` (predeterminado)**: Muestra una muestra de objetos en la página principal, tomados de los marcados como `featured` en objects.csv (o aleatorios si ninguno está destacado)
- **`false`**: No se muestran objetos en la página principal
-### featured_count
+### featured_count {#featured_count}
Cantidad de objetos a mostrar en la página principal cuando `show_sample_on_homepage` es true:
@@ -260,7 +260,7 @@ Cantidad de objetos a mostrar en la página principal cuando `show_sample_on_hom
- Prioriza objetos marcados `featured: yes` en objects.csv
- Si hay menos objetos destacados que `featured_count`, llena los espacios restantes aleatoriamente
-## Protección de historias
+## Protección de historias {#protección-de-historias}
Encripta historias para que solo las personas con la clave correcta puedan acceder a ellas:
@@ -274,18 +274,20 @@ story_key: "tu-clave-secreta"
- Si alguna historia está marcada `private: yes`, el *build* falla en lugar de publicarla en texto plano — ya sea porque falta `story_key`, o porque el flujo de trabajo **Build and Deploy** no ejecuta el paso de encriptación (los sitios actualizados desde antes de v1.6.0 necesitan agregarlo a mano)
- Consulta [Historias privadas](/guia/funciones/historias-privadas/) para la configuración, las pruebas locales y los detalles de los fallos del *build*
-{: .warning }
-> La protección de historias usa encriptación del lado del cliente. Previene el acceso casual pero no es adecuada para contenido altamente sensible. Para mayor seguridad, usa un repositorio privado de GitHub.
+{{< callout "warning" >}}
+La protección de historias usa encriptación del lado del cliente. Previene el acceso casual pero no es adecuada para contenido altamente sensible. Para mayor seguridad, usa un repositorio privado de GitHub.
+{{< /callout >}}
-## Ajustes avanzados
+## Ajustes avanzados {#ajustes-avanzados}
Los siguientes ajustes están pre-configurados y normalmente no necesitan modificación a menos que estés haciendo una personalización avanzada.
-{: .warning }
-> **No editar**
-> El `_config.yml` de Telar incluye una línea: "PLEASE DO NOT EDIT BELOW THIS LINE UNLESS YOU KNOW WHAT YOU ARE DOING". Las secciones debajo de esta línea están configuradas automáticamente y rara vez necesitan cambios.
+{{< callout "warning" >}}
+**No editar**
+El `_config.yml` de Telar incluye una línea: "PLEASE DO NOT EDIT BELOW THIS LINE UNLESS YOU KNOW WHAT YOU ARE DOING". Las secciones debajo de esta línea están configuradas automáticamente y rara vez necesitan cambios.
+{{< /callout >}}
-### Colecciones
+### Colecciones {#colecciones}
Las colecciones Jekyll definen tipos de contenido:
@@ -308,12 +310,13 @@ collections:
collections_dir: _jekyll-files
```
-{: .note }
-> Normalmente no necesitas modificar la configuración de colecciones, a menos que estés haciendo una personalización avanzada.
+{{< callout "note" >}}
+Normalmente no necesitas modificar la configuración de colecciones, a menos que estés haciendo una personalización avanzada.
+{{< /callout >}}
El ajuste `collections_dir` indica a Jekyll dónde encontrar los archivos de trabajo autogenerados.
-### Defaults
+### Defaults {#defaults}
Valores predeterminados de plantilla para cada colección:
@@ -341,7 +344,7 @@ defaults:
layout: "user-page"
```
-### Ajustes del *build*
+### Ajustes del *build* {#ajustes-del-build}
Configuración estándar del *build* de Jekyll:
@@ -363,7 +366,7 @@ future: true
show_drafts: false
```
-### Plugins
+### Plugins {#plugins}
Plugin necesario:
@@ -374,17 +377,17 @@ plugins:
Se instala automáticamente cuando ejecutas `bundle install`.
-### Versión de Telar
+### Versión de Telar {#versión-de-telar}
Información de versión (actualizada automáticamente durante lanzamientos):
```yaml
telar:
- version: "{{ site.telar_version }}"
- release_date: "{{ site.telar_release_date }}"
+ version: "{{< site-value "telar_version" >}}"
+ release_date: "{{< site-value "telar_release_date" >}}"
```
-### Funciones de desarrollo
+### Funciones de desarrollo {#funciones-de-desarrollo}
Opciones para desarrollo, pruebas y situaciones especiales (por favor no edites estos ajustes a menos que sepas lo que estás haciendo):
@@ -401,7 +404,7 @@ development-features:
skip_collections: false
```
-#### christmas_tree_mode
+#### christmas_tree_mode {#christmas_tree_mode}
Muestra todos los mensajes de advertencia para probar el soporte multilingüe:
@@ -410,7 +413,7 @@ Muestra todos los mensajes de advertencia para probar el soporte multilingüe:
Usa esto solo al probar traducciones o el estilo de mensajes de advertencia.
-#### hide_warnings
+#### hide_warnings {#hide_warnings}
Oculta en el sitio publicado las advertencias que genera el *build*:
@@ -419,7 +422,7 @@ Oculta en el sitio publicado las advertencias que genera el *build*:
Usa esto solo cuando hayas revisado una advertencia y sepas que no afecta tu sitio. Mientras esté activado, tampoco verás en el sitio las advertencias de problemas nuevos.
-#### viewer_preloading
+#### viewer_preloading {#viewer_preloading}
Controla cómo se precargan los visores de historias para una navegación más fluida:
@@ -430,7 +433,7 @@ Controla cómo se precargan los visores de historias para una navegación más f
Valores más altos = navegación más fluida pero mayor uso de memoria. Los valores predeterminados funcionan bien para la mayoría de los sitios.
-#### skip_stories
+#### skip_stories {#skip_stories}
Construye un sitio sin historias, manteniendo solo los objetos visibles:
@@ -439,10 +442,11 @@ Construye un sitio sin historias, manteniendo solo los objetos visibles:
Usa esto cuando quieras mostrar objetos sin historias narrativas, o al construir un sitio estilo catálogo.
-{: .note }
-> Renombrado desde `hide_stories` en v0.8.0. El nombre anterior sigue funcionando por compatibilidad.
+{{< callout "note" >}}
+Renombrado desde `hide_stories` en v0.8.0. El nombre anterior sigue funcionando por compatibilidad.
+{{< /callout >}}
-#### skip_collections
+#### skip_collections {#skip_collections}
Construye un sitio con solo páginas personalizadas (sin objetos ni historias):
@@ -451,10 +455,11 @@ Construye un sitio con solo páginas personalizadas (sin objetos ni historias):
Usa esto al construir un sitio con solo páginas personalizadas (como una página "Acerca de" o de inicio) sin ninguna colección.
-{: .note }
-> Cuando `skip_collections` está habilitado, `skip_stories` se activa automáticamente. Renombrado desde `hide_collections` en v0.8.0 — el nombre anterior sigue funcionando por compatibilidad.
+{{< callout "note" >}}
+Cuando `skip_collections` está habilitado, `skip_stories` se activa automáticamente. Renombrado desde `hide_collections` en v0.8.0 — el nombre anterior sigue funcionando por compatibilidad.
+{{< /callout >}}
-## Ejemplo completo
+## Ejemplo completo {#ejemplo-completo}
Aquí hay un ejemplo completo de `_config.yml`:
@@ -555,8 +560,8 @@ show_drafts: false
# Telar Settings
telar:
- version: "{{ site.telar_version }}"
- release_date: "{{ site.telar_release_date }}"
+ version: "{{< site-value "telar_version" >}}"
+ release_date: "{{< site-value "telar_release_date" >}}"
# Plugins
plugins:
@@ -582,7 +587,7 @@ development-features:
skip_collections: false
```
-## Véase también
+## Véase también {#véase-también}
- [Validador de Configuración](/guia/configurar/validador-de-configuracion/) — Revisa tu `_config.yml` en busca de errores comunes
- [Generador y editor de configuración](/guia/configurar/generador-de-configuracion/) — Genera o edita un archivo `_config.yml`
diff --git a/docs/3-1-config-generator.es.md b/content/es/guia/configurar/generador-de-configuracion.md
similarity index 67%
rename from docs/3-1-config-generator.es.md
rename to content/es/guia/configurar/generador-de-configuracion.md
index c499822..872dce1 100644
--- a/docs/3-1-config-generator.es.md
+++ b/content/es/guia/configurar/generador-de-configuracion.md
@@ -1,390 +1,19 @@
---
-layout: docs
-title: "3.1. Generador y editor de configuración"
-parent: "3. Configura tu proyecto"
-grand_parent: Documentación
-nav_order: 1
-lang: es
-permalink: /guia/configurar/generador-de-configuracion/
+title: Generador y editor de configuración
+url: /guia/configurar/generador-de-configuracion/
+translationKey: docs-configure-config-generator
+type: guide
extra_css:
- - config-tools
+- config-tools
+docs_section: reference
---
-# Generador y editor de configuración
+# Generador y editor de configuración {#generador-y-editor-de-configuración}
Ingresa los datos de tu sitio para generar un archivo `_config.yml` listo para usar en tu sitio Telar. Tu configuración nunca se envía a ningún servidor — todo se ejecuta en tu navegador.
-<div class="cg-container" data-telar-version="{{ site.telar_version }}" data-telar-release-date="{{ site.telar_release_date }}">
-
- <!-- Selector de modo -->
- <div class="cg-mode-toggle">
- <button id="cg-mode-create" class="cg-mode-btn cg-active" type="button">Crear nueva</button>
- <button id="cg-mode-edit" class="cg-mode-btn" type="button">Editar existente</button>
- </div>
-
- <!-- Área de pegado (modo Editar existente) -->
- <div id="cg-paste-area" class="cg-paste-area">
- <p class="cg-section-desc">Pega tu <code>_config.yml</code> existente a continuación y haz clic en Cargar para llenar el formulario.</p>
- <div class="cv-editor">
- <div class="cv-lines" id="cg-load-lines" aria-hidden="true">1</div>
- <textarea id="cg-load-input" class="cv-textarea" placeholder="Pega el contenido completo de tu _config.yml aquí..."></textarea>
- </div>
- <div class="cg-load-actions">
- <button id="cg-load-btn" class="cg-button" type="button">Cargar</button>
- <span id="cg-load-feedback" class="cg-load-feedback"></span>
- </div>
- <div id="cg-load-results" class="cv-results"></div>
- </div>
-
- <!-- 1. Configuración del sitio -->
- <div class="cg-section">
- <h3>Configuración del sitio</h3>
- <p class="cg-section-desc">Información básica y apariencia del sitio. Estos son los ajustes más importantes para tu sitio.</p>
-
- <div class="cg-row">
- <label class="cg-label" for="cg-title">Título</label>
- <div class="cg-field">
- <input type="text" id="cg-title" class="cg-input" placeholder="Mi Exhibición Narrativa">
- <div class="cg-warn-msg" id="cg-title-warn"></div>
- <div class="cg-hint">El nombre de tu sitio, visible en la pestaña del navegador y en el encabezado de navegación</div>
- </div>
- </div>
-
- <div class="cg-row">
- <label class="cg-label" for="cg-description">Descripción <span class="cg-optional">(opcional)</span></label>
- <div class="cg-field">
- <textarea id="cg-description" class="cg-textarea-input" rows="2" placeholder="Una breve descripción de tu exhibición"></textarea>
- <div class="cg-hint">Se usa para los metadatos de motores de búsqueda y vistas previas en redes sociales</div>
- </div>
- </div>
-
- <div class="cg-row">
- <label class="cg-label" for="cg-author">Autor <span class="cg-optional">(opcional)</span></label>
- <div class="cg-field">
- <input type="text" id="cg-author" class="cg-input" placeholder="Tu Nombre">
- </div>
- </div>
-
- <div class="cg-row">
- <label class="cg-label" for="cg-email">Correo electrónico <span class="cg-optional">(opcional)</span></label>
- <div class="cg-field">
- <input type="text" id="cg-email" class="cg-input" placeholder="tu@ejemplo.com">
- </div>
- </div>
-
- <div class="cg-row">
- <label class="cg-label" for="cg-theme">Tema</label>
- <div class="cg-field">
- <select id="cg-theme" class="cg-select">
- <option value="trama" selected>trama</option>
- <option value="paisajes">paisajes</option>
- <option value="neogranadina">neogranadina</option>
- <option value="santa-barbara">santa-barbara</option>
- <option value="austin">austin</option>
- </select>
- <div class="cg-hint">Controla el esquema de colores y el estilo visual de tu sitio</div>
- </div>
- </div>
-
- <div class="cg-toggle-row">
- <label class="cg-toggle">
- <input type="checkbox" id="cg-logo-toggle">
- <span class="cg-track"></span>
- </label>
- <div class="cg-toggle-info">
- <label class="cg-toggle-label" for="cg-logo-toggle">Usar una imagen como logo</label>
- <div class="cg-toggle-hint cg-hint">Cuando está desactivado, el título del sitio se muestra como texto en el encabezado de navegación</div>
- </div>
- </div>
- <div id="cg-logo-fields" class="cg-optional-fields">
- <div class="cg-row">
- <label class="cg-label" for="cg-logo-path">Ruta del logo</label>
- <div class="cg-field">
- <input type="text" id="cg-logo-path" class="cg-input" placeholder="telar-content/objects/logo.png">
- <div class="cg-hint">Pon tu logo en <code>telar-content/objects/</code>. Recomendado: máx. 80px de alto, 200–300px de ancho, PNG/JPG/SVG</div>
- </div>
- </div>
- </div>
-
- <div class="cg-row">
- <label class="cg-label" for="cg-language">Idioma</label>
- <div class="cg-field">
- <select id="cg-language" class="cg-select">
- <option value="en">English (en)</option>
- <option value="es" selected>Español (es)</option>
- </select>
- <div class="cg-hint">Controla todos los elementos de la interfaz: navegación, botones, etiquetas, mensajes de error. Tu contenido permanece en el idioma en que lo escribas.</div>
- </div>
- </div>
- <div class="cg-toggle-row">
- <label class="cg-toggle">
- <input type="checkbox" id="cg-collection-mode">
- <span class="cg-track"></span>
- </label>
- <div class="cg-toggle-info">
- <label class="cg-toggle-label" for="cg-collection-mode">Modo colección</label>
- <div class="cg-toggle-hint cg-hint">Cuando se activa, la página principal muestra los objetos primero en una cuadrícula grande, con las historias debajo. Cuando está desactivado (predeterminado), las historias aparecen primero.</div>
- </div>
- </div>
- </div>
-
- <!-- 2. Alojamiento -->
- <div class="cg-section">
- <h3>Alojamiento</h3>
- <p class="cg-section-desc">Telar está diseñado para funcionar con GitHub Pages — la mayoría de los usuarios solo necesitan su nombre de usuario y el nombre del repositorio.</p>
-
- <div class="cg-toggle-row">
- <label class="cg-toggle">
- <input type="checkbox" id="cg-ghpages" checked>
- <span class="cg-track"></span>
- </label>
- <div class="cg-toggle-info">
- <label class="cg-toggle-label" for="cg-ghpages">Alojar en GitHub Pages</label>
- <div class="cg-toggle-hint cg-hint">Si no usas GitHub Pages, desactiva esta opción para ingresar tu URL manualmente.</div>
- </div>
- </div>
-
- <div id="cg-ghpages-fields" class="cg-optional-fields cg-visible">
- <div class="cg-row">
- <label class="cg-label" for="cg-gh-username">Usuario de GitHub</label>
- <div class="cg-field">
- <input type="text" id="cg-gh-username" class="cg-input" placeholder="usuario">
- <div class="cg-error-msg" id="cg-gh-username-error"></div>
- </div>
- </div>
- <div class="cg-row">
- <label class="cg-label" for="cg-gh-repo">Nombre del repositorio</label>
- <div class="cg-field">
- <input type="text" id="cg-gh-repo" class="cg-input" placeholder="mi-exhibicion">
- <div class="cg-error-msg" id="cg-gh-repo-error"></div>
- <div class="cg-warn-msg" id="cg-gh-repo-warn"></div>
- </div>
- </div>
-
- <div class="cg-toggle-row">
- <label class="cg-toggle">
- <input type="checkbox" id="cg-custom-domain">
- <span class="cg-track"></span>
- </label>
- <div class="cg-toggle-info">
- <label class="cg-toggle-label" for="cg-custom-domain">Dominio personalizado</label>
- <div class="cg-toggle-hint cg-hint">¿Tienes un dominio personalizado configurado con GitHub Pages? <a href="https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site" target="_blank" rel="noopener">Aprende cómo configurarlo</a></div>
- </div>
- </div>
-
- <div id="cg-custom-domain-fields" class="cg-optional-fields">
- <div class="cg-row">
- <label class="cg-label" for="cg-domain-url">URL del dominio</label>
- <div class="cg-field">
- <input type="text" id="cg-domain-url" class="cg-input" placeholder="https://minombre.org">
- <div class="cg-error-msg" id="cg-domain-url-error"></div>
- <div class="cg-warn-msg" id="cg-domain-url-warn"></div>
- </div>
- </div>
- <div class="cg-toggle-row">
- <label class="cg-toggle">
- <input type="checkbox" id="cg-root-domain">
- <span class="cg-track"></span>
- </label>
- <div class="cg-toggle-info">
- <label class="cg-toggle-label" for="cg-root-domain">Servir desde el dominio raíz</label>
- <div class="cg-toggle-hint cg-hint">Cuando está activado, tu sitio se sirve desde la raíz del dominio. Cuando está desactivado, se sirve en dominio.com/nombre-repo.</div>
- </div>
- </div>
- </div>
- </div>
-
- <div id="cg-manual-fields" class="cg-optional-fields">
- <div class="cg-row">
- <label class="cg-label" for="cg-manual-url">URL</label>
- <div class="cg-field">
- <input type="text" id="cg-manual-url" class="cg-input" placeholder="https://misitio.org">
- <div class="cg-error-msg" id="cg-manual-url-error"></div>
- <div class="cg-hint">El dominio base de tu sitio</div>
- </div>
- </div>
- <div class="cg-row">
- <label class="cg-label" for="cg-manual-baseurl">Baseurl</label>
- <div class="cg-field">
- <input type="text" id="cg-manual-baseurl" class="cg-input" placeholder="/mi-sitio">
- <div class="cg-hint">Ruta después del dominio. Déjalo vacío para servir desde la raíz.</div>
- </div>
- </div>
- </div>
- </div>
-
- <!-- 3. Integración con Google Sheets -->
- <div class="cg-section">
- <h3>Integración con Google Sheets</h3>
- <p class="cg-section-desc">Administra tu contenido a través de Google Sheets en vez de editar archivos CSV directamente. Telar obtiene tus datos automáticamente en cada <em>build</em>.</p>
-
- <div class="cg-toggle-row">
- <label class="cg-toggle">
- <input type="checkbox" id="cg-gsheets-toggle" checked>
- <span class="cg-track"></span>
- </label>
- <div class="cg-toggle-info">
- <label class="cg-toggle-label" for="cg-gsheets-toggle">Activar Google Sheets</label>
- <div class="cg-toggle-hint cg-hint">Cuando está desactivado, Telar usa los archivos CSV de tu repositorio — asegúrate de tenerlos en <code>telar-content/spreadsheets/</code></div>
- </div>
- </div>
-
- <div id="cg-gsheets-fields" class="cg-optional-fields cg-visible">
- <div class="cg-row">
- <label class="cg-label" for="cg-gsheets-published">URL publicada</label>
- <div class="cg-field">
- <input type="text" id="cg-gsheets-published" class="cg-input" placeholder="https://docs.google.com/spreadsheets/d/e/your-published-id/pubhtml">
- <div class="cg-error-msg" id="cg-gsheets-published-error"></div>
- <div class="cg-warn-msg" id="cg-gsheets-published-warn"></div>
- <div class="cg-hint">Desde Archivo → Compartir → Publicar en la web</div>
- </div>
- </div>
- </div>
- </div>
-
- <!-- 4. Interfaz de historias -->
- <div class="cg-section">
- <h3>Interfaz de historias</h3>
- <p class="cg-section-desc">Controla cómo se muestran y se comportan las historias en tu sitio. Estos ajustes afectan al visor de historias y la presentación en la página de inicio.</p>
-
- <div class="cg-toggle-row">
- <label class="cg-toggle">
- <input type="checkbox" id="cg-show-on-homepage" checked>
- <span class="cg-track"></span>
- </label>
- <div class="cg-toggle-info">
- <label class="cg-toggle-label" for="cg-show-on-homepage">Mostrar historias en la página de inicio</label>
- <div class="cg-toggle-hint cg-hint">Cuando está activado, las tarjetas de historia aparecen en la página de inicio. Las historias siguen siendo accesibles por navegación cuando está desactivado.</div>
- </div>
- </div>
-
- <div class="cg-toggle-row">
- <label class="cg-toggle">
- <input type="checkbox" id="cg-show-story-steps" checked>
- <span class="cg-track"></span>
- </label>
- <div class="cg-toggle-info">
- <label class="cg-toggle-label" for="cg-show-story-steps">Mostrar indicadores de paso en las historias</label>
- <div class="cg-toggle-hint cg-hint">Muestra "Paso 1", "Paso 2", etc. al desplazarte por una historia. Es puramente visual.</div>
- </div>
- </div>
-
- <div class="cg-toggle-row">
- <label class="cg-toggle">
- <input type="checkbox" id="cg-show-object-credits" checked>
- <span class="cg-track"></span>
- </label>
- <div class="cg-toggle-info">
- <label class="cg-toggle-label" for="cg-show-object-credits">Mostrar créditos de objetos</label>
- <div class="cg-toggle-hint cg-hint">Muestra un distintivo de créditos desplegable en la esquina inferior izquierda del visor de historias. La información de créditos siempre aparece en la tabla de metadatos.</div>
- </div>
- </div>
-
- <div class="cg-toggle-row">
- <label class="cg-toggle">
- <input type="checkbox" id="cg-include-demo-content" checked>
- <span class="cg-track"></span>
- </label>
- <div class="cg-toggle-info">
- <label class="cg-toggle-label" for="cg-include-demo-content">Incluir contenido de demostración</label>
- <div class="cg-toggle-hint cg-hint">Obtiene historias de demostración del servidor de contenido de Telar. Muestran un distintivo "Demo" y ayudan a los nuevos usuarios a explorar la interfaz. Desactívalo en sitios en producción.</div>
- </div>
- </div>
- </div>
-
- <!-- 5. Interfaz de la colección -->
- <div class="cg-section">
- <h3>Interfaz de la colección</h3>
- <p class="cg-section-desc">Controla cómo se muestra y se comporta la galería de objetos, incluyendo filtrado, búsqueda y presentación en la página de inicio.</p>
-
- <div class="cg-toggle-row">
- <label class="cg-toggle">
- <input type="checkbox" id="cg-browse-and-search" checked>
- <span class="cg-track"></span>
- </label>
- <div class="cg-toggle-info">
- <label class="cg-toggle-label" for="cg-browse-and-search">Mostrar la interfaz completa de exploración y búsqueda</label>
- <div class="cg-toggle-hint cg-hint">Activa la barra lateral de filtros con facetas en la página de objetos</div>
- </div>
- </div>
-
- <div class="cg-toggle-row">
- <label class="cg-toggle">
- <input type="checkbox" id="cg-show-link-on-homepage" checked>
- <span class="cg-track"></span>
- </label>
- <div class="cg-toggle-info">
- <label class="cg-toggle-label" for="cg-show-link-on-homepage">Mostrar enlace a objetos en la página de inicio</label>
- <div class="cg-toggle-hint cg-hint">Muestra un enlace "Ver los objetos" en la página de inicio</div>
- </div>
- </div>
-
- <div class="cg-toggle-row">
- <label class="cg-toggle">
- <input type="checkbox" id="cg-show-sample-on-homepage" checked>
- <span class="cg-track"></span>
- </label>
- <div class="cg-toggle-info">
- <label class="cg-toggle-label" for="cg-show-sample-on-homepage">Mostrar una muestra de objetos en la página de inicio</label>
- <div class="cg-toggle-hint cg-hint">Muestra en la página de inicio los objetos marcados como destacados en tu objects.csv</div>
- </div>
- </div>
-
- <div class="cg-row">
- <label class="cg-label" for="cg-featured-count">Cantidad de destacados</label>
- <div class="cg-field">
- <input type="number" id="cg-featured-count" class="cg-input cg-input--number" value="4" min="1">
- <div class="cg-hint">Número de objetos a mostrar en la muestra de la página de inicio</div>
- </div>
- </div>
- </div>
-
- <!-- 6. Historias privadas -->
- <div class="cg-section">
- <h3>Historias privadas</h3>
- <p class="cg-section-desc">Encripta las historias para que solo los espectadores con la clave correcta puedan acceder a ellas. Las historias con <code>private: yes</code> en tu project.csv (o en la pestaña Proyecto de Google Sheets) se encriptarán durante el <em>build</em>.</p>
-
- <div class="cg-toggle-row">
- <label class="cg-toggle">
- <input type="checkbox" id="cg-protection-toggle">
- <span class="cg-track"></span>
- </label>
- <div class="cg-toggle-info">
- <label class="cg-toggle-label" for="cg-protection-toggle">Activar historias privadas</label>
- <div class="cg-toggle-hint cg-hint">Usa encriptación del lado del cliente. Previene el acceso casual, pero no es adecuado para contenido altamente sensible.</div>
- </div>
- </div>
-
- <div id="cg-protection-fields" class="cg-optional-fields">
- <div class="cg-row">
- <label class="cg-label" for="cg-secret-key">Clave secreta</label>
- <div class="cg-field">
- <input type="text" id="cg-secret-key" class="cg-input" placeholder="tu-clave-secreta">
- <div class="cg-error-msg" id="cg-secret-key-error"></div>
- <div class="cg-warn-msg" id="cg-secret-key-warn"></div>
- <div class="cg-hint">Los espectadores acceden a las historias protegidas mediante <code>?key=tu-clave-secreta</code></div>
- </div>
- </div>
- </div>
- </div>
-
- <!-- 7. Acciones -->
- <div class="cg-actions">
- <button id="cg-generate" class="cg-button" type="button">Generar</button>
- <button id="cg-copy" class="cg-button" type="button" style="display: none;">Copiar</button>
- <span id="cg-copied" class="cg-copied">¡Copiado!</span>
- </div>
-
- <!-- 8. Salida -->
- <div id="cg-output-wrapper" class="cg-output-wrapper">
- <p class="cg-output-heading">Archivo _config.yml generado</p>
- <div class="cv-editor">
- <div class="cv-lines" id="cg-lines" aria-hidden="true">1</div>
- <textarea id="cg-output" class="cv-textarea" readonly wrap="off"></textarea>
- </div>
- </div>
-
-</div>
+{{< template "widget-guia-configurar-generador-de-configuracion" >}}
+
<script type="text/template" id="cg-template">
# Telar - Digital Storytelling Framework
@@ -505,8 +134,8 @@ show_drafts: false
# Telar Settings (version information)
telar:
- version: "__TELAR_VERSION__"
- release_date: "__TELAR_RELEASE_DATE__"
+ version: __TELAR_VERSION__
+ release_date: __TELAR_RELEASE_DATE__
# Plugins
plugins:
diff --git a/docs/3-3-config-validator.es.md b/content/es/guia/configurar/validador-de-configuracion.md
similarity index 95%
rename from docs/3-3-config-validator.es.md
rename to content/es/guia/configurar/validador-de-configuracion.md
index c84aa3a..4c545d8 100644
--- a/docs/3-3-config-validator.es.md
+++ b/content/es/guia/configurar/validador-de-configuracion.md
@@ -1,32 +1,22 @@
---
-layout: docs
-title: "3.3. Validador de configuración"
-parent: "3. Configura tu proyecto"
-grand_parent: Documentación
-nav_order: 3
-lang: es
-permalink: /guia/configurar/validador-de-configuracion/
+title: Validador de Configuración
+url: /guia/configurar/validador-de-configuracion/
+translationKey: docs-configure-config-validator
+type: guide
extra_css:
- - config-tools
+- config-tools
+docs_section: reference
---
-# Validador de Configuración
+# Validador de Configuración {#validador-de-configuración}
Pega tu `_config.yml` de Telar a continuación para verificar errores comunes de configuración. El validador revisa la sintaxis YAML, los campos obligatorios y los ajustes específicos de Telar.
Tu configuración nunca se envía a ningún servidor — todo se ejecuta en tu navegador.
-<div class="cv-container">
- <div class="cv-editor">
- <div class="cv-lines" id="cv-lines" aria-hidden="true">1</div>
- <textarea id="cv-input" class="cv-textarea" placeholder="Pega el contenido completo de tu _config.yml aquí..."></textarea>
- </div>
- <div class="cv-actions">
- <button id="cv-validate" class="cv-button" type="button">Validar</button>
- </div>
- <div id="cv-results" class="cv-results"></div>
-</div>
+{{< template "widget-guia-configurar-validador-de-configuracion" >}}
+
<script src="https://cdn.jsdelivr.net/npm/js-yaml@4/dist/js-yaml.min.js"></script>
<script>
@@ -49,7 +39,7 @@ Tu configuración nunca se envía a ningún servidor — todo se ejecuta en tu n
inputEl.addEventListener('scroll', function() { linesEl.scrollTop = inputEl.scrollTop; });
updateLineNumbers();
- var KNOWN_THEMES = ['paisajes', 'neogranadina', 'santa-barbara', 'austin'];
+ var KNOWN_THEMES = ['trama', 'paisajes', 'neogranadina', 'santa-barbara', 'austin'];
var WEAK_KEYS = ['test', 'password', '123', '1234', 'abc', 'key', 'secret', 'demo', 'admin'];
function friendlyYamlError(reason) {
@@ -454,14 +444,14 @@ Tu configuración nunca se envía a ningún servidor — todo se ejecuta en tu n
})();
</script>
-## Qué se verifica
+## Qué se verifica {#qué-se-verifica}
1. **Sintaxis YAML** — Detecta errores de análisis, tabulaciones y comillas sin cerrar, con números de línea
2. **Campos obligatorios** — Verifica que `title`, `url` y `baseurl` estén presentes y con el formato correcto
3. **Ajustes de Telar** — Valida nombres de tema, códigos de idioma, URLs de Google Sheets y formato de baseurl
4. **Advertencias útiles** — Notas sobre ajustes predeterminados, errores comunes en GitHub Pages y la sección de solo lectura
-## Véase también
+## Véase también {#véase-también}
- [Referencia de Configuración](/guia/configurar/configuracion/) — Lista completa de todos los ajustes de `_config.yml`
- [Generador y editor de configuración](/guia/configurar/generador-de-configuracion/) — Genera o edita un archivo `_config.yml`
diff --git a/docs/8-0-for-developers.es.md b/content/es/guia/desarrolladores/_index.md
similarity index 76%
rename from docs/8-0-for-developers.es.md
rename to content/es/guia/desarrolladores/_index.md
index 95cd68f..ad8c484 100644
--- a/docs/8-0-for-developers.es.md
+++ b/content/es/guia/desarrolladores/_index.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "8. Para desarrolladores"
-parent: Documentación
-nav_order: 8
-has_children: true
-lang: es
-permalink: /guia/desarrolladores/
+title: Para desarrolladores
+url: /guia/desarrolladores/
+translationKey: docs-developers
+type: guide
+docs_section: developers
---
-# Para desarrolladores
+# Para desarrolladores {#para-desarrolladores}
Documentación técnica para desarrolladores, colaboradores y quienes mantienen versiones fork de Telar.
-## Para quién es esta sección
+## Para quién es esta sección {#para-quién-es-esta-sección}
Esta sección está diseñada para:
- **Desarrolladores** que construyen funcionalidades o arreglan errores en Telar
@@ -24,32 +22,32 @@ Si estás creando el contenido de un sitio de Telar, lo que probablemente necesi
---
-## Qué hay en esta sección
+## Qué hay en esta sección {#qué-hay-en-esta-sección}
-### [8.1 Desarrollo local](/guia/desarrolladores/desarrollo-local/)
+### [8.1 Desarrollo local](/guia/desarrolladores/desarrollo-local/) {#81-desarrollo-local}
Configura tu entorno de desarrollo, construye el sitio en tu computador y prueba los cambios antes de publicarlos.
-### [8.2 GitHub Actions](/guia/desarrolladores/github-actions/)
+### [8.2 GitHub Actions](/guia/desarrolladores/github-actions/) {#82-github-actions}
Entiende cómo el flujo de trabajo **Build and Deploy** construye y publica el sitio, y cómo personalizarlo.
-### [8.3 Arquitectura del contenido de demostración](/guia/desarrolladores/sistema-demos/)
+### [8.3 Arquitectura del contenido de demostración](/guia/desarrolladores/sistema-demos/) {#83-arquitectura-del-contenido-de-demostración}
Aprende cómo funciona el sistema de obtención de contenido de demostración, desde el emparejamiento de versiones hasta la integración de paquetes.
-### [8.4 Arquitectura del sistema de inserción](/guia/desarrolladores/sistema-insercion/)
+### [8.4 Arquitectura del sistema de inserción](/guia/desarrolladores/sistema-insercion/) {#84-arquitectura-del-sistema-de-inserción}
Detalles técnicos del sistema de inserción iframe de Telar y cómo maneja diferentes contextos.
-### [8.5 Estilos avanzados](/guia/desarrolladores/estilos/)
+### [8.5 Estilos avanzados](/guia/desarrolladores/estilos/) {#85-estilos-avanzados}
Personaliza los estilos de Telar con CSS propio, variables de CSS y capas de cascada.
-### [8.6 Diseños y pantallas pequeñas](/guia/desarrolladores/moviles/)
+### [8.6 Diseños y pantallas pequeñas](/guia/desarrolladores/moviles/) {#86-diseños-y-pantallas-pequeñas}
Cómo escoge la página de una historia entre sus dos diseños y cómo se adapta el sitio a las ventanas pequeñas o bajas.
-### [8.7 Vocabulario del motor de historias](/guia/desarrolladores/motor-de-historias/)
+### [8.7 Vocabulario del motor de historias](/guia/desarrolladores/motor-de-historias/) {#87-vocabulario-del-motor-de-historias}
Los términos con que el código del motor de historias y esta documentación nombran las partes de una historia, sus movimientos y sus diseños.
---
-## Contribuir a Telar
+## Contribuir a Telar {#contribuir-a-telar}
Telar es código abierto y recibe contribuciones con gusto. Antes de contribuir:
@@ -62,7 +60,7 @@ Telar es código abierto y recibe contribuciones con gusto. Antes de contribuir:
---
-## Obtener ayuda
+## Obtener ayuda {#obtener-ayuda}
- **Issues**: Reporta errores o solicita funcionalidades en [GitHub Issues](https://github.com/UCSB-AMPLab/telar/issues)
- **Discussions**: Haz preguntas en [GitHub Discussions](https://github.com/UCSB-AMPLab/telar/discussions)
@@ -70,7 +68,7 @@ Telar es código abierto y recibe contribuciones con gusto. Antes de contribuir:
---
-## Enlaces rápidos
+## Enlaces rápidos {#enlaces-rápidos}
- [Documentación principal](/guia/) - Documentación para quienes crean contenido
- [Referencia de configuración](/guia/configurar/configuracion/) - Todas las opciones de _config.yml
diff --git a/docs/8-1-local-development.es.md b/content/es/guia/desarrolladores/desarrollo-local.md
similarity index 86%
rename from docs/8-1-local-development.es.md
rename to content/es/guia/desarrolladores/desarrollo-local.md
index 5153db8..8b9cf4e 100644
--- a/docs/8-1-local-development.es.md
+++ b/content/es/guia/desarrolladores/desarrollo-local.md
@@ -1,25 +1,23 @@
---
-layout: docs
-title: "8.1. Desarrollo local"
-parent: "8. Para desarrolladores"
-grand_parent: Documentación
-nav_order: 1
-lang: es
-permalink: /guia/desarrolladores/desarrollo-local/
+title: Desarrollo local
+url: /guia/desarrolladores/desarrollo-local/
+translationKey: docs-developers-local-development
+type: guide
+docs_section: developers
---
-# Desarrollo local
+# Desarrollo local {#desarrollo-local}
Referencia completa para desarrollo local, comandos para construir el sitio y solución de problemas.
-## Requisitos previos
+## Requisitos previos {#requisitos-previos}
-### Software requerido
+### Software requerido {#software-requerido}
- **Ruby 3.2+**: Runtime de Jekyll
- **Bundler**: Gestión de dependencias de Ruby
-- **Python 3.9+**: Generación IIIF y procesamiento CSV
-- **Node.js 18+**: Empaquetado de JavaScript (esbuild)
+- **Python 3.12**: Generación IIIF y procesamiento CSV
+- **Node.js 22**: Empaquetado de JavaScript (esbuild)
- **Git**: Control de versiones
Telar necesita Ruby 3.2 o una versión más nueva, y la integración continua
@@ -28,7 +26,7 @@ construye el sitio con la 3.2.11. La plantilla de Telar trae un archivo
la reconocen por su cuenta. Con una versión anterior, `bundle install` se
detiene e indica cuál esperaba, en vez de seguir con un conjunto distinto de gemas.
-### Guías de instalación
+### Guías de instalación {#guías-de-instalación}
**macOS (Homebrew):**
@@ -51,7 +49,7 @@ gem install bundler
- Instala [Node.js](https://nodejs.org/) (se recomienda la versión LTS)
- Instala [Git for Windows](https://gitforwindows.org/)
-### Opcional (recomendado)
+### Opcional (recomendado) {#opcional-recomendado}
- **libvips**: Procesamiento rápido de imágenes para la generación de teselas IIIF. Telar recurre a Python puro si no está instalado, pero libvips es aproximadamente 28 veces más rápido.
@@ -65,26 +63,25 @@ brew install vips
sudo apt-get install libvips-dev
```
-### Opcional (solo para objetos de audio)
+### Opcional (solo para objetos de audio) {#opcional-solo-para-objetos-de-audio}
-Si el sitio incluye objetos de audio, dos herramientas adicionales permiten la extracción de clips y la generación de datos de forma de onda. Los sitios sin objetos de audio no necesitan estas herramientas.
+Si el sitio incluye audio, audiowaveform prepara los datos de la forma de onda. Los límites de los fragmentos se aplican en el navegador; el script no extrae archivos separados. Los sitios sin audio no necesitan esta herramienta.
-- **ffmpeg**: Extracción de clips de audio
- **audiowaveform**: Datos de picos para el reproductor WaveSurfer
**macOS:**
```bash
-brew install ffmpeg audiowaveform
+brew install audiowaveform
```
**Ubuntu/Debian:**
```bash
-sudo apt install ffmpeg audiowaveform
+sudo apt install audiowaveform
```
-## Configuración del proyecto
+## Configuración del proyecto {#configuración-del-proyecto}
-### Configuración inicial
+### Configuración inicial {#configuración-inicial}
```bash
# Clona el repositorio
@@ -101,7 +98,7 @@ pip install -r requirements.txt
npm install
```
-### Configuración
+### Configuración {#configuración}
Edita `_config.yml` para desarrollo local:
@@ -110,9 +107,9 @@ baseurl: "" # Vacío para desarrollo local
url: "http://localhost:4001"
```
-## Comandos para construir el sitio
+## Comandos para construir el sitio {#comandos-para-construir-el-sitio}
-### Inicio rápido: script de *build* (recomendado)
+### Inicio rápido: script de *build* (recomendado) {#inicio-rápido-script-de-build-recomendado}
La forma más sencilla de construir y servir tu sitio Telar localmente es usando el script de *build* todo‑en‑uno:
@@ -138,7 +135,7 @@ python3 scripts/build_local_site.py --skip-audio
Este script ejecuta en secuencia todos los pasos necesarios del *build*, imitando lo que hace GitHub Actions al publicar el sitio. También detiene instancias de Jekyll que estén ejecutándose antes de iniciar una nueva.
-### Comandos principales (manuales)
+### Comandos principales (manuales) {#comandos-principales-manuales}
Si prefieres ejecutar los pasos por separado:
@@ -152,7 +149,7 @@ python3 scripts/csv_to_json.py
# 3. Genera archivos de colección de Jekyll
python3 scripts/generate_collections.py
-# 4. Procesa archivos de audio (si los hay — requiere ffmpeg y audiowaveform)
+# 4. Procesa archivos de audio (si los hay — requiere audiowaveform)
# Nota: la detección básica de audio funciona sin este paso (csv_to_json.py
# genera el manifiesto de audio automáticamente). Este script solo se
# necesita para los datos de forma de onda y la extracción de clips.
@@ -175,7 +172,7 @@ bundle exec jekyll build
bundle exec jekyll clean
```
-### Opciones de comando
+### Opciones de comando {#opciones-de-comando}
**Opciones de Jekyll serve:**
@@ -206,9 +203,9 @@ python3 scripts/generate_iiif.py --base-url https://misitio.org
python3 scripts/generate_iiif.py --image textile-001.jpg
```
-## Flujo de trabajo de desarrollo
+## Flujo de trabajo de desarrollo {#flujo-de-trabajo-de-desarrollo}
-### Flujo de trabajo diario
+### Flujo de trabajo diario {#flujo-de-trabajo-diario}
```bash
# 1. Inicia servidor Jekyll
@@ -229,7 +226,7 @@ python3 scripts/generate_iiif.py
# El sitio se actualiza automáticamente
```
-## Estructura de directorios
+## Estructura de directorios {#estructura-de-directorios}
```text
tu-sitio-telar/
@@ -268,9 +265,9 @@ tu-sitio-telar/
└── _site/ # Sitio construido (¡no editar!)
```
-## Solución de problemas
+## Solución de problemas {#solución-de-problemas}
-### Problemas comunes
+### Problemas comunes {#problemas-comunes}
**Jekyll no inicia:**
@@ -318,7 +315,7 @@ ls -la telar-content/texts/stories/
python3 scripts/csv_to_json.py --verbose
```
-### Problemas de dependencias
+### Problemas de dependencias {#problemas-de-dependencias}
**bundle install falla:**
@@ -343,7 +340,7 @@ source venv/bin/activate # En Windows: venv\Scripts\activate
pip install -r requirements.txt
```
-### Problemas de inserción (*embed*)
+### Problemas de inserción (*embed*) {#problemas-de-inserción-embed}
**Los botones de navegación no funcionan en el iframe:**
@@ -448,9 +445,9 @@ Al cambiar las entradas de ancho/alto:
3. Verifica si el menú desplegable de tamaños predefinidos está interfiriendo (selecciona el tamaño predefinido "Custom")
4. Verifica que JavaScript se esté ejecutando sin errores
-## Pruebas
+## Pruebas {#pruebas}
-### Lista de verificación de pruebas locales
+### Lista de verificación de pruebas locales {#lista-de-verificación-de-pruebas-locales}
Antes de publicar:
@@ -463,7 +460,7 @@ Antes de publicar:
- [ ] Adaptable a pantallas móviles
- [ ] Compatible con múltiples navegadores
-### Pruebas de navegador
+### Pruebas de navegador {#pruebas-de-navegador}
Prueba en:
@@ -472,7 +469,7 @@ Prueba en:
- Safari (última versión)
- Navegadores móviles (iOS Safari, Chrome Mobile)
-### Validación
+### Validación {#validación}
```bash
# Verifica validez de HTML
@@ -482,7 +479,7 @@ bundle exec htmlproofer ./_site --disable-external
bundle exec jekyll doctor
```
-### Pruebas automatizadas
+### Pruebas automatizadas {#pruebas-automatizadas}
Telar incluye pruebas automatizadas para los scripts de Python y los módulos de JavaScript. Ejecutar las pruebas es opcional para narradores, pero se recomienda para personas que contribuyen al desarrollo del marco.
@@ -523,9 +520,9 @@ python3 -m pytest tests/e2e/ -v
Las pruebas se ejecutan automáticamente en GitHub mediante el flujo de trabajo `telar-tests.yml` cada vez que haces push a main o abres un pull request.
-## Publicación
+## Publicación {#publicación}
-### Preparar para publicación
+### Preparar para publicación {#preparar-para-publicación}
```bash
# 1. Prueba localmente
@@ -545,7 +542,7 @@ git push origin main
# 5. GitHub Actions construye automáticamente
```
-## Mejores prácticas
+## Mejores prácticas {#mejores-prácticas}
1. **Confirma frecuentemente**: Confirmaciones pequeñas y enfocadas
2. **Prueba localmente primero**: Siempre previsualiza antes de empujar
@@ -555,13 +552,13 @@ git push origin main
6. **Control de versiones**: Rastrea todo el contenido en git
7. *Builds* limpios: ejecuta `jekyll clean` periódicamente
-## Obtener ayuda
+## Obtener ayuda {#obtener-ayuda}
- [GitHub Issues](https://github.com/UCSB-AMPLab/telar/issues)
- [Documentación Jekyll](https://jekyllrb.com/docs/)
- [Documentación IIIF](https://iiif.io/get-started/)
-## Próximos pasos
+## Próximos pasos {#próximos-pasos}
- [Referencia de GitHub Actions](/guia/desarrolladores/github-actions/)
- [Guía de Personalización](/guia/personalizacion/)
diff --git a/docs/8-5-styling.es.md b/content/es/guia/desarrolladores/estilos.md
similarity index 82%
rename from docs/8-5-styling.es.md
rename to content/es/guia/desarrolladores/estilos.md
index 7e0f035..3bd37d1 100644
--- a/docs/8-5-styling.es.md
+++ b/content/es/guia/desarrolladores/estilos.md
@@ -1,20 +1,21 @@
---
-layout: docs
-title: "8.5. Estilos avanzados"
-parent: "8. Para desarrolladores"
-grand_parent: Documentación
-nav_order: 5
-lang: es
-permalink: /guia/desarrolladores/estilos/
+title: Estilos avanzados
+url: /guia/desarrolladores/estilos/
+translationKey: docs-developers-styling
+type: guide
+docs_section: developers
---
-## Estilos avanzados
+# Estilos avanzados {#guide-title}
+
+
+## Estilos avanzados {#estilos-avanzados}
Ve más allá de los temas con CSS personalizado, modificaciones de diseño y estilos de componentes.
-## CSS personalizado
+## CSS personalizado {#css-personalizado}
-### Método 1: agrega a telar.scss
+### Método 1: agrega a telar.scss {#método-1-agrega-a-telarscss}
Edita `assets/css/telar.scss` para agregar estilos personalizados:
@@ -35,7 +36,7 @@ Edita `assets/css/telar.scss` para agregar estilos personalizados:
}
```
-### Método 2: crea una hoja de estilos personalizada
+### Método 2: crea una hoja de estilos personalizada {#método-2-crea-una-hoja-de-estilos-personalizada}
Crea `assets/css/custom.css`:
@@ -54,10 +55,10 @@ Crea `assets/css/custom.css`:
Luego inclúyela en tu `_layouts/default.html`:
```html
-<link rel="stylesheet" href="{{ '/assets/css/custom.css' | relative_url }}">
+<link rel="stylesheet" href="/assets/css/custom.css">
```
-## Variables CSS
+## Variables CSS {#variables-css}
Telar usa propiedades personalizadas CSS que puedes sobrescribir:
@@ -86,9 +87,9 @@ Telar usa propiedades personalizadas CSS que puedes sobrescribir:
Sobrescribe estas en tu CSS personalizado para hacer cambios globales.
-## Personalización del diseño
+## Personalización del diseño {#personalización-del-diseño}
-### Modifica los diseños
+### Modifica los diseños {#modifica-los-diseños}
Edita archivos en el directorio `_layouts/`:
@@ -98,7 +99,7 @@ Edita archivos en el directorio `_layouts/`:
- `glossary.html`: Página de término de glosario
- `home.html`: Diseño de página de inicio
-### Modifica los includes
+### Modifica los includes {#modifica-los-includes}
Edita componentes reutilizables en `_includes/`:
@@ -107,9 +108,9 @@ Edita componentes reutilizables en `_includes/`:
- `story-step.html`: Paso individual de historia
- `object-card.html`: Tarjeta de cuadrícula de objetos
-## Estilos de componentes
+## Estilos de componentes {#estilos-de-componentes}
-### Pasos de historia
+### Pasos de historia {#pasos-de-historia}
```scss
.story-step {
@@ -128,7 +129,7 @@ Edita componentes reutilizables en `_includes/`:
}
```
-### Paneles en capas
+### Paneles en capas {#paneles-en-capas}
```scss
.layer-panel {
@@ -144,7 +145,7 @@ Edita componentes reutilizables en `_includes/`:
}
```
-### Tarjetas de objeto
+### Tarjetas de objeto {#tarjetas-de-objeto}
```scss
.object-card {
@@ -163,7 +164,7 @@ Edita componentes reutilizables en `_includes/`:
}
```
-## Diseño adaptable
+## Diseño adaptable {#diseño-adaptable}
El diseño de historias de Telar cambia a su disposición vertical cuando la ventana mide menos de 1024px de ancho o tiene una relación de aspecto menor que 3:4 (consulta [Optimización móvil](/guia/desarrolladores/moviles/) para más detalles). Cuando agregues reglas adaptables a tus propios componentes, usa esos mismos puntos de quiebre (*breakpoints*) para que tus estilos cambien al mismo tiempo que el diseño:
@@ -185,7 +186,7 @@ El diseño de historias de Telar cambia a su disposición vertical cuando la ven
}
```
-## Capas de cascada
+## Capas de cascada {#capas-de-cascada}
Desde la v1.4.0, los estilos de Telar se organizan en capas de cascada CSS, declaradas en este orden:
@@ -197,9 +198,9 @@ Bootstrap se carga en la capa `third-party` y los estilos propios de Telar se ca
Esto también facilita tus personalizaciones: **el CSS sin capa siempre prevalece sobre el CSS con capa**, sin importar la especificidad del selector. Cualquier regla de CSS común que agregues por fuera de estas capas tiene prioridad sobre los estilos de Telar, así que casi siempre puedes cambiar la apariencia sin recurrir a `!important`. Si una regla personalizada no se aplica como esperas, revisa que no haya quedado dentro de alguna de las capas de Telar.
-## Personalización de JavaScript
+## Personalización de JavaScript {#personalización-de-javascript}
-### Modificar el comportamiento de la historia
+### Modificar el comportamiento de la historia {#modificar-el-comportamiento-de-la-historia}
El código fuente del motor de historias vive en `assets/js/telar-story/` (un módulo por función — motor de desplazamiento, navegación, tarjetas, paneles) y se empaqueta en `assets/js/telar-story.js`, que es el archivo que las páginas cargan. Para cambiar el comportamiento de las historias, edita los módulos y vuelve a generar el paquete:
@@ -209,7 +210,7 @@ npm run build:js
Nunca edites `assets/js/telar-story.js` directamente: es un archivo generado y la próxima vez que se genere el paquete lo sobrescribe. El mapa del directorio en `assets/js/README.md` describe qué hace cada módulo y dónde conviene hacer cada tipo de cambio.
-### Agregar interacciones personalizadas
+### Agregar interacciones personalizadas {#agregar-interacciones-personalizadas}
Crea `assets/js/custom.js`:
@@ -239,9 +240,9 @@ document.addEventListener('DOMContentLoaded', function() {
});
```
-## Personalización de tipografía
+## Personalización de tipografía {#personalización-de-tipografía}
-### Estilos de encabezados
+### Estilos de encabezados {#estilos-de-encabezados}
```scss
h1, h2, h3, h4, h5, h6 {
@@ -257,7 +258,7 @@ h2 { font-size: 2rem; }
h3 { font-size: 1.75rem; }
```
-### Cuerpo de texto
+### Cuerpo de texto {#cuerpo-de-texto}
```scss
body {
@@ -272,7 +273,7 @@ p {
}
```
-## Animación
+## Animación {#animación}
Agrega animaciones sutiles:
@@ -304,7 +305,7 @@ Agrega animaciones sutiles:
}
```
-## Mejores prácticas
+## Mejores prácticas {#mejores-prácticas}
1. **Usa variables CSS** para valores que se repiten
2. **Prueba en múltiples tamaños de pantalla**
@@ -313,7 +314,7 @@ Agrega animaciones sutiles:
5. **Comenta tu código** para referencia futura
6. **Prueba en múltiples navegadores** (Chrome, Firefox, Safari)
-## Optimización de rendimiento
+## Optimización de rendimiento {#optimización-de-rendimiento}
```scss
// Usa will-change para animaciones
@@ -332,7 +333,7 @@ Agrega animaciones sutiles:
}
```
-## Próximos pasos
+## Próximos pasos {#próximos-pasos}
- [Conoce sobre temas](/guia/personalizacion/temas/)
- [Ver sitios de ejemplo](https://ampl.clair.ucsb.edu/telar)
diff --git a/docs/8-2-github-actions.es.md b/content/es/guia/desarrolladores/github-actions.md
similarity index 81%
rename from docs/8-2-github-actions.es.md
rename to content/es/guia/desarrolladores/github-actions.md
index 8aa59f8..1cbab42 100644
--- a/docs/8-2-github-actions.es.md
+++ b/content/es/guia/desarrolladores/github-actions.md
@@ -1,22 +1,23 @@
---
-layout: docs
-title: "8.2. GitHub Actions"
-parent: "8. Para desarrolladores"
-grand_parent: Documentación
-nav_order: 2
-lang: es
-permalink: /guia/desarrolladores/github-actions/
+title: GitHub Actions
+url: /guia/desarrolladores/github-actions/
+translationKey: docs-developers-github-actions
+type: guide
+docs_section: developers
---
-## Flujo de trabajo con GitHub Actions
+# GitHub Actions {#guide-title}
+
+
+## Flujo de trabajo con GitHub Actions {#flujo-de-trabajo-con-github-actions}
Telar usa GitHub Actions para construir y publicar automáticamente tu sitio. Entender este flujo de trabajo te ayuda a solucionar problemas y optimizar tu proceso de desarrollo.
-## Qué hace GitHub Actions
+## Qué hace GitHub Actions {#qué-hace-github-actions}
Cuando publicas vía GitHub Pages, el *build* es **completamente automatizado**. ¡No se requieren pasos manuales!
-### Acciones del usuario (tú)
+### Acciones del usuario (tú) {#acciones-del-usuario-tú}
Edita contenido directamente en GitHub o empuja desde local:
@@ -25,7 +26,7 @@ Edita contenido directamente en GitHub o empuja desde local:
3. **Agrega imágenes** a `telar-content/objects/`
4. **Haz *commit* y *push*** a la rama main
-### Acciones automatizadas (GitHub)
+### Acciones automatizadas (GitHub) {#acciones-automatizadas-github}
El flujo de trabajo (`.github/workflows/build.yml`) automáticamente:
@@ -72,7 +73,7 @@ El flujo de trabajo (`.github/workflows/build.yml`) automáticamente:
- Publica directorio `_site/`
- El sitio queda en vivo en la URL de GitHub Pages
-## Activadores del *build*
+## Activadores del *build* {#activadores-del-build}
El flujo de trabajo se ejecuta automáticamente cuando:
@@ -80,11 +81,11 @@ El flujo de trabajo se ejecuta automáticamente cuando:
- **Cambios a CSV o Markdown**: Las actualizaciones de contenido se publican inmediatamente
- **Cambios a config**: Modificaciones a `_config.yml` reconstruyen el sitio
-## Activador manual del *build*
+## Activador manual del *build* {#activador-manual-del-build}
A veces necesitas reconstruir sin hacer cambios de código (ej., después de editar Google Sheets).
-### Cómo activarlo manualmente
+### Cómo activarlo manualmente {#cómo-activarlo-manualmente}
1. Ve a tu repositorio en GitHub
2. Haz clic en la pestaña **Actions**
@@ -94,19 +95,20 @@ A veces necesitas reconstruir sin hacer cambios de código (ej., después de edi
6. Haz clic en el botón verde **Run workflow**
7. Espera 2-5 minutos para completar
-### Cuándo activarlo manualmente
+### Cuándo activarlo manualmente {#cuándo-activarlo-manualmente}
- Después de editar contenido de Google Sheets
- Después de agregar objetos o pasos de historia en Google Sheets
- Para reconstruir sin cambios de código
- Para forzar un *build* limpio
-{: .tip }
-> Cuando activas el flujo de trabajo a mano, las casillas **force_iiif** y **force_audio** deciden si se regeneran las teselas IIIF y el audio. Las dos vienen marcadas. Si desmarcas una, esa parte se toma del caché y el *build* termina antes.
+{{< callout "tip" >}}
+Cuando activas el flujo de trabajo a mano, las casillas **force_iiif** y **force_audio** deciden si se regeneran las teselas IIIF y el audio. Las dos vienen marcadas. Si desmarcas una, esa parte se toma del caché y el *build* termina antes.
+{{< /callout >}}
-## Errores comunes del *build*
+## Errores comunes del *build* {#errores-comunes-del-build}
-### Error de análisis CSV
+### Error de análisis CSV {#error-de-análisis-csv}
**Error:** `Failed to parse story-1.csv`
@@ -116,7 +118,7 @@ A veces necesitas reconstruir sin hacer cambios de código (ej., después de edi
- Asegura que todas las columnas requeridas estén presentes
- Verifica que no haya caracteres especiales rompiendo el formato CSV
-### Hoja de cálculo rechazada
+### Hoja de cálculo rechazada {#hoja-de-cálculo-rechazada}
**Error:** `Two columns in this spreadsheet mean the same thing: ...` (falla en el paso "Convert CSV to JSON"; el mensaje nombra el archivo)
@@ -131,7 +133,7 @@ A veces necesitas reconstruir sin hacer cambios de código (ej., después de edi
- Cámbiale el nombre a la columna `_metadata` y reconstruye el sitio. Telar reserva ese nombre para su propio uso: si una fila tiene algo escrito en esa columna, Telar la toma por un dato interno y no la muestra en el sitio publicado.
-### Error de generación IIIF
+### Error de generación IIIF {#error-de-generación-iiif}
**Error:** `Failed to process image textile-001.jpg`
@@ -141,7 +143,7 @@ A veces necesitas reconstruir sin hacer cambios de código (ej., después de edi
- Verifica que la imagen no esté dañada
- Asegúrate de que el formato de imagen sea compatible (JPG, PNG, TIFF)
-### Error del *build* de Jekyll
+### Error del *build* de Jekyll {#error-del-build-de-jekyll}
**Error:** `Liquid syntax error`
@@ -151,7 +153,7 @@ A veces necesitas reconstruir sin hacer cambios de código (ej., después de edi
- Verifica que el frontmatter esté correctamente formateado
- Busca etiquetas o corchetes sin cerrar
-### Error de obtención de Google Sheets
+### Error de obtención de Google Sheets {#error-de-obtención-de-google-sheets}
**Error:** `Failed to fetch Google Sheets`
@@ -161,7 +163,7 @@ A veces necesitas reconstruir sin hacer cambios de código (ej., después de edi
- Asegura que la hoja esté publicada en la web (no solo compartida)
- Verifica que la hoja tenga permisos apropiados
-### Fallo del *build* por historia privada
+### Fallo del *build* por historia privada {#fallo-del-build-por-historia-privada}
**Error:** `story/stories are marked protected but no story_key is set` (falla en el paso "Convert CSV to JSON")
@@ -178,7 +180,7 @@ A veces necesitas reconstruir sin hacer cambios de código (ej., después de edi
**Solución:**
- Significa que el sitio generado todavía contiene un rastro del contenido de una historia privada que debió quedar cifrado. Es un error del programa, no de configuración — [repórtalo](https://github.com/UCSB-AMPLab/telar/issues) con el enlace a la ejecución del flujo de trabajo.
-## Rendimiento del *build*
+## Rendimiento del *build* {#rendimiento-del-build}
Tiempos típicos del *build*:
@@ -186,36 +188,36 @@ Tiempos típicos del *build*:
- **Sitios medianos** (10-50 objetos, múltiples historias): 3-5 minutos
- **Sitios grandes** (50+ objetos, muchas historias): 5-10 minutos
-### Optimiza el tiempo del *build*
+### Optimiza el tiempo del *build* {#optimiza-el-tiempo-del-build}
- **Usa IIIF externo** para imágenes grandes (evita generar teselas (*tiles*))
- **Confirma menos imágenes** a la vez (divide cargas grandes)
- **Limpia repositorio** periódicamente (elimina archivos sin usar)
-## Solución de problemas
+## Solución de problemas {#solución-de-problemas}
-### El *build* falla cada vez
+### El *build* falla cada vez {#el-build-falla-cada-vez}
1. Verifica confirmaciones recientes para errores
2. Revisa el registro del *build* para mensajes de error específicos
3. Prueba localmente primero (`bundle exec jekyll serve`) — ten en cuenta que este comando nunca ejecuta el paso de cifrado de historias privadas, así que no reproduce un fallo del *build* por historia privada. Para eso, usa `python3 scripts/build_local_site.py --build-only` (consulta la [Referencia de Desarrollo Local](/guia/desarrolladores/desarrollo-local/))
4. Revierte a la última confirmación funcional si es necesario
-### El *build* tiene éxito pero el sitio no se actualiza
+### El *build* tiene éxito pero el sitio no se actualiza {#el-build-tiene-éxito-pero-el-sitio-no-se-actualiza}
1. Limpia caché del navegador (recarga forzada: Cmd+Shift+R o Ctrl+Shift+R)
2. Espera 5 minutos para propagación de CDN
3. Verifica configuración de GitHub Pages (Settings → Pages)
4. Verifica que la rama correcta esté establecida para publicación en Pages
-### Google Sheets no se actualiza
+### Google Sheets no se actualiza {#google-sheets-no-se-actualiza}
1. Activa flujo de trabajo manualmente (ver arriba)
2. Verifica la URL publicada en `_config.yml`
3. Verifica que la hoja esté publicada en la web
4. Revisa los _logs_ de obtención en pestaña Actions
-## Próximos pasos
+## Próximos pasos {#próximos-pasos}
- [Referencia de Desarrollo Local](/guia/desarrolladores/desarrollo-local/)
- [Guía de Configuración](/guia/configurar/configuracion/)
diff --git a/docs/8-7-story-engine.es.md b/content/es/guia/desarrolladores/motor-de-historias.md
similarity index 93%
rename from docs/8-7-story-engine.es.md
rename to content/es/guia/desarrolladores/motor-de-historias.md
index f7508a9..a6f272b 100644
--- a/docs/8-7-story-engine.es.md
+++ b/content/es/guia/desarrolladores/motor-de-historias.md
@@ -1,20 +1,18 @@
---
-layout: docs
-title: "8.7. Vocabulario del motor de historias"
-parent: "8. Para desarrolladores"
-grand_parent: Documentación
-nav_order: 7
-lang: es
-permalink: /guia/desarrolladores/motor-de-historias/
+title: Vocabulario del motor de historias
+url: /guia/desarrolladores/motor-de-historias/
+translationKey: docs-developers-story-engine
+type: guide
+docs_section: developers
---
-# Vocabulario del motor de historias
+# Vocabulario del motor de historias {#vocabulario-del-motor-de-historias}
El motor de historias es el código que hace funcionar la página de una historia: ubica las tarjetas y el objeto, mueve la historia entre pasos y decide qué se mantiene cargado. Está en `assets/js/telar-story/` y se empaqueta en `assets/js/telar-story.js`. Esta página define los términos que usan el código, sus comentarios y esta documentación para las partes de una historia y para sus movimientos, de modo que cada término nombre una sola cosa.
Las clases de CSS, los atributos `data-*` y el ajuste `max_viewer_cards` conservan sus nombres anteriores, porque los sitios y el Compositor los leen. Cuando un nombre anterior no coincide con un término de esta página, la entrada lo indica.
-## Las partes de una historia
+## Las partes de una historia {#las-partes-de-una-historia}
Una historia se arma con estas partes:
@@ -27,7 +25,7 @@ Una historia se arma con estas partes:
- **Visor**: el visor de imágenes (OpenSeadragon) de una lámina de imagen.
- **Reproductor**: el reproductor de video o de audio de una lámina de medios.
-## Cómo se avanza entre pasos
+## Cómo se avanza entre pasos {#cómo-se-avanza-entre-pasos}
Estos términos describen lo que pasa cuando quien lee avanza de un paso al siguiente:
@@ -43,7 +41,7 @@ Estos términos describen lo que pasa cuando quien lee avanza de un paso al sigu
Para hacer pruebas, la duración de los movimientos se puede ajustar con el parámetro de URL `?nav=base,perUnit,maxSeconds`. Con `?nav=1.2,0`, todos los movimientos duran los 1,2 segundos de base, sin importar el recorrido de la cámara.
-## Diseños
+## Diseños {#diseños}
La página de una historia usa uno de estos dos diseños:
@@ -68,7 +66,7 @@ Los términos para las tarjetas y el espacio que las rodea:
- **Navegación por botones**: los botones de anterior y siguiente mueven la historia un paso a la vez. Funciona en el diseño vertical, en las historias insertadas y, en iOS, en los dos diseños. Sus botones conservan la clase `.mobile-nav`.
- **Navegación por desplazamiento**: el desplazamiento de quien lee mueve la historia. Funciona en el diseño horizontal en todos los sistemas menos iOS.
-## Lo que se mantiene cargado
+## Lo que se mantiene cargado {#lo-que-se-mantiene-cargado}
El motor mantiene cargada una cantidad limitada de objetos, para que una historia larga no tenga en memoria todas sus imágenes y reproductores:
@@ -77,6 +75,6 @@ El motor mantiene cargada una cantidad limitada de objetos, para que una histori
En el motor, "grupo" solo se usa en estos dos sentidos.
-## Apilamiento
+## Apilamiento {#apilamiento}
Las tarjetas y la lámina de cada escena usan su propio bloque de valores de `z-index`, su **rango de `z-index`**, para que una escena posterior cubra a una anterior como una sola pieza.
diff --git a/docs/8-6-mobile.es.md b/content/es/guia/desarrolladores/moviles.md
similarity index 87%
rename from docs/8-6-mobile.es.md
rename to content/es/guia/desarrolladores/moviles.md
index 4e42c0a..71244e5 100644
--- a/docs/8-6-mobile.es.md
+++ b/content/es/guia/desarrolladores/moviles.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "8.6. Diseños y pantallas pequeñas"
-parent: "8. Para desarrolladores"
-grand_parent: Documentación
-nav_order: 6
-lang: es
-permalink: /guia/desarrolladores/moviles/
+title: Diseños y pantallas pequeñas
+url: /guia/desarrolladores/moviles/
+translationKey: docs-developers-mobile
+type: guide
+docs_section: developers
---
-# Diseños y pantallas pequeñas
+# Diseños y pantallas pequeñas {#diseños-y-pantallas-pequeñas}
La página de una historia tiene dos diseños, horizontal y vertical, y escoge entre ellos según el tamaño y la forma de la ventana, no según el tipo de dispositivo. Esta página explica qué hace cada diseño y cómo se adapta el resto del sitio a las ventanas pequeñas o bajas. Los términos que usa están definidos en [8.7 Vocabulario del motor de historias](/guia/desarrolladores/motor-de-historias/).
-## Los dos diseños
+## Los dos diseños {#los-dos-diseños}
En el diseño horizontal, la tarjeta de texto va al lado del objeto, como tarjeta lateral, y quien lee avanza por la historia desplazándose. En el diseño vertical, la tarjeta de texto va debajo del objeto, como tarjeta inferior, y quien lee avanza con los botones de anterior y siguiente.
@@ -25,7 +23,7 @@ La página usa el diseño vertical cuando la ventana cumple alguna de estas cond
En cualquier otro caso usa el diseño horizontal. Si la ventana cambia de tamaño, la página vuelve a escoger el diseño.
-### La tarjeta de texto
+### La tarjeta de texto {#la-tarjeta-de-texto}
En el diseño horizontal, la tarjeta lateral es blanca, va encima del objeto y ocupa entre el 37 % y el 52 % del ancho de la ventana, según la altura de esta. En el diseño vertical, la tarjeta inferior va anclada al borde inferior de la ventana, es blanca y ocupa hasta el 40 % de la altura de la ventana (el 35 % si el objeto es un video o un audio).
@@ -33,7 +31,7 @@ En una ventana de 480 px de alto o menos, como la de un teléfono en orientació
El texto también se ajusta al ancho de la tarjeta: cuando esta mide 480 px o menos, y otra vez a los 360 px, se reducen el relleno y la letra. Si una respuesta pasa de 15 líneas, la letra baja al 90 % del tamaño que la tarjeta usa para las respuestas, para que una de 18 líneas, el máximo, quepa en la tarjeta lateral sin que haya que desplazarse.
-### Navegación
+### Navegación {#navegación}
La navegación se escoge una sola vez, al cargar la historia:
@@ -44,38 +42,38 @@ Como la elección se hace al cargar, una ventana que se abre ancha y luego se an
En el diseño vertical, el botón para volver se convierte en un ícono redondo de 44 px, el contador de pasos pasa al centro del borde superior y la insignia de créditos se reduce a una sola línea.
-### Carga
+### Carga {#carga}
Los dos diseños cargan los objetos de la misma manera: cargan los visores de los pasos siguientes (tantos como indique `preload_steps`, 6 por defecto) y de los 2 anteriores, sin pasar de `max_viewer_cards`. Consulta [3.2 Configuración](/guia/configurar/configuracion/). Cuando una historia tiene al menos tantos objetos distintos como indica `loading_threshold` (5 por defecto), aparece un brillo de carga mientras cargan los primeros visores; en la navegación por botones también aparece cuando quien lee llega a un objeto que todavía no ha cargado.
-## Tamaño de letra compacto
+## Tamaño de letra compacto {#tamaño-de-letra-compacto}
En cualquier ventana de 600 px de alto o menos, sea cual sea su ancho, Telar aplica el tamaño de letra compacto: letra más pequeña y espaciado más ajustado en el contenido de las páginas, la galería de objetos, la barra de navegación, los paneles y sus títulos, y los botones de navegación de la historia, que pasan a medir 45 px.
-## Safari de iOS y muescas
+## Safari de iOS y muescas {#safari-de-ios-y-muescas}
- **Alturas estables:** las alturas del diseño usan unidades dinámicas de *viewport* (`dvh`), y `vh` en los navegadores que no las admiten, para que el diseño no salte cuando aparece o desaparece la barra de direcciones de Safari.
- **Áreas seguras de la muesca:** la insignia de créditos, los botones de navegación, la tarjeta inferior y los paneles quedan libres de la muesca y del indicador de inicio del dispositivo.
- **Estados al pasar el cursor:** solo se aplican en dispositivos con un puntero preciso (`@media (hover: hover) and (pointer: fine)`), para que no queden activos después de tocar una pantalla táctil.
- **Movimiento reducido:** cuando el sistema operativo pide reducir el movimiento, Telar desactiva el desplazamiento suave y las transiciones de las tarjetas y de los paneles, y la cámara pasa de inmediato a cada encuadre.
-## Paneles
+## Paneles {#paneles}
Los paneles entran desde la derecha en los dos diseños. En el diseño horizontal, el de la capa 1 ocupa el 65 % de la ventana (800 px como máximo), el de la capa 2 el 55 % (750 px como máximo) y el del glosario el 50 % (700 px como máximo); en ventanas de entre 1025 px y 1200 px de ancho ocupan el 80 %, el 75 % y el 70 %. En el diseño vertical ocupan casi todo el ancho (98 %, 96 % y 94 %) y el 76 % de la altura, muestran solo el botón para cerrar y tienen menos relleno.
La letra de los paneles se reduce solo con el tamaño de letra compacto: los títulos pasan de 2 rem a 1,4 rem, el texto de 1,05 rem a 0,9 rem y el interlineado de 1,8 a 1,35.
-## Galería de objetos
+## Galería de objetos {#galería-de-objetos}
La galería llena el ancho con columnas de por lo menos 250 px. En el diseño vertical muestra dos columnas, y en ventanas de 441 px de ancho o menos, una.
-## Índice del glosario
+## Índice del glosario {#índice-del-glosario}
En el diseño vertical, el índice del glosario ajusta el espaciado: los encabezados de cada letra se hacen más pequeños y sus márgenes se reducen en un tercio, y el espacio entre términos se reduce a la mitad.
-## Cómo probar el sitio en pantallas pequeñas
+## Cómo probar el sitio en pantallas pequeñas {#cómo-probar-el-sitio-en-pantallas-pequeñas}
-### Herramientas de desarrollo del navegador
+### Herramientas de desarrollo del navegador {#herramientas-de-desarrollo-del-navegador}
Con las herramientas de desarrollo del navegador puedes probar distintos tamaños de ventana:
@@ -92,14 +90,14 @@ Con las herramientas de desarrollo del navegador puedes probar distintos tamaño
Prueba tamaños de ventana a uno y otro lado de los umbrales: 1024 px de ancho, una relación de aspecto de 3:4, y 480 px y 600 px de alto. Recarga la página después de cambiar el tamaño para ver la navegación que tendría quien lea con esa ventana.
-### Dispositivos reales
+### Dispositivos reales {#dispositivos-reales}
Cuando puedas, prueba en dispositivos reales:
- **iOS**: Safari en iPhone y iPad
- **Android**: Chrome en un teléfono y en una tableta
-### Tamaños de pantalla comunes
+### Tamaños de pantalla comunes {#tamaños-de-pantalla-comunes}
- **iPhone SE**: 375 × 667 px
- **iPhone 12/13/14**: 390 × 844 px
@@ -108,27 +106,27 @@ Cuando puedas, prueba en dispositivos reales:
- **Samsung Galaxy S**: 360 × 740 px
- **Samsung Galaxy Note**: 412 × 915 px
-## Contenido para pantallas pequeñas
+## Contenido para pantallas pequeñas {#contenido-para-pantallas-pequeñas}
-### Imágenes
+### Imágenes {#imágenes}
- Asegúrate de que las imágenes IIIF tengan suficiente detalle al hacer zoom.
- Revisa que los detalles que señala cada paso se vean en una pantalla pequeña.
- Comprueba cómo se ven los encuadres en los dos diseños.
-### Texto
+### Texto {#texto}
- Escribe respuestas con párrafos cortos (de 3 a 5 oraciones).
- Usa listas para dividir los pasajes largos.
- Pon la información esencial en la capa 1 y los detalles complementarios en la capa 2, porque es posible que quien lee en un teléfono no abra todas las capas.
-### Widgets
+### Widgets {#widgets}
- **Carruseles:** de 3 a 5 imágenes, con leyendas cortas.
- **Pestañas:** 2 o 3 pestañas con etiquetas cortas; en pantallas angostas la fila de pestañas se desplaza hacia los lados.
- **Acordeones:** funcionan bien en pantallas pequeñas; usa títulos claros.
-## Rendimiento
+## Rendimiento {#rendimiento}
Quien lee en un teléfono suele tener una conexión lenta o con datos limitados:
@@ -136,32 +134,32 @@ Quien lee en un teléfono suele tener una conexión lenta o con datos limitados:
- Escoge fuentes IIIF externas con servidores rápidos y prueba qué tan rápido cargan sus manifiestos.
- En los paneles, usa solo las imágenes que el texto necesita.
-## Accesibilidad
+## Accesibilidad {#accesibilidad}
- La mayoría de los controles miden por lo menos 44 × 44 px, el mínimo de WCAG 2.1 para un objetivo táctil; los botones de navegación de la historia miden 66 px, o 45 px con el tamaño de letra compacto.
- Los botones de navegación y otros controles tienen etiquetas ARIA.
-## Solución de problemas
+## Solución de problemas {#solución-de-problemas}
-### El contenido se desborda
+### El contenido se desborda {#el-contenido-se-desborda}
- Revisa si el CSS personalizado tiene elementos de ancho fijo.
- Asegúrate de que las imágenes tengan `max-width: 100%`.
- Prueba la página en el modo de diseño adaptable del navegador.
-### La navegación no funciona
+### La navegación no funciona {#la-navegación-no-funciona}
- Borra la caché del navegador o prueba en una ventana privada.
- Revisa la consola de JavaScript en busca de errores.
- Comprueba que ningún código personalizado bloquee los eventos táctiles o de la rueda.
-### El sitio va lento
+### El sitio va lento {#el-sitio-va-lento}
- Reduce el tamaño de los archivos de imagen.
- Revisa qué tan rápido responden los manifiestos IIIF.
- Simula una conexión lenta en **DevTools**.
-## Lista de verificación
+## Lista de verificación {#lista-de-verificación}
- [ ] La página de inicio carga y se ve bien
- [ ] La galería de objetos muestra dos columnas en el diseño vertical, y una en un teléfono angosto
diff --git a/docs/8-3-demo-system-architecture.es.md b/content/es/guia/desarrolladores/sistema-demos.md
similarity index 93%
rename from docs/8-3-demo-system-architecture.es.md
rename to content/es/guia/desarrolladores/sistema-demos.md
index 2b63eed..30b011c 100644
--- a/docs/8-3-demo-system-architecture.es.md
+++ b/content/es/guia/desarrolladores/sistema-demos.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "8.3. Arquitectura del contenido de demostración"
-parent: "8. Para desarrolladores"
-grand_parent: Documentación
-nav_order: 3
-lang: es
-permalink: /guia/desarrolladores/sistema-demos/
+title: Arquitectura del contenido de demostración
+url: /guia/desarrolladores/sistema-demos/
+translationKey: docs-developers-demo-system
+type: guide
+docs_section: developers
---
-# Arquitectura del contenido de demostración
+# Arquitectura del contenido de demostración {#arquitectura-del-contenido-de-demostración}
Esta página explica cómo un sitio de Telar descarga el contenido de demostración, lo incorpora a sus datos y lo marca en las páginas, y también cómo se producen los paquetes de demostración. La página [Contenido de demostración](/guia/personalizacion/contenido-demostracion/) lo explica desde el punto de vista de quien hace un sitio.
-## Resumen
+## Resumen {#resumen}
El contenido de demostración se publica en [content.telar.org](https://content.telar.org) como un solo archivo JSON por versión de Telar y por idioma: el paquete de demostración. GitHub Pages sirve ese sitio desde el [repositorio de contenido de demostración](https://github.com/UCSB-AMPLab/demo-content). Durante el *build*, el sitio descarga el paquete y lo incorpora a los archivos JSON de `_data/`; luego, el generador de colecciones escribe las historias, los objetos y las entradas del glosario de demostración como páginas marcadas con `demo: true`.
@@ -27,7 +25,7 @@ Estas son las piezas que intervienen:
| `_demo_content/telar-demo-bundle.json` | El paquete descargado; excluido de git |
| `_data/demo-glossary.json` | Las entradas del glosario del paquete, para el generador de páginas del glosario; excluido de git |
-## Secuencia del *build*
+## Secuencia del *build* {#secuencia-del-build}
El flujo de trabajo **Build and Deploy** no tiene un paso propio para el contenido de demostración. La descarga ocurre dentro del paso **Convert CSV to JSON**, que ejecuta `python scripts/csv_to_json.py`.
@@ -40,9 +38,9 @@ Cuando se ejecuta `csv_to_json.py`:
El paso siguiente del flujo de trabajo, **Generate Jekyll collections**, ejecuta `generate_collections.py`, que escribe las páginas.
-## Descarga del paquete
+## Descarga del paquete {#descarga-del-paquete}
-### Configuración
+### Configuración {#configuración}
`load_config()`, en `fetch_demo_content.py`, lee tres valores de `_config.yml`:
@@ -56,7 +54,7 @@ La versión puede llevar el prefijo `v` o `V` y el sufijo `-beta` (por ejemplo,
Si `include_demo_content` es `false`, `cleanup_demo_content()` borra `_demo_content/` y el script termina. Si es `true`, el script borra primero `_demo_content/` y después descarga; así, si la descarga falla, no queda ningún paquete de un *build* anterior.
-### Selección de versión
+### Selección de versión {#selección-de-versión}
`fetch_versions_index()` descarga `https://content.telar.org/demos/versions.json`, que enumera las versiones publicadas del paquete:
@@ -82,7 +80,7 @@ Si `include_demo_content` es `false`, `cleanup_demo_content()` borra `_demo_cont
Si ninguna versión de la lista es menor o igual a la del sitio, el script muestra las versiones disponibles y termina sin descargar. Si no puede leer `versions.json`, intenta descargar el paquete de la misma versión que el sitio.
-### Descarga y verificaciones
+### Descarga y verificaciones {#descarga-y-verificaciones}
`fetch_bundle(version, language)` descarga:
@@ -105,7 +103,7 @@ Los límites de tamaño son `MAX_VERSIONS_BYTES` y `MAX_BUNDLE_BYTES`, en `scrip
Antes de guardar, `save_bundle()` verifica que el paquete tenga las claves `_meta`, `objects`, `stories` y `project`; que `objects`, `stories` y `project` sean cada uno una lista o un objeto, y que `objects` y `stories` no tengan más de 10.000 entradas cada uno. Si el paquete no pasa alguna de estas verificaciones, no se guarda; si las pasa todas, se escribe en `_demo_content/telar-demo-bundle.json`.
-## Formato del paquete
+## Formato del paquete {#formato-del-paquete}
Un paquete tiene estas claves de primer nivel:
@@ -170,11 +168,11 @@ Cada paso de la lista `steps` de una historia tiene `step`, `object`, `x`, `y` y
Una entrada del glosario tiene `term` (su título) y `content` (Markdown), y puede tener `kind` y `related_terms`. El valor de `kind` va tal como está escrito en la hoja de cálculo de origen, por ejemplo `fuente` en el paquete en español y `source` en el paquete en inglés; el *build* del sitio interpreta ambos como el mismo tipo.
-## Incorporación a `_data/`
+## Incorporación a `_data/` {#incorporación-a-_data}
`merge_demo_content(bundle)` ejecuta cuatro funciones, en este orden. Cada una captura sus propios errores y muestra una línea `[WARN]`, así que, si una falla, las demás se ejecutan igual.
-### Historias en `project.json`
+### Historias en `project.json` {#historias-en-projectjson}
`_merge_demo_projects()` convierte cada entrada de `project` en un registro de historia y pone las historias de demostración antes de las del sitio, en la lista `stories` de la primera entrada de `_data/project.json`. Solo se ejecuta si `_data/project.json` existe y la lista `project` del paquete no está vacía.
@@ -188,7 +186,7 @@ Una entrada del glosario tiene `term` (su título) y `content` (Markdown), y pue
No se copia ningún otro campo. En los paquetes de la v1.8.0, `colonial-landscapes` y `paisajes` tienen `show_sections` en `true`, así que la tarjeta de inicio de cada una muestra la tabla de contenidos de secciones.
-### Objetos en `objects.json`
+### Objetos en `objects.json` {#objetos-en-objectsjson}
`_merge_demo_objects()` agrega los objetos del paquete al final de `_data/objects.json`. Si el identificador de un objeto ya está entre los objetos del sitio, ese objeto se omite y se conserva el del sitio.
@@ -200,7 +198,7 @@ Cada objeto de demostración recibe `object_id`, `title`, `description`, `source
- `alt_text` solo se agrega cuando el objeto del paquete tiene un valor para ese campo
- `media_type` se calcula a partir de `source_url` con `detect_media_type()`, igual que para los objetos del propio sitio; no se lee ningún `media_type` que traiga el paquete
-### Archivos de historia
+### Archivos de historia {#archivos-de-historia}
`_write_demo_stories()` escribe un `_data/{story_id}.json` por cada historia del paquete. Cada paso queda así:
@@ -219,11 +217,11 @@ El contenido de las capas recibe el mismo procesamiento que los paneles del prop
Los enlaces de glosario de una historia de demostración se resuelven con un mapa de enlaces que `_demo_link_terms()` arma a partir del glosario del paquete y de las páginas de glosario del propio sitio.
-### Glosario
+### Glosario {#glosario}
`_write_demo_glossary()` escribe el glosario del paquete en `_data/demo-glossary.json`, como una lista. Cada entrada tiene `term_id`, `title` (tomado de `term`), `content` y `_demo: true`, y además `kind` y `related_terms` cuando la entrada del paquete los trae. Si `related_terms` viene como cadena de texto, se divide en una lista por el carácter `|`.
-## Escritura de las páginas
+## Escritura de las páginas {#escritura-de-las-páginas}
`generate_collections.py` lee los datos ya incorporados y escribe los archivos de las colecciones de Jekyll:
@@ -233,7 +231,7 @@ Los enlaces de glosario de una historia de demostración se resuelven con un map
No se pueden publicar dos entradas del glosario cuyos identificadores produzcan la misma URL. `place_demo_terms()` decide qué entradas de demostración se escriben: si la URL de una entrada de demostración ya pertenece a una entrada del sitio, o a una entrada de demostración anterior, esa entrada se omite con una advertencia, y los enlaces a su identificador llevan a la página que ocupa esa URL. La misma función decide los enlaces de glosario de las historias de demostración, así que los enlaces y las páginas coinciden. Todos los identificadores de las entradas de demostración empiezan con `demo-`.
-## Cómo se marca el contenido de demostración
+## Cómo se marca el contenido de demostración {#cómo-se-marca-el-contenido-de-demostración}
Las plantillas leen la marca `demo` del frontmatter, y el motor de historias lee las marcas de las capas:
@@ -256,7 +254,7 @@ Las plantillas leen la marca `demo` del frontmatter, y el motor de historias lee
| `demo.panel_badge` | Demo content | Contenido de demostración |
| `story.demo_label` | Demo content | Contenido de demostración |
-## Archivos en disco
+## Archivos en disco {#archivos-en-disco}
| Ruta | Lo escribe | Cuándo se borra |
|------|------------|-----------------|
@@ -267,11 +265,11 @@ Las plantillas leen la marca `demo` del frontmatter, y el motor de historias lee
`.gitignore` incluye `_demo_content/` y `_data/demo-glossary.json`.
-## El repositorio de contenido de demostración
+## El repositorio de contenido de demostración {#el-repositorio-de-contenido-de-demostración}
Los paquetes se construyen en el [repositorio de contenido de demostración](https://github.com/UCSB-AMPLab/demo-content), desde el cual se sirve content.telar.org.
-### Estructura
+### Estructura {#estructura}
El repositorio contiene:
@@ -297,7 +295,7 @@ Un directorio de idioma contiene estos archivos de origen:
Los paquetes de la v1.8.0 tienen dos historias: `mujer-alegorica` (10 pasos) y `paisajes` (22 pasos) en español, y `allegorical-woman` y `colonial-landscapes` en inglés. Cada idioma tiene 12 objetos y 24 entradas del glosario.
-### El generador
+### El generador {#el-generador}
El generador arma un paquete a partir de los archivos de origen de un directorio de idioma y lo guarda en ese mismo directorio. Lee las siguientes columnas:
@@ -333,9 +331,9 @@ Para reconstruir los paquetes de la v1.8.0 sin volver a generar las teselas:
python generator/build-demos.py --version 1.8.0 --bundle-only
```
-## Solución de problemas
+## Solución de problemas {#solución-de-problemas}
-### Ejecutar la descarga por separado
+### Ejecutar la descarga por separado {#ejecutar-la-descarga-por-separado}
Desde la raíz de un sitio, ejecuta:
@@ -345,11 +343,11 @@ python3 scripts/fetch_demo_content.py
El script muestra la versión y el idioma del sitio que leyó, la versión del paquete que eligió, la URL del paquete y sus campos `_meta`, y cuántos proyectos, objetos, historias y entradas del glosario guardó.
-### Revisar la incorporación
+### Revisar la incorporación {#revisar-la-incorporación}
Al ejecutar `python3 scripts/csv_to_json.py`, la incorporación muestra una línea por cada parte: `Merged 2 demo project(s) into project.json`, una línea `Merged … demo object(s)`, una línea `Created demo story:` por cada historia y, con los paquetes de la v1.8.0, `Created _data/demo-glossary.json (24 demo terms)`. Si una parte falla, muestra en su lugar una línea `[WARN]`. Cada registro de demostración en `_data/project.json` y `_data/objects.json` tiene `"_demo": true`.
-### Revisar los archivos publicados
+### Revisar los archivos publicados {#revisar-los-archivos-publicados}
Para ver qué versiones están publicadas y comprobar que se puede acceder a un paquete:
@@ -358,7 +356,7 @@ curl https://content.telar.org/demos/versions.json
curl -I https://content.telar.org/demos/v1.8.0/en/telar-demo-bundle.json
```
-## Véase también
+## Véase también {#véase-también}
- [Contenido de demostración](/guia/personalizacion/contenido-demostracion/) — el contenido de demostración para quienes hacen un sitio
- [GitHub Actions](/guia/desarrolladores/github-actions/) — el flujo de trabajo **Build and Deploy**
diff --git a/docs/8-4-embedding-system.es.md b/content/es/guia/desarrolladores/sistema-insercion.md
similarity index 80%
rename from docs/8-4-embedding-system.es.md
rename to content/es/guia/desarrolladores/sistema-insercion.md
index 4daba42..68cab30 100644
--- a/docs/8-4-embedding-system.es.md
+++ b/content/es/guia/desarrolladores/sistema-insercion.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "8.4. Arquitectura del sistema de inserción"
-parent: "8. Para desarrolladores"
-grand_parent: Documentación
-nav_order: 4
-lang: es
-permalink: /guia/desarrolladores/sistema-insercion/
+title: Referencia del sistema de inserción
+url: /guia/desarrolladores/sistema-insercion/
+translationKey: docs-developers-embedding-system
+type: guide
+docs_section: developers
---
-# Referencia del sistema de inserción
+# Referencia del sistema de inserción {#referencia-del-sistema-de-inserción}
Referencia técnica para el sistema de inserción mediante iframe de Telar.
-## Resumen de arquitectura
+## Resumen de arquitectura {#resumen-de-arquitectura}
El sistema de inserción de Telar permite que las historias se muestren dentro de iframes en sitios web externos y plataformas LMS. El sistema está diseñado en torno a estos principios:
@@ -31,9 +29,9 @@ El sistema de inserción de Telar permite que las historias se muestren dentro d
- No requiere integración especial
- Sin dependencias de APIs específicas de LMS
-## Detección del modo *embed*
+## Detección del modo *embed* {#detección-del-modo-embed}
-### Parámetro de URL
+### Parámetro de URL {#parámetro-de-url}
El modo *embed* se activa mediante el parámetro de URL `?embed=true`:
@@ -46,7 +44,7 @@ https://tusitio.com/stories/story-1/?embed=true
- Almacenado en `window.telarEmbed.enabled`
- Disponible para todos los módulos JavaScript
-### Implementación JavaScript
+### Implementación JavaScript {#implementación-javascript}
**Archivo:** `assets/js/embed.js`
@@ -87,9 +85,9 @@ https://tusitio.com/stories/story-1/?embed=true
- Usa DOMContentLoaded para asegurar que el elemento body existe
- La clase body se aplica antes de la inicialización de navegación
-## Modificaciones CSS
+## Modificaciones CSS {#modificaciones-css}
-### Estilos de modo *embed*
+### Estilos de modo *embed* {#estilos-de-modo-embed}
**Archivo:** `assets/css/telar.scss`
@@ -145,30 +143,30 @@ body.embed-mode {
}
```
-## Sistema de navegación
+## Sistema de navegación {#sistema-de-navegación}
-### Navegación en modo *embed*
+### Navegación en modo *embed* {#navegación-en-modo-embed}
**Archivo:** `assets/js/telar-story/main.js`
Las historias insertadas usan siempre la navegación por botones, en cualquier ancho: los eventos de desplazamiento no se propagan de manera confiable dentro de un iframe, así que el motor de desplazamiento nunca se activa en un *embed*. Fuera de los *embeds*, el modo de navegación sigue el modo de diseño: el diseño horizontal usa el motor de desplazamiento (basado en Lenis) y el diseño vertical (pantallas de 1024px de ancho o menos, o más angostas que 3:4) usa los mismos botones de anterior/siguiente. El límite se declara una sola vez en `_sass/_responsive.scss` (`$telar-vertical-min-width`) y `layout-mode.js` lo lee en tiempo de ejecución.
-### Modos de navegación
+### Modos de navegación {#modos-de-navegación}
- ***Embeds* (todos los anchos):** navegación por botones; los *embeds* anchos centran los botones sobre la columna narrativa y los angostos los apilan en el borde derecho
- **Sin *embed*, diseño horizontal:** motor de desplazamiento basado en Lenis
- **Sin *embed*, diseño vertical:** la misma navegación por botones
- **La navegación por teclado** funciona en todos los modos
-### Creación de botones
+### Creación de botones {#creación-de-botones}
**Archivo:** `assets/js/telar-story/navigation.js`
`initializeButtonNavigation()` construye el contenedor `.mobile-nav` con sus botones `.mobile-prev` y `.mobile-next` y los conecta a la navegación por pasos; termina sin hacer nada si el contenedor ya existe.
-## Banner "View Full Site"
+## Banner "View Full Site" {#banner-view-full-site}
-### Creación del banner
+### Creación del banner {#creación-del-banner}
**Archivo:** `assets/js/embed.js`
@@ -204,7 +202,7 @@ function createEmbedBanner() {
}
```
-### Estilos del banner
+### Estilos del banner {#estilos-del-banner}
```scss
.embed-banner {
@@ -231,9 +229,9 @@ function createEmbedBanner() {
- Sin persistencia de sessionStorage
- Enlaza a la página de inicio del sitio (no a la página de historia)
-## Panel de compartir e insertar
+## Panel de compartir e insertar {#panel-de-compartir-e-insertar}
-### Generación de código de inserción
+### Generación de código de inserción {#generación-de-código-de-inserción}
**Archivo:** `assets/js/share-panel.js`
@@ -266,7 +264,7 @@ function generateEmbedCode() {
}
```
-### Limpieza de URL
+### Limpieza de URL {#limpieza-de-url}
```javascript
function addEmbedParameter(url) {
@@ -292,7 +290,7 @@ function addEmbedParameter(url) {
- Agrega parámetro limpio `?embed=true`
- Asegura que el *embed* siempre comience en el paso 1
-### Tamaños predefinidos
+### Tamaños predefinidos {#tamaños-predefinidos}
**Archivo:** `assets/js/share-panel.js`
@@ -308,7 +306,7 @@ const presets = {
};
```
-### Normalización de dimensiones
+### Normalización de dimensiones {#normalización-de-dimensiones}
```javascript
function normalizeDimension(value) {
@@ -325,9 +323,9 @@ function normalizeDimension(value) {
- `800px` → `800px`
- `800` → `800px` (agrega px automáticamente)
-## Soporte multilingüe
+## Soporte multilingüe {#soporte-multilingüe}
-### Inyección de cadenas de idioma
+### Inyección de cadenas de idioma {#inyección-de-cadenas-de-idioma}
**Archivo:** `_layouts/story.html`
@@ -335,8 +333,8 @@ function normalizeDimension(value) {
<script>
window.telarLang = window.telarLang || {};
window.telarLang.embedBanner = {
- text: {{ site.data.languages[site.telar_language].embed_banner.text | jsonify }},
- link: {{ site.data.languages[site.telar_language].embed_banner.link | jsonify }}
+ text: null,
+ link: null
};
</script>
```
@@ -347,7 +345,7 @@ function normalizeDimension(value) {
3. JavaScript lee desde `window.telarLang.embedBanner`
4. Alternativa al inglés si faltan datos de idioma
-### Archivos de idioma
+### Archivos de idioma {#archivos-de-idioma}
**Inglés:** `_data/languages/en.yml`
```yaml
@@ -363,9 +361,9 @@ embed_banner:
link: "Ver el sitio completo"
```
-## Compatibilidad de navegadores
+## Compatibilidad de navegadores {#compatibilidad-de-navegadores}
-### Navegadores admitidos
+### Navegadores admitidos {#navegadores-admitidos}
El modo *embed* de Telar funciona en todos los navegadores modernos:
@@ -374,7 +372,7 @@ El modo *embed* de Telar funciona en todos los navegadores modernos:
- **Safari** 14+
- **Navegadores móviles** (iOS Safari, Chrome Android)
-### Consideraciones de iframe
+### Consideraciones de iframe {#consideraciones-de-iframe}
**Mismo origen vs. origen cruzado:**
- Los *embeds* de Telar son de origen cruzado (dominio diferente al anfitrión)
@@ -392,9 +390,9 @@ El modo *embed* de Telar funciona en todos los navegadores modernos:
- La carga de teselas IIIF no se ve afectada por el contexto iframe
- Los modales Bootstrap (glosario, panel de compartir) funcionan correctamente
-## Probar el modo *embed*
+## Probar el modo *embed* {#probar-el-modo-embed}
-### Pruebas locales
+### Pruebas locales {#pruebas-locales}
**Estructura del archivo de prueba:**
```html
@@ -427,7 +425,7 @@ El modo *embed* de Telar funciona en todos los navegadores modernos:
- [ ] Los botones de inicio y compartir están ocultos
- [ ] Comportamiento responsivo en diferentes anchos
-### Pruebas en producción
+### Pruebas en producción {#pruebas-en-producción}
1. Despliega el sitio a producción (GitHub Pages o dominio personalizado)
2. Prueba el código de inserción en curso real de Canvas LMS
@@ -435,9 +433,9 @@ El modo *embed* de Telar funciona en todos los navegadores modernos:
4. Prueba en dispositivos móviles (iOS, Android)
5. Verifica la consola en busca de errores de JavaScript
-## Consideraciones de seguridad
+## Consideraciones de seguridad {#consideraciones-de-seguridad}
-### Política de seguridad de contenido
+### Política de seguridad de contenido {#política-de-seguridad-de-contenido}
Si tu sitio usa encabezados CSP, asegúrate de que los iframes estén permitidos:
@@ -450,7 +448,7 @@ Content-Security-Policy: frame-ancestors 'self' https://canvas.instructure.com h
- Insertable en cualquier sitio
- Considera esto al alojar contenido sensible
-### Compartir recursos de origen cruzado (CORS)
+### Compartir recursos de origen cruzado (CORS) {#compartir-recursos-de-origen-cruzado-cors}
**Teselas IIIF:**
- Servidas desde el mismo origen que la historia
@@ -461,7 +459,7 @@ Content-Security-Policy: frame-ancestors 'self' https://canvas.instructure.com h
- La mayoría de los proveedores IIIF incluyen encabezados CORS apropiados
- Prueba manifiestos externos antes de insertar
-### Atributo sandbox de iframe
+### Atributo sandbox de iframe {#atributo-sandbox-de-iframe}
**No recomendado para Telar:**
@@ -477,9 +475,9 @@ Content-Security-Policy: frame-ancestors 'self' https://canvas.instructure.com h
- Deshabilita navegación y modales
- Usa iframe estándar sin atributo sandbox
-## Personalizar el comportamiento de *embed*
+## Personalizar el comportamiento de *embed* {#personalizar-el-comportamiento-de-embed}
-### Estilos personalizados de *embed*
+### Estilos personalizados de *embed* {#estilos-personalizados-de-embed}
Agrega CSS personalizado para modo *embed* en `assets/css/telar.scss`:
@@ -494,7 +492,7 @@ body.embed-mode {
}
```
-### Detectar modo *embed* en código personalizado
+### Detectar modo *embed* en código personalizado {#detectar-modo-embed-en-código-personalizado}
```javascript
if (window.telarEmbed?.enabled) {
@@ -503,7 +501,7 @@ if (window.telarEmbed?.enabled) {
}
```
-### Modificar la apariencia del banner
+### Modificar la apariencia del banner {#modificar-la-apariencia-del-banner}
Sobrescribe estilos del banner en `telar.scss`:
@@ -519,32 +517,22 @@ Sobrescribe estilos del banner en `telar.scss`:
}
```
-## Limitaciones conocidas
+## Limitaciones conocidas {#limitaciones-conocidas}
**Sin redimensionamiento dinámico de altura:**
- Solo alturas fijas
- Sin postMessage `lti.frameResize` de Canvas
- Intencional: Telar usa desplazamiento interno
-**Sin enlaces profundos (v0.5.0):**
-- El *embed* siempre comienza en el paso 1
-- Parámetro `?section=` no implementado
-- Planeado para versión futura
+<span class="anchor-alias" id="mejoras-futuras"></span>
-**Estado del visor no preservado:**
-- La URL de *embed* elimina coordenadas hash
-- Cada carga de *embed* comienza fresca
-- Las personas deben navegar a la vista deseada
+## Enlaces a pasos y estado de la inserción {#enlaces-a-pasos-y-estado-de-la-inserción}
-## Mejoras futuras
+El código que genera Compartir retira la consulta y el fragmento actuales y agrega el parámetro de inserción; por eso abre la historia desde la introducción. No conserva los cambios temporales de desplazamiento y zoom del lector.
-**Planeadas para versiones futuras:**
-- Enlaces profundos mediante parámetro `?section=`
-- Tiempo de espera opcional para auto-ocultar banner
-- Seguimiento de analíticas de *embed*
-- Optimizaciones específicas de LMS
+El motor también admite fragmentos de pasos y paneles: <code>#s3</code> abre el tercer paso de contenido, <code>#s3l1</code> abre su primer panel y <code>#s3l1g1</code> señala su primer enlace de glosario. Son distintos del parámetro <code>?section=</code>, que no está implementado. Prueba los enlaces insertados que construyas manualmente en el alojamiento previsto antes de compartirlos.
-## Documentación relacionada
+## Documentación relacionada {#documentación-relacionada}
- **Guía para educadores**: [Insertar en LMS y sitios web](/guia/funciones/insercion/)
- **Configuración de desarrollo**: [Desarrollo Local](/guia/desarrolladores/desarrollo-local/)
diff --git a/content/es/guia/el-compositor/_index.md b/content/es/guia/el-compositor/_index.md
new file mode 100644
index 0000000..30f6629
--- /dev/null
+++ b/content/es/guia/el-compositor/_index.md
@@ -0,0 +1,48 @@
+---
+title: Manual del Compositor
+url: /guia/el-compositor/
+translationKey: docs-the-compositor
+type: guide
+docs_section: compositor
+---
+
+# Manual del Compositor {#manual-del-compositor}
+
+<span class="anchor-alias" id="el-compositor"></span>
+
+<span class="anchor-alias" id="qué-es-el-compositor"></span>
+
+El Compositor de Telar es una herramienta de autoría visual para crear y administrar exhibiciones en Telar. Funciona en tu navegador en [compositor.telar.org](https://compositor.telar.org), donde puedes entretejer imágenes, video, audio y texto en narrativas visuales por capas sin escribir código.
+
+Puedes usarlo para proyectos de humanidades digitales, exhibiciones públicas, narrativas comunitarias y proyectos en el salón de clase, de forma individual o con un equipo. La interfaz está disponible en español e inglés.
+
+Telar proporciona el marco para la exhibición que explora tu público. El Compositor te ofrece un espacio de trabajo para reunir su contenido, previsualizar las historias y publicar el sitio. El contenido y la configuración del sitio publicado se conservan como archivos en un repositorio de GitHub.
+
+## Las partes de una exhibición {#las-partes-de-una-exhibición}
+
+- **Los objetos** son tus materiales de trabajo: imágenes, video o audio, con sus descripciones, fuentes y créditos.
+- **Las historias** guían al público por esos materiales mediante una secuencia de **pasos**. Cada paso combina texto narrativo con un encuadre de un objeto o un fragmento de video o audio.
+- **Los paneles y las entradas del glosario** ofrecen contexto adicional que el público puede abrir durante el recorrido.
+- **La página de inicio y las páginas de apoyo** presentan la exhibición y ayudan al público a orientarse.
+
+Puedes administrar todo esto desde el Compositor, junto con la apariencia y la navegación del sitio.
+
+## Cómo funciona {#cómo-funciona}
+
+1. **Comienza un sitio.** Crea un sitio Telar nuevo o conecta uno que ya tengas.
+2. **Compón tu exhibición.** Agrega las fuentes, escribe las historias, elige los detalles que mostrará cada paso y desarrolla el contexto.
+3. **Revisa y publica.** Comprueba tu trabajo y publica los cambios en GitHub. Después, Telar genera el sitio web público.
+
+Tu trabajo se guarda mientras editas. Publicar es una acción aparte, así que puedes desarrollar un borrador antes de actualizar el sitio público. Después de publicar, revisa el sitio cuando termine de generarse.
+
+<span class="anchor-alias" id="requisitos"></span>
+
+## Antes de comenzar {#antes-de-comenzar}
+
+Necesitas una cuenta de GitHub. La [guía del primer sitio](/guia/primeros-pasos/compositor/) te acompaña al iniciar sesión, dar acceso a la aplicación de Telar en GitHub y crear un sitio. Si ya tienes un repositorio de Telar, sigue [Conectar un sitio existente](/guia/el-compositor/primeros-pasos/).
+
+Si todavía estás desarrollando tu idea, empieza por [Planear una exhibición](/guia/planear/). Para un primer ejercicio práctico, el [recorrido ilustrado del khipu](/guia/el-compositor/iiif-a-historia/) lleva una imagen de una colección IIIF hasta un paso de una historia y muestra cómo guardar su encuadre.
+
+<span class="anchor-alias" id="en-esta-sección"></span>
+
+{{< manual-contents >}}
diff --git a/content/es/guia/el-compositor/configuracion.md b/content/es/guia/el-compositor/configuracion.md
new file mode 100644
index 0000000..6a261ec
--- /dev/null
+++ b/content/es/guia/el-compositor/configuracion.md
@@ -0,0 +1,53 @@
+---
+title: Ajusta la apariencia y la configuración
+url: /guia/el-compositor/configuracion/
+translationKey: docs-the-compositor-settings
+type: guide
+docs_draft: true
+docs_section: compositor
+---
+
+# Ajusta la apariencia y la configuración {#ajusta-la-apariencia-y-la-configuración}
+
+Usa **Configuración del sitio** para la identidad, el idioma, el tema, las opciones de presentación y la dirección de alojamiento. La página distingue los ajustes editoriales de los reservados para la persona responsable.
+
+## Define la identidad y el idioma {#define-la-identidad-y-el-idioma}
+
+Revisa título, descripción, autoría y correo de contacto. El título y la descripción deben corresponder a la presentación del inicio.
+
+El idioma del sitio controla los textos de interfaz que aporta Telar. El idioma de tu cuenta controla la interfaz del Compositor. Ninguno traduce el contenido que escribiste.
+
+Elige un tema disponible en el repositorio. La persona responsable puede actualizar la lista si los temas cambiaron en GitHub. Revisa el resultado con tus textos e imágenes.
+
+{{< media id="theme-language" >}}
+
+## Decide qué muestra el inicio {#decide-qué-muestra-el-inicio}
+
+Los ajustes de historias controlan su presentación en el inicio, el indicador de pasos y los créditos de objetos. Los de colección controlan la exploración, el enlace a la colección, los objetos destacados y si aparecen primero los objetos o las historias.
+
+Da prioridad a las historias si propones un recorrido guiado. Usa el modo de colección si el público debe comenzar explorando objetos. Revisa el inicio después de publicar.
+
+## Reconoce los ajustes de la persona responsable {#reconoce-los-ajustes-de-la-persona-responsable}
+
+Solo la persona responsable cambia el dominio y la ruta de alojamiento, la clave de historias, la integración con Google Sheets y la inclusión de contenido de demostración. Los demás integrantes pueden cambiar ajustes editoriales como títulos, tema y opciones de presentación.
+
+- La **URL del sitio** es el dominio, por ejemplo, `https://ejemplo.github.io`.
+- La **URL base** es la ruta, por ejemplo, `/mi-exhibicion`; déjala vacía si el sitio ocupa la raíz del dominio.
+- La clave se usa en historias privadas. Es distinta del estado de borrador.
+- El contenido de demostración son ejemplos; desactívalo cuando ya no corresponda a tu exhibición.
+
+Cambiar la dirección afecta los enlaces del sitio. Confirma el alojamiento y la dirección antes de publicarlos.
+
+## Elige una fuente de contenido {#elige-una-fuente-de-contenido}
+
+Si Google Sheets sigue activo, un build puede descargar la hoja y reemplazar los objetos e historias que editaste visualmente. Lee el aviso de configuración. El proceso de guardar objetos en el Compositor cambia el proyecto a contenido gestionado por el Compositor.
+
+Antes de cambiar de método, revisa la última versión de la hoja y los cambios sin publicar. El Compositor no devuelve tus ediciones a Google Sheets.
+
+{{< media id="preferences" >}}
+
+## Guarda y publica {#guarda-y-publica}
+
+Usa **Guardar cambios** en esta página y espera la confirmación. Revisa después la publicación por separado. Cuando termine el build, comprueba el inicio, el menú y una historia.
+
+Consulta [el proceso de publicación](/guia/el-compositor/publicacion/).
diff --git a/content/es/guia/el-compositor/cursos.md b/content/es/guia/el-compositor/cursos.md
new file mode 100644
index 0000000..1bcc237
--- /dev/null
+++ b/content/es/guia/el-compositor/cursos.md
@@ -0,0 +1,50 @@
+---
+title: Organiza un curso con sitios de estudiantes
+url: /guia/el-compositor/cursos/
+translationKey: docs-the-compositor-courses
+type: guide
+docs_draft: true
+docs_section: compositor
+---
+
+# Organiza un curso con sitios de estudiantes {#organiza-un-curso-con-sitios-de-estudiantes}
+
+Un curso comparte una colección de objetos con los sitios de los grupos de estudiantes. Cada grupo construye su exhibición; los docentes pueden entrar a ella desde la pantalla del curso.
+
+La creación de cursos aparece solo en las cuentas con acceso a esa función. Si no ves la opción, puedes crear un sitio de exhibición normal.
+
+## Crea la colección del curso {#crea-la-colección-del-curso}
+
+Al crear un proyecto, elige la opción de curso. Agrega los objetos con los que trabajará la clase y revisa títulos, créditos y direcciones de las fuentes.
+
+Prepara una historia breve de ejemplo y la [guía rápida del taller](/empezar/) antes de la sesión. Los estudiantes necesitan un recorrido técnico y una pregunta que puedan investigar con los materiales.
+
+Abre la administración del curso con su contraseña de acceso cuando se solicite. Mantén esa contraseña separada de los códigos que compartes con los estudiantes.
+
+## Comparte un código de clase {#comparte-un-código-de-clase}
+
+Abre **Curso**, elige **Nuevo código** y selecciona la opción para la clase. Agrega una etiqueta que permita distinguir las secciones y define un vencimiento cuando corresponda.
+
+Los estudiantes ingresan el código al crear su sitio. La persona responsable de un sitio existente también puede ingresarlo en su configuración. Al unirse, el sitio queda vinculado al curso y recibe su colección.
+
+El grupo debe unir su sitio con el código de clase; no debe usar un código para docentes.
+
+## Agrega al equipo docente {#agrega-al-equipo-docente}
+
+Crea un código separado para docentes. Quien lo usa se une como docente, así que compártelo solo con el equipo previsto.
+
+La pantalla del curso enumera los sitios inscritos y sus integrantes. Abre un sitio desde esa lista para revisar historias y acompañar la autoría. El acceso docente depende de la pertenencia al curso.
+
+## Administra el curso {#administra-el-curso}
+
+Desactiva un código cuando ya no deba admitir a nadie. Esto no retira los sitios ni docentes que ya se unieron.
+
+Sacar un sitio del curso permite que el grupo continúe por su cuenta. El sitio conserva como objetos normales los materiales que recibió y los docentes pierden el acceso derivado del curso. Lee la confirmación antes de retirarlo.
+
+## Entiende qué protege el código {#entiende-qué-protege-el-código}
+
+El código controla quién se une al curso. No restringe el acceso a imágenes externas. Estas permanecen en los servidores de sus manifiestos; un código de clase o una clave de historia no vuelve privada una imagen pública.
+
+Revisa las condiciones de publicación del material antes de compartirlo mediante un curso.
+
+**Antes del taller:** prueba el ingreso con un ejemplo docente, confirma la colección y comparte el enlace corto de la guía. Usa [la guía de planeación](/guia/planear/) para el ejercicio narrativo.
diff --git a/content/es/guia/el-compositor/editor-historias.md b/content/es/guia/el-compositor/editor-historias.md
new file mode 100644
index 0000000..b7f0a2b
--- /dev/null
+++ b/content/es/guia/el-compositor/editor-historias.md
@@ -0,0 +1,96 @@
+---
+title: Editor de historias
+url: /guia/el-compositor/editor-historias/
+translationKey: docs-the-compositor-story-editor
+type: guide
+docs_section: compositor
+---
+
+# Editor de historias {#editor-de-historias}
+
+Abre una historia desde **Historias** para escribir sus preguntas, respuestas breves y paneles opcionales. El editor reúne el esquema narrativo, los textos editables y la vista que tendrán tus visitantes.
+
+La barra lateral usa un **cuadrado** para la portada, **círculos** para los pasos y un **triángulo hacia arriba** para el último paso. El primer panel se desprende de su paso; el segundo se desprende del primero.
+
+<span class="anchor-alias" id="tarjeta-de-título" aria-hidden="true"></span>
+
+{{< media id="editor-overview" >}}
+
+## Portada {#portada}
+
+Selecciona la portada en la parte superior del esquema. Haz clic en el título, el subtítulo o la firma, o en el icono de edición correspondiente, para cambiar el campo. Tus cambios se guardan mientras trabajas.
+
+<span class="anchor-alias" id="selector-de-objetos" aria-hidden="true"></span>
+
+## Visor IIIF {#visor-iiif}
+
+Selecciona un paso con imagen y usa **Cambiar objeto** para elegir su fuente. Desplaza la imagen y ajusta el zoom hasta el detalle que quieras mostrar.
+
+Para guardar la vista:
+
+1. Selecciona el paso.
+2. Desplaza la imagen y ajusta el zoom al encuadre deseado.
+3. Pulsa **Capturar posición**.
+4. Comprueba la confirmación **Capturada**.
+5. Pasa a la portada o a otro paso; después, regresa y revisa el encuadre guardado.
+
+{{< callout "note" >}}
+Mover la imagen y ajustar el zoom te permite explorar el objeto. **Capturar posición** guarda el encuadre del paso seleccionado. Vuelve a capturarlo si cambias la vista que quieres conservar.
+{{< /callout >}}
+
+{{< media id="framing" >}}
+
+Las guías indican el marco y el centro de la vista. El límite del texto ayuda a ver cuánto de la respuesta breve cabe en la tarjeta pública.
+
+## Gestión de pasos {#gestión-de-pasos}
+
+- **+ Agregar paso** crea un paso. Si el diálogo ofrece el objeto anterior, puedes conservarlo o elegir otro.
+- **Cambiar objeto** selecciona otra fuente para el paso actual.
+- Arrastra un paso desde su control de orden para cambiar su posición.
+- Usa el control de eliminación y lee la confirmación antes de quitar un paso.
+- **Agregar título de sección** inserta un encabezado para agrupar partes de la historia.
+
+Escribe una pregunta y una respuesta breve en cada tarjeta. Haz clic en el texto o en su icono de edición. El campo de respuesta acepta Markdown; haz clic fuera para revisar el texto con formato.
+
+Los pasos de video y audio tienen controles de medios en lugar del visor de imágenes. Consulta [Video y audio](/guia/el-compositor/video-y-audio/).
+
+## Edición de capas {#edición-de-capas}
+
+Pulsa **+ Agregar panel** en la tarjeta de un paso o abre un panel existente con su botón. Edita el título y el contenido directamente desde el texto o los iconos de edición. El primer panel puede ofrecer un botón para abrir un segundo panel.
+
+Mantén breve la respuesta principal. Usa los paneles para el contexto, la evidencia y los matices que una persona pueda elegir explorar.
+
+{{< media id="panels" >}}
+
+### Barra de formato {#barra-de-formato}
+
+Al editar el contenido de un panel, usa los controles de formato o escribe Markdown directamente. Revisa el panel con formato al terminar. Consulta [Sintaxis de Markdown](/guia/tu-contenido/sintaxis-markdown/) y [Contenido enriquecido](/guia/tu-contenido/contenido-enriquecido/).
+
+{{< media id="panel-editor" >}}
+
+### Atajos de teclado {#atajos-de-teclado}
+
+Los atajos dependen del campo que tenga el foco. Mantén el foco en el editor de texto al aplicar un comando de formato. Usa la barra de herramientas si no sabes qué comando está disponible.
+
+### Inserción de imágenes {#inserción-de-imágenes}
+
+Usa los controles de imágenes del editor de paneles y completa los datos que solicite el diálogo. Una imagen dentro del panel hace parte de la explicación; la fuente principal del paso se elige por separado con **Cambiar objeto**.
+
+<span class="anchor-alias" id="pegado-enriquecido" aria-hidden="true"></span>
+
+### Pegado con formato {#pegado-con-formato}
+
+Al traer texto de otra aplicación, revisa el formato, los enlaces y el espaciado del panel antes de publicar.
+
+<span class="anchor-alias" id="preservación-de-inserciones" aria-hidden="true"></span>
+
+### Conservación de inserciones {#conservación-de-inserciones}
+
+Para agregar medios y contenido interactivo dentro de los paneles, sigue [Contenido enriquecido](/guia/tu-contenido/contenido-enriquecido/) y [Widgets](/guia/tu-contenido/widgets/). Revisa el resultado publicado además de la vista del editor.
+
+## Véase también {#véase-también}
+
+- [Usar un objeto IIIF en una historia](/guia/el-compositor/iiif-a-historia/)
+- [Inicio y navegación](/guia/el-compositor/panel-de-control/)
+- [Video y audio](/guia/el-compositor/video-y-audio/)
+- [Publicación](/guia/el-compositor/publicacion/)
diff --git a/content/es/guia/el-compositor/equipo.md b/content/es/guia/el-compositor/equipo.md
new file mode 100644
index 0000000..8c2c605
--- /dev/null
+++ b/content/es/guia/el-compositor/equipo.md
@@ -0,0 +1,44 @@
+---
+title: Trabaja en equipo
+url: /guia/el-compositor/equipo/
+translationKey: docs-the-compositor-team
+type: guide
+docs_draft: true
+docs_section: compositor
+---
+
+# Trabaja en equipo {#trabaja-en-equipo}
+
+Los integrantes editan el mismo proyecto en el Compositor. El rol del proyecto y el acceso al repositorio de GitHub están relacionados, pero son distintos: alguien puede editar en el Compositor mientras tiene pendiente una invitación de GitHub.
+
+## Invita a otra persona {#invita-a-otra-persona}
+
+La persona responsable puede usar los controles del equipo para elegir **+ Invitar colaborador** e ingresar el nombre de usuario de GitHub.
+
+Si esa persona ya tiene cuenta en el Compositor, el proyecto puede agregarse a su cuenta. De lo contrario, el Compositor proporciona un enlace que debes compartir antes de 48 horas. Revisa las invitaciones pendientes si todavía no se ha unido.
+
+Invita la cuenta que la persona usa para iniciar sesión. Su nombre visible o correo no son su nombre de usuario de GitHub.
+
+## Entiende los roles {#entiende-los-roles}
+
+- La **persona responsable**, identificada como **Coordinador/a**, administra los integrantes y los ajustes estructurales.
+- Un **colaborador** edita contenido y puede publicar, subir archivos y ejecutar una actualización.
+- Un **docente** recibe acceso editorial mediante un curso y tiene los mismos permisos de publicación.
+
+Algunos controles estructurales, como crear entradas del glosario y cambiar sus IDs, corresponden a la persona responsable. La eliminación también tiene en cuenta quién creó el elemento. La interfaz indica cuándo tu rol no permite una acción.
+
+## Revisa el acceso al repositorio {#revisa-el-acceso-al-repositorio}
+
+Abre **Acceso al repositorio** para consultar el estado en GitHub de cada integrante. Las invitaciones pendientes deben aceptarse; la persona responsable puede renovar las vencidas.
+
+Cada integrante puede aceptar su invitación en esta página o abrirla en GitHub si el Compositor no logra aceptarla. La persona responsable puede agregar o retirar acceso de otros integrantes donde la interfaz lo permita.
+
+La publicación utiliza la aplicación de GitHub instalada. Publicar desde el Compositor no confirma que todos hayan aceptado su acceso personal a GitHub.
+
+## Coordina las ediciones y la publicación {#coordina-las-ediciones-y-la-publicación}
+
+Espera a que se establezca la conexión de colaboración antes de comenzar. Acuerden quién editará cada pasaje y quién publicará los cambios compartidos. Revisen juntos la lista de publicación cuando hayan trabajado varias personas.
+
+Retirar a alguien elimina su acceso al proyecto. Los docentes se administran desde el curso y no pueden retirarse individualmente mientras el sitio siga vinculado a él.
+
+**Comprueba el resultado:** pídele a la persona invitada que inicie sesión, abra el proyecto correcto y confirme su rol. Sigue con [los proyectos de curso](/guia/el-compositor/cursos/) si vas a trabajar con una clase.
diff --git a/content/es/guia/el-compositor/glosario.md b/content/es/guia/el-compositor/glosario.md
new file mode 100644
index 0000000..f41ed2f
--- /dev/null
+++ b/content/es/guia/el-compositor/glosario.md
@@ -0,0 +1,53 @@
+---
+title: Crea y enlaza entradas del glosario
+url: /guia/el-compositor/glosario/
+translationKey: docs-the-compositor-glossary
+type: guide
+docs_draft: true
+docs_section: compositor
+---
+
+# Crea y enlaza entradas del glosario {#crea-y-enlaza-entradas-del-glosario}
+
+Usa el glosario para definiciones y contexto que puedan servir en varios lugares. Cada entrada tiene un ID para los enlaces, un título visible, un tipo y una definición.
+
+## Agrega una entrada {#agrega-una-entrada}
+
+1. Abre **Glosario** en la navegación principal.
+2. Si eres responsable del sitio, elige **+ Nuevo término**.
+3. Escribe un título claro y una definición que se entienda por sí sola.
+4. Elige el tipo: palabra clave, fuente primaria, persona o entidad, o lugar.
+5. Revisa la vista previa para lectores.
+
+La persona responsable agrega y elimina entradas y cambia sus IDs. Los demás integrantes pueden trabajar en el contenido de las entradas existentes. Si no aparece el control de creación, pídele a la persona responsable que agregue el término.
+
+{{< media id="glossary" >}}
+
+## Enlázala desde una historia {#enlázala-desde-una-historia}
+
+En el editor de texto de un panel, usa **Insertar enlace de glosario** y busca el término. Elige un texto personalizado si la frase requiere otra expresión.
+
+También puedes escribir el enlace:
+
+```text
+[[khipu]]
+[[khipu|cuerdas anudadas]]
+```
+
+Antes de la barra vertical va el ID, no el título visible. Usa el ID de la entrada que creaste. Revisa el enlace en la vista previa y después en el sitio publicado.
+
+## Revisa dónde se usa {#revisa-dónde-se-usa}
+
+La lista de usos muestra referencias en historias, páginas y otros términos. Abre cada referencia para revisar su contexto antes de cambiar una definición de la que dependen varios pasajes.
+
+Una definición breve debe resolver la duda inmediata del lector. Lleva una discusión extensa sobre una fuente al panel de ese paso y enlaza el glosario cuando necesites contexto compartido.
+
+## Cambia un ID o un tipo con cuidado {#cambia-un-id-o-un-tipo-con-cuidado}
+
+La persona responsable puede cambiar el ID. El Compositor actualiza sus enlaces internos, pero la dirección pública cambia al publicar. Los enlaces compartidos fuera del proyecto seguirán apuntando a la dirección anterior.
+
+**Editar tipos** permite agregar categorías propias con un ID, una etiqueta para el panel y un encabezado para la página del glosario. Escribe esas etiquetas en el idioma de la exhibición.
+
+Eliminar una entrada deja sus referencias sin resolver. Revisa primero dónde se usa y reemplaza o retira los enlaces antes de publicar.
+
+**Comprueba el resultado:** abre el término desde un panel, revisa el texto visible y vuelve al mismo paso. Sigue con [el inicio y las páginas](/guia/el-compositor/paginas/).
diff --git a/content/es/guia/el-compositor/iiif-a-historia.md b/content/es/guia/el-compositor/iiif-a-historia.md
new file mode 100644
index 0000000..b0c4aef
--- /dev/null
+++ b/content/es/guia/el-compositor/iiif-a-historia.md
@@ -0,0 +1,115 @@
+---
+title: Usar un objeto IIIF en una historia
+url: /guia/el-compositor/iiif-a-historia/
+translationKey: docs-the-compositor-iiif-to-story
+type: guide
+docs_section: compositor
+---
+
+# Usar un objeto IIIF en una historia {#usar-un-objeto-iiif-en-una-historia}
+
+<p class="lede">Conecta una imagen alojada en otra colección con tu exhibición, úsala en un paso y captura el encuadre que quieres mostrar al público.</p>
+
+<div class="manual-meta"><span>Antes de empezar: un sitio y una historia que puedas editar</span><span>Ejemplo: el manifiesto IIIF de un khipu</span></div>
+
+<p>Si el khipu ya está en tu colección, puedes ir directamente a <a href="#elegir">Úsalo en un paso</a>.</p>
+
+<div class="manual-note"><p><strong>Tres acciones distintas:</strong> agregar un objeto lo deja disponible en el Compositor. Elegirlo en un paso lo incorpora a tu historia. Publicar envía tus cambios al repositorio para que el sitio se vuelva a construir.</p></div>
+
+<nav class="manual-toc" aria-label="En esta página"><strong>En esta guía</strong><ol>
+<li><a href="#abrir">Abre la ventana de importación</a></li><li><a href="#obtener">Obtén el manifiesto</a></li><li><a href="#metadatos">Revisa el objeto</a></li><li><a href="#elegir">Úsalo en un paso</a></li><li><a href="#encuadrar">Captura el encuadre</a></li><li><a href="#contexto">Agrega contexto</a></li><li><a href="#publicar">Publica y comprueba</a></li><li><a href="#problemas">Si algo no funciona</a></li>
+</ol></nav>
+
+## 1. Abre la ventana de importación {#abrir}
+
+Abre **Objetos**, pulsa **+ Agregar objeto** y elige **Manifiesto IIIF**.
+
+Un manifiesto IIIF describe un objeto e indica al visor dónde cargar sus imágenes. Usa la dirección del manifiesto que proporciona la colección.
+
+## 2. Obtén el manifiesto {#obtener}
+
+Pega este ejemplo en **URL del manifiesto IIIF** y pulsa **Obtener manifiesto**.
+
+<pre class="manifest-code" id="manifest-url">https://juancobo.com/138la/iiif/khipu/p7/manifest.json</pre>
+<button class="copy-button" type="button" data-copy="manifest-url">Copiar URL del manifiesto</button>
+
+
+
+Espera a que aparezca la vista previa. Este ejemplo lleva el título “Haptic khipu — Taking a sample from the khipu for radio-carbon dating, Spring 2025”.
+
+## 3. Revisa el objeto {#metadatos}
+
+Revisa **Título**, **Creador**, **Año**, **Descripción**, **Fuente** y **Crédito**. Es posible que el proveedor incluya solo algunos datos. Conserva la información de fuente y crédito, y completa lo que falte con información de catálogo confiable.
+
+Desplázate dentro de la ventana para revisar los demás campos.
+
+El idioma de la interfaz no traduce los metadatos del manifiesto. Puedes revisar su redacción para tu exhibición.
+
+{{< media id="import" >}}
+
+Pulsa **Agregar objeto**. El objeto debe aparecer en tu colección. Abre su ficha para comprobar la imagen y agregar una **Descripción para accesibilidad**.
+
+
+
+## 4. Úsalo en un paso {#elegir}
+
+1. Abre **Historias** y elige la historia que vas a editar.
+2. Pulsa **+ Agregar paso**.
+3. Si aparece la opción de conservar el objeto anterior, elige **Elegir otro objeto**.
+4. Selecciona el khipu en el selector de objetos. También puedes usar **Cambiar objeto** en un paso existente.
+
+El paso debe mostrar la imagen importada. Escribe una pregunta y una respuesta breve. Para este ejercicio puedes usar:
+
+**Pregunta:** ¿Qué actividad se documenta en esta imagen?
+
+**Respuesta:** Una toma de muestra de un khipu para datación por radiocarbono, en la primavera de 2025.
+
+Estas frases describen el ejemplo. Tu propia historia debe desarrollar las preguntas que quieres explorar con el público.
+
+{{< media id="editor-overview" >}}
+
+## 5. Captura el encuadre {#encuadrar}
+
+1. Desplaza y amplía la imagen hasta mostrar el detalle que quieres presentar.
+2. Usa las guías de encuadre para comprender el área que conservará el paso.
+3. Pulsa **Capturar posición**.
+4. Comprueba que el control confirme **Capturada**.
+
+<div class="manual-note"><p><strong>Captura después de encuadrar.</strong> Mover el visor te permite explorar el objeto. Capturar posición guarda la vista de este paso. Vuelve a capturarla si cambias el encuadre que quieres conservar.</p></div>
+
+Pasa a otro paso y regresa. Comprueba que se haya conservado el encuadre que elegiste.
+
+{{< media id="framing" >}}
+
+## 6. Agrega contexto {#contexto}
+
+En la tarjeta del paso, pulsa **+ Agregar panel**. Si el paso ya tiene un panel, ábrelo con el botón correspondiente. Usa los iconos de edición del título y del texto del panel para escribir su contenido.
+
+Por ejemplo, explica cómo la imagen ayuda a explorar tu pregunta y enlaza la fuente del objeto.
+
+Mantén la respuesta breve legible en la tarjeta del paso. Usa los paneles para los detalles que ayudan a comprender la evidencia.
+
+## 7. Publica y comprueba {#publicar}
+
+Abre **Publicar** y revisa los cambios. Corrige los errores que bloqueen la publicación y revisa las advertencias antes de publicar.
+
+Cuando termine la construcción del sitio, abre la historia publicada y comprueba que:
+
+- El nuevo paso muestre el objeto correcto.
+- El encuadre muestre el detalle que capturaste.
+- La pregunta, la respuesta y el panel se lean correctamente.
+- La fuente, el crédito y la descripción para accesibilidad del objeto sean adecuados.
+
+## Si algo no funciona {#problemas}
+
+**El manifiesto no carga.** Revisa la dirección completa e intenta abrirla en un navegador. La dirección debe devolver un manifiesto IIIF. Una página de catálogo o un archivo de imagen son recursos distintos.
+
+**Faltan metadatos.** Revisa el catálogo de la colección y completa los campos correspondientes. Los datos importados dependen de lo que incluya el proveedor.
+
+**La imagen aparece en Objetos, pero no en la historia.** Abre el paso y comprueba qué objeto tiene seleccionado.
+
+**El encuadre publicado es distinto.** Vuelve a encuadrar el paso, pulsa **Capturar posición**, publica y comprueba que la construcción termine.
+
+**El sitio en línea todavía muestra el contenido anterior.** Revisa el estado de la publicación y de la construcción. Editar el borrador y publicarlo son operaciones distintas.
+
+<p><a href="/manual/review/">Revisar el guion propuesto y sus textos exactos →</a></p>
diff --git a/content/es/guia/el-compositor/objetos.md b/content/es/guia/el-compositor/objetos.md
new file mode 100644
index 0000000..896fac6
--- /dev/null
+++ b/content/es/guia/el-compositor/objetos.md
@@ -0,0 +1,106 @@
+---
+title: Objetos
+url: /guia/el-compositor/objetos/
+translationKey: docs-the-compositor-objects
+type: guide
+docs_section: compositor
+---
+
+# Objetos {#objetos}
+
+La página de objetos en el Compositor te permite explorar, editar y agregar los elementos visuales que componen tu exhibición. Cada objeto que administras aquí — imágenes, manifiestos IIIF, videos, archivos de audio — se registra en el archivo `objects.csv` de tu repositorio. El Compositor se encarga de ese archivo por ti, así que nunca necesitas editarlo directamente.
+
+## Lista de objetos {#lista-de-objetos}
+
+La lista muestra los objetos con su miniatura, ID, usos y estado. Cada objeto muestra:
+
+- Una **miniatura** de vista previa de la imagen o el medio
+- El **título** del objeto
+- Un **indicador de estado** que muestra su condición actual
+
+### Indicadores de estado {#indicadores-de-estado}
+
+El estado informa sobre la disponibilidad; no significa que la ficha de catálogo ya esté completamente revisada.
+
+- **Listo** — El objeto tiene título y supera la comprobación de imagen cuando corresponde.
+- **Sin metadatos** — Falta el título. Revisa la ficha y completa el título y la información útil de catálogo.
+- **Sin teselas** — La imagen aún no está disponible. En archivos alojados por el sitio, revisa el build y las teselas; en fuentes externas, revisa el manifiesto.
+- **No está en el repositorio** — La ficha está marcada como ausente del repositorio. Revisa la comparación con GitHub antes de decidir qué conservar.
+
+### Control de destacados {#control-de-destacados}
+
+Puedes marcar cualquier objeto como destacado. Los objetos destacados aparecen de manera prominente en la página de inicio de tu sitio y en la galería de objetos.
+
+Para cambiar el estado de destacado de un objeto, haz clic en el indicador de destacado en la fila del objeto.
+
+{{< media id="objects" >}}
+
+## Editar metadatos {#editar-metadatos}
+
+Selecciona un objeto para abrir su editor de metadatos. Aquí puedes completar o actualizar la información que describe al objeto en tu exhibición.
+
+Los campos de metadatos son:
+
+| Campo | Descripción |
+|---|---|
+| **Título** | El nombre del objeto como aparece en tu sitio |
+| **Creador** | La persona u organización que creó el objeto |
+| **Año** | Cuándo se creó o publicó el objeto |
+| **Descripción** | Un resumen breve de lo que el objeto muestra o contiene |
+| **Fuente** | De dónde proviene el objeto — una colección, archivo o URL |
+| **Texto alternativo** | Una descripción para lectores de pantalla y accesibilidad |
+| **Género / Medio** | El tipo de objeto — fotografía, pintura, mapa, manuscrito, etc. |
+
+{{< callout "tip" >}}
+El texto alternativo es importante para la accesibilidad. Escribe una oración breve y descriptiva que transmita lo que muestra la imagen a quien no puede verla.
+{{< /callout >}}
+
+{{< media id="object-metadata" >}}
+
+## Agregar IIIF externo {#agregar-iiif-externo}
+
+1. Abre **Objetos** y pulsa **+ Agregar objeto**.
+2. Selecciona **Manifiesto IIIF**.
+3. Pega la URL y pulsa **Obtener manifiesto**.
+4. Revisa la vista previa, el título, la fuente, el crédito y los demás metadatos disponibles.
+5. Pulsa **Agregar objeto**.
+
+Agregar el objeto lo deja disponible en la colección. Debes seleccionarlo por separado en un paso con **Cambiar objeto**.
+
+Sigue [Usar un objeto IIIF en una historia](/guia/el-compositor/iiif-a-historia/) para el ejemplo ilustrado completo del khipu. Consulta [Imágenes IIIF externas](/guia/tu-contenido/iiif-externo/) para más contexto.
+
+{{< media id="import" >}}
+
+## Subir imágenes {#subir-imágenes}
+
+Puedes subir tus propias imágenes directamente a través del Compositor. Las imágenes subidas se confirman en tu repositorio y las teselas IIIF se generan automáticamente durante el siguiente *build*.
+
+1. Haz clic en **Agregar objeto** y selecciona la opción de subida
+2. Arrastra archivos al área de subida, o haz clic para seleccionar archivos desde tu computador
+3. Completa los metadatos mientras se procesa la subida
+4. Guarda el objeto en tu proyecto
+
+Los formatos admitidos son JPG, PNG y TIFF, con un tamaño máximo de 25 MB por imagen.
+
+{{< callout "note" >}}
+Después de subir, el estado del objeto puede mostrar **Sin teselas** hasta que publiques y el *build* de GitHub Actions genere las teselas IIIF. El objeto sigue siendo utilizable en el Compositor — las teselas estarán disponibles en tu sitio en línea después de que se complete el *build*.
+{{< /callout >}}
+
+## Guardar en el repositorio {#guardar-en-el-repositorio}
+
+Cuando guardas cambios en los objetos — ya sea editando metadatos, agregando IIIF o subiendo imágenes — esos cambios se guardan en el borrador del Compositor. Para enviarlos a GitHub, necesitas publicar.
+
+Al publicar se confirma un archivo `objects.csv` actualizado en tu repositorio junto con cualquier imagen subida. Consulta [Publicación](/guia/el-compositor/publicacion/) para el flujo de trabajo completo.
+
+## Sincronización {#sincronización}
+
+Cuando los objetos cambian fuera del Compositor, usa la revisión de **Cambios en GitHub** del proyecto. Lee las diferencias y elige qué versión conservar antes de aplicarlas. Consulta [Sincronización y actualizaciones](/guia/el-compositor/sincronizacion-y-actualizaciones/).
+
+Editar un borrador y publicar son acciones distintas. Revisa las consecuencias para el objeto afectado en vez de volver a importar todo el proyecto.
+
+## Véase también {#véase-también}
+
+- [Inicio y navegación](/guia/el-compositor/panel-de-control/) — Regresa a la vista general del proyecto
+- [Objetos](/guia/tu-contenido/objetos/) — Cómo funcionan los objetos en Telar
+- [Imágenes IIIF externas](/guia/tu-contenido/iiif-externo/) — Información sobre manifiestos IIIF y fuentes
+- [Imágenes autoalojadas](/guia/tu-contenido/imagenes-autoalojadas/) — Cómo las imágenes subidas se convierten en teselas IIIF
diff --git a/content/es/guia/el-compositor/paginas.md b/content/es/guia/el-compositor/paginas.md
new file mode 100644
index 0000000..f103429
--- /dev/null
+++ b/content/es/guia/el-compositor/paginas.md
@@ -0,0 +1,53 @@
+---
+title: Organiza el inicio y las páginas
+url: /guia/el-compositor/paginas/
+translationKey: docs-the-compositor-pages
+type: guide
+docs_draft: true
+docs_section: compositor
+---
+
+# Organiza el inicio y las páginas {#organiza-el-inicio-y-las-páginas}
+
+Abre **Inicio y páginas** para editar la presentación de la exhibición, organizar el menú y crear páginas de apoyo.
+
+## Edita la página de inicio {#edita-la-página-de-inicio}
+
+Selecciona **Inicio**, que aparece fijo en la barra lateral. Edita el título y la descripción, el texto de bienvenida y los encabezados o introducciones de las secciones de historias y objetos.
+
+Estos campos presentan toda la exhibición. Explica qué puede explorar el público y ofrece un punto de entrada claro. Deja la introducción extensa de cada historia dentro de ella.
+
+Organiza las tarjetas en el orden de lectura que prefieras. Las historias en borrador se excluyen de la publicación. La presentación de la colección se ajusta en **Configuración del sitio**; los metadatos y el estado destacado de los objetos se editan en **Objetos**.
+
+{{< media id="homepage" >}}
+
+## Agrega una página de apoyo {#agrega-una-página-de-apoyo}
+
+1. Elige **Agregar página**.
+2. Escribe un título, por ejemplo, Presentación, Equipo o Metodología.
+3. Redacta el contenido con el editor de texto.
+4. Revisa su URL y la vista previa del menú.
+
+Una página sirve para información que debe estar disponible fuera de las historias: créditos, participantes, métodos de investigación o agradecimientos. No tiene la secuencia de pasos con encuadres de una historia.
+
+Si el Compositor encuentra páginas existentes en el repositorio, ofrece importarlas. Revisa su contenido antes de reemplazarlo o duplicarlo.
+
+{{< media id="pages" >}}
+
+## Organiza el menú {#organiza-el-menú}
+
+Usa la vista previa de navegación para ordenar los enlaces y seleccionar la página que quieres editar. Los nombres deben ser breves y reconocibles.
+
+Que Inicio esté fijo en la barra lateral del editor no obliga a que sea el primer enlace del menú público. Comprueba el orden en la vista previa del menú.
+
+## Revisa las direcciones {#revisa-las-direcciones}
+
+Cada página necesita una URL propia y no puede ocupar una dirección reservada por el sitio. El Compositor explica los conflictos junto al campo.
+
+El cambio de dirección se aplica al publicar. Los enlaces anteriores dejarán de llevar a la página. Actualiza los enlaces del contenido y los lugares donde la hayas compartido.
+
+## Comprueba el recorrido completo {#comprueba-el-recorrido-completo}
+
+Después de publicar, empieza en el inicio y abre todos los enlaces del menú. Revisa títulos, contenido y orden de historias. Guardar un cambio en el editor todavía no modifica el sitio público.
+
+Sigue con [la apariencia y la configuración](/guia/el-compositor/configuracion/).
diff --git a/content/es/guia/el-compositor/panel-de-control.md b/content/es/guia/el-compositor/panel-de-control.md
new file mode 100644
index 0000000..b0e6083
--- /dev/null
+++ b/content/es/guia/el-compositor/panel-de-control.md
@@ -0,0 +1,69 @@
+---
+title: Inicio y navegación
+url: /guia/el-compositor/panel-de-control/
+translationKey: docs-the-compositor-dashboard
+type: guide
+docs_section: compositor
+---
+
+<span class="anchor-alias" id="panel-de-control" aria-hidden="true"></span>
+
+# Inicio y navegación {#inicio-y-navegación}
+
+La página **Inicio** presenta el proyecto activo, muestra su actividad reciente y enlaza con las partes principales del Compositor. La navegación superior permite pasar entre **Objetos**, **Historias**, **Glosario**, **Inicio y páginas**, **Configuración del sitio** y **Publicar**.
+
+## Vista previa del sitio {#vista-previa-del-sitio}
+
+Edita el contenido de la página pública de tu exhibición en **Inicio y páginas**. **Inicio** ofrece una presentación del proyecto; no es el editor de la página pública.
+
+## Mensaje de bienvenida {#mensaje-de-bienvenida}
+
+Abre **Inicio y páginas** para editar la introducción que ven tus visitantes. Revisa el título, la descripción y el idioma de la interfaz pública en **Configuración del sitio**. Publica cuando quieras llevar esos cambios al sitio público.
+
+## Historias {#historias}
+
+La página **Historias** reúne las narrativas de tu exhibición.
+
+### Ver y abrir historias {#ver-y-abrir-historias}
+
+Pulsa **Editar** en una historia para abrir el [editor de historias](/guia/el-compositor/editor-historias/). Cada fila muestra el título y el número de pasos.
+
+### Crear una historia nueva {#crear-una-historia-nueva}
+
+1. Pulsa **+ Nueva historia**.
+2. Escribe un título y, si lo necesitas, un subtítulo y una firma.
+3. Pulsa **Guardar** para crear la historia y abrir su editor.
+
+### Reordenar historias {#reordenar-historias}
+
+Arrastra una historia desde su control de orden para cambiar cómo aparece en el sitio público. El nuevo orden se incluye cuando publicas.
+
+### Eliminar una historia {#eliminar-una-historia}
+
+Usa **Eliminar historia** y lee la confirmación antes de continuar. El sitio público cambia cuando publicas la eliminación. Si borraste algo por error, revisa si está disponible **Deshacer**.
+
+<span class="anchor-alias" id="controles-de-borrador-y-privacidad" aria-hidden="true"></span>
+
+### Controles de borrador y privado {#controles-de-borrador-y-privado}
+
+- **Borrador** excluye una historia de la exhibición pública. Úsalo para preparar trabajo que todavía no deba aparecer.
+- **Privado** controla el acceso al contenido de la historia. Lee [Historias privadas](/guia/funciones/historias-privadas/) antes de usarlo en un proyecto.
+
+{{< media id="stories" >}}
+
+## Cambiar de proyecto {#cambiar-de-proyecto}
+
+Usa el nombre del proyecto en el encabezado para cambiar entre sitios conectados. Cada sitio tiene su propia colección, historias y cambios sin publicar.
+
+## Barra de estado {#barra-de-estado}
+
+El encabezado muestra el estado de la conexión y si hay cambios sin publicar. Espera a que la conexión esté lista antes de editar. Usa **Publicar** para revisar los cambios y seguir la generación del sitio.
+
+El control de colaboración abre información sobre el equipo y su actividad. Desde el menú de usuario puedes entrar a **Cuenta**, donde **Idioma de la interfaz** cambia las etiquetas del Compositor. No traduce los textos de la exhibición; el idioma de su interfaz pública se configura por separado.
+
+## Véase también {#véase-también}
+
+- [Guía rápida para talleres](/empezar/) — Un recorrido breve por la primera historia
+- [Objetos](/guia/el-compositor/objetos/) — Agregar y administrar fuentes
+- [Editor de historias](/guia/el-compositor/editor-historias/) — Componer pasos y paneles
+- [Publicación](/guia/el-compositor/publicacion/) — Revisar y publicar
diff --git a/docs/9-1-getting-started.es.md b/content/es/guia/el-compositor/primeros-pasos.md
similarity index 53%
rename from docs/9-1-getting-started.es.md
rename to content/es/guia/el-compositor/primeros-pasos.md
index bc8b008..2273a87 100644
--- a/docs/9-1-getting-started.es.md
+++ b/content/es/guia/el-compositor/primeros-pasos.md
@@ -1,18 +1,18 @@
---
-layout: docs
-title: "9.1. Primeros pasos"
-parent: "9. El Compositor"
-grand_parent: Documentación
-nav_order: 1
-lang: es
-permalink: /guia/el-compositor/primeros-pasos/
+title: Conectar un sitio existente
+url: /guia/el-compositor/primeros-pasos/
+translationKey: docs-the-compositor-getting-started
+type: guide
+docs_section: compositor
---
-# Primeros pasos con el Compositor
+<span class="anchor-alias" id="primeros-pasos-con-el-compositor" aria-hidden="true"></span>
-Esta página te guía a través del inicio de sesión en el Compositor, la conexión de un repositorio y la importación de tu contenido. Al final, tendrás tu exhibición cargada en el Compositor y lista para editar.
+# Conectar un sitio existente {#conectar-un-sitio-existente}
-## Requisitos previos
+Usa esta guía cuando tu repositorio Telar ya exista. Para empezar un proyecto nuevo, sigue [Crear tu primer sitio](/guia/primeros-pasos/compositor/).
+
+## Requisitos previos {#requisitos-previos}
Antes de comenzar, asegúrate de tener:
@@ -20,7 +20,7 @@ Antes de comenzar, asegúrate de tener:
- Un **repositorio de Telar** — crea uno a partir de la [plantilla de Telar](https://github.com/UCSB-AMPLab/telar) (consulta [Usar el Compositor](/guia/primeros-pasos/compositor/) para instrucciones paso a paso)
- **GitHub Pages habilitado** — en la configuración del repositorio, pon la fuente de Pages en **GitHub Actions**
-## Iniciar sesión
+## Iniciar sesión {#iniciar-sesión}
El Compositor usa tu cuenta de GitHub para la autenticación y la publicación. No se necesita una cuenta separada.
@@ -28,7 +28,7 @@ El Compositor usa tu cuenta de GitHub para la autenticación y la publicación.
2. Haz clic en **Iniciar sesión con GitHub**
3. Autoriza el Compositor de Telar cuando GitHub te lo solicite
-## Instalar la aplicación de GitHub
+## Instalar la aplicación de GitHub {#instalar-la-aplicación-de-github}
En tu primer inicio de sesión, el Compositor te pide instalar la aplicación de GitHub de Telar. Esta aplicación le da al Compositor permiso para leer y escribir en tus repositorios.
@@ -36,10 +36,11 @@ En tu primer inicio de sesión, el Compositor te pide instalar la aplicación de
2. Elige si deseas conceder acceso a todos los repositorios o solo a algunos específicos
3. Confirma la instalación
-{: .tip }
-> Si solo quieres que el Compositor acceda a un repositorio, selecciona **Only select repositories** y elige el repositorio de la lista. Puedes cambiar esto después en la configuración de GitHub, en **Applications**.
+{{< callout "tip" >}}
+Si solo quieres que el Compositor acceda a un repositorio, selecciona **Only select repositories** y elige el repositorio de la lista. Puedes cambiar esto después en la configuración de GitHub, en **Applications**.
+{{< /callout >}}
-## Conectar un repositorio
+## Conectar un repositorio {#conectar-un-repositorio}
Después de iniciar sesión, selecciona con qué repositorio quieres trabajar.
@@ -49,20 +50,15 @@ Después de iniciar sesión, selecciona con qué repositorio quieres trabajar.
Si el repositorio se creó a partir de la plantilla de Telar y tiene contenido en `telar-content/`, el Compositor lo importa automáticamente.
-## Importar desde Google Sheets
-
-Si tu sitio de Telar usa Google Sheets como fuente de datos, el Compositor puede importar directamente desde tu hoja de cálculo.
+## Importar desde Google Sheets {#importar-desde-google-sheets}
-1. Cuando el Compositor detecta una URL de Google Sheets en la configuración del sitio, ofrece importar desde Sheets
-2. Confirma la importación para traer el contenido actual al Compositor
-3. Después de tu primera publicación a través del Compositor, puedes deshabilitar opcionalmente la conexión con Google Sheets — el Compositor se convierte en tu editor principal
+Si el sitio usa Google Sheets, sigue la importación y las comprobaciones de configuración que muestre el Compositor. Revisa el contenido importado y cualquier solicitud de desactivar la conexión con Sheets antes de continuar con la autoría visual.
-{: .note }
-> Importar desde Google Sheets no elimina ni modifica tu hoja de cálculo. Los datos se copian al Compositor para que puedas editarlos visualmente.
+La importación no elimina la hoja de cálculo. Decide qué método de autoría administrará los cambios futuros; no supongas que editar en el Compositor actualiza automáticamente la hoja original.
-## Después de importar
+## Después de importar {#después-de-importar}
-Una vez que la importación se completa, llegas al [Panel de control](/guia/el-compositor/panel-de-control/). Desde allí puedes:
+Después de la importación y las comprobaciones de configuración, usa la [navegación principal](/guia/el-compositor/panel-de-control/) para:
- Ver y administrar tus historias
- Explorar y editar tus objetos
@@ -70,8 +66,8 @@ Una vez que la importación se completa, llegas al [Panel de control](/guia/el-c
El contenido importado se guarda en el servidor. Los cambios que hagas no se envían a GitHub hasta que publiques — así que puedes explorar y experimentar libremente.
-## Véase también
+## Véase también {#véase-también}
-- [Panel de control](/guia/el-compositor/panel-de-control/) — Navega tu proyecto y administra historias
+- [Inicio y navegación](/guia/el-compositor/panel-de-control/) — Navega tu proyecto y administra historias
- [Objetos](/guia/el-compositor/objetos/) — Explora, edita y agrega objetos
- [Usar el Compositor](/guia/primeros-pasos/compositor/) — Crear un repositorio y habilitar GitHub Pages
diff --git a/docs/9-6-publishing.es.md b/content/es/guia/el-compositor/publicacion.md
similarity index 76%
rename from docs/9-6-publishing.es.md
rename to content/es/guia/el-compositor/publicacion.md
index db0cd82..55fb082 100644
--- a/docs/9-6-publishing.es.md
+++ b/content/es/guia/el-compositor/publicacion.md
@@ -1,24 +1,22 @@
---
-layout: docs
-title: "9.6. Publicación"
-parent: "9. El Compositor"
-grand_parent: Documentación
-nav_order: 6
-lang: es
-permalink: /guia/el-compositor/publicacion/
+title: Publicación
+url: /guia/el-compositor/publicacion/
+translationKey: docs-the-compositor-publishing
+type: guide
+docs_section: compositor
---
-# Publicación
+# Publicación {#publicación}
La publicación envía tus cambios del Compositor a tu repositorio de GitHub. Hasta que publiques, todas las ediciones — de objetos, historias y configuraciones — se guardan en el servidor. Al publicar se crea un solo *commit* en tu repositorio, se activa un *build* de GitHub Pages y tus cambios se hacen visibles en tu sitio.
-## Resumen de cambios
+## Resumen de cambios {#resumen-de-cambios}
Antes de publicar, el Compositor muestra un resumen de todo lo que ha cambiado desde tu última publicación. Esto te permite revisar tu trabajo antes de confirmar.
El resumen de cambios lista adiciones, modificaciones y eliminaciones en tu proyecto — objetos nuevos, pasos de historias editados, metadatos actualizados y cualquier otro cambio que hayas hecho. Revisa este resumen con cuidado para asegurarte de que refleja lo que deseas publicar.
-## Validación previa a la publicación
+## Validación previa a la publicación {#validación-previa-a-la-publicación}
El Compositor valida tu proyecto antes de permitirte publicar. La validación detecta problemas que podrían causar inconvenientes en tu sitio en línea.
@@ -27,13 +25,15 @@ Hay dos niveles de validación:
- **Errores** — Problemas críticos que bloquean la publicación. Por ejemplo, un campo obligatorio podría faltar o una historia podría hacer referencia a un objeto que no existe. Debes corregir los errores antes de publicar.
- **Advertencias** — Problemas no críticos que no bloquean la publicación pero vale la pena revisar. Por ejemplo, un objeto podría no tener texto alternativo o una historia podría tener un solo paso. Puedes publicar con advertencias, pero resolverlas mejora tu exhibición.
-## Publicar
+{{< media id="upgrade" >}}
-Cuando estés listo, haz clic en el botón de publicar. El Compositor crea un solo *commit* atómico en tu repositorio de GitHub que contiene todos tus cambios. El *commit* se atribuye a tu cuenta de GitHub — tu nombre y correo electrónico aparecen en el historial de *commits* del repositorio, no los del Compositor.
+## Publicar {#publicar}
-La publicación activa un *build* de GitHub Pages automáticamente. No necesitas visitar GitHub ni ejecutar pasos adicionales.
+Cuando estés listo, usa el control de publicación. El Compositor envía los cambios revisados al repositorio mediante su App de GitHub instalada. El cuerpo del commit registra **Published by @tu-usuario-de-github**.
-## Seguimiento del *build*
+Publicar y terminar la generación del sitio son etapas distintas. Sigue el estado de la generación antes de revisar el sitio público.
+
+## Seguimiento del *build* {#seguimiento-del-build}
Después de publicar, el Compositor hace seguimiento del progreso del *build* de GitHub Pages en tiempo real. Un indicador de progreso muestra el estado actual:
@@ -44,11 +44,11 @@ Después de publicar, el Compositor hace seguimiento del progreso del *build* de
Si un *build* falla, el Compositor muestra la información del error para que puedas diagnosticar el problema. Las causas comunes incluyen YAML inválido en archivos de configuración o archivos requeridos faltantes. Puedes corregir el problema y publicar de nuevo.
-## Después de publicar
+## Después de publicar {#después-de-publicar}
Una vez que el *build* se completa correctamente, el Compositor proporciona un enlace directo a tu sitio en línea. Haz clic en él para ver tus cambios publicados de inmediato.
-## Editor de configuración
+## Editor de configuración {#editor-de-configuración}
El Compositor incluye un editor de configuración para los ajustes esenciales del sitio. En lugar de editar el archivo `_config.yml` directamente a través de GitHub, puedes actualizar campos clave a través de un formulario en el Compositor.
@@ -56,12 +56,13 @@ El editor de configuración te permite cambiar ajustes como el título del sitio
Si el archivo `_config.yml` de tu sitio está escrito de una forma que no le permite al Compositor guardar en él los ajustes de **Configuración del sitio**, la página **Publicar** te avisa y te ofrece reescribir el archivo. Haz clic en **Revisar la reescritura** para ver qué va a pasar. El Compositor rehace `_config.yml` a partir de la plantilla de la versión de Telar que usa tu sitio y conserva tal cual los ajustes propios de tu archivo. La revisión te muestra qué ajustes van a quedar con el valor de **Configuración del sitio** o de la plantilla, y qué líneas no puede leer el Compositor y por eso se van a quitar. Los comentarios entre ajustes no se conservan. Cuando haces clic en **Aceptar la reescritura**, el Compositor escribe el archivo nuevo la próxima vez que publiques; el anterior queda en el historial de tu sitio en GitHub. Cualquier persona con permiso para editar **Configuración del sitio** puede aceptar la reescritura.
-{: .note }
-> El editor de configuración cubre los ajustes de uso más común. Para opciones de configuración avanzadas, puedes seguir editando `_config.yml` directamente en tu repositorio. Consulta [Configuración](/guia/configuracion/) para la referencia completa.
+{{< callout "note" >}}
+El editor de configuración cubre los ajustes de uso más común. Para opciones de configuración avanzadas, puedes seguir editando `_config.yml` directamente en tu repositorio. Consulta [Configuración](/guia/configuracion/) para la referencia completa.
+{{< /callout >}}
-## Véase también
+## Véase también {#véase-también}
- [Editor de historias](/guia/el-compositor/editor-historias/) — Construir y editar historias
- [Objetos](/guia/el-compositor/objetos/) — Gestionar objetos en el Compositor
- [Sincronización y actualizaciones](/guia/el-compositor/sincronizacion-y-actualizaciones/) — Mantener tu proyecto sincronizado con el repositorio
-- [Panel de control](/guia/el-compositor/panel-de-control/) — Regresa a la vista general del proyecto
+- [Inicio y navegación](/guia/el-compositor/panel-de-control/) — Regresa a la vista general del proyecto
diff --git a/content/es/guia/el-compositor/sincronizacion-y-actualizaciones.md b/content/es/guia/el-compositor/sincronizacion-y-actualizaciones.md
new file mode 100644
index 0000000..3715f43
--- /dev/null
+++ b/content/es/guia/el-compositor/sincronizacion-y-actualizaciones.md
@@ -0,0 +1,57 @@
+---
+title: Sincronización y actualizaciones
+url: /guia/el-compositor/sincronizacion-y-actualizaciones/
+translationKey: docs-the-compositor-sync-updates
+type: guide
+docs_section: compositor
+---
+
+# Sincronización y actualizaciones {#sincronización-y-actualizaciones}
+
+El Compositor comprueba los cambios hechos en GitHub y las actualizaciones disponibles de Telar. Los cambios hechos fuera del editor se revisan antes de aplicarlos al borrador.
+
+## Detección al regresar {#detección-al-regresar}
+
+Al abrir un proyecto conectado, el Compositor revisa su repositorio. Si GitHub cambió, sigue el aviso para revisar las diferencias. La revisión abarca los objetos, historias, ajustes, términos del glosario y páginas afectados.
+
+<span class="anchor-alias" id="resincronización" aria-hidden="true"></span>
+
+## Resincronizar {#resincronizar}
+
+La revisión de **Cambios en GitHub** muestra las diferencias y pide elegir qué versión conservar cuando es necesario.
+
+1. Lee cada cambio y sus consecuencias.
+2. Elige la versión de GitHub o la del Compositor, según corresponda.
+3. Resuelve las decisiones que solicite la revisión.
+4. Pulsa **Aplicar estas elecciones** cuando el resultado sea el que buscas.
+
+Conservar la versión del Compositor significa que la próxima publicación enviará esa versión a GitHub. Tomar la versión de GitHub aplica el contenido correspondiente al Compositor. Los cambios sin publicar que solo existen en el Compositor se conservan.
+
+{{< callout "note" >}}
+Revisar la sincronización y publicar son acciones distintas. Lee las consecuencias de cada elemento; no uses una nueva importación como forma habitual de deshacer un pequeño error de edición.
+{{< /callout >}}
+
+Si no se puede leer un archivo o el repositorio cambia durante la revisión, sigue el mensaje y actualiza la comparación antes de aplicarla.
+
+## Detección de versión {#detección-de-versión}
+
+El Compositor comprueba la versión de Telar que usa tu sitio y puede pedir una actualización antes de continuar.
+
+## Página de actualización {#página-de-actualización}
+
+Revisa las versiones actual y de destino, las notas de la versión y los cambios agrupados por archivo. Una actualización puede cambiar archivos del framework y migrar los ajustes que necesite la nueva versión. Lee la propuesta antes de aceptarla.
+
+{{< media id="upgrade" >}}
+
+## Actualización con un clic {#actualización-con-un-clic}
+
+Sigue los controles de actualización y espera a que terminen la operación y la generación del sitio. Después, sigue el enlace de regreso. Revisa el sitio antes de continuar con el trabajo que motivó la actualización.
+
+El historial del repositorio registra los cambios de la actualización. Si algo no se ve bien, usa la información de la generación y la lista de archivos propuesta para entender qué cambió.
+
+## Véase también {#véase-también}
+
+- [Publicación](/guia/el-compositor/publicacion/)
+- [Inicio y navegación](/guia/el-compositor/panel-de-control/)
+- [Conectar un sitio existente](/guia/el-compositor/primeros-pasos/)
+- [Actualizar Telar](/guia/configuracion/actualizacion/) — Referencia de actualización del framework
diff --git a/content/es/guia/el-compositor/solucionar-problemas.md b/content/es/guia/el-compositor/solucionar-problemas.md
new file mode 100644
index 0000000..35e8aaa
--- /dev/null
+++ b/content/es/guia/el-compositor/solucionar-problemas.md
@@ -0,0 +1,44 @@
+---
+title: Resuelve problemas y recupera historias
+url: /guia/el-compositor/solucionar-problemas/
+translationKey: docs-the-compositor-troubleshooting
+type: guide
+docs_draft: true
+docs_section: compositor
+---
+
+# Resuelve problemas y recupera historias {#resuelve-problemas-y-recupera-historias}
+
+Identifica primero qué versión estás viendo: el contenido guardado en el editor, los archivos de GitHub o el sitio público generado. Cada una requiere una corrección distinta.
+
+## El editor cambió, pero el sitio no {#el-editor-cambió-pero-el-sitio-no}
+
+Guardar conserva el contenido en el Compositor. Publica los cambios y espera a que termine el build. Si la publicación terminó pero el build falló, revisa el error en lugar de publicar repetidamente los mismos cambios.
+
+Confirma el repositorio y el idioma en el encabezado y abre la dirección pública desde el proyecto. Una pestaña puede seguir mostrando una versión anterior; recárgala después del build exitoso.
+
+## Hay un objeto o encuadre incorrecto {#hay-un-objeto-o-encuadre-incorrecto}
+
+Abre el objeto y revisa su dirección de origen. Una ficha de catálogo no es un manifiesto IIIF. Usa **Obtener manifiesto** para comprobar la dirección y revisa la vista previa antes de agregar otro objeto.
+
+Si la historia muestra otra imagen, selecciona el objeto correcto en ese paso. Si muestra la imagen correcta con otra vista, elige la página del documento cuando corresponda, ajusta el encuadre y usa **Capturar posición**. Espera la confirmación y vuelve a visitar el paso.
+
+## GitHub tiene otro contenido {#github-tiene-otro-contenido}
+
+Abre [Cambios en GitHub](/guia/el-compositor/sincronizacion-y-actualizaciones/) y revisa los elementos afectados. Decide qué versión conservar en cada caso. La revisión conserva el trabajo sin publicar que solo existe en el editor; no es una orden para descartarlo todo.
+
+Si Google Sheets está activo, revisa si un build descargó contenido de la hoja. Decide qué método alimentará los próximos builds antes de volver a editar ambas copias.
+
+## Recupera una historia que no aparece {#recupera-una-historia-que-no-aparece}
+
+Si hay archivos de historias en GitHub que no están en el Compositor, **Inicio** puede ofrecer a la persona responsable **Restaurar como borradores**.
+
+La restauración lee esos archivos y trae las historias como borradores. Lee los avisos, abre cada historia y revisa sus pasos y referencias a paneles antes de habilitarla para publicar.
+
+**Ignorar** descarta esta opción de recuperación para las historias detectadas. No equivale a eliminar sus archivos de GitHub.
+
+## Falta un control o se rechaza una acción {#falta-un-control-o-se-rechaza-una-acción}
+
+Confirma tu rol y consulta [el equipo y el acceso al repositorio](/guia/el-compositor/equipo/). Algunos controles corresponden a la persona responsable; los de pertenencia a un curso se administran desde el curso.
+
+Para pedir ayuda, anota la dirección del proyecto, la acción intentada, el error visible y si ocurre al editar, publicar o generar el sitio. Comparte esos datos con quien mantiene el proyecto o en un [reporte de Telar](https://github.com/UCSB-AMPLab/telar/issues). Excluye claves de acceso y contenido privado.
diff --git a/docs/9-5-video-audio.es.md b/content/es/guia/el-compositor/video-y-audio.md
similarity index 80%
rename from docs/9-5-video-audio.es.md
rename to content/es/guia/el-compositor/video-y-audio.md
index aed802b..0844608 100644
--- a/docs/9-5-video-audio.es.md
+++ b/content/es/guia/el-compositor/video-y-audio.md
@@ -1,20 +1,18 @@
---
-layout: docs
-title: "9.5. Video y audio"
-parent: "9. El Compositor"
-grand_parent: Documentación
-nav_order: 5
-lang: es
-permalink: /guia/el-compositor/video-y-audio/
+title: Video y audio
+url: /guia/el-compositor/video-y-audio/
+translationKey: docs-the-compositor-video-audio
+type: guide
+docs_section: compositor
---
-# Video y audio
+# Video y audio {#video-y-audio}
El Compositor admite objetos de video y audio junto con imágenes. Cuando un paso de la historia hace referencia a un objeto de video o audio, la columna del visor muestra el reproductor de medios correspondiente — un reproductor de video insertado o un reproductor de audio con forma de onda — y ofrece herramientas para fijar los tiempos del clip y el comportamiento de bucle.
Para más información sobre cómo funcionan los objetos de video y audio en Telar, consulta [Objetos de video](/guia/tu-contenido/objetos-de-video/) y [Objetos de audio](/guia/tu-contenido/objetos-de-audio/).
-## Detección del tipo de medio
+## Detección del tipo de medio {#detección-del-tipo-de-medio}
El Compositor detecta el tipo de medio de cada objeto automáticamente a partir de su URL de origen. No necesitas configurar el tipo manualmente — el Compositor lee la URL y determina si el objeto es una imagen, un video o un archivo de audio.
@@ -24,7 +22,7 @@ Cada paso en la barra lateral muestra una insignia de tipo de medio para ayudart
- **Audio** — Un ícono de música para objetos de audio
- **Texto** — Un ícono de texto para pasos sin objeto de medio
-## Fuentes de video compatibles
+## Fuentes de video compatibles {#fuentes-de-video-compatibles}
El Compositor reconoce URLs de video de tres plataformas:
@@ -34,17 +32,19 @@ El Compositor reconoce URLs de video de tres plataformas:
Cuando un paso hace referencia a un objeto de video, un reproductor de video en línea aparece en la columna del visor con controles de reproducción estándar.
-## Objetos de audio
+{{< media id="external-media" >}}
+
+## Objetos de audio {#objetos-de-audio}
Los objetos de audio utilizan archivos autoalojados almacenados en tu repositorio en `telar-content/objects/`. El Compositor admite formatos MP3, OGG y M4A.
Cuando un paso hace referencia a un objeto de audio, la columna del visor muestra un reproductor de forma de onda WaveSurfer. La forma de onda ofrece una representación visual del audio e incluye controles de reproducción y pausa.
-## Recortar el clip
+## Recortar el clip {#recortar-el-clip}
Un clip es el segmento de un archivo de video o de audio que se reproduce durante un paso. Lo defines arrastrando en el visor, en vez de escribir marcas de tiempo en una hoja de cálculo.
-### Video
+### Video {#video}
Debajo del video hay una línea de tiempo que abarca el archivo completo: el clip aparece como una franja resaltada y una marca fina indica por dónde va la reproducción.
@@ -54,35 +54,37 @@ Debajo del video hay una línea de tiempo que abarca el archivo completo: el cli
Los tiempos de los dos extremos de la barra son el comienzo y el final del clip, y en el medio se lee su duración: **Clip de 0:07**. Cada vez que cambias el rango, esa duración da paso por un momento a la confirmación **Clip guardado**.
-### Audio
+### Audio {#audio}
El audio no tiene una línea de tiempo aparte: la región del clip va sobre la onda misma. Arrastra sus extremos para fijar el comienzo y el final.
-### Comprobar el clip
+### Comprobar el clip {#comprobar-el-clip}
Debajo del reproductor, el clip vigente se lee `Clip 0:05 → 0:12`. Si el paso reproduce el archivo completo, ahí dice **Sin clip definido**.
**Previsualizar fragmento** reproduce el clip solo, para que veas exactamente lo que le va a llegar al público sin tener que aguantar el resto del archivo.
-{: .note }
-> Los videos de Google Drive no se pueden recortar. En lugar de los tiempos del clip, el visor muestra **Google Drive no admite recorte de clips**.
+{{< callout "note" >}}
+Los videos de Google Drive no se pueden recortar. En lugar de los tiempos del clip, el visor muestra **Google Drive no admite recorte de clips**.
+{{< /callout >}}
-{: .tip }
-> El Compositor fija los mismos valores `clip_start` y `clip_end` que describen [Objetos de video](/guia/tu-contenido/objetos-de-video/) y [Objetos de audio](/guia/tu-contenido/objetos-de-audio/). Son intercambiables: puedes definir el clip aquí y editarlo después en la hoja de cálculo, o al revés.
+{{< callout "tip" >}}
+El Compositor fija los mismos valores `clip_start` y `clip_end` que describen [Objetos de video](/guia/tu-contenido/objetos-de-video/) y [Objetos de audio](/guia/tu-contenido/objetos-de-audio/). Son intercambiables: puedes definir el clip aquí y editarlo después en la hoja de cálculo, o al revés.
+{{< /callout >}}
-## Control de bucle
+## Control de bucle {#control-de-bucle}
Cada paso tiene un interruptor **Repetir** que determina si el clip se repite continuamente cuando el público llega a ese paso. Cuando está activado, el clip se reproduce en bucle hasta que el público avanza al siguiente paso.
La configuración de bucle se conserva al guardar y se aplica tanto a pasos de video como de audio.
-## Género y medio
+## Género y medio {#género-y-medio}
Los objetos tienen un campo de tipo que se corresponde con la columna `medium_genre` en `objects.csv`. El Compositor gestiona este campo a través del editor de metadatos de [Objetos](/guia/el-compositor/objetos/) — puedes configurarlo al agregar o editar un objeto.
El valor de género o medio ayuda a la galería de objetos a organizar los elementos por tipo y proporciona contexto adicional para el público al explorar la exhibición.
-## Véase también
+## Véase también {#véase-también}
- [Editor de historias](/guia/el-compositor/editor-historias/) — Construir historias con el editor visual
- [Publicación](/guia/el-compositor/publicacion/) — Revisar y publicar cambios
diff --git a/content/es/guia/ensenar/_index.md b/content/es/guia/ensenar/_index.md
new file mode 100644
index 0000000..c4cf230
--- /dev/null
+++ b/content/es/guia/ensenar/_index.md
@@ -0,0 +1,11 @@
+---
+title: Enseñar con Telar
+url: /guia/ensenar/
+translationKey: docs-teaching
+type: guide
+extra_css:
+- teaching-contact
+docs_section: teaching
+---
+
+{{< section-overview >}}
diff --git a/content/es/guia/ensenar/solicitar-acceso.md b/content/es/guia/ensenar/solicitar-acceso.md
new file mode 100644
index 0000000..76cad20
--- /dev/null
+++ b/content/es/guia/ensenar/solicitar-acceso.md
@@ -0,0 +1,13 @@
+---
+title: Solicita acceso al modo docente
+url: /guia/ensenar/solicitar-acceso/
+translationKey: docs-teaching-request-access
+type: guide
+docs_hub: true
+extra_css:
+- showcase
+- teaching-contact
+docs_section: teaching
+---
+
+{{< teaching-request >}}
diff --git a/content/es/guia/estructura-de-contenido/_index.md b/content/es/guia/estructura-de-contenido/_index.md
new file mode 100644
index 0000000..15fd367
--- /dev/null
+++ b/content/es/guia/estructura-de-contenido/_index.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/estructura-de-contenido/
+translationKey: redirects-es-estructura-contenido-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/tu-contenido/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/estructura-de-contenido/glosario.md b/content/es/guia/estructura-de-contenido/glosario.md
new file mode 100644
index 0000000..4f21fbc
--- /dev/null
+++ b/content/es/guia/estructura-de-contenido/glosario.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/estructura-de-contenido/glosario/
+translationKey: redirects-es-ec-glosario-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/funciones/glosario/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/estructura-de-contenido/historias-paneles.md b/content/es/guia/estructura-de-contenido/historias-paneles.md
new file mode 100644
index 0000000..6d16417
--- /dev/null
+++ b/content/es/guia/estructura-de-contenido/historias-paneles.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/estructura-de-contenido/historias-paneles/
+translationKey: redirects-es-ec-historias-paneles-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/tu-contenido/historias-paneles/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/estructura-de-contenido/historias-privadas.md b/content/es/guia/estructura-de-contenido/historias-privadas.md
new file mode 100644
index 0000000..04f6ede
--- /dev/null
+++ b/content/es/guia/estructura-de-contenido/historias-privadas.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/estructura-de-contenido/historias-privadas/
+translationKey: redirects-es-ec-historias-privadas-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/funciones/historias-privadas/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/estructura-de-contenido/objetos-galeria.md b/content/es/guia/estructura-de-contenido/objetos-galeria.md
new file mode 100644
index 0000000..4244c11
--- /dev/null
+++ b/content/es/guia/estructura-de-contenido/objetos-galeria.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/estructura-de-contenido/objetos-galeria/
+translationKey: redirects-es-ec-objetos-galeria-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/tu-contenido/objetos/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/estructura-de-contenido/paginas-personalizadas.md b/content/es/guia/estructura-de-contenido/paginas-personalizadas.md
new file mode 100644
index 0000000..4d75945
--- /dev/null
+++ b/content/es/guia/estructura-de-contenido/paginas-personalizadas.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/estructura-de-contenido/paginas-personalizadas/
+translationKey: redirects-es-ec-paginas-personalizadas-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/funciones/paginas-personalizadas/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/estructura-de-contenido/widgets.md b/content/es/guia/estructura-de-contenido/widgets.md
new file mode 100644
index 0000000..ed37239
--- /dev/null
+++ b/content/es/guia/estructura-de-contenido/widgets.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/estructura-de-contenido/widgets/
+translationKey: redirects-es-ec-widgets-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/tu-contenido/widgets/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/flujos-de-trabajo/_index.md b/content/es/guia/flujos-de-trabajo/_index.md
new file mode 100644
index 0000000..23b02b9
--- /dev/null
+++ b/content/es/guia/flujos-de-trabajo/_index.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/flujos-de-trabajo/
+translationKey: redirects-es-ft-flujos-de-trabajo-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/configuracion/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/flujos-de-trabajo/actualizacion.md b/content/es/guia/flujos-de-trabajo/actualizacion.md
new file mode 100644
index 0000000..bb245e1
--- /dev/null
+++ b/content/es/guia/flujos-de-trabajo/actualizacion.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/flujos-de-trabajo/actualizacion/
+translationKey: redirects-es-ft-actualizacion-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/configuracion/actualizacion/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/flujos-de-trabajo/desarrollo-local.md b/content/es/guia/flujos-de-trabajo/desarrollo-local.md
new file mode 100644
index 0000000..ef7f7d2
--- /dev/null
+++ b/content/es/guia/flujos-de-trabajo/desarrollo-local.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/flujos-de-trabajo/desarrollo-local/
+translationKey: redirects-es-ft-desarrollo-local-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/primeros-pasos/desarrollo-local/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/flujos-de-trabajo/google-sheets.md b/content/es/guia/flujos-de-trabajo/google-sheets.md
new file mode 100644
index 0000000..e694aa7
--- /dev/null
+++ b/content/es/guia/flujos-de-trabajo/google-sheets.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/flujos-de-trabajo/google-sheets/
+translationKey: redirects-es-ft-google-sheets-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/tus-datos/google-sheets/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/flujos-de-trabajo/hibrido.md b/content/es/guia/flujos-de-trabajo/hibrido.md
new file mode 100644
index 0000000..79e037a
--- /dev/null
+++ b/content/es/guia/flujos-de-trabajo/hibrido.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/flujos-de-trabajo/hibrido/
+translationKey: redirects-es-ft-hibrido-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/tu-contenido/contenido-enriquecido/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/flujos-de-trabajo/inicio-rapido-guiado.md b/content/es/guia/flujos-de-trabajo/inicio-rapido-guiado.md
new file mode 100644
index 0000000..2c2555f
--- /dev/null
+++ b/content/es/guia/flujos-de-trabajo/inicio-rapido-guiado.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/flujos-de-trabajo/inicio-rapido-guiado/
+translationKey: redirects-es-ft-inicio-rapido-guiado-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/primeros-pasos/google-sheets/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/flujos-de-trabajo/insercion.md b/content/es/guia/flujos-de-trabajo/insercion.md
new file mode 100644
index 0000000..0728a31
--- /dev/null
+++ b/content/es/guia/flujos-de-trabajo/insercion.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/flujos-de-trabajo/insercion/
+translationKey: redirects-es-ft-insercion-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/funciones/insercion/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/flujos-de-trabajo/interfaz-web-github.md b/content/es/guia/flujos-de-trabajo/interfaz-web-github.md
new file mode 100644
index 0000000..dc4d084
--- /dev/null
+++ b/content/es/guia/flujos-de-trabajo/interfaz-web-github.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/flujos-de-trabajo/interfaz-web-github/
+translationKey: redirects-es-ft-interfaz-web-github-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/configuracion/configuracion-manual/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/docs/6-0-site-features.es.md b/content/es/guia/funciones/_index.md
similarity index 85%
rename from docs/6-0-site-features.es.md
rename to content/es/guia/funciones/_index.md
index 267c821..db38523 100644
--- a/docs/6-0-site-features.es.md
+++ b/content/es/guia/funciones/_index.md
@@ -1,14 +1,12 @@
---
-layout: docs
-title: 6. Funciones del sitio
-parent: Documentación
-nav_order: 6
-lang: es
-permalink: /guia/funciones/
-has_children: true
+title: Funciones del sitio
+url: /guia/funciones/
+translationKey: docs-site-features
+type: guide
+docs_section: reference
---
-# Funciones del sitio
+# Funciones del sitio {#funciones-del-sitio}
Telar incluye varias funciones integradas que enriquecen tu exhibición más allá de la experiencia básica de las historias.
diff --git a/docs/6-1-objects-gallery.es.md b/content/es/guia/funciones/galeria-objetos.md
similarity index 83%
rename from docs/6-1-objects-gallery.es.md
rename to content/es/guia/funciones/galeria-objetos.md
index e106c30..ad5f87b 100644
--- a/docs/6-1-objects-gallery.es.md
+++ b/content/es/guia/funciones/galeria-objetos.md
@@ -1,22 +1,20 @@
---
-layout: docs
-title: "6.1. Galería de objetos"
-parent: "6. Funciones del sitio"
-grand_parent: Documentación
-nav_order: 1
-lang: es
-permalink: /guia/funciones/galeria-objetos/
+title: Galería de objetos
+url: /guia/funciones/galeria-objetos/
+translationKey: docs-site-features-objects-gallery
+type: guide
+docs_section: reference
---
-# Galería de objetos
+# Galería de objetos {#galería-de-objetos}
La galería de objetos ofrece una interfaz navegable y con búsqueda para tu colección en `/objects/`.
-## Página de la galería
+## Página de la galería {#página-de-la-galería}
Hay dos modos, controlados por la opción `browse_and_search` en tu `_config.yml`:
-### Modo de exploración y búsqueda
+### Modo de exploración y búsqueda {#modo-de-exploración-y-búsqueda}
Cuando `browse_and_search` es `true` (el valor predeterminado), la galería incluye una **barra lateral de filtros** y una **barra de búsqueda** para explorar tu colección.
@@ -54,11 +52,11 @@ Los objetos de video y audio muestran miniaturas con iconos de marcador de posic
Los filtros y términos de búsqueda activos aparecen como etiquetas removibles sobre la cuadrícula. Haz clic en **Clear all** para reiniciar.
-### Modo de cuadrícula simple
+### Modo de cuadrícula simple {#modo-de-cuadrícula-simple}
Cuando `browse_and_search` es `false`, la galería muestra una cuadrícula sencilla de tarjetas de objetos sin filtros ni búsqueda.
-### Completar los metadatos de la galería
+### Completar los metadatos de la galería {#completar-los-metadatos-de-la-galería}
Para la mejor experiencia en la galería, completa estas columnas en tu `objects.csv`:
@@ -70,10 +68,11 @@ Para la mejor experiencia en la galería, completa estas columnas en tu `objects
Sin estas columnas, la galería sigue funcionando, pero las opciones de filtrado y ordenación son limitadas.
-{: .note }
-> Los objetos agregados o subidos a través del Compositor aparecen en la galería después de publicar.
+{{< callout "note" >}}
+Los objetos agregados o subidos a través del Compositor aparecen en la galería después de publicar.
+{{< /callout >}}
-## Objetos destacados en la página principal
+## Objetos destacados en la página principal {#objetos-destacados-en-la-página-principal}
Puedes mostrar una selección de objetos en tu página principal marcándolos como destacados:
@@ -88,7 +87,7 @@ collection_interface:
La página principal muestra hasta `featured_count` objetos (predeterminado: 4). Si marcas menos objetos como destacados de lo que permite el conteo, los espacios restantes se llenan aleatoriamente de tu colección.
-### Enlace a objetos en la página principal
+### Enlace a objetos en la página principal {#enlace-a-objetos-en-la-página-principal}
El enlace "View the objects" en la página principal se controla por separado:
@@ -99,7 +98,7 @@ collection_interface:
Aunque el enlace esté oculto, la página de la galería sigue accesible a través del menú de navegación.
-## Configuración
+## Configuración {#configuración}
Todas las opciones de la galería están bajo `collection_interface` en `_config.yml`:
@@ -111,9 +110,9 @@ collection_interface:
featured_count: 4 # Cantidad de objetos en la página principal
```
-Consulta la [Referencia de configuración](/guia/configurar/configuracion/#collection-interface-settings) para detalles completos de cada opción.
+Consulta la [Referencia de configuración](/guia/configurar/configuracion/#ajustes-de-la-interfaz-de-colección) para detalles completos de cada opción.
-## Véase también
+## Véase también {#véase-también}
- [Objetos](/guia/tu-contenido/objetos/) — Definir objetos y páginas de objetos
- [Columnas de objetos](/guia/tus-datos/csv-objetos/) — Referencia completa de columnas para objects.csv
diff --git a/docs/6-2-glossary.es.md b/content/es/guia/funciones/glosario.md
similarity index 77%
rename from docs/6-2-glossary.es.md
rename to content/es/guia/funciones/glosario.md
index fa1a3a7..16364cb 100644
--- a/docs/6-2-glossary.es.md
+++ b/content/es/guia/funciones/glosario.md
@@ -1,22 +1,23 @@
---
-layout: docs
-title: "6.2. Glosario"
-parent: "6. Funciones del sitio"
-grand_parent: Documentación
-nav_order: 2
-lang: es
-permalink: /guia/funciones/glosario/
+title: Glosario
+url: /guia/funciones/glosario/
+translationKey: docs-site-features-glossary
+type: guide
+docs_section: reference
---
-# Glosario
+# Glosario {#glosario}
El glosario te permite definir términos que las personas pueden consultar sin abandonar una historia. Cuando alguien hace clic en un enlace de glosario, la definición aparece en un panel lateral deslizante.
-## Crear un glosario
+
+Para autoría visual, consulta [cómo crear y enlazar entradas](/guia/el-compositor/glosario/).
+
+## Crear un glosario {#crear-un-glosario}
Hay dos formas de definir términos de glosario. El formato CSV (nuevo en v0.8.0) es el recomendado para la mayoría de los proyectos.
-### Formato CSV (recomendado)
+### Formato CSV (recomendado) {#formato-csv-recomendado}
Agrega un archivo `glossary.csv` a `telar-content/spreadsheets/`:
@@ -34,9 +35,9 @@ Cada fila define un término:
- **`definition`** — El texto de la definición (admite Markdown básico)
- **`related_terms`** — Otros valores `term_id`, separados por `|`, para referencias cruzadas
-El formato CSV funciona con Google Sheets — la pestaña de glosario se obtiene automáticamente como los demás CSV. Los nombres de columnas pueden estar en inglés o español (consulta [Referencia CSV: Glosario](/guia/tus-datos/csv-glosario/#glossary-csv-aliases) para los alias).
+El formato CSV funciona con Google Sheets — la pestaña de glosario se obtiene automáticamente como los demás CSV. Los nombres de columnas pueden estar en inglés o español (consulta [Referencia CSV: Glosario](/guia/tus-datos/csv-glosario/#alias-del-csv-de-glosario) para los alias).
-### Formato Markdown (legado)
+### Formato Markdown (legado) {#formato-markdown-legado}
Archivos Markdown individuales en `telar-content/texts/glossary/`:
@@ -55,14 +56,15 @@ los colonizadores europeos a finales del siglo XV...
Cada archivo define un término. El cuerpo del archivo es la definición. En estos archivos, `related_terms` se escribe como una lista YAML, no con el `|` que separa los valores en el CSV: Telar no reinterpreta el frontmatter de un archivo Markdown.
-{: .note }
-> Si existen tanto un glosario CSV como archivos Markdown de glosario, Telar usa el CSV e ignora los archivos Markdown (con una advertencia en el *build*).
+{{< callout "note" >}}
+Si existen tanto un glosario CSV como archivos Markdown de glosario, Telar usa el CSV e ignora los archivos Markdown (con una advertencia en el *build*).
+{{< /callout >}}
-## Enlazar a términos del glosario
+## Enlazar a términos del glosario {#enlazar-a-términos-del-glosario}
Enlaza a términos del glosario desde el texto y los paneles de tus historias usando sintaxis de doble corchete:
-### Forma abreviada
+### Forma abreviada {#forma-abreviada}
Usa el `title` del término como texto del enlace:
@@ -72,7 +74,7 @@ El [[loom]] era central para la producción textil.
Se renderiza como: El <u>Telar</u> era central para la producción textil.
-### Texto personalizado
+### Texto personalizado {#texto-personalizado}
Usa un separador de barra vertical para especificar un texto de enlace diferente:
@@ -82,7 +84,7 @@ El [[loom|dispositivo de tejido]] era central para la producción textil.
Se renderiza como: El <u>dispositivo de tejido</u> era central para la producción textil.
-### Dónde funcionan los enlaces
+### Dónde funcionan los enlaces {#dónde-funcionan-los-enlaces}
Los autoenlaces de glosario funcionan en:
@@ -94,10 +96,11 @@ La **pregunta** del paso es un encabezado, así que los enlaces de glosario ahí
Si un `term_id` no se encuentra en el glosario, un ícono de advertencia y un mensaje de error aparecen en la salida del *build* y en el panel de la historia.
-{: .note }
-> Los términos se reconocen sin distinción de mayúsculas. `[[loom]]`, `[[Loom]]` y `[[LOOM]]` resuelven a la misma entrada, así que puedes escribir un término como mejor se lea —por ejemplo, una sigla como `[[IIIF]]`.
+{{< callout "note" >}}
+Los términos se reconocen sin distinción de mayúsculas. `[[loom]]`, `[[Loom]]` y `[[LOOM]]` resuelven a la misma entrada, así que puedes escribir un término como mejor se lea —por ejemplo, una sigla como `[[IIIF]]`.
+{{< /callout >}}
-## Experiencia de visualización
+## Experiencia de visualización {#experiencia-de-visualización}
Cuando alguien hace clic en un enlace de glosario:
@@ -111,14 +114,14 @@ La persona permanece en el paso actual de la historia durante todo el proceso
-## Consejos
+## Consejos {#consejos}
- **Mantén las definiciones concisas** — Las personas las leen en medio de una historia. Una o dos oraciones es lo ideal; guarda las explicaciones extensas para los paneles de las historias.
- **Usa términos relacionados** para construir una red de referencias cruzadas. Esto ayuda a las personas a explorar conceptos conectados.
- **Prefija los términos de demostración** con `demo-` (ej., `demo-loom`) para etiquetarlos como contenido de demostración.
- **Prueba tus enlaces** construyendo el sitio y revisando las advertencias de glosario en la salida del *build*.
-## Véase también
+## Véase también {#véase-también}
- [Referencia CSV: Glosario](/guia/tus-datos/csv-glosario/) — Referencia completa de columnas del CSV de glosario y alias
- [Historias y Paneles](/guia/tu-contenido/historias-paneles/) — Dónde se usan los enlaces de glosario
diff --git a/docs/6-3-private-stories.es.md b/content/es/guia/funciones/historias-privadas.md
similarity index 84%
rename from docs/6-3-private-stories.es.md
rename to content/es/guia/funciones/historias-privadas.md
index 1ca3461..749a05f 100644
--- a/docs/6-3-private-stories.es.md
+++ b/content/es/guia/funciones/historias-privadas.md
@@ -1,20 +1,18 @@
---
-layout: docs
-title: "6.3. Historias privadas"
-parent: "6. Funciones del sitio"
-grand_parent: Documentación
-nav_order: 3
-lang: es
-permalink: /guia/funciones/historias-privadas/
+title: Historias privadas
+url: /guia/funciones/historias-privadas/
+translationKey: docs-site-features-private-stories
+type: guide
+docs_section: reference
---
-# Historias privadas
+# Historias privadas {#historias-privadas}
Las historias privadas se encriptan para que solo las personas con la clave correcta puedan leerlas. Usa esta función para compartir historias en desarrollo con colaboradores, restringir el acceso a materiales de clase o mantener contenido sensible fuera de la vista pública.
**Nuevo en v0.8.0.**
-## Cómo funciona
+## Cómo funciona {#cómo-funciona}
Telar construye todas las historias — privadas o no — con las mismas plantillas. Durante el *build* de Jekyll, una historia privada se genera exactamente igual que una abierta. Solo cuando el *build* termina, un paso aparte la encripta:
@@ -28,11 +26,11 @@ El título y subtítulo de la historia permanecen visibles en el listado del pro
-## Configuración
+## Configuración {#configuración}
Se necesitan dos cosas: una clave en tu configuración y una marca en cada historia que desees proteger.
-### 1. Establece la clave de historia
+### 1. Establece la clave de historia {#1-establece-la-clave-de-historia}
Agrega `story_key` a tu `_config.yml`:
@@ -42,7 +40,7 @@ story_key: "tu-clave-secreta"
Esta clave se usa para encriptar todas las historias protegidas. Elige algo fácil de recordar pero difícil de adivinar.
-### 2. Marca las historias como privadas
+### 2. Marca las historias como privadas {#2-marca-las-historias-como-privadas}
En tu `project.csv`, establece la columna `privada` en `yes` para cada historia que quieras encriptar:
@@ -54,10 +52,11 @@ order,story_id,title,subtitle,privada
Las historias sin `privada: yes` permanecen públicas.
-{: .note }
-> `protected` y `protegida` también funcionan como nombres de columna — Telar los trata igual que `private`/`privada`. Los sitios nuevos y los ejemplos de esta documentación usan `private`/`privada`.
+{{< callout "note" >}}
+`protected` y `protegida` también funcionan como nombres de columna — Telar los trata igual que `private`/`privada`. Los sitios nuevos y los ejemplos de esta documentación usan `private`/`privada`.
+{{< /callout >}}
-## Probar localmente
+## Probar localmente {#probar-localmente}
Ni `bundle exec jekyll serve` ni el modo por defecto de `scripts/build_local_site.py` (servir) encriptan nada: Jekyll regenera `_site` continuamente mientras sirve el sitio, y la encriptación es un paso único que corre cuando un *build* termina. **Al previsualizar así, las historias privadas se ven como contenido legible, en texto plano.** Es el comportamiento esperado, no un error: el comando con el que se construye el sitio al publicarlo todavía no ha corrido.
@@ -69,17 +68,17 @@ python3 scripts/build_local_site.py --build-only
Luego sirve el directorio `_site/` resultante con un servidor de archivos estáticos (por ejemplo, `python3 -m http.server` desde dentro de `_site/`). Esto ejecuta el mismo paso de encriptación que el *build* de GitHub Actions, así que también puede fallar como fallaría un *build* real — mira Fallos del *build* más abajo.
-## Compartir historias protegidas
+## Compartir historias protegidas {#compartir-historias-protegidas}
Hay dos formas en que las personas pueden desbloquear una historia protegida:
-### Formulario de ingreso de clave
+### Formulario de ingreso de clave {#formulario-de-ingreso-de-clave}
Cuando alguien abre una historia protegida, ve una capa con un campo para ingresar la clave. Escribe la clave y presiona **Enter**. Si la clave es correcta, la capa desaparece y la historia aparece.
Si la clave es incorrecta, el formulario muestra un mensaje de error y permite intentar de nuevo.
-### Enlace con parámetro de clave
+### Enlace con parámetro de clave {#enlace-con-parámetro-de-clave}
Puedes compartir un enlace directo que incluya la clave como parámetro de URL:
@@ -89,14 +88,15 @@ https://tu-sitio.com/stories/borrador-analisis/?key=tu-clave-secreta
Las personas que abran este enlace se saltan el formulario de ingreso — la historia se desencripta automáticamente.
-{: .warning }
-> La clave es visible en la URL al compartirla de esta manera. Cualquier persona que vea el enlace (en el historial del navegador, registros de chat o correo electrónico) tendrá acceso a la historia.
+{{< callout "warning" >}}
+La clave es visible en la URL al compartirla de esta manera. Cualquier persona que vea el enlace (en el historial del navegador, registros de chat o correo electrónico) tendrá acceso a la historia.
+{{< /callout >}}
-### Caché de sesión
+### Caché de sesión {#caché-de-sesión}
Una vez que alguien desbloquea una historia, permanece desbloqueada durante el resto de su sesión de navegador. Navegar a otra página y regresar a la historia no requiere reingresar la clave. Cerrar el navegador borra el caché.
-## Consideraciones de seguridad
+## Consideraciones de seguridad {#consideraciones-de-seguridad}
La protección de historias es apenas una barrera de privacidad superficial, no una medida de seguridad. Disuade el acceso casual: quienes visitan el sitio no pueden abrir las herramientas de desarrollo del navegador y leer el contenido sin más. No protege el contenido frente a alguien decidido a obtenerlo.
@@ -113,7 +113,7 @@ La protección de historias es apenas una barrera de privacidad superficial, no
**Para una confidencialidad real**, usa un repositorio privado de GitHub. En un repositorio privado ni el sitio ni sus archivos quedan al alcance del público, así que solo pueden ver algo las personas a quienes les diste acceso al repositorio. La protección de historias, por sí sola, no sustituye a un repositorio privado cuando el contenido de verdad no debe ser leído por personas no autorizadas.
-## Fallos del *build*
+## Fallos del *build* {#fallos-del-build}
Telar se niega a publicar una historia privada en texto plano. En lugar de publicar contenido sin proteger, el *build* puede fallar en dos puntos:
@@ -122,16 +122,16 @@ Telar se niega a publicar una historia privada en texto plano. En lugar de publi
Cualquiera de los dos fallos imprime un mensaje que identifica cuál ocurrió, en inglés y en español.
-## Referencia de configuración
+## Referencia de configuración {#referencia-de-configuración}
| Opción | Ubicación | Propósito |
|--------|----------|-----------|
| `story_key` | `_config.yml` | La clave de encriptación/desencriptación |
| `private` | Columna de `project.csv` | Marca historias individuales para encriptación (también se acepta `protected`) |
-Consulta [Configuración](/guia/configurar/configuracion/#story-protection) para detalles sobre la opción `story_key`.
+Consulta [Configuración](/guia/configurar/configuracion/#protección-de-historias) para detalles sobre la opción `story_key`.
-## Véase también
+## Véase también {#véase-también}
- [Historias y Paneles](/guia/tu-contenido/historias-paneles/) — Cómo construir historias
- [Referencia CSV: Proyecto](/guia/tus-datos/csv-proyecto/) — La columna `private` en project.csv
diff --git a/docs/6-5-embedding.es.md b/content/es/guia/funciones/insercion.md
similarity index 75%
rename from docs/6-5-embedding.es.md
rename to content/es/guia/funciones/insercion.md
index 3afd422..5072c4e 100644
--- a/docs/6-5-embedding.es.md
+++ b/content/es/guia/funciones/insercion.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "6.5. Insertar en Canvas"
-parent: "6. Funciones del sitio"
-grand_parent: Documentación
-nav_order: 5
-lang: es
-permalink: /guia/funciones/insercion/
+title: Insertar historias de Telar en LMS y sitios web
+url: /guia/funciones/insercion/
+translationKey: docs-site-features-embedding
+type: guide
+docs_section: reference
---
-# Insertar historias de Telar en LMS y sitios web
+# Insertar historias de Telar en LMS y sitios web {#insertar-historias-de-telar-en-lms-y-sitios-web}
Inserta historias individuales de Telar en Canvas, Moodle, WordPress o cualquier sitio web que admita iframes.
-## ¿Qué es insertar (*embed*)?
+## ¿Qué es insertar (*embed*)? {#qué-es-insertar-embed}
Insertar te permite mostrar una historia de Telar dentro de otro sitio web o sistema de gestión del aprendizaje (LMS, por sus siglas en inglés). Tu historia aparece como parte de la página anfitriona, permitiendo que estudiantes o visitantes la exploren sin salir de la plataforma.
@@ -22,7 +20,7 @@ Insertar te permite mostrar una historia de Telar dentro de otro sitio web o sis
- Mantener navegación y marca consistentes
- Sin inicio de sesión adicional ni enlaces externos
-## Cuándo usar la inserción
+## Cuándo usar la inserción {#cuándo-usar-la-inserción}
**Ideal para:**
- Módulos de curso en Canvas LMS
@@ -35,7 +33,7 @@ Insertar te permite mostrar una historia de Telar dentro de otro sitio web o sis
- Compartir enlaces directos (usa la función de compartir enlace)
- Integración de sitio completo (enlaza a tu página de inicio de Telar)
-## Requisitos previos
+## Requisitos previos {#requisitos-previos}
Antes de insertar:
@@ -43,9 +41,9 @@ Antes de insertar:
- Necesitas acceso de edición a la plataforma de destino (Canvas, WordPress, etc.)
- La plataforma debe admitir inserción de HTML/iframe
-## Cómo insertar una historia
+## Cómo insertar una historia {#cómo-insertar-una-historia}
-### Paso 1: abre el panel de compartir e insertar
+### Paso 1: abre el panel de compartir e insertar {#paso-1-abre-el-panel-de-compartir-e-insertar}
**En una página de historia:**
@@ -59,12 +57,12 @@ Antes de insertar:
1. Ve a la página de inicio de tu sitio Telar
2. Haz clic en el botón **Share** en la barra de navegación (arriba a la derecha)
-### Paso 2: cambia a la pestaña de código de inserción
+### Paso 2: cambia a la pestaña de código de inserción {#paso-2-cambia-a-la-pestaña-de-código-de-inserción}
1. En el panel de compartir, haz clic en la pestaña **Embed Code**
2. Lee el texto introductorio para obtener orientación específica de la plataforma
-### Paso 3: selecciona una historia (solo desde la página de inicio)
+### Paso 3: selecciona una historia (solo desde la página de inicio) {#paso-3-selecciona-una-historia-solo-desde-la-página-de-inicio}
Si abriste el panel de compartir desde la página de inicio:
@@ -72,11 +70,11 @@ Si abriste el panel de compartir desde la página de inicio:
2. Elige la historia que deseas insertar
3. El código de inserción se actualizará automáticamente
-### Paso 4: elige las dimensiones
+### Paso 4: elige las dimensiones {#paso-4-elige-las-dimensiones}
Selecciona un tamaño predefinido que coincida con tu plataforma, o indica dimensiones personalizadas.
-#### Tamaños predefinidos
+#### Tamaños predefinidos {#tamaños-predefinidos}
| Tamaño predefinido | Ancho | Alto | Ideal para |
|--------|-------|--------|----------|
@@ -89,11 +87,12 @@ Selecciona un tamaño predefinido que coincida con tu plataforma, o indica dimen
| **Fixed** | 800px | 600px | Contenedores de tamaño fijo |
| **Custom** | Tu elección | Tu elección | Control manual |
-{: .tip }
-> **Sugerencia: Comienza con el tamaño predefinido**
-> Usa el tamaño predefinido para tu plataforma y luego ajusta si es necesario. La mayoría de las plataformas funcionan mejor con ancho del 100% y altura de 600-800px.
+{{< callout "tip" >}}
+**Sugerencia: Comienza con el tamaño predefinido**
+Usa el tamaño predefinido para tu plataforma y luego ajusta si es necesario. La mayoría de las plataformas funcionan mejor con ancho del 100% y altura de 600-800px.
+{{< /callout >}}
-#### Dimensiones personalizadas
+#### Dimensiones personalizadas {#dimensiones-personalizadas}
Para el tamaño predefinido **Custom** o para modificar un tamaño predefinido:
@@ -104,13 +103,14 @@ Para el tamaño predefinido **Custom** o para modificar un tamaño predefinido:
- Usualmente píxeles: `600` o `600px`
- El porcentaje funciona pero puede comportarse de manera inesperada en iframes
-{: .note }
-> **Entendiendo ancho y alto**
-> - **Ancho: 100%** llena el espacio horizontal disponible (recomendado para la mayoría de los usos)
-> - **Alto: Píxeles fijos** proporciona visualización consistente en todos los dispositivos
-> - El código de inserción agregará automáticamente "px" a números simples
+{{< callout "note" >}}
+**Entendiendo ancho y alto**
+- **Ancho: 100%** llena el espacio horizontal disponible (recomendado para la mayoría de los usos)
+- **Alto: Píxeles fijos** proporciona visualización consistente en todos los dispositivos
+- El código de inserción agregará automáticamente "px" a números simples
+{{< /callout >}}
-### Paso 5: Copia el código de inserción
+### Paso 5: Copia el código de inserción {#paso-5-copia-el-código-de-inserción}
1. Revisa el código generado en el cuadro de texto
2. Haz clic en el botón **Copy Embed Code**
@@ -127,12 +127,13 @@ El código de inserción se ve así:
</iframe>
```
-{: .tip }
-> Para iniciar una historia incrustada en un paso específico, agrega un fragmento de enlace profundo a la URL de inserción — por ejemplo, `?embed=true#s3` abre en el paso 3. Consulta [Compartir y enlaces profundos](/guia/tu-contenido/historias-paneles/#compartir-y-enlaces-profundos) para el formato del fragmento.
+{{< callout "tip" >}}
+Para iniciar una historia incrustada en un paso específico, agrega un fragmento de enlace profundo a la URL de inserción — por ejemplo, `?embed=true#s3` abre en el paso 3. Consulta [Compartir y enlaces profundos](/guia/tu-contenido/historias-paneles/#compartir-y-enlaces-profundos) para el formato del fragmento.
+{{< /callout >}}
-## Instrucciones específicas de plataforma
+## Instrucciones específicas de plataforma {#instrucciones-específicas-de-plataforma}
-### Canvas LMS
+### Canvas LMS {#canvas-lms}
**Para insertar en una página de curso de Canvas:**
@@ -145,9 +146,10 @@ El código de inserción se ve así:
7. Haz clic en **Save** o **Update**
8. Visualiza la página para ver tu historia insertada
-{: .note }
-> **Confirmación de inserción en Canvas**
-> Canvas puede mostrar un cuadro en blanco en el editor. Esto es normal—la historia se mostrará correctamente cuando veas la página publicada.
+{{< callout "note" >}}
+**Confirmación de inserción en Canvas**
+Canvas puede mostrar un cuadro en blanco en el editor. Esto es normal—la historia se mostrará correctamente cuando veas la página publicada.
+{{< /callout >}}
**Probando tu inserción:**
@@ -157,7 +159,7 @@ El código de inserción se ve así:
4. Asegúrate de que el visor de imágenes IIIF funcione
5. Verifica que el banner "View full site" aparezca (es descartable)
-### WordPress
+### WordPress {#wordpress}
**Para insertar en una publicación o página de WordPress:**
@@ -176,7 +178,7 @@ El bloque Custom HTML es el enfoque recomendado. No uses el bloque "Embed"—est
**Editor clásico:**
Cambia a la pestaña **Text** (no Visual), pega el código, luego regresa a **Visual** para ver una vista previa.
-### Moodle
+### Moodle {#moodle}
**Para insertar en un curso de Moodle:**
@@ -189,7 +191,7 @@ Cambia a la pestaña **Text** (no Visual), pega el código, luego regresa a **Vi
Alternativamente, usa el tipo de recurso **Page** y pega el código de inserción en modo HTML.
-### Otras plataformas
+### Otras plataformas {#otras-plataformas}
La mayoría de los constructores de sitios web y plataformas CMS admiten inserción de iframe:
@@ -200,9 +202,9 @@ La mayoría de los constructores de sitios web y plataformas CMS admiten inserci
Consulta la documentación de tu plataforma para instrucciones sobre cómo agregar HTML personalizado o iframes.
-## Lo que verán las personas
+## Lo que verán las personas {#lo-que-verán-las-personas}
-### Características del modo *embed*
+### Características del modo *embed* {#características-del-modo-embed}
Cuando una historia está insertada, las personas experimentan:
@@ -228,7 +230,7 @@ Cuando una historia está insertada, las personas experimentan:
- Botón de inicio (no se muestra en modo *embed*)
- Botón de compartir (no se muestra en modo *embed*)
-### Accesibilidad
+### Accesibilidad {#accesibilidad}
Las historias insertadas mantienen accesibilidad completa:
@@ -237,9 +239,9 @@ Las historias insertadas mantienen accesibilidad completa:
- Compatible con lectores de pantalla
- Contenido de texto permanece accesible
-## Consejos para una inserción exitosa
+## Consejos para una inserción exitosa {#consejos-para-una-inserción-exitosa}
-### Elige dimensiones apropiadas
+### Elige dimensiones apropiadas {#elige-dimensiones-apropiadas}
**Para plataformas LMS (Canvas, Moodle):**
- Usa ancho del 100% para llenar el área de contenido
@@ -256,7 +258,7 @@ Las historias insertadas mantienen accesibilidad completa:
- O usa ancho del 100% con altura de 500-600px
- Prueba en dispositivos móviles reales
-### Prueba antes de publicar
+### Prueba antes de publicar {#prueba-antes-de-publicar}
1. Previsualiza la historia insertada antes de hacerla pública
2. Prueba la navegación (botones, teclado, desplazamiento)
@@ -264,7 +266,7 @@ Las historias insertadas mantienen accesibilidad completa:
4. Verifica en dispositivos móviles y tabletas
5. Asegúrate de que la historia insertada no rompa el diseño de la página
-### Múltiples historias en una página
+### Múltiples historias en una página {#múltiples-historias-en-una-página}
Puedes insertar múltiples historias en una sola página:
@@ -273,7 +275,7 @@ Puedes insertar múltiples historias en una sola página:
3. Agrega texto o encabezados entre las historias insertadas
4. Considera la longitud de la página y el tiempo de carga
-### Consideraciones de seguridad
+### Consideraciones de seguridad {#consideraciones-de-seguridad}
**Las URLs de inserción son públicas:**
- Cualquier persona con el código de inserción puede ver tu historia
@@ -285,7 +287,7 @@ Puedes insertar múltiples historias en una sola página:
- Los estudiantes pueden ver la historia incluso fuera del curso accediendo a la URL directamente
- Considera esto al insertar contenido sensible
-## Actualizar historias insertadas
+## Actualizar historias insertadas {#actualizar-historias-insertadas}
**Los cambios a tu sitio Telar aparecen automáticamente en las inserciones:**
@@ -301,11 +303,12 @@ Si necesitas cambiar el ancho o alto:
2. Reemplaza el código antiguo en tu plataforma
3. Guarda/publica la actualización
-{: .tip }
-> **Sugerencia: Compatibilidad de versiones**
-> Mientras mantengas el formato de URL de inserción (`?embed=true`), las historias insertadas funcionarán a través de actualizaciones de versión de Telar.
+{{< callout "tip" >}}
+**Sugerencia: Compatibilidad de versiones**
+Mientras mantengas el formato de URL de inserción (`?embed=true`), las historias insertadas funcionarán a través de actualizaciones de versión de Telar.
+{{< /callout >}}
-## Solución de problemas
+## Solución de problemas {#solución-de-problemas}
**iframe no se muestra:**
- Verifica que el parámetro `?embed=true` esté incluido en la URL
@@ -321,7 +324,7 @@ Si necesitas cambiar el ancho o alto:
- Aumenta la altura del iframe (recomendado: 800px mínimo)
- Pon `width: 100%` para comportamiento responsivo
-## Próximos pasos
+## Próximos pasos {#próximos-pasos}
- **Enlaces para compartir**: Usa la pestaña Share Link para enlaces directos en lugar de insertar
- **Personalización**: Aprende sobre [personalizar tu sitio Telar](/guia/personalizacion/)
diff --git a/docs/6-4-custom-pages.es.md b/content/es/guia/funciones/paginas-personalizadas.md
similarity index 83%
rename from docs/6-4-custom-pages.es.md
rename to content/es/guia/funciones/paginas-personalizadas.md
index 59115ec..c529747 100644
--- a/docs/6-4-custom-pages.es.md
+++ b/content/es/guia/funciones/paginas-personalizadas.md
@@ -1,18 +1,19 @@
---
-layout: docs
-title: "6.4. Páginas personalizadas"
-parent: "6. Funciones del sitio"
-grand_parent: Documentación
-nav_order: 4
-lang: es
-permalink: /guia/funciones/paginas-personalizadas/
+title: Páginas personalizadas
+url: /guia/funciones/paginas-personalizadas/
+translationKey: docs-site-features-custom-pages
+type: guide
+docs_section: reference
---
-# Páginas personalizadas
+# Páginas personalizadas {#páginas-personalizadas}
Crea páginas personalizadas para créditos, metodología, información del equipo, o cualquier otro contenido que no encaje en la estructura de la historia.
-## ¿Qué son las páginas personalizadas?
+
+Para autoría visual, consulta [inicio y páginas](/guia/el-compositor/paginas/).
+
+## ¿Qué son las páginas personalizadas? {#qué-son-las-páginas-personalizadas}
Las páginas personalizadas son páginas independientes que aparecen en el menú de navegación de tu sitio pero no son parte del visor de historia. A diferencia de las capas de historia, que están estrechamente integradas con objetos IIIF y navegación de pasos, las páginas personalizadas son contenedores flexibles para cualquier contenido que quieras compartir.
@@ -23,9 +24,9 @@ Las páginas personalizadas son páginas independientes que aparecen en el menú
- **Bibliografía**: Lista fuentes y lecturas adicionales
- **Contacto**: Proporciona formas de ponerse en contacto
-## Crear una página personalizada
+## Crear una página personalizada {#crear-una-página-personalizada}
-### Paso 1: crea el archivo Markdown
+### Paso 1: crea el archivo Markdown {#paso-1-crea-el-archivo-markdown}
Agrega un nuevo archivo `.md` en el directorio `telar-content/texts/pages/`:
@@ -36,7 +37,7 @@ telar-content/texts/pages/
└── methodology.md # Tu página de metodología personalizada
```
-### Paso 2: escribe tu contenido
+### Paso 2: escribe tu contenido {#paso-2-escribe-tu-contenido}
Las páginas personalizadas usan Markdown estándar con soporte completo para widgets y glosario:
@@ -70,25 +71,26 @@ Este proyecto fue posible gracias a...
</details>
```
-{: .note }
-> El frontmatter (líneas `---`) es requerido pero puede estar vacío. Le indica a Jekyll que procese el archivo.
+{{< callout "note" >}}
+El frontmatter (líneas `---`) es requerido pero puede estar vacío. Le indica a Jekyll que procese el archivo.
+{{< /callout >}}
-### Paso 3: agrega a la navegación
+### Paso 3: agrega a la navegación {#paso-3-agrega-a-la-navegación}
Actualiza `_data/navigation.yml` para incluir tu nueva página en el menú. Consulta [Configuración de Navegación](/guia/personalizacion/menu-navegacion/) para más detalles.
-## Funcionalidades soportadas
+## Funcionalidades soportadas {#funcionalidades-soportadas}
Las páginas personalizadas soportan las mismas funcionalidades de Markdown que las capas de historia:
-### Formato Markdown
+### Formato Markdown {#formato-markdown}
- **Encabezados** (h1-h6)
- **Negrita**, *cursiva* y otro formato de texto
- Listas (con viñetas y numeradas)
- Enlaces e imágenes
- Citas en bloque
-### Widgets
+### Widgets {#widgets}
Todos los widgets de Telar funcionan en páginas personalizadas:
- **Acordeón**: Secciones colapsables
@@ -97,7 +99,7 @@ Todos los widgets de Telar funcionan en páginas personalizadas:
Consulta [Referencia de Sintaxis Markdown](/guia/tu-contenido/sintaxis-markdown/) para documentación completa de widgets.
-### Enlaces de glosario
+### Enlaces de glosario {#enlaces-de-glosario}
El enlace automático del glosario funciona de la misma manera:
@@ -107,7 +109,7 @@ El sistema de [[encomienda]] fue una institución clave...
Cuando las personas hacen clic en el enlace, el panel de glosario se abre con la definición.
-## Diseño y estilo
+## Diseño y estilo {#diseño-y-estilo}
Las páginas personalizadas usan el layout `user-page`, que proporciona:
@@ -118,7 +120,7 @@ Las páginas personalizadas usan el layout `user-page`, que proporciona:
También está disponible el layout convencional de Jekyll, `layout: page`, si agregas tus propios archivos Markdown con front matter: una columna de texto centrada y mínima, con el encabezado y el pie de página del sitio, pero sin procesamiento de widgets ni integración con el glosario.
-## Nombres de archivo
+## Nombres de archivo {#nombres-de-archivo}
Los nombres de archivo determinan la URL de la página:
@@ -134,7 +136,7 @@ Los nombres de archivo determinan la URL de la página:
- Usa guiones para espacios (no guiones bajos)
- Usa nombres descriptivos (el nombre del archivo se convierte en la URL)
-## Ejemplo: página de créditos
+## Ejemplo: página de créditos {#ejemplo-página-de-créditos}
Aquí hay un ejemplo completo que muestra créditos con un acordeón para reconocimientos detallados:
@@ -187,7 +189,7 @@ Estamos agradecidos con las siguientes personas e instituciones:
</div>
```
-## Diferencias con las capas de historia
+## Diferencias con las capas de historia {#diferencias-con-las-capas-de-historia}
| Funcionalidad | Capas de Historia | Páginas Personalizadas |
|---------|--------------|--------------|
@@ -199,7 +201,7 @@ Estamos agradecidos con las siguientes personas e instituciones:
| Navegación | Vía interfaz de historia | Vía menú del sitio |
| Estructura de URL | `/nombre-historia/` | `/nombre-pagina/` |
-## Próximos pasos
+## Próximos pasos {#próximos-pasos}
- Aprende cómo [configurar la navegación](/guia/personalizacion/menu-navegacion/) para agregar páginas a tu menú
- Explora [sintaxis de widgets](/guia/tu-contenido/sintaxis-markdown/) para acordeón, pestañas y carruseles
diff --git a/content/es/guia/google-sheets.md b/content/es/guia/google-sheets.md
new file mode 100644
index 0000000..dec428d
--- /dev/null
+++ b/content/es/guia/google-sheets.md
@@ -0,0 +1,9 @@
+---
+title: Manual de Google Sheets
+url: /guia/google-sheets/
+translationKey: docs-google-sheets
+type: guide
+docs_section: sheets
+---
+
+{{< section-overview >}}
diff --git a/content/es/guia/iiif/_index.md b/content/es/guia/iiif/_index.md
new file mode 100644
index 0000000..c26b95b
--- /dev/null
+++ b/content/es/guia/iiif/_index.md
@@ -0,0 +1,5 @@
+---
+build:
+ list: never
+ render: never
+---
diff --git a/content/es/guia/iiif/contenido-demostracion.md b/content/es/guia/iiif/contenido-demostracion.md
new file mode 100644
index 0000000..bdd8897
--- /dev/null
+++ b/content/es/guia/iiif/contenido-demostracion.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/iiif/contenido-demostracion/
+translationKey: redirects-es-iiif-contenido-demo-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/personalizacion/contenido-demostracion/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/integracion-iiif.md b/content/es/guia/integracion-iiif.md
new file mode 100644
index 0000000..b207e08
--- /dev/null
+++ b/content/es/guia/integracion-iiif.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/integracion-iiif/
+translationKey: redirects-es-integracion-iiif-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/tu-contenido/imagenes-autoalojadas/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/docs/7-0-customization.es.md b/content/es/guia/personalizacion/_index.md
similarity index 73%
rename from docs/7-0-customization.es.md
rename to content/es/guia/personalizacion/_index.md
index 8ed4a72..7985685 100644
--- a/docs/7-0-customization.es.md
+++ b/content/es/guia/personalizacion/_index.md
@@ -1,18 +1,19 @@
---
-layout: docs
-title: "7. Personalización"
-parent: Documentación
-nav_order: 7
-has_children: true
-lang: es
-permalink: /guia/personalizacion/
+title: Personalización
+url: /guia/personalizacion/
+translationKey: docs-customization
+type: guide
+docs_section: reference
---
-## Personalización
+# Personalización {#guide-title}
+
+
+## Personalización {#personalización}
Haz Telar tuyo con temas, estilos personalizados y modificaciones de diseño.
-## Temas
+## Temas {#temas}
Telar incluye 4 temas predeterminados que puedes cambiar con una sola línea en `_config.yml`:
@@ -23,13 +24,13 @@ Telar incluye 4 temas predeterminados que puedes cambiar con una sola línea en
[Conoce sobre temas](/guia/personalizacion/temas/)
-## Estilos avanzados
+## Estilos avanzados {#estilos-avanzados}
Para una personalización más profunda, además de los temas, puedes modificar variables CSS, diseños y estilos de componentes.
[Guía de estilos avanzados](/guia/desarrolladores/estilos/)
-## Cambio rápido de tema
+## Cambio rápido de tema {#cambio-rápido-de-tema}
Cambia tu tema en `_config.yml`:
diff --git a/docs/7-4-demo-content.es.md b/content/es/guia/personalizacion/contenido-demostracion.md
similarity index 84%
rename from docs/7-4-demo-content.es.md
rename to content/es/guia/personalizacion/contenido-demostracion.md
index 11f8db2..550160a 100644
--- a/docs/7-4-demo-content.es.md
+++ b/content/es/guia/personalizacion/contenido-demostracion.md
@@ -1,24 +1,22 @@
---
-layout: docs
-title: "7.4. Contenido de demostración"
-parent: "7. Personalización"
-grand_parent: Documentación
-nav_order: 4
-lang: es
-permalink: /guia/personalizacion/contenido-demostracion/
+title: Contenido de demostración
+url: /guia/personalizacion/contenido-demostracion/
+translationKey: docs-customization-demo-content
+type: guide
+docs_section: reference
---
-# Contenido de demostración
+# Contenido de demostración {#contenido-de-demostración}
El contenido de demostración agrega a tu sitio dos historias de ejemplo terminadas. Con ellas puedes ver, antes de escribir la tuya, cómo se arma una historia en Telar y cómo funciona.
-## ¿Qué es el contenido de demostración?
+## ¿Qué es el contenido de demostración? {#qué-es-el-contenido-de-demostración}
Es un conjunto de historias de ejemplo, junto con los objetos y las entradas del glosario que usan. Cada vez que se construye el sitio, Telar lo descarga de [content.telar.org](https://content.telar.org) y lo suma a tu propio contenido. Nunca se guarda en tu repositorio, así que, cuando lo desactivas, el siguiente *build* ya no lo incluye.
El contenido de demostración lleva una marca en todos los lugares donde aparece, de modo que siempre puedes distinguirlo de tu propio trabajo.
-## Las historias de demostración
+## Las historias de demostración {#las-historias-de-demostración}
El sitio recibe dos historias, en su mismo idioma:
@@ -27,7 +25,7 @@ El sitio recibe dos historias, en su mismo idioma:
| The Allegorical Woman | La mujer alegórica | 10 | Una historia sencilla, centrada en una sola imagen |
| Colonial Landscapes | Paisajes coloniales | 22 | Una historia más larga, con capítulos, paneles y fuentes primarias |
-### La mujer alegórica
+### La mujer alegórica {#la-mujer-alegórica}
Esta historia, de Natalie Cobo, recorre los detalles de *Aspecto Symbólico del Mundo Hispánico*, un grabado de 1761 de Laureano Atlas que se conserva en la Princeton University Library. En ella se ven:
@@ -39,7 +37,7 @@ Esta historia, de Natalie Cobo, recorre los detalles de *Aspecto Symbólico del
El primer paso enlaza a la hoja de cálculo de la historia en Google Sheets, para que puedas comparar cada fila con el paso que produce.
-### Paisajes coloniales
+### Paisajes coloniales {#paisajes-coloniales}
Esta historia es una selección de *Paisajes Coloniales*, un proyecto de Santiago Muñoz, Adelaida Ávila y María Alejandra Orduz Avella. Gira en torno a una pintura de 1614 de la Sabana de Bogotá, hecha para un pleito y conservada en el Archivo General de Indias, en Sevilla.
@@ -53,7 +51,7 @@ Cada fuente primaria es una entrada del glosario: al hacer clic en su recuadro,
El glosario incluye además varias palabras clave y una persona, así que la página del glosario agrupa sus entradas en **Palabras clave**, **Fuentes primarias** y **Personas y entidades**.
-## Activar o desactivar el contenido de demostración
+## Activar o desactivar el contenido de demostración {#activar-o-desactivar-el-contenido-de-demostración}
Un solo ajuste de `_config.yml` controla el contenido de demostración. En un sitio de Telar nuevo viene activado.
@@ -72,11 +70,12 @@ Para cambiarlo:
GitHub Actions vuelve a construir el sitio, y el cambio se ve en cuanto termina. Si construyes el sitio en tu computador, ejecuta `python3 scripts/csv_to_json.py` y `python3 scripts/generate_collections.py` (o `python3 scripts/build_local_site.py`, que ejecuta ambos) y después Jekyll. Consulta [Desarrollo local](/guia/primeros-pasos/desarrollo-local/).
-{: .tip }
-> **Conserva las demostraciones mientras aprendes**
-> Mientras escribes tu primera historia, vale la pena tener a mano las historias de demostración, al lado de la tuya. Desactívalas antes de compartir el sitio.
+{{< callout "tip" >}}
+**Conserva las demostraciones mientras aprendes**
+Mientras escribes tu primera historia, vale la pena tener a mano las historias de demostración, al lado de la tuya. Desactívalas antes de compartir el sitio.
+{{< /callout >}}
-## Dónde aparece el contenido de demostración
+## Dónde aparece el contenido de demostración {#dónde-aparece-el-contenido-de-demostración}
El contenido de demostración aparece en los mismos lugares que tu propio contenido, con una marca:
@@ -92,7 +91,7 @@ El contenido de demostración aparece en los mismos lugares que tu propio conten
En un sitio en inglés, las marcas dicen **DEMO** y **Demo content**.
-## Idioma
+## Idioma {#idioma}
El contenido de demostración sigue el idioma del sitio, que se define con `telar_language` en `_config.yml`:
@@ -103,7 +102,7 @@ El contenido de demostración sigue el idioma del sitio, que se define con `tela
Con cualquier otro valor se recibe el contenido de demostración en inglés. Si cambias el idioma del sitio, el siguiente *build* descarga el contenido de demostración en el idioma nuevo.
-## El contenido de demostración y tu propio contenido
+## El contenido de demostración y tu propio contenido {#el-contenido-de-demostración-y-tu-propio-contenido}
El contenido de demostración se suma al tuyo durante el *build* y nunca reemplaza nada de lo que tienes:
@@ -117,7 +116,7 @@ El contenido de demostración se suma al tuyo durante el *build* y nunca reempla
Todos los identificadores de los objetos y de las entradas del glosario de demostración empiezan con `demo-`, así que normalmente no coinciden con los tuyos.
-## Usar las demostraciones como modelo
+## Usar las demostraciones como modelo {#usar-las-demostraciones-como-modelo}
Las historias de demostración están escritas en el mismo formato de hoja de cálculo que tus historias. Los archivos de origen están publicados en el [repositorio de contenido de demostración](https://github.com/UCSB-AMPLab/demo-content) en GitHub, en `demos/v1.8.0/es/` y `demos/v1.8.0/en/`:
@@ -129,9 +128,9 @@ Las historias de demostración están escritas en el mismo formato de hoja de c
Para ver cómo se refleja en la página la estructura de una historia, compara las filas de `paisajes.csv` con la historia en tu sitio: las filas con la columna `objeto` vacía son las tarjetas de título de los capítulos.
-## Solución de problemas
+## Solución de problemas {#solución-de-problemas}
-### No aparecen las historias de demostración
+### No aparecen las historias de demostración {#no-aparecen-las-historias-de-demostración}
Si activaste el contenido de demostración y las historias no aparecen:
@@ -140,10 +139,10 @@ Si activaste el contenido de demostración y las historias no aparecen:
3. Abre el registro del *build*, despliega el paso **Convert CSV to JSON** y busca las líneas que empiezan con **Telar Demo Content Fetcher**
4. Haz una recarga forzada de la página (Ctrl+Shift+R en Windows o Linux, Cmd+Shift+R en Mac)
-### No se pudo descargar el contenido de demostración
+### No se pudo descargar el contenido de demostración {#no-se-pudo-descargar-el-contenido-de-demostración}
Si content.telar.org no responde o la descarga falla, el registro del *build* avisa que el sitio se construirá sin las demostraciones, y el *build* continúa. Tu contenido se publica como siempre, sin las historias de demostración. El siguiente *build* vuelve a intentarlo.
-### El contenido de demostración está en otro idioma
+### El contenido de demostración está en otro idioma {#el-contenido-de-demostración-está-en-otro-idioma}
Revisa `telar_language` en `_config.yml`. Debe ser `"en"` o `"es"`; con cualquier otro valor se recibe el contenido de demostración en inglés.
diff --git a/content/es/guia/personalizacion/estilos.md b/content/es/guia/personalizacion/estilos.md
new file mode 100644
index 0000000..a49f21a
--- /dev/null
+++ b/content/es/guia/personalizacion/estilos.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/personalizacion/estilos/
+translationKey: redirects-es-pers-estilos-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/desarrolladores/estilos/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/docs/7-3-navigation-menu.es.md b/content/es/guia/personalizacion/menu-navegacion.md
similarity index 76%
rename from docs/7-3-navigation-menu.es.md
rename to content/es/guia/personalizacion/menu-navegacion.md
index 693ec8a..7e74c9c 100644
--- a/docs/7-3-navigation-menu.es.md
+++ b/content/es/guia/personalizacion/menu-navegacion.md
@@ -1,18 +1,19 @@
---
-layout: docs
-title: "7.3. Menú de navegación"
-parent: "7. Personalización"
-grand_parent: Documentación
-nav_order: 3
-lang: es
-permalink: /guia/personalizacion/menu-navegacion/
+title: Configuración del menú de navegación
+url: /guia/personalizacion/menu-navegacion/
+translationKey: docs-customization-navigation-menu
+type: guide
+docs_section: reference
---
-# Configuración del menú de navegación
+# Configuración del menú de navegación {#configuración-del-menú-de-navegación}
Personaliza el menú de navegación de tu sitio para incluir páginas personalizadas, enlaces externos y etiquetas bilingües.
-## ¿Qué es el menú de navegación?
+
+En el Compositor, organiza la navegación en [Inicio y páginas](/guia/el-compositor/paginas/). Esta página documenta el archivo de navegación.
+
+## ¿Qué es el menú de navegación? {#qué-es-el-menú-de-navegación}
El menú de navegación aparece en el encabezado de tu sitio y proporciona enlaces a:
- Tus historias (generados automáticamente)
@@ -22,15 +23,15 @@ El menú de navegación aparece en el encabezado de tu sitio y proporciona enlac
-## Cómo funciona
+## Cómo funciona {#cómo-funciona}
La navegación se configura a través de `_data/navigation.yml`. Este enfoque basado en datos te da control completo sobre la estructura y etiquetas del menú.
Cuando existe `navigation.yml`, Telar lo usa para construir el menú. Si el archivo falta, aparece un menú básico incluido en el código, con enlaces a Historias, Objetos y Acerca de.
-## Crear tu archivo de navegación
+## Crear tu archivo de navegación {#crear-tu-archivo-de-navegación}
-### Paso 1: crea el archivo
+### Paso 1: crea el archivo {#paso-1-crea-el-archivo}
Agrega `navigation.yml` al directorio `_data/`:
@@ -41,7 +42,7 @@ _data/
└── project.json # Datos de proyecto generados
```
-### Paso 2: define la estructura de tu menú
+### Paso 2: define la estructura de tu menú {#paso-2-define-la-estructura-de-tu-menú}
Aquí hay una configuración básica:
@@ -64,7 +65,7 @@ menu:
url: "/credits/"
```
-### Campos requeridos
+### Campos requeridos {#campos-requeridos}
Cada elemento del menú necesita:
@@ -74,15 +75,15 @@ Cada elemento del menú necesita:
| `titulo_es` | Etiqueta en español | `"Acerca de"` |
| `url` | URL de la página | `"/about/"` |
-### Campos opcionales
+### Campos opcionales {#campos-opcionales}
| Campo | Propósito | Ejemplo |
|-------|---------|---------|
| `external` | Abre en nueva pestaña | `true` |
-## Tipos de elementos de menú
+## Tipos de elementos de menú {#tipos-de-elementos-de-menú}
-### Páginas internas
+### Páginas internas {#páginas-internas}
Enlaza a páginas dentro de tu sitio:
@@ -94,7 +95,7 @@ Enlaza a páginas dentro de tu sitio:
La URL debe coincidir con el nombre de archivo de tu página (`methodology.md` → `/methodology/`).
-### Enlaces externos
+### Enlaces externos {#enlaces-externos}
Enlaza a recursos externos:
@@ -107,7 +108,7 @@ Enlaza a recursos externos:
Cuando `external: true`, el enlace se abre en una nueva pestaña con `target="_blank"`.
-### Página de inicio de historias
+### Página de inicio de historias {#página-de-inicio-de-historias}
Enlaza a la lista de historias:
@@ -117,7 +118,7 @@ Enlaza a la lista de historias:
url: "/"
```
-### Índice de objetos
+### Índice de objetos {#índice-de-objetos}
Enlaza al catálogo de objetos:
@@ -127,7 +128,7 @@ Enlaza al catálogo de objetos:
url: "/objects/"
```
-## Ejemplo completo
+## Ejemplo completo {#ejemplo-completo}
Aquí hay una configuración de navegación completa para un proyecto de investigación:
@@ -167,16 +168,16 @@ menu:
external: true
```
-## Etiquetas bilingües
+## Etiquetas bilingües {#etiquetas-bilingües}
-### Cómo funciona la selección de idioma
+### Cómo funciona la selección de idioma {#cómo-funciona-la-selección-de-idioma}
Telar muestra las etiquetas del menú según la configuración de idioma de tu sitio (`telar_language` en `_config.yml`):
- Si `telar_language: en` → Muestra etiquetas `title_en`
- Si `telar_language: es` → Muestra etiquetas `titulo_es`
-### Cuando falta una etiqueta de idioma
+### Cuando falta una etiqueta de idioma {#cuando-falta-una-etiqueta-de-idioma}
Si a un elemento del menú le falta la etiqueta del idioma del sitio, Telar sigue este orden:
@@ -184,7 +185,7 @@ Si a un elemento del menú le falta la etiqueta del idioma del sitio, Telar sigu
2. Si falta, usa la del otro idioma
3. Si faltan las dos, muestra la URL como etiqueta
-## Orden del menú
+## Orden del menú {#orden-del-menú}
Los elementos del menú aparecen en el orden en que los listas en `navigation.yml`:
@@ -198,9 +199,9 @@ menu:
...
```
-## Actualizar el menú
+## Actualizar el menú {#actualizar-el-menú}
-### Agregar una nueva página
+### Agregar una nueva página {#agregar-una-nueva-página}
Cuando creas una nueva página personalizada:
@@ -217,7 +218,7 @@ Cuando creas una nueva página personalizada:
El menú se actualiza automáticamente.
-### Eliminar una página
+### Eliminar una página {#eliminar-una-página}
Para eliminar una página del menú:
@@ -233,7 +234,7 @@ Para eliminar una página del menú:
El archivo de la página puede permanecer en `telar-content/texts/pages/` pero no aparecerá en la navegación.
-### Reordenar elementos
+### Reordenar elementos {#reordenar-elementos}
Cambia el orden en `navigation.yml`:
@@ -251,7 +252,7 @@ menu:
# Resto del menú...
```
-## Cuando no hay archivo de navegación
+## Cuando no hay archivo de navegación {#cuando-no-hay-archivo-de-navegación}
Si `_data/navigation.yml` no existe, Telar muestra un menú básico incluido en el código:
@@ -261,9 +262,9 @@ Si `_data/navigation.yml` no existe, Telar muestra un menú básico incluido en
Así tu sitio siempre tiene una navegación básica, incluso sin configuración.
-## Solución de problemas
+## Solución de problemas {#solución-de-problemas}
-### El menú no se actualiza
+### El menú no se actualiza {#el-menú-no-se-actualiza}
Si tus cambios de menú no aparecen:
@@ -272,7 +273,7 @@ Si tus cambios de menú no aparecen:
3. **Limpia caché del navegador**: Usa Ctrl+Shift+R (Cmd+Shift+R en Mac) para actualizar forzadamente
4. **Verifica ubicación del archivo**: El archivo debe estar en `_data/navigation.yml` (no `data/` o `_data/nav.yml`)
-### Se muestra el idioma incorrecto
+### Se muestra el idioma incorrecto {#se-muestra-el-idioma-incorrecto}
Si las etiquetas del menú aparecen en el idioma incorrecto:
@@ -280,7 +281,7 @@ Si las etiquetas del menú aparecen en el idioma incorrecto:
2. Verifica que estés usando nombres de campo correctos (`title_en` y `titulo_es`, no `title` o `label`)
3. Asegúrate de que ambas etiquetas de idioma estén presentes
-### El enlace externo no se abre en nueva pestaña
+### El enlace externo no se abre en nueva pestaña {#el-enlace-externo-no-se-abre-en-nueva-pestaña}
Agrega el campo `external: true`:
@@ -291,9 +292,9 @@ Agrega el campo `external: true`:
external: true # Requerido para nueva pestaña
```
-## Mejores prácticas
+## Mejores prácticas {#mejores-prácticas}
-### Etiquetas claras y descriptivas
+### Etiquetas claras y descriptivas {#etiquetas-claras-y-descriptivas}
Usa etiquetas que describan claramente el destino:
@@ -309,7 +310,7 @@ Usa etiquetas que describan claramente el destino:
titulo_es: "Info"
```
-### Ordenamiento consistente
+### Ordenamiento consistente {#ordenamiento-consistente}
Mantén elementos relacionados juntos:
@@ -327,11 +328,11 @@ Mantén elementos relacionados juntos:
- title_en: "Archive"
```
-### Limita la longitud del menú
+### Limita la longitud del menú {#limita-la-longitud-del-menú}
Mantén menús enfocados (5-7 elementos es ideal). Para sitios más grandes, considera agrupar contenido de manera diferente o usar enlaces de pie de página para páginas secundarias.
-## Véase también
+## Véase también {#véase-también}
- [Páginas Personalizadas](/guia/funciones/paginas-personalizadas/) - Crear páginas para enlazar en la navegación
- [Referencia de Configuración](/guia/configurar/configuracion/) - Opciones completas de `_config.yml` incluyendo `telar_language`
diff --git a/content/es/guia/personalizacion/moviles.md b/content/es/guia/personalizacion/moviles.md
new file mode 100644
index 0000000..93f854b
--- /dev/null
+++ b/content/es/guia/personalizacion/moviles.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/personalizacion/moviles/
+translationKey: redirects-es-pers-moviles-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/desarrolladores/moviles/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/docs/7-2-home-page.es.md b/content/es/guia/personalizacion/pagina-de-inicio.md
similarity index 82%
rename from docs/7-2-home-page.es.md
rename to content/es/guia/personalizacion/pagina-de-inicio.md
index cd7d3a9..b1f59b4 100644
--- a/docs/7-2-home-page.es.md
+++ b/content/es/guia/personalizacion/pagina-de-inicio.md
@@ -1,22 +1,26 @@
---
-layout: docs
-title: "7.2. Personalizar la página de inicio"
-parent: "7. Personalización"
-grand_parent: Documentación
-nav_order: 2
-lang: es
-permalink: /guia/personalizacion/pagina-de-inicio/
+title: Personalizar la página de inicio
+url: /guia/personalizacion/pagina-de-inicio/
+translationKey: docs-customization-home-page
+type: guide
+docs_section: reference
---
-## Personalizar la página de inicio
+# Personalizar la página de inicio {#guide-title}
+
+
+
+En el Compositor, usa [Inicio y páginas](/guia/el-compositor/paginas/). El formato siguiente describe la misma página de inicio publicada.
+
+## Personalizar la página de inicio {#personalizar-la-página-de-inicio}
La página principal de tu sitio Telar está controlada por un archivo Markdown sencillo (`index.md`) en el directorio raíz del repositorio. Ahí puedes editar o quitar el mensaje de bienvenida y cambiar los encabezados de cada sección.
-## Ubicación del archivo
+## Ubicación del archivo {#ubicación-del-archivo}
`index.md` **debe** estar en el directorio raíz de tu repositorio (no en un subdirectorio). Jekyll busca este archivo ahí para convertirlo en tu página de inicio.
-## Estructura básica
+## Estructura básica {#estructura-básica}
Aquí está la estructura predeterminada de `index.md`:
@@ -33,7 +37,7 @@ objects_intro: "Browse {count} objects featured in the stories."
Tu contenido personalizado va aquí...
```
-## Modo colección
+## Modo colección {#modo-colección}
De manera predeterminada, la página principal muestra las historias primero con una muestra de objetos debajo. El modo colección invierte este orden — los objetos aparecen primero en una cuadrícula grande, con las historias en una cuadrícula más pequeña debajo.
@@ -55,21 +59,21 @@ El modo colección funciona bien para sitios con una gran cantidad de objetos y
**Nuevo en v1.1.0.** Consulta la [Referencia de configuración](/guia/configurar/configuracion/#collection_mode) para los detalles del ajuste.
-## Opciones de front matter
+## Opciones de front matter {#opciones-de-front-matter}
-### stories_heading
+### stories_heading {#stories_heading}
El encabezado que se muestra sobre la cuadrícula de historias. Predeterminado: `"Explore the stories"`
-### stories_intro
+### stories_intro {#stories_intro}
Texto introductorio opcional que se muestra entre el encabezado y la cuadrícula de historias. Déjalo en blanco (`""`) si no quieres texto introductorio.
-### objects_heading
+### objects_heading {#objects_heading}
El encabezado que se muestra sobre la sección de objetos. Predeterminado: `"See the objects behind the stories"`
-### objects_intro
+### objects_intro {#objects_intro}
Texto introductorio para la sección de objetos. Usa `{count}` como marcador de posición para el número de objetos.
@@ -77,7 +81,7 @@ Predeterminado: `"Browse {count} objects featured in the stories."`
El marcador de posición `{count}` se reemplaza automáticamente con el número real de objetos.
-## Agregar contenido personalizado
+## Agregar contenido personalizado {#agregar-contenido-personalizado}
Cualquier contenido Markdown que agregues debajo del front matter aparecerá sobre la sección de historias. Esto es ideal para:
@@ -86,7 +90,7 @@ Cualquier contenido Markdown que agregues debajo del front matter aparecerá sob
- Avisos importantes
- Llamados a la acción personalizados
-### Ejemplo: bienvenida personalizada
+### Ejemplo: bienvenida personalizada {#ejemplo-bienvenida-personalizada}
```markdown
---
@@ -106,7 +110,7 @@ textiles coloniales de la región andina.
Navega a través de las historias a continuación para descubrir las técnicas y significados culturales de estos artefactos.
```
-### Ejemplo: cuadro de alerta
+### Ejemplo: cuadro de alerta {#ejemplo-cuadro-de-alerta}
Puedes usar etiquetas de alerta para mostrar advertencias:
@@ -127,21 +131,21 @@ objects_intro: "Browse {count} objects featured in the stories."
> y objetos regularmente. ¡Vuelve pronto para ver cómo nos queda!
```
-## Aviso del sitio de demostración
+## Aviso del sitio de demostración {#aviso-del-sitio-de-demostración}
La plantilla incluye de manera predeterminada un aviso que dice que el sitio es de demostración, con enlaces al repositorio de GitHub y la documentación.
-### Para personalizar
+### Para personalizar {#para-personalizar}
Edita el contenido Markdown para que coincida con tu proyecto.
-### Para eliminar
+### Para eliminar {#para-eliminar}
Simplemente elimina el bloque de aviso de demostración de `index.md`.
-## Ejemplos
+## Ejemplos {#ejemplos}
-### Página de inicio minimalista
+### Página de inicio minimalista {#página-de-inicio-minimalista}
```markdown
---
@@ -156,7 +160,7 @@ objects_intro: "Browse {count} objects featured in the stories."
Sin contenido personalizado: solo muestra historias y objetos. Las tarjetas de historias muestran miniaturas según el tipo de medio: las historias de video y audio muestran un ícono como marcador de posición cuando no hay un objeto de imagen disponible.
-### Con texto introductorio
+### Con texto introductorio {#con-texto-introductorio}
```markdown
---
@@ -174,20 +178,20 @@ objects_intro: "Browse {count} objects featured in the stories."
El **Proyecto Textiles Coloniales** utiliza ...
```
-## Recomendaciones
+## Recomendaciones {#recomendaciones}
- Mantén el contenido de la página de inicio conciso para que los visitantes entren a tus historias.
- Usa `##` (segundo nivel) o `###` (tercer nivel) para crear encabezados.
- Prueba tu página de inicio en distintos tamaños de pantalla para cerciorarte de que se vea bien.
- Actualiza los avisos y textos introductorios a medida que tu exhibición evolucione.
-## Notas técnicas
+## Notas técnicas {#notas-técnicas}
- La configuración `layout: index` es obligatoria y no debe cambiarse.
- La configuración `title` controla la etiqueta `<title>` de la página.
- Todas las funciones de Markdown son compatibles (consulta la [Guía de sintaxis de Markdown](/guia/tu-contenido/sintaxis-markdown/)).
-## Próximos pasos
+## Próximos pasos {#próximos-pasos}
- [Aprende sobre temas](/guia/personalizacion/temas/) para dar estilo a tu página de inicio.
- [Explora estilos avanzados](/guia/desarrolladores/estilos/) para CSS personalizado.
diff --git a/docs/7-1-themes.es.md b/content/es/guia/personalizacion/temas.md
similarity index 82%
rename from docs/7-1-themes.es.md
rename to content/es/guia/personalizacion/temas.md
index d8044a7..511425d 100644
--- a/docs/7-1-themes.es.md
+++ b/content/es/guia/personalizacion/temas.md
@@ -1,20 +1,21 @@
---
-layout: docs
-title: "7.1. Temas"
-parent: "7. Personalización"
-grand_parent: Documentación
-nav_order: 1
-lang: es
-permalink: /guia/personalizacion/temas/
+title: Temas
+url: /guia/personalizacion/temas/
+translationKey: docs-customization-themes
+type: guide
+docs_section: reference
---
-## Temas
+# Temas {#guide-title}
+
+
+## Temas {#temas}
Telar incluye cinco temas visuales listos para usar, y puedes cambiarlos desde `_config.yml`.
-## Temas disponibles
+## Temas disponibles {#temas-disponibles}
-### Trama (predeterminado)
+### Trama (predeterminado) {#trama-predeterminado}
La identidad visual de Telar, diseñada por Adelaida Ávila. Terracota y lavanda, con encabezados en Space Grotesk.
@@ -28,7 +29,7 @@ La identidad visual de Telar, diseñada por Adelaida Ávila. Terracota y lavanda
**Ideal para:** la mayoría de las exhibiciones; es el tema más versátil.
-### Paisajes Coloniales
+### Paisajes Coloniales {#paisajes-coloniales}
Colores de tierra y cielo, del proyecto [Paisajes Coloniales](https://paisajescoloniales.com). Azul pizarra y ciruela, con encabezados en Playfair Display.
@@ -42,7 +43,7 @@ Colores de tierra y cielo, del proyecto [Paisajes Coloniales](https://paisajesco
**Ideal para:** narrativas históricas y exhibiciones arqueológicas.
-### Neogranadina
+### Neogranadina {#neogranadina}
Verde y carmesí encendidos sobre carbón, con IM Fell, una tipografía tomada de los punzones de una imprenta del siglo XVII.
@@ -57,7 +58,7 @@ Verde y carmesí encendidos sobre carbón, con IM Fell, una tipografía tomada d
**Ideal para:** materiales de archivo.
-### Santa Barbara
+### Santa Barbara {#santa-barbara}
Dorado y azul marino, los colores de la Universidad de California en Santa Bárbara, con encabezados en Roboto Serif.
@@ -72,7 +73,7 @@ Dorado y azul marino, los colores de la Universidad de California en Santa Bárb
**Ideal para:** imágenes en escala de grises y monocromas.
-### Austin
+### Austin {#austin}
El naranja quemado de la Universidad de Texas en Austin, con verde salvia y piedra, y encabezados en Crimson Pro.
@@ -85,7 +86,7 @@ El naranja quemado de la Universidad de Texas en Austin, con verde salvia y pied
**Ideal para:** materiales contemporáneos.
-## Cambia temas
+## Cambia temas {#cambia-temas}
Edita `_config.yml` en tu repositorio:
@@ -95,9 +96,9 @@ telar_theme: "santa-barbara" # Opciones: trama, paisajes, neogranadina, santa-b
Confirma el cambio y GitHub Actions reconstruirá tu sitio automáticamente (2-5 minutos).
-## Crea temas personalizados
+## Crea temas personalizados {#crea-temas-personalizados}
-### Paso 1: crea un archivo de tema
+### Paso 1: crea un archivo de tema {#paso-1-crea-un-archivo-de-tema}
Crea el archivo `_data/themes/custom.yml`. Los colores se agrupan en `colors.text` y `colors.background`, y las fuentes en `fonts`:
@@ -127,10 +128,11 @@ fonts:
Lo más rápido es copiar uno de los temas que ya vienen en `_data/themes/` y cambiarle los valores. Todas las claves son opcionales: la que no pongas toma el valor de Trama.
-{: .warning }
-> Telar solo lee las claves que aparecen aquí. Un archivo con otros nombres de clave se carga sin errores, pero no cambia nada: tu sitio se ve con los colores predeterminados. La salida del *build* nombra las claves que Telar buscó y no encontró.
+{{< callout "warning" >}}
+Telar solo lee las claves que aparecen aquí. Un archivo con otros nombres de clave se carga sin errores, pero no cambia nada: tu sitio se ve con los colores predeterminados. La salida del *build* nombra las claves que Telar buscó y no encontró.
+{{< /callout >}}
-### Paso 2: activa el tema personalizado
+### Paso 2: activa el tema personalizado {#paso-2-activa-el-tema-personalizado}
En `_config.yml`:
@@ -138,14 +140,14 @@ En `_config.yml`:
telar_theme: "custom"
```
-### Paso 3: prueba y refina
+### Paso 3: prueba y refina {#paso-3-prueba-y-refina}
1. Confirma cambios
2. Espera a que se construya el sitio
3. Revisa tu sitio
4. Ajusta colores y fuentes según sea necesario
-## Claves de color del tema
+## Claves de color del tema {#claves-de-color-del-tema}
Todos los temas admiten estas claves de color:
@@ -163,10 +165,11 @@ Todos los temas admiten estas claves de color:
| `colors.background.panel_layer2` | Fondo del panel de la capa 2 |
| `colors.background.panel_glossary` | Fondo del panel del glosario |
-{: .note }
-> Telar revisa el contraste del texto sobre los cuatro fondos de `colors.background`. Consulta [Accesibilidad del color](#accesibilidad-del-color).
+{{< callout "note" >}}
+Telar revisa el contraste del texto sobre los cuatro fondos de `colors.background`. Consulta [Accesibilidad del color](#accesibilidad-del-color).
+{{< /callout >}}
-## Claves de tipografía
+## Claves de tipografía {#claves-de-tipografía}
Estas dos claves controlan las fuentes de todo el sitio:
@@ -175,7 +178,7 @@ Estas dos claves controlan las fuentes de todo el sitio:
| `fonts.headings` | h1–h6, títulos de página |
| `fonts.body` | Párrafos, listas, texto general |
-### Ejemplos de fuentes
+### Ejemplos de fuentes {#ejemplos-de-fuentes}
Las dos claves van dentro de `fonts`, y cada una recibe una lista de fuentes: la que quieres y, después, las que el navegador usa si no puede cargar la primera.
@@ -200,7 +203,7 @@ fonts:
```
O `'Open Sans', Helvetica, sans-serif`, o `'Crimson Text', Georgia, serif`.
-## Usa Google Fonts
+## Usa Google Fonts {#usa-google-fonts}
Para usar fuentes no incluidas por defecto:
@@ -215,11 +218,11 @@ Para usar fuentes no incluidas por defecto:
headings: "'Tu Fuente', serif"
```
-## Atribución de la persona creadora del tema
+## Atribución de la persona creadora del tema {#atribución-de-la-persona-creadora-del-tema}
Telar v0.4.0+ permite añadir atribución opcional para reconocer a quienes diseñan temas personalizados en el pie de página del sitio.
-### Agrega atribución a temas personalizados
+### Agrega atribución a temas personalizados {#agrega-atribución-a-temas-personalizados}
Al crear un tema propio, agrega la información de la persona creadora en tu archivo YAML:
@@ -250,7 +253,7 @@ fonts:
body: "'Inter', sans-serif"
```
-### Campos de atribución
+### Campos de atribución {#campos-de-atribución}
Todos los campos son opcionales:
@@ -276,7 +279,7 @@ creator_url: "https://github.com/mirl-ucsb"
description: "Retro Cool. Digital Heat."
```
-### Cómo se muestra la atribución
+### Cómo se muestra la atribución {#cómo-se-muestra-la-atribución}
Cuando agregas información de atribución, aparece en el pie de página:
@@ -292,7 +295,7 @@ Cuando agregas información de atribución, aparece en el pie de página:
**Sin ninguno:**
No se muestra atribución
-### Atribución para temas predeterminados
+### Atribución para temas predeterminados {#atribución-para-temas-predeterminados}
Todos los temas incluidos en Telar traen atribución por defecto:
@@ -316,7 +319,7 @@ Todos los temas incluidos en Telar traen atribución por defecto:
- Creador: AMPL en UT Austin
- URL: https://liberalarts.utexas.edu/history/
-### Comparte temas personalizados
+### Comparte temas personalizados {#comparte-temas-personalizados}
Si quieres compartir un tema con la comunidad de Telar:
@@ -325,7 +328,7 @@ Si quieres compartir un tema con la comunidad de Telar:
3. Describe recomendaciones de uso (ej., ideal para imágenes en escala de grises)
4. Compártelo en el foro [Telar Discussions](https://github.com/UCSB-AMPLab/telar/discussions)
-### Quitar la atribución
+### Quitar la atribución {#quitar-la-atribución}
Si prefieres usar un tema sin atribución:
@@ -338,11 +341,11 @@ Si prefieres usar un tema sin atribución:
No se mostrará ninguna atribución en el pie de página.
-## Accesibilidad del color
+## Accesibilidad del color {#accesibilidad-del-color}
Cada tema empareja un color de texto con un fondo: `colors.text.panel_layer1` va sobre `colors.background.panel_layer1`, y así con los demás. Cuando los dos se parecen demasiado en brillo, cuesta leer el texto.
-### Cómo revisa Telar tus colores
+### Cómo revisa Telar tus colores {#cómo-revisa-telar-tus-colores}
Al construir el sitio, Telar calcula un color de texto que alcance una relación de contraste de 4,5:1 sobre cada uno de los cuatro fondos: `button`, `panel_layer1`, `panel_layer2` y `panel_glossary`. Ese es el nivel AA de WCAG para texto de tamaño normal.
@@ -353,7 +356,7 @@ Telar empieza por el color que escogiste y lo conserva siempre que llegue a 4,5:
1. `colors.text.heading` o `colors.text.button`, el que tenga mayor contraste sobre ese fondo
2. blanco o negro, el que tenga mayor contraste
-### Cuando Telar reemplaza un color
+### Cuando Telar reemplaza un color {#cuando-telar-reemplaza-un-color}
Telar escribe una línea en la salida del *build* por cada color que reemplaza:
@@ -365,7 +368,7 @@ El mensaje aparece en inglés.
Si todos los colores del tema cumplen, no aparece ninguna línea. Para conservar el color que querías, cambia el fondo en vez del texto.
-### Lo que Telar no revisa
+### Lo que Telar no revisa {#lo-que-telar-no-revisa}
De esto te encargas tú:
@@ -376,15 +379,15 @@ De esto te encargas tú:
Para revisarlos, usa herramientas como el [WebAIM Contrast Checker](https://webaim.org/resources/contrastchecker/).
-### Los colores que Telar no puede leer
+### Los colores que Telar no puede leer {#los-colores-que-telar-no-puede-leer}
Telar solo lee colores hexadecimales, como `#FFFFFF` o `#FFF`. Un color con nombre como `white`, o un valor `rgb()`, queda tal como lo escribiste: Telar no lo revisa y lo anota en la salida del *build*.
-## Cuando falta el tema o una de sus claves
+## Cuando falta el tema o una de sus claves {#cuando-falta-el-tema-o-una-de-sus-claves}
Si Telar no encuentra el archivo de tema que nombraste en `_config.yml`, vuelve al tema **Trama** y el sitio no se rompe. Si el archivo existe, Telar lo usa, incluso si no reconoce ninguno de los nombres de clave que trae. Cada clave que no pusiste toma el valor de Trama, y la salida del *build* dice cuáles faltan.
-## Próximos pasos
+## Próximos pasos {#próximos-pasos}
- [Estilos avanzados](/guia/desarrolladores/estilos/) para personalización más profunda
- [Configuración](/guia/configurar/configuracion/) para otros ajustes del sitio
diff --git a/content/es/guia/planear/_index.md b/content/es/guia/planear/_index.md
new file mode 100644
index 0000000..fd8a2bf
--- /dev/null
+++ b/content/es/guia/planear/_index.md
@@ -0,0 +1,34 @@
+---
+title: Planear una exhibición
+url: /guia/planear/
+translationKey: docs-plan
+type: guide
+docs_draft: true
+docs_section: planning
+---
+
+<p class="eyebrow">Capítulo 1 · Propósito, público y fuentes</p>
+<h1>Empieza por lo que quieres que las personas observen.</h1>
+<p class="lede">Una exhibición reúne fuentes e interpretación. Antes de elegir un editor, piensa qué quieres que tus visitantes exploren y con qué materiales podrán hacerlo.</p>
+<div class="chapter-outcome"><strong>Al terminar este capítulo</strong><p>Tendrás un planteamiento breve de la exhibición: una pregunta central, un público y un pequeño conjunto de fuentes por examinar.</p></div>
+<h2 id="purpose">1. Convierte un tema en una pregunta</h2>
+<p>Un tema define de qué trata tu exhibición. Una pregunta invita a mirar con atención. Empieza por algo que puedas explorar a través de tus materiales.</p>
+<div class="worked-example"><p class="eyebrow">Un ejemplo para pensar</p><div class="example-pair"><div><span>Tema</span><p>Una pintura de la Sabana de Bogotá.</p></div><div><span>Posible pregunta central</span><p>¿Qué nos permite entender esta pintura sobre las personas y la tierra?</p></div></div><p class="example-note">Es una posible pregunta de partida, no una interpretación terminada. Los detalles que examines darán forma al argumento.</p></div>
+<p>Escribe la idea que quieres que tus visitantes se lleven, aunque sea provisional. Después, piensa qué preguntas podrían ayudarles a llegar a ella. El inicio debe darles una entrada; el cierre debe retomar lo que la exhibición les ha ayudado a ver.</p>
+<h2 id="audience">2. Imagina a tus visitantes</h2>
+<p>Piensa en alguien que llega sin los conocimientos que tú tienes sobre el material. ¿Qué puede reconocer? ¿Qué necesita una introducción? ¿Qué palabras o supuestos podrían dificultar la lectura?</p>
+<ul><li>¿Para quién estás creando esta exhibición?</li><li>¿Qué contexto necesita antes de observar los primeros detalles?</li><li>¿Qué debería poder observar o explicar al terminar?</li></ul>
+<p>Usa esas respuestas para elegir el inicio, el lenguaje y la cantidad de contexto. El glosario puede explicar términos recurrentes; un panel puede desarrollar el contexto de un paso específico.</p>
+<h2 id="sources">3. Examina las fuentes antes de ordenarlas</h2>
+<p>Elige un conjunto pequeño para empezar: una imagen, un documento, una grabación de audio, un video o varios materiales relacionados. Puedes volver a la misma fuente en más de un paso.</p>
+<p>Observa y escucha con cuidado. Anota elementos importantes, las relaciones entre ellos, las preguntas que plantean y lo que sigue siendo incierto. Conecta cada posible observación con un detalle que puedas mostrar.</p>
+<div class="prompt-grid"><div><h3>¿Qué hay allí?</h3><p>Personas, palabras, símbolos, sonidos, gestos, distribuciones y ausencias.</p></div><div><h3>¿Qué preguntas surgen?</h3><p>Preguntas sobre su creación, uso, público, fecha, lugar e interpretación.</p></div></div>
+<p>Guarda junto a tus notas la dirección de la fuente, los datos del catálogo y el crédito. Identifica qué puedes compartir y qué debes revisar. Señala las interpretaciones inciertas como preguntas por investigar.</p>
+<h2 id="exercise">4. Escribe un planteamiento que puedas desarrollar</h2>
+<p>En papel o en un documento, completa estas cuatro frases:</p>
+<ol class="exercise-list"><li><strong>Mi exhibición pregunta…</strong><span>Escribe una pregunta central.</span></li><li><strong>La estoy creando para…</strong><span>Define el público y el contexto que necesitará.</span></li><li><strong>Voy a trabajar con…</strong><span>Enumera un pequeño conjunto de fuentes y los detalles que vale la pena examinar.</span></li><li><strong>Al terminar, mis visitantes deberían…</strong><span>Describe una comprensión u observación que la exhibición pueda ayudar a desarrollar.</span></li></ol>
+<div class="chapter-note"><strong>Mantén el planteamiento abierto.</strong><p>La planeación es un proceso de revisión. A medida que examines las fuentes y pruebes la historia con lectores, ajusta la pregunta, la secuencia y la conclusión.</p></div>
+<h2 id="next">Después: esboza el arco narrativo</h2>
+<p>Convierte tu planteamiento en un inicio, una secuencia de preguntas y un cierre. Sigue con <a href='/guia/primeros-pasos/estructura-narrativa/'>el arco narrativo</a>; después relaciona los pasos con las fuentes, planea las capas y organiza la exhibición.</p>
+<p>El <a href="/assets/templates/telar-worksheet.pdf">planeador narrativo</a> ofrece un inicio y un cierre entre los cuales trabajar. Las <a href="https://telar.org/workshop/">diapositivas del taller</a> muestran cómo agregar preguntas, fuentes y capas.</p>
+<a class='button' href='/guia/primeros-pasos/estructura-narrativa/'>Planea el recorrido de la historia →</a>
diff --git a/content/es/guia/planear/capas-y-glosario.md b/content/es/guia/planear/capas-y-glosario.md
new file mode 100644
index 0000000..8c60b4f
--- /dev/null
+++ b/content/es/guia/planear/capas-y-glosario.md
@@ -0,0 +1,42 @@
+---
+title: Planea los paneles y el glosario
+url: /guia/planear/capas-y-glosario/
+translationKey: docs-plan-layers-and-glossary
+type: guide
+docs_draft: true
+docs_section: planning
+---
+
+# Planea los paneles y el glosario {#planea-los-paneles-y-el-glosario}
+
+Mantén claro el hilo principal y ofrece contexto adicional donde el público pueda necesitarlo. Los paneles corresponden a un paso; las entradas del glosario explican términos que pueden aparecer en toda la exhibición.
+
+## Escribe primero la respuesta breve {#escribe-primero-la-respuesta-breve}
+
+Responde la pregunta en una o dos frases. Distingue la observación de la inferencia: ¿qué muestra la fuente y qué propones que significa?
+
+Lee las preguntas y respuestas sin abrir nada más. Si falta una explicación esencial, incorpórala al hilo principal antes de agregar detalles opcionales.
+
+## Dale un propósito a cada panel {#dale-un-propósito-a-cada-panel}
+
+Un primer panel puede explicar cómo se produjo una fuente, introducir una comparación o presentar la evidencia de una interpretación. El segundo se abre desde el primero y permite desarrollar esa discusión.
+
+En el planeador, dibuja la primera rama desde la pregunta y la segunda desde el primer panel. Así se representa el recorrido: paso → primer panel → segundo panel.
+
+Elige un botón que anticipe el contenido. “Cómo se tomó la muestra” orienta mejor que repetir “Más” en todos los pasos. No tienes que incluir en los paneles todo lo que investigaste.
+
+{{< media id="panels" >}}
+
+## Usa el glosario para el contexto recurrente {#usa-el-glosario-para-el-contexto-recurrente}
+
+Define un término si la explicación ayudará en varios pasajes. La definición debe entenderse por sí sola; enlaza entradas relacionadas cuando resulte útil.
+
+Una historia sobre un khipu puede necesitar una explicación del término y un panel sobre la actividad que muestra una fotografía específica. Son funciones distintas.
+
+La sintaxis es `[[id-del-termino]]`, o `[[id-del-termino|texto visible]]` si la frase requiere otra expresión. El Compositor también ofrece un control para insertar estos enlaces.
+
+## Revisa los recorridos opcionales {#revisa-los-recorridos-opcionales}
+
+Abre los paneles y enlaces del glosario en el orden en que los encontraría un lector. Comprueba que el título, el botón y el primer párrafo correspondan. Aclara qué fuente respalda cada afirmación y de dónde viene una comparación.
+
+**Resultado:** respuestas breves, esquemas de paneles con un propósito claro y una lista de términos compartidos. Sigue con [la organización de toda la exhibición](/guia/planear/organizar-la-exhibicion/).
diff --git a/content/es/guia/planear/fuentes-y-encuadres.md b/content/es/guia/planear/fuentes-y-encuadres.md
new file mode 100644
index 0000000..a08d6e5
--- /dev/null
+++ b/content/es/guia/planear/fuentes-y-encuadres.md
@@ -0,0 +1,44 @@
+---
+title: Elige fuentes y encuadres
+url: /guia/planear/fuentes-y-encuadres/
+translationKey: docs-plan-sources-and-framing
+type: guide
+docs_draft: true
+docs_section: planning
+---
+
+# Elige fuentes y encuadres {#elige-fuentes-y-encuadres}
+
+El encuadre debe ayudar a responder la pregunta del paso. Acerca la imagen cuando un detalle sirva de evidencia y aléjala cuando importe la relación entre varios elementos.
+
+## Lleva un registro de fuentes {#lleva-un-registro-de-fuentes}
+
+Para cada objeto, anota el título, la autoría conocida, la fecha o época, la institución que lo conserva, la dirección de la ficha de catálogo y el crédito. Anota por separado la dirección del manifiesto IIIF y la de la ficha de catálogo: el manifiesto proporciona la imagen y la ficha, el contexto del objeto.
+
+Registra qué puedes publicar y las dudas de atribución o interpretación. Si trabajas con materiales propios, conserva el archivo original además de la copia preparada para la exhibición.
+
+<span class="anchor-alias" id="relaciona-cada-paso-con-una-vista"></span>
+
+## Decide qué se verá en cada paso {#decide-qué-se-verá-en-cada-paso}
+
+Agrega tres notas a cada pregunta del plan:
+
+1. ¿Qué objeto, página o fragmento verá el visitante?
+2. ¿Qué detalle debe notar?
+3. ¿Qué explica la respuesta breve sobre ese detalle?
+
+Puedes volver al mismo objeto varias veces. Un cambio de encuadre permite desarrollar un argumento sin introducir una fuente nueva en cada paso. Usa una vista más amplia al pasar entre detalles distantes para que el público entienda su relación.
+
+## Planea imágenes, documentos y grabaciones {#planea-imágenes-documentos-y-grabaciones}
+
+En documentos de varias páginas, elige primero la página y después el encuadre. Para video o audio, identifica un fragmento y anota su inicio y final. Revisa si necesita una transcripción u otra explicación.
+
+El [ejemplo del khipu](/guia/el-compositor/iiif-a-historia/) muestra cómo agregar un objeto con la URL de su manifiesto IIIF, seleccionarlo en un paso, ajustar el encuadre y guardarlo con **Capturar posición**. Comprueba que la imagen que encuadras sea la del objeto que agregaste.
+
+## Describe la evidencia junto a la interpretación {#describe-la-evidencia-junto-a-la-interpretación}
+
+Describe los detalles visuales o sonoros pertinentes mediante el texto alternativo del paso o la explicación que lo acompaña. Evita depender únicamente de “mira aquí” o de un color para señalar la evidencia.
+
+Prueba la vista en una ventana más pequeña. Una etiqueta que puedes leer en tu monitor quizá necesite un acercamiento, una transcripción o una explicación escrita.
+
+**Resultado:** un registro de fuentes y una vista o un fragmento propuesto para cada paso. Sigue con [los paneles y el glosario](/guia/planear/capas-y-glosario/).
diff --git a/content/es/guia/planear/organizar-la-exhibicion.md b/content/es/guia/planear/organizar-la-exhibicion.md
new file mode 100644
index 0000000..6ea5897
--- /dev/null
+++ b/content/es/guia/planear/organizar-la-exhibicion.md
@@ -0,0 +1,44 @@
+---
+title: Organiza toda la exhibición
+url: /guia/planear/organizar-la-exhibicion/
+translationKey: docs-plan-exhibition-layout
+type: guide
+docs_draft: true
+docs_section: planning
+---
+
+# Organiza toda la exhibición {#organiza-toda-la-exhibición}
+
+Una exhibición incluye la página de inicio, las historias, los objetos, el glosario y las páginas de apoyo. Planea cómo recorrerlos antes de pulir cada pantalla.
+
+## Decide qué presenta la página de inicio {#decide-qué-presenta-la-página-de-inicio}
+
+Explica el tema, la pregunta central y quién hizo la exhibición. Ofrece contexto suficiente para elegir una historia sin repetir la introducción completa de cada una.
+
+Dale a cada tarjeta un título propio y un subtítulo útil. Si el orden importa, pon primero la historia por la que recomiendas comenzar. Aclara cuándo pueden leerse de manera independiente.
+
+{{< media id="public-home" >}}
+
+## Define la relación entre historias {#define-la-relación-entre-historias}
+
+Usa una historia para un argumento continuo o un examen guiado. Divide el material cuando cada historia tenga una pregunta, un público o un conjunto de fuentes distinto.
+
+Describe en una frase la función de cada historia. Si dos descripciones son intercambiables, reconsidera la división. Si una historia requiere conocimientos de otra, explica o enlaza esa relación.
+
+## Ofrece otras entradas a las fuentes {#ofrece-otras-entradas-a-las-fuentes}
+
+La galería de objetos permite explorar fuera de los recorridos guiados. Los títulos, créditos y descripciones útiles, junto con metadatos consistentes, ayudan a comprender lo que aparece allí.
+
+El glosario ofrece contexto recurrente. Una página de presentación o metodología puede explicar autorías, decisiones de investigación, selección de fuentes y agradecimientos sin interrumpir las historias.
+
+## Dibuja la navegación {#dibuja-la-navegación}
+
+Enumera los enlaces del menú y la página que debe abrir cada uno. Mantén una lista que se pueda comprender de un vistazo. Usa nombres que describan el destino.
+
+En el Compositor, organiza el menú en **Inicio y páginas** y ajusta la presentación de historias y objetos en **Configuración del sitio**. Con archivos, la navegación se guarda en `_data/navigation.yml`; consulta [la referencia de navegación](/guia/personalizacion/menu-navegacion/).
+
+## Elige una primera versión manejable {#elige-una-primera-versión-manejable}
+
+Construye primero un recorrido completo: inicio → historia → fuente o panel → cierre. Después agrega otras historias y páginas de apoyo.
+
+**Resultado:** un mapa sencillo del sitio, una lista ordenada de historias y un esquema de inicio. Sigue con [las pruebas con lectores](/guia/planear/revision/).
diff --git a/content/es/guia/planear/revision.md b/content/es/guia/planear/revision.md
new file mode 100644
index 0000000..521d6c0
--- /dev/null
+++ b/content/es/guia/planear/revision.md
@@ -0,0 +1,43 @@
+---
+title: Prueba la exhibición con lectores
+url: /guia/planear/revision/
+translationKey: docs-plan-review
+type: guide
+docs_draft: true
+docs_section: planning
+---
+
+# Prueba la exhibición con lectores {#prueba-la-exhibición-con-lectores}
+
+Que el sitio se genere sin errores no garantiza que se entienda. Antes de difundirlo, pide a otras personas que lo prueben para comprobar si tiene sentido para quien lo ve por primera vez.
+
+## Recorre el hilo principal {#recorre-el-hilo-principal}
+
+Entra al sitio publicado por la página de inicio, no por los enlaces que guardaste mientras editabas. Elige una historia y recórrela paso a paso hasta el final, como lo haría alguien que llega por primera vez.
+
+Comprueba que cada fuente aparezca en la página, encuadre o fragmento previsto. Lee la pregunta y respuesta frente a esa vista. Abre todos los paneles y enlaces del glosario y vuelve a la historia.
+
+## Invita a alguien a probarla {#invita-a-alguien-a-probarla}
+
+Propón una tarea pequeña: encontrar la primera historia, explicar qué cambia entre dos vistas o localizar la fuente de una afirmación. Observa antes de explicar la interfaz.
+
+Pregunta qué notó, qué entendió y dónde perdió el hilo. Distingue un problema de interfaz de una interpretación que necesita reescritura. Revisa el pasaje y vuelve a probarlo.
+
+## Prueba otras formas de lectura {#prueba-otras-formas-de-lectura}
+
+- Usa una ventana estrecha y un teléfono, si tienes uno disponible.
+- Navega con el teclado: al pasar de un enlace o un control a otro, debe verse en cuál estás, por ejemplo con un borde resaltado.
+- Lee el texto alternativo y las transcripciones junto a los materiales visuales y sonoros.
+- Revisa tamaño del texto, contraste y nombres de botones.
+- Abre los enlaces externos de las fuentes y verifica los créditos.
+- Revisa el idioma de la interfaz y los textos que el sitio aporta automáticamente.
+
+Si una fuente no carga, prueba por separado la ficha de catálogo y el manifiesto. Si falla el encuadre, vuelve al paso y captura o copia de nuevo la vista prevista.
+
+## Prepara la versión que vas a compartir {#prepara-la-versión-que-vas-a-compartir}
+
+Retira del recorrido público el material incompleto. Una historia marcada como **Borrador** no aparece en el índice de historias del sitio, pero sus archivos CSV pueden escribirse en el repositorio de GitHub cuando publicas. **Privada** es un estado distinto: cifra el contenido de la historia y pide una clave para leerlo. Revisa el resultado en el sitio publicado, no solo en el editor.
+
+Registra la dirección pública, la fecha de las pruebas y las limitaciones conocidas. Conserva los archivos fuente y una nota breve sobre cómo volver a generar la exhibición.
+
+**Resultado:** una primera versión probada y una lista breve de mejoras. Si necesitas ayuda para construirla o corregirla, consulta el manual del [Compositor](/guia/el-compositor/), de [Google Sheets](/guia/google-sheets/) o de [autoría local](/guia/autoria-local/).
diff --git a/content/es/guia/primeros-pasos/_index.md b/content/es/guia/primeros-pasos/_index.md
new file mode 100644
index 0000000..b6ce744
--- /dev/null
+++ b/content/es/guia/primeros-pasos/_index.md
@@ -0,0 +1,14 @@
+---
+title: Primeros pasos
+url: /guia/primeros-pasos/
+translationKey: docs-getting-started
+type: guide
+docs_hub: true
+docs_section: guides
+---
+
+<span class="anchor-alias" id="primeros-pasos" aria-hidden="true"></span>
+
+<span class="anchor-alias" id="después-de-la-configuración" aria-hidden="true"></span>
+
+<h1>Elige cómo construir tu exhibición</h1><p class="lede">Empieza con una pregunta y tus fuentes. Después, elige la forma de autoría que te sirva.</p>{{< build-options >}}
diff --git a/content/es/guia/primeros-pasos/agrega-contenido.md b/content/es/guia/primeros-pasos/agrega-contenido.md
new file mode 100644
index 0000000..bc496f7
--- /dev/null
+++ b/content/es/guia/primeros-pasos/agrega-contenido.md
@@ -0,0 +1,72 @@
+---
+title: Agrega un objeto y una primera historia
+url: /guia/primeros-pasos/agrega-contenido/
+translationKey: docs-getting-started-add-content
+type: guide
+docs_section: sheets
+---
+
+# Agrega un objeto y una primera historia {#agrega-un-objeto-y-una-primera-historia}
+
+<span class="anchor-alias" id="construye-tu-sitio"></span>
+
+Empieza con un objeto y una secuencia breve. Cuando funcione el recorrido completo, amplíalo con otras fuentes y capas opcionales.
+
+<span class="anchor-alias" id="agrega-paneles-de-detalle"></span>
+<span class="anchor-alias" id="agrega-tu-contenido"></span>
+<span class="anchor-alias" id="agrega-tus-archivos-multimedia"></span>
+## Agrega la fuente {#agrega-la-fuente}
+
+En **objects**, agrega ID, título, dirección de origen y metadatos útiles. Para una fuente IIIF externa, pega el manifiesto en `source_url`.
+
+Si necesitas un ejemplo para practicar:
+
+```text
+https://juancobo.com/138la/iiif/khipu/p7/manifest.json
+```
+
+Elige el ID `khipu` y un título como “Khipu háptico”. Describe la actividad visible y conserva la información de catálogo y el crédito de la fuente.
+
+Para alojar un archivo propio, súbelo a `telar-content/objects/` en el repositorio, usa su nombre como ID y deja `source_url` vacío. Consulta [las imágenes autoalojadas](/guia/tu-contenido/imagenes-autoalojadas/) para formatos y procesamiento.
+
+<span class="anchor-alias" id="estructura-tu-historia"></span>
+<span class="anchor-alias" id="registra-tus-historias"></span>
+<span class="anchor-alias" id="registra-tus-objetos"></span>
+## Registra la historia {#registra-la-historia}
+
+En **project**, agrega orden, ID estable y título. Por ejemplo:
+
+| order | story_id | title |
+|---|---|---|
+| 1 | historia-khipu | Examinando un khipu |
+
+Crea o renombra la pestaña como `historia-khipu`. El ID y la pestaña deben coincidir. Conserva los encabezados de la plantilla.
+
+## Agrega el primer paso {#agrega-el-primer-paso}
+
+Completa una fila:
+
+| Columna | Ejemplo |
+|---|---|
+| `step` | `1` |
+| `object` | `khipu` |
+| `x`, `y`, `zoom` | `0.5`, `0.5`, `1` |
+| `question` | ¿Qué actividad documenta esta imagen? |
+| `answer` | Una toma de muestras de un khipu para datación por radiocarbono en la primavera de 2025. |
+| `alt_text` | Manos con guantes trabajan con cuerdas anudadas sobre una superficie blanca. |
+
+Agrega otra fila numerada para la siguiente observación. Puedes volver al mismo objeto con otro encuadre. En objetos de varias páginas, la columna opcional `page` elige primero la página.
+
+Para grabaciones, usa `clip_start` y `clip_end` en segundos y `loop` cuando corresponda. Revisa [video](/guia/tu-contenido/objetos-de-video/) y [audio](/guia/tu-contenido/objetos-de-audio/) antes de elegir un proveedor con otro comportamiento de reproducción.
+
+## Agrega profundidad opcional {#agrega-profundidad-opcional}
+
+Escribe contexto adicional en `layer1_content` y un nombre útil para el botón en `layer1_button`. El segundo panel usa `layer2_content` y se abre desde el primero.
+
+Para textos extensos, referencia un archivo Markdown. Agrega términos en **glossary** e inserta enlaces `[[id-del-termino]]` en los campos que los admiten.
+
+## Genera la primera versión {#genera-la-primera-versión}
+
+Guarda los cambios de la hoja. En el repositorio, abre **Actions**, selecciona **Build and Deploy** y después **Run workflow**. El build descarga la hoja publicada.
+
+Espera a que termine y abre el sitio. Sigue con [los encuadres y la revisión](/guia/primeros-pasos/revisa-y-perfecciona/).
diff --git a/content/es/guia/primeros-pasos/como-funciona-telar.md b/content/es/guia/primeros-pasos/como-funciona-telar.md
new file mode 100644
index 0000000..fc713d0
--- /dev/null
+++ b/content/es/guia/primeros-pasos/como-funciona-telar.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/primeros-pasos/como-funciona-telar/
+translationKey: redirects-es-pp-como-funciona-telar-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/primeros-pasos/estructura-narrativa/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/docs/1-1-compositor.es.md b/content/es/guia/primeros-pasos/compositor.md
similarity index 60%
rename from docs/1-1-compositor.es.md
rename to content/es/guia/primeros-pasos/compositor.md
index d217b21..f7307c7 100644
--- a/docs/1-1-compositor.es.md
+++ b/content/es/guia/primeros-pasos/compositor.md
@@ -1,42 +1,45 @@
---
-layout: docs
-title: "1.1. Opción A: Usa el Compositor"
-parent: 1. Primeros pasos
-grand_parent: Documentación
-nav_order: 1
-lang: es
-permalink: /guia/primeros-pasos/compositor/
+title: Usa el Compositor
+url: /guia/primeros-pasos/compositor/
+translationKey: docs-getting-started-compositor
+type: guide
+docs_section: compositor
---
-# Usa el Compositor
+# Usa el Compositor {#usa-el-compositor}
El Compositor de Telar es una herramienta visual para construir exhibiciones. Puedes agregar objetos, escribir historias, organizar pasos y previsualizar tu sitio — todo en el navegador, sin necesidad de programar.
Cuando estés listo, el Compositor publica un sitio Telar completo en GitHub Pages.
-## Lo que necesitas
+## Lo que necesitas {#lo-que-necesitas}
- Una [cuenta de GitHub](https://github.com/join) (gratis)
- Imágenes, videos o archivos de audio para la exhibición
-## Empieza aquí
+## Empieza aquí {#empieza-aquí}
Ve a [compositor.telar.org](https://compositor.telar.org) e inicia sesión con tu cuenta de GitHub. El Compositor te pedirá instalar la aplicación Telar Compositor en GitHub — esto le da permiso para crear y administrar repositorios en tu nombre.
Una vez que hayas iniciado sesión, tienes dos opciones:
-### Crea un sitio nuevo
+### Crea un sitio nuevo {#crea-un-sitio-nuevo}
-Haz clic en **Crear un sitio nuevo**, escribe un nombre para el repositorio — **usa letras minúsculas y guiones** (ej., `mi-exhibicion`) — y el Compositor se encarga del resto: crea el repositorio a partir de la plantilla de Telar, configura GitHub Pages y deja tu sitio listo para editar.
+Abre el menú de proyectos y elige **Agregar o crear un repositorio**; después, **Un sitio de Telar**. Escribe un nombre de repositorio y un título visible, y elige el idioma y el tema. Usa un nombre breve, en minúsculas y con guiones, como `mi-exhibicion`.
-{: .warning }
-> **El repositorio será público.** GitHub Pages requiere un repositorio público a menos que tengas un plan pago de GitHub.
+Pulsa **Crear sitio** cuando estén listos esos datos. El Compositor crea el repositorio con la plantilla de Telar y prepara el sitio para editarlo.
-### Conecta un repositorio existente
+{{< callout "warning" >}}
+**El repositorio será público.** GitHub Pages requiere un repositorio público a menos que tengas un plan pago de GitHub.
+{{< /callout >}}
+
+{{< media id="create-site" >}}
+
+### Conecta un repositorio existente {#conecta-un-repositorio-existente}
Si ya creaste un repositorio a partir de la [plantilla de Telar](https://github.com/UCSB-AMPLab/telar) o tienes un sitio Telar existente, selecciónalo de la lista y el Compositor importará tu contenido.
-<details Markdown="1">
+<details markdown="1">
<summary><strong>Configuración manual: crea un repositorio en GitHub primero</strong></summary>
Si prefieres crear el repositorio tú mismo antes de conectarlo:
@@ -62,7 +65,7 @@ Una vez hecho, vuelve a [compositor.telar.org](https://compositor.telar.org) y c
</details>
-## Qué puedes hacer con el Compositor
+## Qué puedes hacer con el Compositor {#qué-puedes-hacer-con-el-compositor}
- **Editar historias visualmente** — agregar pasos, escribir texto, ajustar coordenadas de imagen y previsualizar la narrativa en tiempo real
- **Subir imágenes** — arrastra y suelta imágenes directamente; las teselas IIIF se generan de forma automática
@@ -71,9 +74,13 @@ Una vez hecho, vuelve a [compositor.telar.org](https://compositor.telar.org) y c
Para la guía completa, véase [El Compositor](/guia/el-compositor/).
-## Siguientes pasos
+{{< media id="editor-overview" >}}
+
+## Siguientes pasos {#siguientes-pasos}
-Una vez que el sitio esté en línea, continúa con el tutorial para aprender más sobre el modelo narrativo de Telar y cómo perfeccionar la exhibición:
+Sigue con el recorrido de autoría visual:
-- **[Planea tu narrativa](/guia/primeros-pasos/estructura-narrativa/)** — conoce cómo se articulan historias, pasos y paneles
-- **[Revisa y perfecciona](/guia/primeros-pasos/revisa-y-perfecciona/)** — ajusta coordenadas de imagen, revisa el sitio y dale los toques finales
+- [Objetos](/guia/el-compositor/objetos/) — Agrega fuentes y revisa sus metadatos.
+- [Usar un objeto IIIF en una historia](/guia/el-compositor/iiif-a-historia/) — Sigue el ejemplo ilustrado del khipu.
+- [Editor de historias](/guia/el-compositor/editor-historias/) — Escribe pasos, captura vistas y desarrolla paneles.
+- [Publicación](/guia/el-compositor/publicacion/) — Revisa los cambios y comprueba el sitio generado.
diff --git a/content/es/guia/primeros-pasos/desarrollo-local.md b/content/es/guia/primeros-pasos/desarrollo-local.md
new file mode 100644
index 0000000..c4ea7ef
--- /dev/null
+++ b/content/es/guia/primeros-pasos/desarrollo-local.md
@@ -0,0 +1,114 @@
+---
+title: Instala y ejecuta Telar localmente
+url: /guia/primeros-pasos/desarrollo-local/
+translationKey: docs-getting-started-local-dev
+type: guide
+docs_section: local
+---
+
+# Instala y ejecuta Telar localmente {#instala-y-ejecuta-telar-localmente}
+
+<span class="anchor-alias" id="publicación-en-github-pages"></span>
+
+<span class="anchor-alias" id="próximos-pasos"></span>
+
+<span class="anchor-alias" id="paso-7-agrega-términos-del-glosario-opcional"></span>
+
+<span class="anchor-alias" id="paso-6-construye-tu-historia"></span>
+
+<span class="anchor-alias" id="paso-5-encuentra-coordenadas-para-momentos-de-historia"></span>
+
+<span class="anchor-alias" id="paso-4-previsualiza-tus-objetos"></span>
+
+<span class="anchor-alias" id="paso-3-cataloga-tus-objetos"></span>
+
+<span class="anchor-alias" id="paso-2-escribe-tu-texto-narrativo"></span>
+
+<span class="anchor-alias" id="paso-1-reúne-tus-imágenes"></span>
+
+<span class="anchor-alias" id="instalación"></span>
+
+<span class="anchor-alias" id="flujo-de-trabajo-paso-a-paso"></span>
+
+<span class="anchor-alias" id="flujo-de-trabajo-de-desarrollo-diario"></span>
+
+<span class="anchor-alias" id="descripción-general"></span>
+
+<span class="anchor-alias" id="desarrollo-local"></span>
+
+<span class="anchor-alias" id="comandos-principales"></span>
+
+Construye una exhibición con archivos CSV y Markdown en tu computador. Este método permite controlar los archivos fuente, el proceso de generación y el alojamiento. También puedes previsualizar un sitio cuyo contenido viene de Google Sheets.
+
+<span class="anchor-alias" id="requisitos-previos"></span>
+## Requisitos {#requisitos}
+
+El build actual de Telar usa Ruby 3.2, Python 3.12 y Node.js 22. Usa Ruby 3.2 o superior dentro de la serie 3.x y Bundler. Los archivos de dependencias de tu versión son la referencia para construirla.
+
+Comprueba los programas en la terminal:
+
+```bash
+ruby -v
+bundle -v
+python3 --version
+node --version
+npm --version
+git --version
+```
+
+Instala lo que falte con el gestor de paquetes o versiones de tu sistema. En macOS, Ruby puede ser demasiado antiguo; revisa la versión en lugar de asumir que la instalación del sistema sirve.
+
+## Obtén tu propia copia {#obtén-tu-propia-copia}
+
+Crea un repositorio a partir de la [plantilla de Telar](https://github.com/UCSB-AMPLab/telar) y clónalo. Reemplaza la dirección del ejemplo:
+
+```bash
+git clone https://github.com/TU-CUENTA/TU-REPOSITORIO.git
+cd TU-REPOSITORIO
+```
+
+También puedes descargar los archivos si no vas a usar Git. Conserva un respaldo separado de los archivos editables.
+
+<span class="anchor-alias" id="instala-ruby-y-bundler"></span>
+## Instala las dependencias {#instala-las-dependencias}
+
+Usa un entorno virtual de Python para separar los paquetes de este proyecto:
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python3 -m pip install -r requirements.txt
+bundle install
+npm ci
+```
+
+En Windows, activa con `.venv\Scripts\Activate.ps1` en PowerShell. Vuelve a activar el mismo entorno al retomar el proyecto. Si falla la instalación, revisa las versiones antes de cambiar los archivos de dependencias.
+
+<span class="anchor-alias" id="clona-y-configura"></span>
+<span class="anchor-alias" id="configura-ajustes-del-sitio"></span>
+Para objetos de audio, instala la herramienta del sistema audiowaveform para preparar la forma de onda. Los límites del fragmento se aplican en el navegador; el script no extrae archivos separados por fragmento.
+
+## Configura el sitio {#configura-el-sitio}
+
+Edita la sección de autoría de `_config.yml`: título, descripción, autoría, idioma y tema. Si vas a editar archivos CSV directamente, configura:
+
+```yaml
+google_sheets:
+ enabled: false
+```
+
+Conserva los ajustes de generación de la plantilla que aparecen más abajo. Si el sitio ocupa la raíz del dominio, `baseurl` queda vacío; en un sitio de proyecto contiene la ruta del repositorio.
+
+## Genera la primera vista previa {#genera-la-primera-vista-previa}
+
+Desde la raíz del repositorio, con el entorno activo:
+
+```bash
+python3 scripts/build_local_site.py
+```
+
+El script procesa contenido, audio y teselas IIIF, genera JavaScript e inicia Jekyll en el puerto 4001. Abre la dirección con la ruta configurada, por ejemplo `http://127.0.0.1:4001/mi-exhibicion/`.
+
+Detén el servidor con Ctrl+C. Usa `--port 4003` si otro sitio ocupa el puerto 4001.
+
+**Comprueba el resultado:** deben cargar el inicio y un objeto de ejemplo. Sigue con [los archivos de contenido](/guia/autoria-local/contenido/).
diff --git a/content/es/guia/primeros-pasos/estructura-narrativa.md b/content/es/guia/primeros-pasos/estructura-narrativa.md
new file mode 100644
index 0000000..6acbfbd
--- /dev/null
+++ b/content/es/guia/primeros-pasos/estructura-narrativa.md
@@ -0,0 +1,59 @@
+---
+title: Planea el recorrido de la historia
+url: /guia/primeros-pasos/estructura-narrativa/
+translationKey: docs-getting-started-narrative-structure
+type: guide
+docs_draft: true
+docs_section: planning
+---
+
+<span class="anchor-alias" id="dibuja-el-arco-narrativo"></span>
+
+# Planea el recorrido de la historia {#planea-el-recorrido-de-la-historia}
+
+<span class="anchor-alias" id="planea-tu-historia"></span>
+
+<span class="anchor-alias" id="paso-2-planea-tu-narrativa"></span>
+
+<span class="anchor-alias" id="paneles-en-capas"></span>
+
+<span class="anchor-alias" id="el-patrón-preguntarespuestainvitación"></span>
+
+Organiza la historia alrededor de una pregunta central. Cada paso debe ayudar a responderla con un detalle o una fuente que el público pueda examinar.
+
+<span class="anchor-alias" id="dale-una-tarea-al-inicio"></span>
+
+## Presenta la fuente y la pregunta {#presenta-la-fuente-y-la-pregunta}
+
+Al comienzo, presenta la fuente, plantea la pregunta y da el contexto que el público necesita para empezar. Elige una primera vista que le permita orientarse. Deja cada detalle para el paso en el que lo vayas a analizar.
+
+En el [planeador narrativo](/assets/templates/telar-worksheet.pdf), el cuadrado representa la introducción. Úsalo para anotar cómo vas a presentar la historia; las preguntas de los pasos van en los círculos.
+
+## Construye una secuencia de preguntas {#construye-una-secuencia-de-preguntas}
+
+Escribe junto a cada círculo la pregunta u observación de un paso. Empieza por detalles que el público pueda reconocer y úsalos para introducir las relaciones o interpretaciones que quieres explicar.
+
+Para una pintura, una posible secuencia es: ¿Qué vemos? ¿Qué detalles identifican el lugar? ¿Por qué se incluyeron? ¿Qué sugiere su distribución? Son preguntas para investigar, no afirmaciones que la imagen demuestre por sí sola.
+
+Anota junto a cada pregunta la fuente o el detalle en que se apoya la respuesta. Si no puedes mostrar esa evidencia, revisa la respuesta, busca otra fuente o señala qué sigue siendo incierto.
+
+{{< story-arc >}}
+
+<span class="anchor-alias" id="escribe-un-cierre-que-se-desprenda-de-los-pasos"></span>
+
+## Cierra la historia retomando la pregunta inicial {#cierra-la-historia-retomando-la-pregunta-inicial}
+
+El triángulo que apunta hacia arriba representa el final de la historia. Vuelve a la pregunta inicial y explica qué aportan los detalles que el público examinó. No dejes para el final la fuente de la que depende toda la interpretación: preséntala durante el recorrido.
+
+Comprueba que alguien que lea solo el recorrido principal, sin abrir los paneles, entienda el cierre. La explicación principal debe entenderse por sí sola; los paneles sirven para ampliar el contexto o profundizar en un argumento.
+
+## Lee la secuencia en voz alta {#lee-la-secuencia-en-voz-alta}
+
+Lee en orden solo las preguntas y las respuestas breves. Luego, pídele a otra persona que haga lo mismo mientras mira los encuadres propuestos.
+
+- Elimina explicaciones repetidas.
+- Si un paso reúne dos observaciones sin relación entre sí, divídelo en dos.
+- Agrega una transición si un cambio de fuente, lugar o época resulta difícil de seguir.
+- Lleva a un panel el contexto especializado que interrumpe el hilo principal.
+
+**Resultado:** un inicio, una secuencia numerada de preguntas con sus fuentes y un cierre provisional. Sigue con [el encuadre de cada paso](/guia/planear/fuentes-y-encuadres/).
diff --git a/docs/1-2-google-sheets-option.es.md b/content/es/guia/primeros-pasos/google-sheets.md
similarity index 90%
rename from docs/1-2-google-sheets-option.es.md
rename to content/es/guia/primeros-pasos/google-sheets.md
index e575270..cca4b55 100644
--- a/docs/1-2-google-sheets-option.es.md
+++ b/content/es/guia/primeros-pasos/google-sheets.md
@@ -1,39 +1,32 @@
---
-layout: docs
-title: "1.2. Opción B: Configura con Google Sheets"
-parent: 1. Primeros pasos
-grand_parent: Documentación
-nav_order: 2
-lang: es
-permalink: /guia/primeros-pasos/google-sheets/
+title: Configura con Google Sheets
+url: /guia/primeros-pasos/google-sheets/
+translationKey: docs-getting-started-google-sheets
+type: guide
extra_css:
- - config-tools
-tutorial_next:
- title: "Planea tu narrativa"
- url: /guia/primeros-pasos/estructura-narrativa/
-tutorial_hide_top: true
+- config-tools
+docs_section: sheets
---
-# Configura con Google Sheets
+# Configura con Google Sheets {#configura-con-google-sheets}
Esta guía te lleva paso a paso por la configuración de una exposición en Telar usando Google Sheets para gestionar tu contenido. Las herramientas interactivas en esta página generan tu archivo de configuración automáticamente.
Vas a configurar tres cosas: un repositorio en GitHub para tu sitio, una hoja de cálculo de Google Sheets para tu contenido y un archivo de configuración para conectarlos. Irás ingresando algunos datos a medida que avanzas — tu nombre de usuario de GitHub, el enlace de tu hoja de cálculo, un título para tu sitio. Al final de esta página, descargarás un archivo de configuración listo para usar.
-## Configura tu sitio
-
-En este primer paso vas a configurar tres cosas: un repositorio en GitHub para tu sitio, una hoja de cálculo en Google Sheets para tu contenido y un archivo de configuración para conectarlos. A medida que avanzas, vas a ingresar algunos datos — tu nombre de usuario de GitHub, el enlace de tu hoja de cálculo, un título para tu sitio. Al final de esta página, vas a descargar un archivo de configuración listo para usar.
+## Configura tu sitio {#configura-tu-sitio}
Vas a necesitar:
- Una [cuenta de GitHub](https://github.com/join) (gratis)
- Una [cuenta de Google](https://accounts.google.com/) para Google Sheets (gratis)
-{: .tip }
-> **¿Ya conoces GitHub Pages y YAML?** Puedes configurar todo manualmente con la [guía de configuración manual](/guia/configuracion/configuracion-manual/).
+{{< callout "tip" >}}
+**¿Ya conoces GitHub Pages y YAML?** Puedes configurar todo manualmente con la [guía de configuración manual](/guia/configuracion/configuracion-manual/).
+{{< /callout >}}
La configuración puede parecer muchos pasos, pero solo tienes que hacerla una vez. Después de eso, todo se maneja desde tu hoja de cálculo de Google Sheets.
-## Crea tu repositorio
+## Crea tu repositorio {#crea-tu-repositorio}
Un repositorio es el espacio de tu proyecto en GitHub — allí se guardan tu archivo de configuración y tus imágenes.
@@ -46,8 +39,9 @@ Un repositorio es el espacio de tu proyecto en GitHub — allí se guardan tu ar
-{: .warning }
-> **Mantén tu repositorio público.** Los repositorios privados no funcionan con GitHub Pages a menos que tengas un plan de pago en GitHub.
+{{< callout "warning" >}}
+**Mantén tu repositorio público.** Los repositorios privados no funcionan con GitHub Pages a menos que tengas un plan de pago en GitHub.
+{{< /callout >}}
Ingresa tus datos de GitHub a continuación. Se usan para construir la dirección web de tu sitio y para generar tu archivo de configuración al final.
@@ -77,7 +71,7 @@ Ingresa tus datos de GitHub a continuación. Se usan para construir la direcció
</div>
</div>
-## Activa GitHub Pages
+## Activa GitHub Pages {#activa-github-pages}
GitHub Pages convierte tu repositorio en un sitio web en vivo, de forma gratuita.
@@ -87,7 +81,7 @@ GitHub Pages convierte tu repositorio en un sitio web en vivo, de forma gratuita
-## Duplica la plantilla de Google Sheets
+## Duplica la plantilla de Google Sheets {#duplica-la-plantilla-de-google-sheets}
Tu hoja de cálculo de Google Sheets es donde manejas todo tu contenido — objetos, historias y textos.
@@ -95,7 +89,7 @@ Tu hoja de cálculo de Google Sheets es donde manejas todo tu contenido — obje
2. Haz clic en **Archivo** → **Hacer una copia**
3. Guárdala en tu Google Drive con un nombre que recuerdes (ej., "Mi exhibición Telar")
-## Publica tu hoja de cálculo
+## Publica tu hoja de cálculo {#publica-tu-hoja-de-cálculo}
Tu hoja de cálculo necesita estar publicada para que Telar pueda leer tu contenido al construir el sitio.
@@ -116,7 +110,7 @@ Tu hoja de cálculo necesita estar publicada para que Telar pueda leer tu conten
</div>
</div>
-## Genera tu configuración
+## Genera tu configuración {#genera-tu-configuración}
Completa los datos restantes y esta página creará tu archivo de configuración.
@@ -192,7 +186,7 @@ Una vez generado:
2. Selecciona todo el contenido existente y reemplázalo con lo que copiaste o descargaste
3. Haz clic en **Commit changes** para guardar
-## Verifica tu configuración
+## Verifica tu configuración {#verifica-tu-configuración}
Después de guardar, GitHub Actions construirá y publicará tu sitio automáticamente. Esto toma entre 2 y 5 minutos.
@@ -202,14 +196,15 @@ Después de guardar, GitHub Actions construirá y publicará tu sitio automátic
-{: .warning }
-> **¿Problemas con el *build*?** Verifica que la URL publicada de Google Sheets sea correcta — debe venir de Archivo → Compartir → Publicar en la Web. Si tu sitio no aparece, revisa la pestaña Actions para ver los detalles del error. También puedes pegar tu `_config.yml` en el [Validador de configuración de Telar](/guia/configurar/validador-de-configuracion/) para verificar errores.
+{{< callout "warning" >}}
+**¿Problemas con el *build*?** Verifica que la URL publicada de Google Sheets sea correcta — debe venir de Archivo → Compartir → Publicar en la Web. Si tu sitio no aparece, revisa la pestaña Actions para ver los detalles del error. También puedes pegar tu `_config.yml` en el [Validador de configuración de Telar](/guia/configurar/validador-de-configuracion/) para verificar errores.
+{{< /callout >}}
---
-## Próximos pasos
+## Próximos pasos {#próximos-pasos}
-Tu sitio Telar ya está funcionando. Sigue este tutorial para aprender cómo funcionan las historias de Telar y agregar tu propio contenido, o salta a la sección que quieras:
+La conexión está lista. Sigue con [el modelo de la hoja](/guia/tus-datos/google-sheets/) y después agrega un objeto y tu primera historia. Usa [la guía de planeación](/guia/planear/) si aún no has preparado la narrativa.
- **[Planea tu narrativa](/guia/primeros-pasos/estructura-narrativa/)** — Conoce cómo se articulan historias, pasos y paneles
- **[Agrega tu contenido](/guia/primeros-pasos/agrega-contenido/)** — Sube imágenes, llena tu hoja de cálculo y crea tu primera historia
@@ -526,8 +521,8 @@ show_drafts: false
# Telar Settings (version information)
telar:
- version: "{{ site.telar_version }}"
- release_date: "{{ site.telar_release_date }}"
+ version: "{{< site-value "telar_version" >}}"
+ release_date: "{{< site-value "telar_release_date" >}}"
# Plugins
plugins:
diff --git a/content/es/guia/primeros-pasos/inicio-rapido.md b/content/es/guia/primeros-pasos/inicio-rapido.md
new file mode 100644
index 0000000..062914d
--- /dev/null
+++ b/content/es/guia/primeros-pasos/inicio-rapido.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/primeros-pasos/inicio-rapido/
+translationKey: redirects-es-pp-inicio-rapido-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/primeros-pasos/google-sheets/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/primeros-pasos/revisa-y-perfecciona.md b/content/es/guia/primeros-pasos/revisa-y-perfecciona.md
new file mode 100644
index 0000000..e451633
--- /dev/null
+++ b/content/es/guia/primeros-pasos/revisa-y-perfecciona.md
@@ -0,0 +1,58 @@
+---
+title: Encuadra, revisa y publica desde Sheets
+url: /guia/primeros-pasos/revisa-y-perfecciona/
+translationKey: docs-getting-started-review-refine
+type: guide
+docs_section: sheets
+---
+
+# Encuadra, revisa y publica desde Sheets {#encuadra-revisa-y-publica-desde-sheets}
+
+<span class="anchor-alias" id="sigue-construyendo"></span>
+
+<span class="anchor-alias" id="próximos-pasos"></span>
+
+<span class="anchor-alias" id="haz-historias-privadas-opcional"></span>
+
+Usa el primer build para elegir vistas precisas y probar la narrativa. Conserva la hoja como fuente mientras revisas.
+
+<span class="anchor-alias" id="ajusta-las-coordenadas-de-imagen"></span>
+## Ajusta el encuadre de cada imagen {#ajusta-el-encuadre-de-cada-imagen}
+
+1. Abre la página del objeto correspondiente en el sitio generado.
+2. Elige **Identificar coordenadas**.
+3. Selecciona la página si el documento tiene varias.
+4. Desplaza y acerca la imagen hasta el detalle del paso.
+5. Copia X, Y y Zoom a la fila del paso.
+6. Vuelve a generar y visita de nuevo ese paso.
+
+En el ejemplo del khipu, encuadra el propio khipu. No uses otra imagen porque ya tengas abierta su herramienta de coordenadas.
+
+{{< media id="coordinates" >}}
+
+<span class="anchor-alias" id="revisa-y-perfecciona"></span>
+## Revisa la historia y las rutas opcionales {#revisa-la-historia-y-las-rutas-opcionales}
+
+Lee las preguntas y respuestas breves en secuencia. Comprueba que la fuente y el encuadre respalden cada observación.
+
+Abre todos los paneles, sigue los enlaces del glosario y vuelve a la historia. Revisa cierre, orden de historias y menú. Prueba una ventana estrecha y la navegación con teclado.
+
+Usa [la guía de pruebas con lectores](/guia/planear/revision/) para revisar con otra persona.
+
+## Publica una revisión de la hoja {#publica-una-revisión-de-la-hoja}
+
+Editar la hoja no ejecuta por sí solo el flujo del repositorio. Inicia **Build and Deploy** desde **Actions** cuando quieras publicar su versión más reciente.
+
+Si falla, abre el registro de ejecución. Confirma la dirección publicada de la hoja y que sigan publicadas las pestañas necesarias. Si carga el sitio, pero no una fuente, revisa el ID y la URL del objeto antes de cambiar otros ajustes.
+
+## Maneja lo privado y lo incompleto {#maneja-lo-privado-y-lo-incompleto}
+
+Una historia privada usa la columna `private` de project y una `story_key` en la configuración. Lee [historias privadas](/guia/funciones/historias-privadas/) antes de usarla. Una clave no vuelve privadas las imágenes alojadas externamente.
+
+Mantén el trabajo incompleto fuera de la lista pública hasta que esté listo. El borrador del Compositor es un proceso del editor; no supongas que marcar una fila como privada la excluye de la publicación.
+
+## Completa la exhibición {#completa-la-exhibición}
+
+Edita la presentación del inicio y las páginas de apoyo, revisa créditos y desactiva el contenido de demostración cuando ya no corresponda. Vuelve a generar y comprueba el resultado público.
+
+Guarda juntas las direcciones de la hoja, el repositorio y el sitio. Anota cuál es la fuente de edición para que los colaboradores sepan dónde hacer el próximo cambio.
diff --git a/content/es/guia/referencia/_index.md b/content/es/guia/referencia/_index.md
new file mode 100644
index 0000000..8401aa7
--- /dev/null
+++ b/content/es/guia/referencia/_index.md
@@ -0,0 +1,9 @@
+---
+title: Referencia
+url: /guia/referencia/
+translationKey: docs-reference
+type: guide
+docs_section: reference
+---
+
+{{< section-overview >}}
diff --git a/content/es/guia/referencia/configuracion.md b/content/es/guia/referencia/configuracion.md
new file mode 100644
index 0000000..157521a
--- /dev/null
+++ b/content/es/guia/referencia/configuracion.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/referencia/configuracion/
+translationKey: redirects-es-ref-configuracion-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/configurar/configuracion/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/referencia/csv-historias-glosario.md b/content/es/guia/referencia/csv-historias-glosario.md
new file mode 100644
index 0000000..ae43b1f
--- /dev/null
+++ b/content/es/guia/referencia/csv-historias-glosario.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/referencia/csv-historias-glosario/
+translationKey: redirects-es-ref-csv-historias-glosario-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/tus-datos/csv-historias/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/referencia/csv-proyecto-objetos.md b/content/es/guia/referencia/csv-proyecto-objetos.md
new file mode 100644
index 0000000..c68411f
--- /dev/null
+++ b/content/es/guia/referencia/csv-proyecto-objetos.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/referencia/csv-proyecto-objetos/
+translationKey: redirects-es-ref-csv-proyecto-objetos-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/tus-datos/csv-proyecto/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/referencia/generador-de-configuracion.md b/content/es/guia/referencia/generador-de-configuracion.md
new file mode 100644
index 0000000..fcb059f
--- /dev/null
+++ b/content/es/guia/referencia/generador-de-configuracion.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/referencia/generador-de-configuracion/
+translationKey: redirects-es-ref-generador-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/configurar/generador-de-configuracion/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/referencia/sintaxis-markdown.md b/content/es/guia/referencia/sintaxis-markdown.md
new file mode 100644
index 0000000..2e8f2ec
--- /dev/null
+++ b/content/es/guia/referencia/sintaxis-markdown.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/referencia/sintaxis-markdown/
+translationKey: redirects-es-ref-sintaxis-markdown-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/tu-contenido/sintaxis-markdown/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guia/referencia/validador-de-configuracion.md b/content/es/guia/referencia/validador-de-configuracion.md
new file mode 100644
index 0000000..f9f974c
--- /dev/null
+++ b/content/es/guia/referencia/validador-de-configuracion.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guia/referencia/validador-de-configuracion/
+translationKey: redirects-es-ref-validador-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/configurar/validador-de-configuracion/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/docs/4-0-your-content.es.md b/content/es/guia/tu-contenido/_index.md
similarity index 65%
rename from docs/4-0-your-content.es.md
rename to content/es/guia/tu-contenido/_index.md
index b7d7095..1de6dc2 100644
--- a/docs/4-0-your-content.es.md
+++ b/content/es/guia/tu-contenido/_index.md
@@ -1,16 +1,14 @@
---
-layout: docs
-title: "4. Tu contenido"
-parent: Documentación
-nav_order: 4
-has_children: true
-lang: es
-permalink: /guia/tu-contenido/
+title: Tu contenido
+url: /guia/tu-contenido/
+translationKey: docs-your-content
+type: guide
+docs_section: reference
---
-# Tu contenido
+# Tu contenido {#tu-contenido}
-Tu exhibición se construye a partir de varios tipos de contenido — objetos, imágenes, historias y páginas de apoyo. Todo el contenido fuente está en la carpeta `telar-content/` de tu repositorio. La estructura se define a través de archivos de hoja de cálculo (con [Google Sheets](/guia/tus-datos/google-sheets/) o [CSV](/guia/tus-datos/csv-proyecto/)), y el contenido narrativo extenso se escribe en archivos Markdown.
+Los objetos, las historias, los paneles y las páginas de apoyo forman la exhibición. Esta referencia explica sus archivos fuente y formatos. Usa el [manual del Compositor](/guia/el-compositor/) para edición visual, el [de Sheets](/guia/google-sheets/) para hojas de cálculo o el [de autoría local](/guia/autoria-local/) para CSV y Markdown. Los tres métodos generan un sitio estático.
- [Objetos](/guia/tu-contenido/objetos/) — Los elementos visuales que tus historias exploran — imágenes, mapas, documentos, fotografías
- [Imágenes autoalojadas](/guia/tu-contenido/imagenes-autoalojadas/) — Sube tus propias imágenes y Telar genera teselas ampliables automáticamente
diff --git a/docs/4-5-rich-content.es.md b/content/es/guia/tu-contenido/contenido-enriquecido.md
similarity index 71%
rename from docs/4-5-rich-content.es.md
rename to content/es/guia/tu-contenido/contenido-enriquecido.md
index f535691..fae05d4 100644
--- a/docs/4-5-rich-content.es.md
+++ b/content/es/guia/tu-contenido/contenido-enriquecido.md
@@ -1,21 +1,23 @@
---
-layout: docs
-title: "4.5. Contenido enriquecido con Markdown"
-parent: "4. Tu contenido"
-grand_parent: Documentación
-nav_order: 5
-lang: es
-permalink: /guia/tu-contenido/contenido-enriquecido/
+title: Contenido enriquecido con Markdown
+url: /guia/tu-contenido/contenido-enriquecido/
+translationKey: docs-your-content-rich-content
+type: guide
+docs_section: reference
---
-# Contenido enriquecido con Markdown
+# Contenido enriquecido con Markdown {#contenido-enriquecido-con-markdown}
Tu sitio está funcionando y tus historias están en la hoja de cálculo. Ahora quieres paneles más ricos — esta guía te muestra cómo agregar archivos Markdown para paneles de historias que necesiten más que unos pocos párrafos de texto.
-{: .note }
-> Esta guía se construye sobre las guías de configuración. Completa una de las opciones de [Primeros pasos](/guia/primeros-pasos/) primero si aún no lo has hecho.
+{{< callout "note" >}}
+Esta guía se construye sobre las guías de configuración. Completa una de las opciones de [Primeros pasos](/guia/primeros-pasos/) primero si aún no lo has hecho.
+{{< /callout >}}
-## Cuándo agregar archivos Markdown
+
+Esta página explica el contenido de paneles en archivos y hojas de cálculo. En el Compositor, edita el título en su campo y el contenido en el editor del panel; la misma referencia de formato se aplica al cuerpo.
+
+## Cuándo agregar archivos Markdown {#cuándo-agregar-archivos-markdown}
La hoja de cálculo maneja bien la mayoría de las exposiciones en Telar. Considera agregar archivos Markdown cuando necesites:
@@ -27,13 +29,13 @@ La hoja de cálculo maneja bien la mayoría de las exposiciones en Telar. Consid
Si tus paneles son en su mayoría de 1-2 párrafos, probablemente no necesitas este flujo de trabajo. Quédate con Google Sheets y regresa aquí si tus necesidades crecen.
-## Cómo funciona
+## Cómo funciona {#cómo-funciona}
El enfoque híbrido es sencillo: la estructura de tu historia se mantiene en Google Sheets, pero en lugar de escribir el texto del panel en una celda de la hoja de cálculo, apuntas a un archivo Markdown en tu repositorio.
Telar detecta la diferencia automáticamente. Si el valor en una celda de `layer1_content` o `layer2_content` termina en `.md`, Telar carga el archivo. De lo contrario, trata el valor como texto directo. Puedes mezclar ambos enfoques libremente — algunos pasos con texto directo, otros con referencias a archivos.
-## Paso 1: crea tu archivo Markdown
+## Paso 1: crea tu archivo Markdown {#paso-1-crea-tu-archivo-markdown}
1. En tu repositorio de GitHub, navega a `telar-content/texts/stories/`
2. Si tu historia es `story-1`, crea una carpeta llamada `story-1/` (o el nombre que prefieras)
@@ -48,24 +50,24 @@ Telar detecta la diferencia automáticamente. Si el valor en una celda de `layer
-{: .tip }
-
-> **Organización de archivos**
-> Un patrón común es una carpeta por historia, con archivos nombrados por paso y tema:
->
-> ```
-> telar-content/texts/stories/
-> story-1/
-> paso1-tecnicas.md
-> paso2-materiales.md
-> paso3-historia.md
-> story-2/
-> paso1-panorama.md
-> ```
->
-> Cualquier organización funciona — a Telar solo le importa la ruta que pongas en la hoja de cálculo.
-
-## Paso 2: vincula el archivo desde tu hoja de cálculo
+{{< callout "tip" >}}
+**Organización de archivos**
+Un patrón común es una carpeta por historia, con archivos nombrados por paso y tema:
+
+```
+telar-content/texts/stories/
+ story-1/
+ paso1-tecnicas.md
+ paso2-materiales.md
+ paso3-historia.md
+ story-2/
+ paso1-panorama.md
+```
+
+Cualquier organización funciona — a Telar solo le importa la ruta que pongas en la hoja de cálculo.
+{{< /callout >}}
+
+## Paso 2: vincula el archivo desde tu hoja de cálculo {#paso-2-vincula-el-archivo-desde-tu-hoja-de-cálculo}
En tu Google Sheet, pon la ruta del archivo en la columna `layer1_content` o `layer2_content`. La ruta es relativa a `telar-content/texts/stories/`:
@@ -77,9 +79,9 @@ En tu Google Sheet, pon la ruta del archivo en la columna `layer1_content` o `la
Observa cómo el paso 2 usa texto directo mientras que los pasos 1 y 3 referencian archivos. Puedes mezclar ambos métodos libremente.
-## Escribir contenido en Markdown
+## Escribir contenido en Markdown {#escribir-contenido-en-markdown}
-### Estructura básica
+### Estructura básica {#estructura-básica}
Un archivo Markdown para un panel de historia se ve así:
@@ -99,7 +101,7 @@ que antecede al contacto europeo por miles de años.
El `title` en el *frontmatter* (la sección entre las líneas `---`) se convierte en el encabezado del panel. Si lo omites, Telar usa el texto del botón.
-### Formato básico
+### Formato básico {#formato-básico}
Markdown usa caracteres sencillos para dar formato:
@@ -113,12 +115,12 @@ Markdown usa caracteres sencillos para dar formato:
| `[texto](url)` | Un enlace |
| `> cita` | Una cita en bloque |
-{: .tip }
+{{< callout "tip" >}}
+**¿Nuevo en Markdown?**
+Prueba el [tutorial de CommonMark](https://commonmark.org/help/) — toma unos 10 minutos y cubre todo lo que necesitas para los paneles de Telar.
+{{< /callout >}}
-> **¿Nuevo en Markdown?**
-> Prueba el [tutorial de CommonMark](https://commonmark.org/help/) — toma unos 10 minutos y cubre todo lo que necesitas para los paneles de Telar.
-
-### Qué pueden hacer los archivos Markdown que el texto directo no puede
+### Qué pueden hacer los archivos Markdown que el texto directo no puede {#qué-pueden-hacer-los-archivos-markdown-que-el-texto-directo-no-puede}
Los archivos Markdown admiten todas las funciones de contenido de Telar:
@@ -129,7 +131,7 @@ Los archivos Markdown admiten todas las funciones de contenido de Telar:
Estas funciones se manejan mejor en archivos porque usan sintaxis de varias líneas que es difícil de administrar dentro de una celda de hoja de cálculo.
-## Editar archivos Markdown en GitHub
+## Editar archivos Markdown en GitHub {#editar-archivos-markdown-en-github}
No necesitas instalar nada para editar archivos Markdown. GitHub tiene un editor integrado:
@@ -140,11 +142,11 @@ No necesitas instalar nada para editar archivos Markdown. GitHub tiene un editor
GitHub también muestra una pestaña **Preview** para que puedas verificar el formato antes de hacer *commit*.
-{: .note }
-
-> **Después de editar archivos, recuerda reconstruir.** Ve a **Actions** → **Build and Deploy** → **Run workflow** para ver tus cambios en el sitio en vivo.
+{{< callout "note" >}}
+**Después de editar archivos, recuerda reconstruir.** Ve a **Actions** → **Build and Deploy** → **Run workflow** para ver tus cambios en el sitio en vivo.
+{{< /callout >}}
-## Próximos pasos
+## Próximos pasos {#próximos-pasos}
- [Referencia de sintaxis Markdown](/guia/tu-contenido/sintaxis-markdown/) — guía completa de formato con widgets y medios
- [Tu contenido](/guia/tu-contenido/) — cómo Telar organiza los archivos
diff --git a/docs/4-8-pdf-documents.es.md b/content/es/guia/tu-contenido/documentos-pdf.md
similarity index 71%
rename from docs/4-8-pdf-documents.es.md
rename to content/es/guia/tu-contenido/documentos-pdf.md
index 7882599..741bb84 100644
--- a/docs/4-8-pdf-documents.es.md
+++ b/content/es/guia/tu-contenido/documentos-pdf.md
@@ -1,20 +1,18 @@
---
-layout: docs
-title: "4.8. Documentos PDF"
-parent: "4. Tu contenido"
-grand_parent: Documentación
-nav_order: 8
-lang: es
-permalink: /guia/tu-contenido/documentos-pdf/
+title: Documentos PDF
+url: /guia/tu-contenido/documentos-pdf/
+translationKey: docs-your-content-pdf-documents
+type: guide
+docs_section: reference
---
-# Documentos PDF
+# Documentos PDF {#documentos-pdf}
Telar puede mostrar documentos PDF de múltiples páginas — libros, registros legales, manuscritos, mapas — como objetos ampliables de alta resolución. Cada página de un PDF se convierte en una imagen con zoom profundo, igual que una fotografía o un escaneo.
Esto permite construir historias que amplían páginas y regiones específicas de un documento, guiando al público a través de detalles que de otra manera podrían pasar desapercibidos.
-## Agregar un PDF
+## Agregar un PDF {#agregar-un-pdf}
Agregar un PDF funciona de la misma manera que agregar una imagen. Coloca el archivo en `telar-content/objects/` con un nombre que coincida con el `object_id` en tu hoja de cálculo.
@@ -36,10 +34,11 @@ Por ejemplo, si tu hoja de cálculo tiene un objeto con `object_id` = `leyes-nue
python3 scripts/generate_iiif.py --base-url http://localhost:4001
```
-{: .note }
-> Telar renderiza cada página del PDF como una imagen de alta resolución durante el proceso de *build*. Un PDF de 40 páginas producirá 40 imágenes de página separadas, cada una con su propio conjunto de teselas de zoom. El tiempo de *build* aumenta con el número de páginas.
+{{< callout "note" >}}
+Telar renderiza cada página del PDF como una imagen de alta resolución durante el proceso de *build*. Un PDF de 40 páginas producirá 40 imágenes de página separadas, cada una con su propio conjunto de teselas de zoom. El tiempo de *build* aumenta con el número de páginas.
+{{< /callout >}}
-## Cómo funciona
+## Cómo funciona {#cómo-funciona}
Cuando agregas un PDF y construyes tu sitio:
@@ -49,7 +48,7 @@ Cuando agregas un PDF y construyes tu sitio:
4. En las páginas de objetos, el visor muestra el documento completo con controles de navegación por páginas
5. En las historias, cada paso puede hacer referencia a una página específica
-## Páginas de objetos vs. historias
+## Páginas de objetos vs. historias {#páginas-de-objetos-vs-historias}
Los PDF se comportan de manera diferente según el contexto:
@@ -57,7 +56,7 @@ Los PDF se comportan de manera diferente según el contexto:
- **Historias** muestran una página a la vez. Cada paso de la historia especifica qué página mostrar usando la columna `pagina` en tu hoja de cálculo. El visor amplía las coordenadas que configuraste para esa página, igual que lo hace con una fotografía.
-## Enlazar a una página del documento
+## Enlazar a una página del documento {#enlazar-a-una-página-del-documento}
Para llevar a alguien directo a una página concreta de un documento, abre la página del objeto, ve a esa página con los controles de navegación y copia la URL de la barra de direcciones. La URL termina en `?page=` y el número de página:
@@ -75,7 +74,7 @@ Funciona igual con cualquier objeto de varias páginas, incluidos los que vienen
Puedes usar esta URL en cualquier enlace del sitio, por ejemplo en una entrada del glosario o en un panel.
-## Usar PDF en historias
+## Usar PDF en historias {#usar-pdf-en-historias}
Para hacer referencia a una página específica de un PDF en un paso de la historia, agrega una columna `pagina` a tu hoja de cálculo. El valor es el número de página (comenzando desde 1).
@@ -89,17 +88,18 @@ paso,objeto,x,y,zoom,pagina,pregunta,respuesta
- Los pasos 1 y 2 hacen referencia a las páginas 1 y 10 del PDF `leyes-nuevas`
- El paso 3 hace referencia a una imagen regular (`textil-001`) sin valor de `pagina` — la columna se deja vacía para objetos de una sola imagen
-{: .tip }
-> **Encontrar coordenadas para una página específica.** Navega a la página de objeto de tu PDF (`/objects/leyes-nuevas/`). Usa los controles de navegación para ir a la página que deseas. Luego usa el selector de coordenadas — incluye automáticamente el número de página actual en los valores copiados.
+{{< callout "tip" >}}
+**Encontrar coordenadas para una página específica.** Navega a la página de objeto de tu PDF (`/objects/leyes-nuevas/`). Usa los controles de navegación para ir a la página que deseas. Luego usa el selector de coordenadas — incluye automáticamente el número de página actual en los valores copiados.
+{{< /callout >}}
-### La columna `pagina`
+### La columna `pagina` {#la-columna-pagina}
- **Los números de página comienzan en 1** (la página 1 es la primera página del PDF)
- **Debe ser un número entero positivo** — valores decimales o negativos producen una advertencia
- **Dejar vacío para objetos de una sola imagen** — Telar ignora los valores vacíos de `pagina`
- **Nombres de columna bilingües**: `page` (inglés) o `pagina` / `página` (español)
-## Tipos de PDF compatibles
+## Tipos de PDF compatibles {#tipos-de-pdf-compatibles}
Telar renderiza PDF usando PyMuPDF, que maneja la mayoría de los archivos PDF estándar:
@@ -107,10 +107,11 @@ Telar renderiza PDF usando PyMuPDF, que maneja la mayoría de los archivos PDF e
- **PDF nativos** — Documentos con texto incrustado y gráficos vectoriales
- **PDF mixtos** — Documentos que combinan imágenes escaneadas y texto nativo
-{: .note }
-> La calidad del renderizado depende del documento fuente. Las páginas escaneadas a 300 DPI o más producen los mejores resultados de zoom profundo. Los escaneos de baja resolución pueden verse borrosos al ampliar.
+{{< callout "note" >}}
+La calidad del renderizado depende del documento fuente. Las páginas escaneadas a 300 DPI o más producen los mejores resultados de zoom profundo. Los escaneos de baja resolución pueden verse borrosos al ampliar.
+{{< /callout >}}
-## Consideraciones de tamaño
+## Consideraciones de tamaño {#consideraciones-de-tamaño}
Los PDF producen más datos que las imágenes individuales porque cada página genera su propia pirámide de teselas:
@@ -118,36 +119,38 @@ Los PDF producen más datos que las imágenes individuales porque cada página g
- Un documento de 100 páginas puede aumentar significativamente el tiempo de *build* y el tamaño del repositorio
- Considera usar solo las páginas que necesitas en lugar de incluir el documento completo
-{: .note }
-> **Si tu sitio está alojado en GitHub Pages** (el caso por defecto en la mayoría de sitios Telar), ten en cuenta que GitHub no permite archivos individuales de más de 100 MB, y recomienda mantener el tamaño total del repositorio por debajo de 1 GB. Un PDF grande más todas las teselas de zoom que genera puede sumar rápidamente.
+{{< callout "note" >}}
+**Si tu sitio está alojado en GitHub Pages** (el caso por defecto en la mayoría de sitios Telar), ten en cuenta que GitHub no permite archivos individuales de más de 100 MB, y recomienda mantener el tamaño total del repositorio por debajo de 1 GB. Un PDF grande más todas las teselas de zoom que genera puede sumar rápidamente.
+{{< /callout >}}
-{: .tip }
-> **Para documentos muy grandes** (más de 100 páginas), verifica si una biblioteca o archivo ya aloja una versión digitalizada con un manifiesto IIIF. Si es así, puedes usar la URL del manifiesto en la columna `source_url` en lugar de autoalojar el PDF. Consulta [IIIF externo](/guia/tu-contenido/iiif-externo/) para saber cómo encontrar y usar estos manifiestos.
+{{< callout "tip" >}}
+**Para documentos muy grandes** (más de 100 páginas), verifica si una biblioteca o archivo ya aloja una versión digitalizada con un manifiesto IIIF. Si es así, puedes usar la URL del manifiesto en la columna `source_url` en lugar de autoalojar el PDF. Consulta [IIIF externo](/guia/tu-contenido/iiif-externo/) para saber cómo encontrar y usar estos manifiestos.
+{{< /callout >}}
-## Solución de problemas
+## Solución de problemas {#solución-de-problemas}
-### El PDF no carga
+### El PDF no carga {#el-pdf-no-carga}
- Verifica que el archivo exista en `telar-content/objects/`
- Asegúrate de que el nombre del archivo (sin `.pdf`) coincida con el `object_id` en tu hoja de cálculo
- Verifica que el objeto tenga la columna `source_url` vacía
- Asegúrate de que las teselas IIIF se hayan generado (verifica que exista `iiif/objects/{object-id}/`)
-### Se muestra la página incorrecta en la historia
+### Se muestra la página incorrecta en la historia {#se-muestra-la-página-incorrecta-en-la-historia}
- Verifica el valor de `pagina` en tu hoja de cálculo — debe ser un número entero positivo
- Los números de página comienzan en 1, no en 0
- Usa el selector de coordenadas en la página del objeto para verificar el número de página correcto
-### Errores de *build*
+### Errores de *build* {#errores-de-build}
- Asegúrate de que PyMuPDF esté instalado (`pip install pymupdf`)
- Si PyMuPDF no está disponible, Telar omite los archivos PDF con un mensaje informativo — los demás objetos se procesan normalmente
-## Ver también
+## Ver también {#ver-también}
- [Imágenes autoalojadas](/guia/tu-contenido/imagenes-autoalojadas/) — Agregar fotografías y escaneos
- [Objetos](/guia/tu-contenido/objetos/) — Definir objetos en tu hoja de cálculo
-- [Historias y paneles](/guia/tu-contenido/historias-y-paneles/) — Construir pasos de historias
+- [Historias y paneles](/guia/tu-contenido/historias-paneles/) — Construir pasos de historias
- [Columnas de historias](/guia/tus-datos/csv-historias/) — Referencia completa de columnas incluyendo la columna `pagina`
- [IIIF externo](/guia/tu-contenido/iiif-externo/) — Usar manifiestos IIIF de bibliotecas y archivos
diff --git a/docs/4-4-stories-panels.es.md b/content/es/guia/tu-contenido/historias-paneles.md
similarity index 78%
rename from docs/4-4-stories-panels.es.md
rename to content/es/guia/tu-contenido/historias-paneles.md
index ae2a409..667b72f 100644
--- a/docs/4-4-stories-panels.es.md
+++ b/content/es/guia/tu-contenido/historias-paneles.md
@@ -1,21 +1,20 @@
---
-layout: docs
-title: "4.4. Historias y paneles"
-parent: "4. Tu contenido"
-grand_parent: Documentación
-nav_order: 4
-lang: es
-permalink: /guia/tu-contenido/historias-paneles/
+title: Historias y paneles
+url: /guia/tu-contenido/historias-paneles/
+translationKey: docs-your-content-stories-panels
+type: guide
+docs_section: reference
---
-# Historias y paneles
+# Historias y paneles {#historias-y-paneles}
Las historias son narrativas que se leen desplazándose y se construyen en torno a los objetos. Cada historia lleva al público por una secuencia de pasos — que enfocan regiones concretas de las imágenes, momentos de los videos o segmentos de las grabaciones de audio — con pares de pregunta y respuesta y paneles de detalle expandibles.
-{: .tip }
-> El [editor de historias del Compositor](/guia/el-compositor/editor-historias/) te permite hacer lo mismo sin editar las hojas de cálculo a mano: construir y reordenar pasos, configurar coordenadas y previsualizar la historia sin salir del navegador.
+{{< callout "tip" >}}
+El [editor de historias del Compositor](/guia/el-compositor/editor-historias/) te permite hacer lo mismo sin editar las hojas de cálculo a mano: construir y reordenar pasos, configurar coordenadas y previsualizar la historia sin salir del navegador.
+{{< /callout >}}
-## Cómo funciona la experiencia de desplazamiento
+## Cómo funciona la experiencia de desplazamiento {#cómo-funciona-la-experiencia-de-desplazamiento}
Una historia llena la ventana del navegador. El objeto — ya sea una imagen en el visor IIIF, un reproductor de video o uno de audio — ocupa todo el fondo. A medida que se avanza en la historia, las tarjetas de texto pasan por encima una tras otra, en lugar de quedar apiladas.
@@ -31,7 +30,7 @@ Cada paso:
2. Muestra una **pregunta** y una breve **respuesta** en la tarjeta de texto
3. Puede ofrecer hasta dos capas adicionales de detalle mediante botones expandibles
-## Registrar historias
+## Registrar historias {#registrar-historias}
Antes de construir los pasos de una historia, regístrala en `project.csv`:
@@ -44,9 +43,9 @@ El `story_id` determina el nombre del archivo CSV de la historia y su URL. Con `
Si se omite `story_id`, Telar usa `story-{order}` (p. ej., `story-1.csv` si `order` es 1).
-Consulta la [Referencia CSV: Proyecto](/guia/tus-datos/csv-proyecto/#project-csv-projectcsv--proyectocsv) para todas las columnas de project.csv.
+Consulta la [Referencia CSV: Proyecto](/guia/tus-datos/csv-proyecto/#csv-de-proyecto-projectcsv--proyectocsv) para todas las columnas de project.csv.
-## Construir los pasos de la historia
+## Construir los pasos de la historia {#construir-los-pasos-de-la-historia}
Cada historia tiene su propio archivo CSV en `telar-content/spreadsheets/`. El archivo define los pasos en secuencia:
@@ -57,7 +56,7 @@ step,object,x,y,zoom,question,answer,layer1_content
3,map-lima,0.5,0.5,1.0,¿Dónde se encontraron estos textiles?,En el centro histórico de Lima,Las excavaciones arqueológicas de los años 1990...
```
-### Campos requeridos
+### Campos requeridos {#campos-requeridos}
Cada paso necesita:
@@ -67,7 +66,7 @@ Cada paso necesita:
- **`question`** — El encabezado que se muestra en la tarjeta de texto
- **`answer`** — Una respuesta breve debajo de la pregunta
-### Coordenadas
+### Coordenadas {#coordenadas}
Las coordenadas le indican al visor dónde enfocar en cada paso. Los valores de `x` y `y` van de 0 a 1:
@@ -79,7 +78,7 @@ Para encontrar coordenadas, usa el **selector de coordenadas** en cualquier pág
-## Tarjetas de título
+## Tarjetas de título {#tarjetas-de-título}
Las tarjetas de título son pasos de solo texto, sin objeto asociado. Funcionan bien como encabezados de capítulo, separadores de sección o transiciones temáticas dentro de una historia.
@@ -94,24 +93,25 @@ paso,objeto,x,y,zoom,pregunta,respuesta
Las tarjetas de título participan plenamente en la navegación — el desplazamiento, el teclado y los [enlaces profundos](#compartir-y-enlaces-profundos) funcionan como se espera. Las tarjetas de título no admiten paneles de capas — las columnas de capa se ignoran, igual que `x`, `y` y `zoom`.
-### Tabla de contenidos de secciones
+### Tabla de contenidos de secciones {#tabla-de-contenidos-de-secciones}
Si la historia usa tarjetas de título como encabezados de capítulo, se puede mostrar una tabla de contenidos navegable en la tarjeta de inicio. Actívala agregando `mostrar_secciones: si` (o `show_sections: yes`) en la fila de la historia en `project.csv`.
Cuando está activada, la tarjeta de inicio recorre la historia en busca de tarjetas de título y las lista como enlaces. Al hacer clic en uno se salta directamente a esa sección. La tarjeta de inicio también cambia a un fondo más oscuro (el color del panel de nivel 2) para distinguirla visualmente.
-{: .tip }
-> Si el primer capítulo comienza inmediatamente después de la tarjeta de inicio, crea también una tarjeta de título para ese capítulo. La tabla de contenidos solo lista las tarjetas de título que existan en el CSV de la historia — si el capítulo 1 no tiene tarjeta de título, no aparecerá en la tabla de contenidos.
+{{< callout "tip" >}}
+Si el primer capítulo comienza inmediatamente después de la tarjeta de inicio, crea también una tarjeta de título para ese capítulo. La tabla de contenidos solo lista las tarjetas de título que existan en el CSV de la historia — si el capítulo 1 no tiene tarjeta de título, no aparecerá en la tabla de contenidos.
+{{< /callout >}}
Consulta [Columnas del proyecto](/guia/tus-datos/csv-proyecto/) para la referencia de la columna `mostrar_secciones`.
-### Botón de volver al comienzo
+### Botón de volver al comienzo {#botón-de-volver-al-comienzo}
Cuando se avanza más allá de la tarjeta de inicio, el botón **Volver al inicio** de la esquina superior izquierda cambia a **Comienzo**. Al hacer clic regresa a la tarjeta de inicio. En la tarjeta de inicio, el botón vuelve a mostrar "Volver al inicio" y enlaza a la página principal.
Esto es automático — no requiere configuración.
-## Capas de los paneles
+## Capas de los paneles {#capas-de-los-paneles}
Cada paso puede tener hasta dos capas de detalle adicional, siguiendo el patrón QAI (pregunta, respuesta, invitación). La pregunta y la respuesta aparecen en la tarjeta de texto. La invitación es el conjunto de botones que abren paneles expandibles con contenido más profundo:
@@ -127,14 +127,15 @@ Para cada capa, agrega dos columnas a la hoja de cálculo de tu historia:
Si una capa no tiene contenido, su botón se oculta automáticamente. A la capa 2 se entra desde la capa 1: su botón aparece al final del panel de la Capa 1, no en la tarjeta de texto principal.
-## Escribir contenido para los paneles
+## Escribir contenido para los paneles {#escribir-contenido-para-los-paneles}
Puedes escribir el contenido de los paneles de tres maneras. Elige según la complejidad del contenido:
-{: .note }
-> Los tres métodos que siguen son para quien trabaja en una hoja de cálculo. En el Compositor, el título del panel tiene su propio campo, y todo lo que pegues en el campo **Contenido** —incluido un bloque `---`— se publica como parte del texto del panel, no como título.
+{{< callout "note" >}}
+Los tres métodos que siguen son para quien trabaja en una hoja de cálculo. En el Compositor, el título del panel tiene su propio campo, y todo lo que pegues en el campo **Contenido** —incluido un bloque `---`— se publica como parte del texto del panel, no como título.
+{{< /callout >}}
-### Método 1: introducir texto directamente
+### Método 1: introducir texto directamente {#método-1-introducir-texto-directamente}
Escribe el texto directamente en la celda de la hoja de cálculo. Ideal para paneles cortos (1–2 párrafos).
@@ -150,14 +151,15 @@ Para saltos de línea dentro de una celda:
- **Archivos CSV**: Usa saltos de línea reales dentro de texto entre comillas
- **Alternativa**: Usa etiquetas HTML `<br>`
-### Método 2: pegar texto Markdown
+### Método 2: pegar texto Markdown {#método-2-pegar-texto-markdown}
Pega texto escrito en un editor de texto plano. Así puedes usar todas las funciones de Markdown: encabezados, *widgets* (acordeón, carrusel, pestañas), control del tamaño de las imágenes y un título de panel propio con frontmatter YAML.
-{: .warning }
-> Si copias y pegas desde Microsoft Word, Google Docs o aplicaciones similares, el formato **no** se conservará. Escribe directamente en sintaxis Markdown — consulta la [Guía de sintaxis Markdown](/guia/tu-contenido/sintaxis-markdown/).
+{{< callout "warning" >}}
+Si copias y pegas desde Microsoft Word, Google Docs o aplicaciones similares, el formato **no** se conservará. Escribe directamente en sintaxis Markdown — consulta la [Guía de sintaxis Markdown](/guia/tu-contenido/sintaxis-markdown/).
+{{< /callout >}}
-### Método 3: indicar un archivo Markdown
+### Método 3: indicar un archivo Markdown {#método-3-indicar-un-archivo-markdown}
Indica la ruta a un archivo Markdown en el repositorio. Ideal para paneles complejos — sobre todo los que llevan *widgets* o contenido que se quiera reutilizar en varios pasos.
@@ -170,7 +172,7 @@ Guarda los archivos Markdown en `telar-content/texts/stories/`. En la hoja de c
**Cómo decide Telar**: si el valor termina en `.md` y ese archivo existe, Telar carga el archivo; si no, trata el valor como contenido.
-### Elegir el método correcto
+### Elegir el método correcto {#elegir-el-método-correcto}
| Escenario | Método recomendado |
|----------|-------------------|
@@ -180,7 +182,7 @@ Guarda los archivos Markdown en `telar-content/texts/stories/`. En la hoja de c
| Mismo contenido usado en varios lugares | Método 3: Archivo |
| Ediciones rápidas sin salir de la hoja de cálculo | Método 1 o 2 |
-## Archivos Markdown de las historias
+## Archivos Markdown de las historias {#archivos-markdown-de-las-historias}
Al usar el Método 3 (archivos), los archivos Markdown de las historias se ubican en `telar-content/texts/stories/`:
@@ -198,7 +200,7 @@ telar-content/texts/stories/
Organizar los archivos en subcarpetas por historia facilita el manejo a medida que crece el sitio.
-### Título del panel
+### Título del panel {#título-del-panel}
Agrega un título de panel personalizado usando frontmatter YAML:
@@ -213,10 +215,11 @@ de tejido compleja que era común en el periodo colonial.
Si omites el frontmatter, el panel no tiene título — el contenido comienza de inmediato.
-{: .note }
-> Esto vale para los paneles que se escriben en una hoja de cálculo o en un archivo Markdown. En el Compositor, el título del panel tiene su propio campo, y un bloque `---` que pegues en el campo **Contenido** se publica como parte del texto del panel, no como título.
+{{< callout "note" >}}
+Esto vale para los paneles que se escriben en una hoja de cálculo o en un archivo Markdown. En el Compositor, el título del panel tiene su propio campo, y un bloque `---` que pegues en el campo **Contenido** se publica como parte del texto del panel, no como título.
+{{< /callout >}}
-### Qué se puede usar en los paneles
+### Qué se puede usar en los paneles {#qué-se-puede-usar-en-los-paneles}
Los paneles de las historias admiten:
@@ -225,7 +228,7 @@ Los paneles de las historias admiten:
- [Autoenlaces de glosario](/guia/funciones/glosario/) (`[[term-id]]`)
- Imágenes con controles de tamaño (consulta la [Guía de sintaxis Markdown](/guia/tu-contenido/sintaxis-markdown/))
-## Pasos multimedia
+## Pasos multimedia {#pasos-multimedia}
Los pasos de una historia pueden hacer referencia a cualquier tipo de objeto — no solo imágenes. Cuando un paso apunta a un objeto de video o audio, en lugar del visor de imágenes aparece el reproductor correspondiente.
@@ -234,7 +237,7 @@ Los pasos de una historia pueden hacer referencia a cualquier tipo de objeto —
No se necesita configuración adicional. Telar detecta el tipo de objeto en la hoja de cálculo de objetos y carga el reproductor que corresponde.
-## Control de clips
+## Control de clips {#control-de-clips}
En los pasos de video y audio puedes fijar un tiempo de inicio, un tiempo de fin y la repetición en bucle. Agrega estas columnas a la hoja de cálculo de la historia:
@@ -252,12 +255,13 @@ step,object,clip_start,clip_end,loop,question,answer
2,field-recording,0,30,true,¿Qué sonidos rodean el taller?,El golpeteo rítmico del telar llena el espacio.
```
-{: .tip }
-> También puedes fijar los tiempos del clip de forma visual en el Compositor. Consulta [Video y audio en el Compositor](/guia/el-compositor/video-y-audio/) para más detalles.
+{{< callout "tip" >}}
+También puedes fijar los tiempos del clip de forma visual en el Compositor. Consulta [Video y audio en el Compositor](/guia/el-compositor/video-y-audio/) para más detalles.
+{{< /callout >}}
Consulta la [Referencia CSV: Historias](/guia/tus-datos/csv-historias/) para la referencia completa de columnas incluyendo las columnas de clip.
-## Texto alternativo
+## Texto alternativo {#texto-alternativo}
Cada paso puede incluir una columna `alt_text` con una descripción de lo que se ve o se escucha en ese punto de la historia. Los lectores de pantalla y otras tecnologías de asistencia usan este texto.
@@ -266,16 +270,17 @@ step,object,x,y,zoom,alt_text,question,answer
1,textile-001,0.5,0.3,0.8,Primer plano de hilos de urdimbre entrelazados en rojo y dorado,¿Qué es este textil?,Un fragmento colonial con patrones complejos de tejido.
```
-{: .tip }
-> El texto alternativo de cada paso también se puede configurar en el [editor de pasos del Compositor](/guia/el-compositor/editor-historias/).
+{{< callout "tip" >}}
+El texto alternativo de cada paso también se puede configurar en el [editor de pasos del Compositor](/guia/el-compositor/editor-historias/).
+{{< /callout >}}
-## Navegación por teclado
+## Navegación por teclado {#navegación-por-teclado}
Las historias admiten navegación por teclado. Las teclas de flecha, la barra espaciadora y Page Up/Page Down desplazan la historia, y los puntos de anclaje magnético aseguran que cada pulsación llegue al paso siguiente o anterior.
Cuando un panel está abierto, el comportamiento del teclado cambia: Flecha Arriba/Abajo y Page Up/Page Down desplazan el contenido del panel en lugar de navegar entre pasos. La barra espaciadora desplaza el panel hacia adelante y Shift+Espacio lo desplaza hacia atrás.
-## Compartir y enlaces profundos
+## Compartir y enlaces profundos {#compartir-y-enlaces-profundos}
Telar actualiza automáticamente la URL en la barra de direcciones del navegador a medida que se avanza por la historia. La URL codifica el paso actual y cualquier capa de panel abierta, de modo que se puede copiar y compartir un enlace que abra directamente un punto específico de la historia.
@@ -288,12 +293,13 @@ El fragmento de la URL usa un formato compacto:
Al abrir un enlace profundo, la historia salta directamente al paso codificado y abre el panel si se especificó uno. Esto funciona tanto con la navegación por desplazamiento como con la navegación por botones.
-{: .note }
-> El botón de retroceso del navegador regresa a la página anterior — no al paso anterior. Los enlaces profundos están diseñados para compartir posiciones, no para navegar dentro de una historia.
+{{< callout "note" >}}
+El botón de retroceso del navegador regresa a la página anterior — no al paso anterior. Los enlaces profundos están diseñados para compartir posiciones, no para navegar dentro de una historia.
+{{< /callout >}}
-## Controlar la visualización de las historias
+## Controlar la visualización de las historias {#controlar-la-visualización-de-las-historias}
-### Ocultar historias de la página principal
+### Ocultar historias de la página principal {#ocultar-historias-de-la-página-principal}
Si deseas tener objetos en la página principal pero prefieres que a las historias se llegue por la navegación o enlaces directos:
@@ -304,7 +310,7 @@ story_interface:
Las historias siguen accesibles en sus URL — solo se ocultan las tarjetas de la página principal.
-### Ocultar indicadores de paso
+### Ocultar indicadores de paso {#ocultar-indicadores-de-paso}
Los indicadores **Paso 1**, **Paso 2** de la esquina superior izquierda de la página de la historia se pueden ocultar para una vista más despejada:
@@ -315,7 +321,7 @@ story_interface:
Quien lee puede seguir navegando por los pasos con normalidad.
-## Véase también
+## Véase también {#véase-también}
- [Referencia CSV: Historias](/guia/tus-datos/csv-historias/) — Referencia completa de columnas para las hojas de cálculo de historias
- [Objetos](/guia/tu-contenido/objetos/) — Definir los objetos usados en las historias
diff --git a/docs/4-3-external-iiif.es.md b/content/es/guia/tu-contenido/iiif-externo.md
similarity index 82%
rename from docs/4-3-external-iiif.es.md
rename to content/es/guia/tu-contenido/iiif-externo.md
index 395033a..4b1a82f 100644
--- a/docs/4-3-external-iiif.es.md
+++ b/content/es/guia/tu-contenido/iiif-externo.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "4.3. Imágenes IIIF externas"
-parent: "4. Tu contenido"
-grand_parent: Documentación
-nav_order: 3
-lang: es
-permalink: /guia/tu-contenido/iiif-externo/
+title: Imágenes IIIF externas
+url: /guia/tu-contenido/iiif-externo/
+translationKey: docs-your-content-external-iiif
+type: guide
+docs_section: reference
---
-# Imágenes IIIF externas
+# Imágenes IIIF externas {#imágenes-iiif-externas}
Muchos museos, bibliotecas y archivos ponen sus colecciones a disposición a través de una tecnología llamada [IIIF](https://iiif.io/) (Marco Internacional de Interoperabilidad de Imágenes). Esto significa que puedes construir historias en Telar usando imágenes de alta resolución de instituciones de todo el mundo, sin descargar ni alojar las imágenes.
-## Encontrar imágenes IIIF
+## Encontrar imágenes IIIF {#encontrar-imágenes-iiif}
Busca recursos IIIF en:
@@ -23,7 +21,7 @@ Busca recursos IIIF en:
Cuando una institución ofrece IIIF, generalmente encontrarás una URL de manifiesto — un enlace que describe la imagen y sus metadatos. Normalmente termina en `info.json` o `manifest.json`.
-## Agregar una imagen externa
+## Agregar una imagen externa {#agregar-una-imagen-externa}
En tu hoja de cálculo de objetos (Google Sheet u `objects.csv`):
@@ -35,7 +33,7 @@ En tu hoja de cálculo de objetos (Google Sheet u `objects.csv`):
Eso es todo. Telar obtendrá la imagen directamente del servidor de la institución cuando alguien visite tu sitio.
-### Formatos de URL de manifiesto
+### Formatos de URL de manifiesto {#formatos-de-url-de-manifiesto}
Las URLs IIIF normalmente se ven así:
@@ -44,7 +42,7 @@ Las URLs IIIF normalmente se ven así:
Telar es compatible con ambos formatos y con las dos versiones de IIIF (2.0 y 3.0).
-## Combinar imágenes propias y externas
+## Combinar imágenes propias y externas {#combinar-imágenes-propias-y-externas}
Puedes usar tus propias imágenes e imágenes IIIF externas en el mismo proyecto. Deja `source_url` en blanco para los objetos con imágenes autoalojadas:
@@ -55,7 +53,7 @@ mapa-museo,Mapa del museo,...,https://example.org/iiif/manifest.json
mi-ceramica,Mi cerámica,,,
```
-## Documentos de múltiples páginas
+## Documentos de múltiples páginas {#documentos-de-múltiples-páginas}
Algunos manifiestos IIIF describen documentos de múltiples páginas — libros digitalizados, manuscritos, registros legales o mapas con varias hojas. Estos manifiestos contienen múltiples *canvases*, uno por página.
@@ -66,11 +64,11 @@ object_id,title,source_url
leyes-nuevas,Recopilación de leyes,https://example.org/iiif/presentation/3/leyes-nuevas/manifest.json
```
-### Páginas de objetos
+### Páginas de objetos {#páginas-de-objetos}
En las páginas de objetos, el visor muestra el documento completo con controles de navegación — flechas de avance y retroceso y un selector de página — para que quienes visitan puedan recorrer todas las páginas.
-### Historias
+### Historias {#historias}
En las historias, cada paso puede hacer referencia a una página específica usando la columna `pagina`:
@@ -82,10 +80,11 @@ paso,objeto,x,y,zoom,pagina,pregunta,respuesta
La columna `pagina` indica qué *canvas* (página) del manifiesto mostrar. Los números de página comienzan en 1.
-{: .tip }
-> **Encontrar coordenadas para una página específica.** Navega a la página de objeto de tu documento de múltiples páginas. Usa los controles de navegación para ir a la página que deseas. Luego usa el selector de coordenadas — incluye automáticamente el número de página actual en los valores copiados.
+{{< callout "tip" >}}
+**Encontrar coordenadas para una página específica.** Navega a la página de objeto de tu documento de múltiples páginas. Usa los controles de navegación para ir a la página que deseas. Luego usa el selector de coordenadas — incluye automáticamente el número de página actual en los valores copiados.
+{{< /callout >}}
-### Encontrar manifiestos de múltiples páginas
+### Encontrar manifiestos de múltiples páginas {#encontrar-manifiestos-de-múltiples-páginas}
Los manifiestos IIIF de múltiples páginas son comunes en instituciones que han digitalizado libros y manuscritos:
@@ -96,11 +95,11 @@ Los manifiestos IIIF de múltiples páginas son comunes en instituciones que han
Busca un enlace de "manifiesto IIIF" en la página del objeto, o consulta la documentación IIIF de la institución.
-## Extracción automática de metadatos
+## Extracción automática de metadatos {#extracción-automática-de-metadatos}
Cuando proporcionas una `source_url`, Telar puede llenar automáticamente los metadatos a partir del manifiesto IIIF — título, descripción, creador, periodo, ubicación y crédito. Esto te ahorra escribir información que la institución ya tiene registrada.
-### Cómo usarlo
+### Cómo usarlo {#cómo-usarlo}
Agrega la URL del manifiesto IIIF a tu hoja de cálculo y deja los campos de metadatos vacíos:
@@ -116,7 +115,7 @@ Cuando tu sitio se construya, Telar:
3. Llenará los campos que dejaste vacíos
4. Conservará los valores que hayas escrito
-### Tus datos siempre tienen prioridad
+### Tus datos siempre tienen prioridad {#tus-datos-siempre-tienen-prioridad}
Tienes control total sobre lo que se extrae:
@@ -132,18 +131,18 @@ map-001,Mi título personalizado,,https://example.org/manifest.json,,,,
Telar usará "Mi título personalizado" (tu valor) y extraerá la descripción, creador, periodo, ubicación y crédito del manifiesto.
-### Detección de idioma
+### Detección de idioma {#detección-de-idioma}
La extracción respeta la configuración de idioma de tu sitio (`telar_language` en `_config.yml`):
- **Sitios en inglés** (`en`) — Prioriza metadatos en inglés; recurre a otros idiomas si no están
- **Sitios en español** (`es`) — Prioriza español, luego inglés, luego otros idiomas
-### Detección inteligente de créditos
+### Detección inteligente de créditos {#detección-inteligente-de-créditos}
Para el campo `credit`, Telar filtra textos legales genéricos (URLs de Creative Commons, avisos de derechos) y busca líneas de atribución significativas — el nombre de la institución, el titular de los derechos o la línea de crédito.
-### Qué busca Telar
+### Qué busca Telar {#qué-busca-telar}
Cada institución nombra sus metadatos de manera diferente. Telar busca variaciones comunes:
@@ -156,7 +155,7 @@ Cada institución nombra sus metadatos de manera diferente. Telar busca variacio
| location | Repository, Holding Institution, Current Location |
| credit | Attribution, Rights Holder, Credit Line, Provider |
-### Cuándo escribir tus propios valores
+### Cuándo escribir tus propios valores {#cuándo-escribir-tus-propios-valores}
Quizás quieras ingresar tus propios valores cuando:
@@ -165,14 +164,14 @@ Quizás quieras ingresar tus propios valores cuando:
- La descripción es muy técnica para tu público
- Prefieres una versión más corta o más simple de algún campo
-### Procesamiento durante el *build*
+### Procesamiento durante el *build* {#procesamiento-durante-el-build}
La extracción de metadatos ocurre automáticamente al construir el sitio:
- **GitHub Pages**: Se ejecuta durante el despliegue — no necesitas hacer nada
- **Desarrollo local**: Ejecuta `python3 scripts/csv_to_json.py` cuando agregues o actualices URLs de manifiestos
-### Validación
+### Validación {#validación}
Durante el *build*, Telar verifica cada manifiesto:
@@ -182,33 +181,33 @@ Durante el *build*, Telar verifica cada manifiesto:
Revisa los registros del *build* para ver el estado de la extracción.
-### Limitaciones
+### Limitaciones {#limitaciones}
- Solo funciona con **manifiestos IIIF externos** (las imágenes autoalojadas no tienen manifiestos de los cuales extraer)
- Los manifiestos deben ser de acceso público (sin inicio de sesión)
- Las etiquetas HTML se eliminan del texto extraído
- Algunos manifiestos pueden no incluir campos de metadatos
-## Solución de problemas
+## Solución de problemas {#solución-de-problemas}
-### La imagen no carga
+### La imagen no carga {#la-imagen-no-carga}
- Verifica que la URL del manifiesto sea correcta — intenta abrirla directamente en tu navegador
- Asegúrate de que el recurso sea de acceso público (sin autenticación)
- Confirma que pegaste la URL completa, incluyendo `info.json` o `manifest.json`
-### Los metadatos no aparecen
+### Los metadatos no aparecen {#los-metadatos-no-aparecen}
- Revisa los registros del *build* para ver advertencias de extracción
- El manifiesto puede no incluir los campos que esperas
- Intenta ingresar los valores manualmente en tu hoja de cálculo
-### Carga lenta
+### Carga lenta {#carga-lenta}
- Las imágenes externas se cargan desde el servidor de la institución — la velocidad depende de su infraestructura
- Algunas instituciones pueden limitar las solicitudes de sitios desconocidos
-## Véase también
+## Véase también {#véase-también}
- [Imágenes autoalojadas](/guia/tu-contenido/imagenes-autoalojadas/) — Sube tus propias imágenes en lugar de usar fuentes externas
- [Documentos PDF](/guia/tu-contenido/documentos-pdf/) — Autoalojar documentos PDF de múltiples páginas
diff --git a/docs/4-2-self-hosted-images.es.md b/content/es/guia/tu-contenido/imagenes-autoalojadas.md
similarity index 64%
rename from docs/4-2-self-hosted-images.es.md
rename to content/es/guia/tu-contenido/imagenes-autoalojadas.md
index 486864b..d7fcd86 100644
--- a/docs/4-2-self-hosted-images.es.md
+++ b/content/es/guia/tu-contenido/imagenes-autoalojadas.md
@@ -1,14 +1,12 @@
---
-layout: docs
-title: "4.2. Imágenes autoalojadas"
-parent: "4. Tu contenido"
-grand_parent: Documentación
-nav_order: 2
-lang: es
-permalink: /guia/tu-contenido/imagenes-autoalojadas/
+title: Imágenes autoalojadas
+url: /guia/tu-contenido/imagenes-autoalojadas/
+translationKey: docs-your-content-self-hosted-images
+type: guide
+docs_section: reference
---
-# Imágenes autoalojadas
+# Imágenes autoalojadas {#imágenes-autoalojadas}
Si tienes tus propias imágenes — fotografías, escaneos de documentos, mapas — puedes subirlas directamente a tu sitio Telar. Telar las convierte automáticamente en teselas ampliables de alta resolución para que el público pueda explorar cada detalle.
@@ -16,7 +14,7 @@ También puedes alojar archivos de audio (MP3, OGG, M4A) en el mismo directorio.
Este proceso usa una tecnología llamada [IIIF](https://iiif.io/) (Marco Internacional de Interoperabilidad de Imágenes) para las imágenes, pero no necesitas entender IIIF para usar archivos autoalojados. Solo sube tus archivos y Telar se encarga del resto.
-## Agregar imágenes
+## Agregar imágenes {#agregar-imágenes}
Cada imagen debe corresponder a un objeto definido en tu hoja de cálculo. El nombre del archivo (sin la extensión) debe coincidir con el `object_id` del objeto.
@@ -38,10 +36,11 @@ Por ejemplo, si tu hoja de cálculo tiene un objeto con `object_id` = `textile-0
python3 scripts/generate_iiif.py --base-url http://localhost:4001
```
-{: .note }
-> Telar solo genera teselas para objetos que estén en tu hoja de cálculo y que no tengan una fuente IIIF externa. Esto es automático — solo agrega tus imágenes y se procesarán durante el siguiente *build*.
+{{< callout "note" >}}
+Telar solo genera teselas para objetos que estén en tu hoja de cálculo y que no tengan una fuente IIIF externa. Esto es automático — solo agrega tus imágenes y se procesarán durante el siguiente *build*.
+{{< /callout >}}
-## Formatos compatibles
+## Formatos compatibles {#formatos-compatibles}
- **JPG, PNG, HEIC, WebP, TIFF, GIF, BMP** — todos los formatos de imagen comunes funcionan
- **SVG** — dibujos vectoriales, mapas y diagramas. Telar los convierte en imágenes al construir el sitio (véase más abajo)
@@ -51,16 +50,19 @@ Por ejemplo, si tu hoja de cálculo tiene un objeto con `object_id` = `textile-0
- **Resolución**: Mientras más alta, mejor — se recomienda al menos 2000px en el lado más largo para buena calidad de zoom
- **Límites de tamaño**: Imágenes individuales hasta 100 MB; mantén el repositorio total bajo 1 GB en GitHub
-{: .tip }
-> **Las fotos de iPhone funcionan directamente.** Las fotos HEIC de iPhone se procesan sin conversión previa. Telar las convierte automáticamente a JPEG durante la generación de teselas, conservando tus archivos originales.
+{{< callout "tip" >}}
+**Las fotos de iPhone funcionan directamente.** Las fotos HEIC de iPhone se procesan sin conversión previa. Telar las convierte automáticamente a JPEG durante la generación de teselas, conservando tus archivos originales.
+{{< /callout >}}
-{: .tip }
-> **Los dibujos SVG se convierten en imagen.** Al construir el sitio, Telar convierte cada SVG en una imagen de 4000 píxeles en el lado más largo y genera las teselas a partir de ella. Tu archivo original se conserva, pero el zoom no pasa de esa resolución: un dibujo con detalles muy finos puede verse borroso al ampliarlo al máximo. Si necesitas más detalle, exporta el dibujo a PNG o TIFF en un tamaño mayor y sube ese archivo.
+{{< callout "tip" >}}
+**Los dibujos SVG se convierten en imagen.** Al construir el sitio, Telar convierte cada SVG en una imagen de 4000 píxeles en el lado más largo y genera las teselas a partir de ella. Tu archivo original se conserva, pero el zoom no pasa de esa resolución: un dibujo con detalles muy finos puede verse borroso al ampliarlo al máximo. Si necesitas más detalle, exporta el dibujo a PNG o TIFF en un tamaño mayor y sube ese archivo.
+{{< /callout >}}
-{: .tip }
-> **Nombres de archivo.** Usa IDs simples y descriptivos, sin espacios ni caracteres especiales: `textile-001.jpg`, `ceramic-bowl-blue.jpg`
+{{< callout "tip" >}}
+**Nombres de archivo.** Usa IDs simples y descriptivos, sin espacios ni caracteres especiales: `textile-001.jpg`, `ceramic-bowl-blue.jpg`
+{{< /callout >}}
-## Cómo funciona
+## Cómo funciona {#cómo-funciona}
Cuando agregas una imagen y construyes tu sitio:
@@ -71,10 +73,11 @@ Cuando agregas una imagen y construyes tu sitio:
Esto permite un zoom fluido incluso en imágenes muy grandes.
-{: .note }
-> **Generación rápida de teselas con libvips.** Cuando libvips está disponible, Telar lo usa para generar las teselas IIIF: la generación resulta unas 28 veces más rápida que con la biblioteca `iiif` de Python, a la que recurre automáticamente si libvips no está instalado. Consulta [Desarrollo local](/guia/desarrolladores/desarrollo-local/) para instrucciones de instalación.
+{{< callout "note" >}}
+**Generación rápida de teselas con libvips.** Cuando libvips está disponible, Telar lo usa para generar las teselas IIIF: la generación resulta unas 28 veces más rápida que con la biblioteca `iiif` de Python, a la que recurre automáticamente si libvips no está instalado. Consulta [Desarrollo local](/guia/desarrolladores/desarrollo-local/) para instrucciones de instalación.
+{{< /callout >}}
-## Sistema de coordenadas
+## Sistema de coordenadas {#sistema-de-coordenadas}
Telar usa coordenadas normalizadas (valores de 0 a 1) para describir posiciones dentro de una imagen:
@@ -84,7 +87,7 @@ Telar usa coordenadas normalizadas (valores de 0 a 1) para describir posiciones
Usas estas coordenadas en los pasos de tu historia para indicarle a Telar dónde hacer zoom en cada imagen.
-### Cómo encontrar coordenadas
+### Cómo encontrar coordenadas {#cómo-encontrar-coordenadas}
Cada página de objeto incluye un selector de coordenadas integrado:
@@ -94,29 +97,30 @@ Cada página de objeto incluye un selector de coordenadas integrado:
4. Copia los valores X, Y y Zoom
5. Pégalos en tu hoja de cálculo de historias o archivo CSV
-{: .tip }
-> El selector de coordenadas tiene un botón **Copy entire row** que copia una fila completa con las coordenadas ya incluidas — lista para pegar en tu hoja de cálculo.
+{{< callout "tip" >}}
+El selector de coordenadas tiene un botón **Copy entire row** que copia una fila completa con las coordenadas ya incluidas — lista para pegar en tu hoja de cálculo.
+{{< /callout >}}
-## Solución de problemas
+## Solución de problemas {#solución-de-problemas}
-### La imagen no carga
+### La imagen no carga {#la-imagen-no-carga}
- Verifica que el archivo exista en `telar-content/objects/`
- Asegúrate de que el nombre del archivo (sin extensión) coincida con el `object_id` en tu hoja de cálculo
- Verifica que la columna `source_url` del objeto esté vacía (de lo contrario Telar espera una imagen externa)
- Confirma que se hayan generado las teselas IIIF (revisa que exista `iiif/objects/{object-id}/`)
-### Visualización de baja calidad
+### Visualización de baja calidad {#visualización-de-baja-calidad}
- Usa imágenes de mayor resolución (al menos 2000px en el lado más largo)
- Las imágenes muy pequeñas no se verán bien al aplicar zoom
-### Carga lenta
+### Carga lenta {#carga-lenta}
- Optimiza el tamaño de los archivos antes de subirlos (los TIFF grandes se pueden convertir a JPEG de alta calidad)
- GitHub Pages tiene límites de ancho de banda — para sitios de alto tráfico, considera otro servicio de alojamiento
-## Véase también
+## Véase también {#véase-también}
- [Imágenes IIIF externas](/guia/tu-contenido/iiif-externo/) — Usa imágenes de museos y bibliotecas en lugar de subir las tuyas
- [Objetos](/guia/tu-contenido/objetos/) — Cómo definir objetos en tu hoja de cálculo
diff --git a/docs/4-10-audio-objects.es.md b/content/es/guia/tu-contenido/objetos-de-audio.md
similarity index 76%
rename from docs/4-10-audio-objects.es.md
rename to content/es/guia/tu-contenido/objetos-de-audio.md
index c421eb9..c906045 100644
--- a/docs/4-10-audio-objects.es.md
+++ b/content/es/guia/tu-contenido/objetos-de-audio.md
@@ -1,26 +1,24 @@
---
-layout: docs
-title: "4.10. Objetos de audio"
-parent: "4. Tu contenido"
-grand_parent: Documentación
-nav_order: 10
-lang: es
-permalink: /guia/tu-contenido/objetos-de-audio/
+title: Objetos de audio
+url: /guia/tu-contenido/objetos-de-audio/
+translationKey: docs-your-content-audio-objects
+type: guide
+docs_section: reference
---
-# Objetos de audio
+# Objetos de audio {#objetos-de-audio}
Telar puede mostrar archivos de audio autoalojados como objetos en tu exhibición. El audio funciona igual que las imágenes y los videos — se pueden construir historias alrededor de grabaciones, enfocar momentos específicos con el control de clips y combinarlos con los demás objetos.
A diferencia de los objetos de video (que se insertan desde plataformas externas), los archivos de audio se alojan directamente en tu repositorio. Pon tus archivos MP3, OGG o M4A en `telar-content/objects/` y Telar se encarga del resto.
-## Agregar un objeto de audio
+## Agregar un objeto de audio {#agregar-un-objeto-de-audio}
Para agregar un archivo de audio, ponlo en `telar-content/objects/` con un nombre que coincida con el `object_id` en tu hoja de cálculo de objetos.
Por ejemplo, si tu hoja de cálculo tiene un objeto con `object_id` = `grabacion-campo-01`, nombra tu archivo `grabacion-campo-01.mp3`.
-### Formatos compatibles
+### Formatos compatibles {#formatos-compatibles}
Telar reconoce tres formatos de audio:
@@ -28,21 +26,21 @@ Telar reconoce tres formatos de audio:
- **OGG** — formato abierto con buena compresión
- **M4A** — formato común de dispositivos Apple y grabadoras profesionales
-## Cómo se muestra el audio
+## Cómo se muestra el audio {#cómo-se-muestra-el-audio}
-### En historias
+### En historias {#en-historias}
Cuando un paso de la historia hace referencia a un objeto de audio, una visualización de forma de onda WaveSurfer llena el área del visor con controles de reproducción y pausa. Si se configuran valores de `inicio_clip` y `fin_clip` en la hoja de cálculo, el reproductor reproduce solo el segmento especificado. Esto es útil para dirigir la atención a un momento particular en una grabación larga.
-### En páginas de objetos
+### En páginas de objetos {#en-páginas-de-objetos}
Cada objeto de audio tiene su propia página (`/objects/{object-id}/`) con un reproductor de forma de onda completo. Debajo de la forma de onda, un selector de clips permite elegir los tiempos de inicio y fin arrastrando los bordes de la región sobre la forma de onda — útil al construir pasos de historias. Los valores se copian directamente a la hoja de cálculo.
-### En la galería
+### En la galería {#en-la-galería}
Los objetos de audio aparecen en la galería de objetos con un ícono de forma de onda sobre un fondo gris. El filtro **Type** de la galería permite a quienes visitan explorar por tipo de medio (Image, Video o Audio).
-## Control de clips
+## Control de clips {#control-de-clips}
Los pasos de las historias pueden especificar un tiempo de inicio, un tiempo de fin y una configuración de bucle para los objetos de audio. Las columnas funcionan exactamente igual que para los videos — consulta [Objetos de video: Control de clips](/guia/tu-contenido/objetos-de-video/#control-de-clips) para la referencia completa de columnas y ejemplos.
@@ -52,14 +50,15 @@ Los pasos de las historias pueden especificar un tiempo de inicio, un tiempo de
| `clip_end` | `fin_clip` | Tiempo de fin en segundos |
| `loop` | `bucle` | Repetir el clip (`true`, `yes` o `sí`) |
-{: .tip }
-> También puedes fijar los tiempos del clip de forma visual en el Compositor. Consulta [Video y audio en el Compositor](/guia/el-compositor/video-y-audio/) para más detalles.
+{{< callout "tip" >}}
+También puedes fijar los tiempos del clip de forma visual en el Compositor. Consulta [Video y audio en el Compositor](/guia/el-compositor/video-y-audio/) para más detalles.
+{{< /callout >}}
-## Procesamiento de audio en el *build*
+## Procesamiento de audio en el *build* {#procesamiento-de-audio-en-el-build}
Telar procesa los archivos de audio durante el *build* para extraer clips y generar datos de picos para la visualización de la forma de onda. Esto se gestiona mediante `process_audio.py`, que se ejecuta automáticamente como parte del *build*.
-### Dependencias opcionales
+### Dependencias opcionales {#dependencias-opcionales}
El procesamiento de audio requiere dos herramientas externas. Solo se necesitan si el sitio incluye objetos de audio — los sitios sin audio no las requieren.
@@ -80,10 +79,11 @@ brew install ffmpeg audiowaveform
sudo apt install ffmpeg audiowaveform
```
-{: .note }
-> **GitHub Actions se encarga de esto automáticamente.** El flujo de trabajo `build.yml` detecta archivos de audio en el repositorio e instala estas herramientas durante el *build*. No se necesita configuración manual para sitios desplegados.
+{{< callout "note" >}}
+**GitHub Actions se encarga de esto automáticamente.** El flujo de trabajo `build.yml` detecta archivos de audio en el repositorio e instala estas herramientas durante el *build*. No se necesita configuración manual para sitios desplegados.
+{{< /callout >}}
-## Véase también
+## Véase también {#véase-también}
- [Objetos de video](/guia/tu-contenido/objetos-de-video/) — Insertar video desde plataformas externas
- [Objetos](/guia/tu-contenido/objetos/) — Definir objetos en tu hoja de cálculo
diff --git a/docs/4-9-video-objects.es.md b/content/es/guia/tu-contenido/objetos-de-video.md
similarity index 74%
rename from docs/4-9-video-objects.es.md
rename to content/es/guia/tu-contenido/objetos-de-video.md
index 0e6aa42..22bab93 100644
--- a/docs/4-9-video-objects.es.md
+++ b/content/es/guia/tu-contenido/objetos-de-video.md
@@ -1,20 +1,18 @@
---
-layout: docs
-title: "4.9. Objetos de video"
-parent: "4. Tu contenido"
-grand_parent: Documentación
-nav_order: 9
-lang: es
-permalink: /guia/tu-contenido/objetos-de-video/
+title: Objetos de video
+url: /guia/tu-contenido/objetos-de-video/
+translationKey: docs-your-content-video-objects
+type: guide
+docs_section: reference
---
-# Objetos de video
+# Objetos de video {#objetos-de-video}
Telar puede mostrar videos de YouTube, Vimeo y Google Drive como objetos en tu exhibición. Los videos funcionan igual que las imágenes — puedes construir historias alrededor de ellos, enfocar momentos específicos con control de clips e incluirlos junto a los demás objetos.
Los videos no se almacenan en el repositorio — Telar los inserta directamente desde la plataforma donde ya están alojados.
-## Agregar un objeto de video
+## Agregar un objeto de video {#agregar-un-objeto-de-video}
Para agregar un video, pon la URL del video en la columna `source_url` de tu hoja de cálculo de objetos. Telar detecta el tipo de medio automáticamente a partir de la URL — no se necesita configuración adicional.
@@ -25,7 +23,7 @@ object_id,title,source_url
interview-01,Oral history interview,https://www.youtube.com/watch?v=dQw4w9WgXcQ
```
-### Plataformas compatibles
+### Plataformas compatibles {#plataformas-compatibles}
Telar reconoce URLs de video de tres plataformas:
@@ -33,26 +31,27 @@ Telar reconoce URLs de video de tres plataformas:
- **Vimeo** — `vimeo.com/123456789`
- **Google Drive** — `drive.google.com/file/d/.../view` (el video debe estar compartido públicamente o con "Cualquier persona con el enlace")
-{: .note }
-> Telar no admite archivos de video autoalojados. Los videos deben estar alojados en una de las plataformas compatibles. Para medios autoalojados, consulta [Objetos de audio](/guia/tu-contenido/objetos-de-audio/).
+{{< callout "note" >}}
+Telar no admite archivos de video autoalojados. Los videos deben estar alojados en una de las plataformas compatibles. Para medios autoalojados, consulta [Objetos de audio](/guia/tu-contenido/objetos-de-audio/).
+{{< /callout >}}
-## Cómo se muestran los videos
+## Cómo se muestran los videos {#cómo-se-muestran-los-videos}
-### En historias
+### En historias {#en-historias}
Cuando un paso de la historia hace referencia a un objeto de video, el reproductor ocupa el área del visor. El reproductor incluye controles de reproducción estándar (reproducir, pausar, avanzar) y responde a cualquier configuración de clip definida para ese paso.
Si estableces valores de `clip_start` y `clip_end` en tu hoja de cálculo de historias, el video reproduce solo el segmento especificado. Esto es útil para dirigir la atención a un momento particular sin requerir que el público vea la grabación completa.
-### En páginas de objetos
+### En páginas de objetos {#en-páginas-de-objetos}
Cada objeto de video tiene su propia página (`/objects/{object-id}/`) con un reproductor insertado. Debajo del reproductor, un selector de tiempos de clip permite reproducir hasta una posición y capturar marcas de tiempo — útil al construir pasos de historias.
-### En la galería
+### En la galería {#en-la-galería}
Los objetos de video aparecen en la galería de objetos con un ícono de reproducción sobre un fondo gris. El filtro **Type** de la galería permite a quienes visitan explorar por tipo de medio (Image, Video o Audio).
-## Control de clips
+## Control de clips {#control-de-clips}
Los pasos de la historia pueden especificar un tiempo de inicio, un tiempo de fin y una configuración de bucle para los objetos de video. Agrega estas columnas a la hoja de cálculo de la historia:
@@ -70,7 +69,7 @@ paso,objeto,inicio_clip,fin_clip,bucle,pregunta,respuesta
2,entrevista-01,120,145,true,Un motivo recurrente,Observa cómo se repite el patrón — este *clip* se reproduce en bucle para resaltar la repetición.
```
-### Encontrar tiempos de clip
+### Encontrar tiempos de clip {#encontrar-tiempos-de-clip}
La página de objeto de cada video incluye un selector de tiempos de clip:
@@ -79,13 +78,14 @@ La página de objeto de cada video incluye un selector de tiempos de clip:
3. Haz clic en los botones de captura de marca de tiempo para registrar los tiempos de inicio y fin
4. Copia los valores en tu hoja de cálculo de historias
-{: .tip }
-> También puedes fijar los tiempos del clip de forma visual en el Compositor. Consulta [Video y audio en el Compositor](/guia/el-compositor/video-y-audio/) para más detalles.
+{{< callout "tip" >}}
+También puedes fijar los tiempos del clip de forma visual en el Compositor. Consulta [Video y audio en el Compositor](/guia/el-compositor/video-y-audio/) para más detalles.
+{{< /callout >}}
-## Véase también
+## Véase también {#véase-también}
- [Objetos de audio](/guia/tu-contenido/objetos-de-audio/) — Agregar archivos de audio autoalojados
- [Objetos](/guia/tu-contenido/objetos/) — Definir objetos en tu hoja de cálculo
-- [Historias y paneles](/guia/tu-contenido/historias-y-paneles/) — Construir pasos de historias
+- [Historias y paneles](/guia/tu-contenido/historias-paneles/) — Construir pasos de historias
- [Columnas de historias](/guia/tus-datos/csv-historias/) — Referencia completa de columnas incluyendo columnas de clip
-- [Galería de objetos](/guia/funciones-del-sitio/galeria-de-objetos/) — Cómo se muestran los videos en la galería
+- [Galería de objetos](/guia/funciones/galeria-objetos/) — Cómo se muestran los videos en la galería
diff --git a/docs/4-1-objects.es.md b/content/es/guia/tu-contenido/objetos.md
similarity index 80%
rename from docs/4-1-objects.es.md
rename to content/es/guia/tu-contenido/objetos.md
index d29d89c..ce477b4 100644
--- a/docs/4-1-objects.es.md
+++ b/content/es/guia/tu-contenido/objetos.md
@@ -1,21 +1,20 @@
---
-layout: docs
-title: "4.1. Objetos"
-parent: "4. Tu contenido"
-grand_parent: Documentación
-nav_order: 1
-lang: es
-permalink: /guia/tu-contenido/objetos/
+title: Objetos
+url: /guia/tu-contenido/objetos/
+translationKey: docs-your-content-objects
+type: guide
+docs_section: reference
---
-# Objetos
+# Objetos {#objetos}
Los objetos son los materiales en el centro de tu sitio Telar — imágenes, videos, grabaciones de audio, documentos y otros materiales que tus historias exploran.
-{: .tip }
-> El [Compositor](/guia/el-compositor/objetos/) ofrece una interfaz visual para gestionar objetos — incluyendo obtención automática de manifiestos IIIF, carga de imágenes y edición de metadatos.
+{{< callout "tip" >}}
+El [Compositor](/guia/el-compositor/objetos/) ofrece una interfaz visual para gestionar objetos — incluyendo obtención automática de manifiestos IIIF, carga de imágenes y edición de metadatos.
+{{< /callout >}}
-## Definir objetos
+## Definir objetos {#definir-objetos}
Cada objeto de tu sitio se define como una fila en tu hoja de cálculo de objetos — ya sea en la pestaña de objetos de tu Google Sheet, o en `objects.csv` (u `objetos.csv`) en `telar-content/spreadsheets/`.
@@ -31,7 +30,7 @@ map-lima,Mapa de Lima
- **`title`** — El nombre visible
- **`alt_text`** — Texto alternativo para accesibilidad (opcional). Si se deja vacío, se usa el `title` del objeto.
-### Detección del tipo de medio
+### Detección del tipo de medio {#detección-del-tipo-de-medio}
Telar determina automáticamente si un objeto es una imagen, un video o un archivo de audio según su fuente — no se necesita configuración adicional:
@@ -47,10 +46,11 @@ Para videos y audio, consulta [Objetos de video](/guia/tu-contenido/objetos-de-v
Puedes agregar metadatos más detallados para cada objeto — descripción, creador, periodo, año, `medium` (el género o medio del objeto, p. ej. "Fotografía", "Óleo", "Historia oral"), dimensiones, fuente, crédito y más. Consulta la referencia de [Columnas de objetos](/guia/tus-datos/csv-objetos/) para la lista completa de columnas.
-{: .note }
-> La columna `medium` (antes `object_type`) describe el género o medio del objeto — no el tipo de medio (Imagen, Video, Audio), que Telar detecta automáticamente. El nombre de columna `object_type` sigue funcionando por compatibilidad. En español, también se acepta `medio_genero`.
+{{< callout "note" >}}
+La columna `medium` (antes `object_type`) describe el género o medio del objeto — no el tipo de medio (Imagen, Video, Audio), que Telar detecta automáticamente. El nombre de columna `object_type` sigue funcionando por compatibilidad. En español, también se acepta `medio_genero`.
+{{< /callout >}}
-## Páginas de objetos
+## Páginas de objetos {#páginas-de-objetos}
Cada objeto tiene su propia página en `/objects/{object_id}/`. La página muestra:
@@ -62,13 +62,13 @@ Cada objeto tiene su propia página en `/objects/{object_id}/`. La página muest
-### Selector de coordenadas
+### Selector de coordenadas {#selector-de-coordenadas}
El selector de coordenadas es una herramienta de desarrollo en cada página de objeto. Haz clic o aplica zoom en la imagen y luego lee las coordenadas normalizadas (rango de 0 a 1) que aparecen debajo del visor. Usa los botones **Copy** para copiar las coordenadas directamente en el CSV de tu historia.
-## Véase también
+## Véase también {#véase-también}
- [Galería de objetos](/guia/funciones/galeria-objetos/) — Explora, busca y filtra tu colección
- [Columnas de objetos](/guia/tus-datos/csv-objetos/) — Referencia completa de columnas para objects.csv
diff --git a/docs/4-6-markdown-syntax.es.md b/content/es/guia/tu-contenido/sintaxis-markdown.md
similarity index 73%
rename from docs/4-6-markdown-syntax.es.md
rename to content/es/guia/tu-contenido/sintaxis-markdown.md
index 4a73704..5223675 100644
--- a/docs/4-6-markdown-syntax.es.md
+++ b/content/es/guia/tu-contenido/sintaxis-markdown.md
@@ -1,22 +1,21 @@
---
-layout: docs
-title: "4.6. Sintaxis de Markdown"
-parent: "4. Tu contenido"
-grand_parent: Documentación
-nav_order: 6
-lang: es
-permalink: /guia/tu-contenido/sintaxis-markdown/
+title: Referencia de sintaxis de Markdown
+url: /guia/tu-contenido/sintaxis-markdown/
+translationKey: docs-your-content-markdown-syntax
+type: guide
katex: true
+docs_section: reference
---
-# Referencia de sintaxis de Markdown
+# Referencia de sintaxis de Markdown {#referencia-de-sintaxis-de-markdown}
El contenido de los paneles de Telar admite formato Markdown enriquecido. Esta referencia recoge la sintaxis más útil para el texto narrativo.
-{: .note }
-> **Esta referencia cubre el contenido de los paneles**: lo que sigue vale para `layer1_content` y `layer2_content`, y para los archivos Markdown que indiquen esas columnas. Los campos `question` y `answer` de un paso funcionan de otra manera. La pregunta es un encabezado, así que va en texto plano, sin procesamiento Markdown. Las respuestas quedan en texto corrido y Telar recorta las que pasan de 18 líneas. Consulta [Las respuestas son texto corrido](/guia/tus-datos/csv-historias/#las-respuestas-son-texto-corrido).
+{{< callout "note" >}}
+**Esta referencia cubre el contenido de los paneles**: lo que sigue vale para `layer1_content` y `layer2_content`, y para los archivos Markdown que indiquen esas columnas. Los campos `question` y `answer` de un paso funcionan de otra manera. La pregunta es un encabezado, así que va en texto plano, sin procesamiento Markdown. Las respuestas quedan en texto corrido y Telar recorta las que pasan de 18 líneas. Consulta [Las respuestas son texto corrido](/guia/tus-datos/csv-historias/#las-respuestas-son-texto-corrido).
+{{< /callout >}}
-## ¿Qué es Markdown?
+## ¿Qué es Markdown? {#qué-es-markdown}
Markdown es un lenguaje de marcado ligero que te permite formatear texto usando una sintaxis simple y legible. En lugar de etiquetas HTML complejas, escribes en texto plano con caracteres especiales como `*` para énfasis o `#` para encabezados. Markdown es:
@@ -25,7 +24,7 @@ Markdown es un lenguaje de marcado ligero que te permite formatear texto usando
- **Portátil**: los archivos de texto plano funcionan en cualquier parte
- **Convertible**: se convierte automáticamente a HTML para mostrarse en el sitio
-### Recursos de aprendizaje
+### Recursos de aprendizaje {#recursos-de-aprendizaje}
¿Estás empezando con Markdown? Estos recursos te ayudarán:
@@ -37,14 +36,15 @@ Telar usa el procesador [Python Markdown](https://python-markdown.github.io/) co
---
-## Cómo escribir el contenido de los paneles
+## Cómo escribir el contenido de los paneles {#cómo-escribir-el-contenido-de-los-paneles}
-Puedes escribir el contenido de los paneles de tres maneras. Para más detalles, consulta la [Referencia CSV: Historias](/guia/tus-datos/csv-historias/#contenido-de-capa).
+Puedes escribir el contenido de los paneles de tres maneras. Para más detalles, consulta la [Referencia CSV: Historias](/guia/tus-datos/csv-historias/#contenido-de-las-capas).
-{: .note }
-> Los tres métodos que siguen son para quien trabaja en una hoja de cálculo. En el Compositor, el título del panel tiene su propio campo, y todo lo que pegues en el campo **Contenido** —incluido un bloque `---`— se publica como parte del texto del panel, no como título.
+{{< callout "note" >}}
+Los tres métodos que siguen son para quien trabaja en una hoja de cálculo. En el Compositor, el título del panel tiene su propio campo, y todo lo que pegues en el campo **Contenido** —incluido un bloque `---`— se publica como parte del texto del panel, no como título.
+{{< /callout >}}
-### Método 1: Introducir texto directamente
+### Método 1: Introducir texto directamente {#método-1-introducir-texto-directamente}
Escribe el texto del panel directamente en la columna `contenido_capa1` de tu hoja de cálculo:
@@ -54,7 +54,7 @@ Escribe el texto del panel directamente en la columna `contenido_capa1` de tu ho
Los saltos de línea en la celda de tu hoja de cálculo crean saltos de párrafo. Si no indicas otro, el título del panel es el texto del botón.
-### Método 2: Pegar texto Markdown
+### Método 2: Pegar texto Markdown {#método-2-pegar-texto-markdown}
Pega texto desde un editor de texto plano. Puedes incluir encabezados, widgets y un título de panel personalizado usando frontmatter YAML:
@@ -71,10 +71,11 @@ de tejido compleja que era común en el período colonial.
Estos patrones se creaban usando...
```
-{: .warning }
-> Si copias y pegas desde Microsoft Word, Google Docs o aplicaciones similares, el formato **no** se conservará. Escribe en sintaxis Markdown.
+{{< callout "warning" >}}
+Si copias y pegas desde Microsoft Word, Google Docs o aplicaciones similares, el formato **no** se conservará. Escribe en sintaxis Markdown.
+{{< /callout >}}
-### Método 3: Indicar un archivo de texto
+### Método 3: Indicar un archivo de texto {#método-3-indicar-un-archivo-de-texto}
Para contenido complejo, indica un archivo Markdown guardado en `telar-content/texts/stories/`:
@@ -91,9 +92,9 @@ El archivo usa frontmatter para el título del panel y admite todas las funcione
---
-## Formato básico
+## Formato básico {#formato-básico}
-### Encabezados
+### Encabezados {#encabezados}
```markdown
## Encabezado de segundo nivel
@@ -101,10 +102,11 @@ El archivo usa frontmatter para el título del panel y admite todas las funcione
#### Encabezado de cuarto nivel
```
-{: .note }
-> **Consejo**: No uses `# Primer nivel` en los paneles; cada panel ya tiene su título.
+{{< callout "note" >}}
+**Consejo**: No uses `# Primer nivel` en los paneles; cada panel ya tiene su título.
+{{< /callout >}}
-### Estilos de texto
+### Estilos de texto {#estilos-de-texto}
```markdown
**Texto en negrita** para énfasis
@@ -112,7 +114,7 @@ El archivo usa frontmatter para el título del panel y admite todas las funcione
***Negrita y cursiva*** para máximo énfasis
```
-### Listas
+### Listas {#listas}
Listas desordenadas:
```markdown
@@ -130,14 +132,14 @@ Listas ordenadas:
3. Tercer paso
```
-### Enlaces
+### Enlaces {#enlaces}
```markdown
[Texto del enlace](https://example.com)
[Enlace interno](/objects/textile-001/)
```
-### Citas en bloque
+### Citas en bloque {#citas-en-bloque}
```markdown
> Esto es una cita en bloque.
@@ -146,17 +148,17 @@ Listas ordenadas:
---
-## Imágenes
+## Imágenes {#imágenes}
Telar proporciona sintaxis especial para controlar los tamaños de imagen en los paneles.
-### Sintaxis básica
+### Sintaxis básica {#sintaxis-básica}
```markdown
{tamaño}
```
-### Opciones de tamaño
+### Opciones de tamaño {#opciones-de-tamaño}
| Tamaño | Palabra clave | Ancho máx. | Caso de uso |
|--------|---------------|-----------|-------------|
@@ -165,7 +167,7 @@ Telar proporciona sintaxis especial para controlar los tamaños de imagen en los
| Grande | `{lg}` o `{large}` | 700 px | Imágenes destacadas, vistas detalladas |
| Completo | `{full}` | 100% | Panoramas, visuales de ancho completo |
-### Rutas de imagen
+### Rutas de imagen {#rutas-de-imagen}
**Rutas relativas** (sin barra inicial) se cargan automáticamente desde `/telar-content/objects/`:
@@ -186,7 +188,7 @@ Telar proporciona sintaxis especial para controlar los tamaños de imagen en los
{lg}
```
-### Ejemplos
+### Ejemplos {#ejemplos}
```markdown
{small}
@@ -195,10 +197,11 @@ Telar proporciona sintaxis especial para controlar los tamaños de imagen en los
{full}
```
-{: .tip }
-> **Tamaño predeterminado**: las imágenes sin etiqueta de tamaño salen en mediano (450 px). Ponle la etiqueta a cada imagen para que el tamaño quede explícito.
+{{< callout "tip" >}}
+**Tamaño predeterminado**: las imágenes sin etiqueta de tamaño salen en mediano (450 px). Ponle la etiqueta a cada imagen para que el tamaño quede explícito.
+{{< /callout >}}
-### Pies de imagen
+### Pies de imagen {#pies-de-imagen}
Agrega un pie de imagen colocando texto en la línea inmediatamente después de la imagen:
@@ -222,9 +225,9 @@ El prefijo `caption:` se elimina del texto mostrado.
---
-## Medios enriquecidos
+## Medios enriquecidos {#medios-enriquecidos}
-### Videos de YouTube
+### Videos de YouTube {#videos-de-youtube}
Inserta videos de YouTube adaptables usando un iframe HTML:
@@ -242,7 +245,7 @@ Reemplaza `VIDEO_ID` con el ID de tu video de YouTube.
El `padding-bottom: 56.25%` crea un contenedor con relación de aspecto 16:9.
-### Otros iframes
+### Otros iframes {#otros-iframes}
Cualquier contenido incrustable con iframe funciona:
@@ -256,9 +259,9 @@ Cualquier contenido incrustable con iframe funciona:
---
-## Código
+## Código {#código}
-### Código en línea
+### Código en línea {#código-en-línea}
Usa comillas invertidas para referencias de `código en línea`:
@@ -266,7 +269,7 @@ Usa comillas invertidas para referencias de `código en línea`:
El campo `object_id` debe coincidir con el nombre del archivo.
```
-### Bloques de código
+### Bloques de código {#bloques-de-código}
Usa triple comillas invertidas para bloques de código:
@@ -289,7 +292,7 @@ description: Una narrativa convincente
---
-## Notas al pie
+## Notas al pie {#notas-al-pie}
Crea notas al pie con sintaxis `[^1]`:
@@ -305,15 +308,15 @@ Las notas al pie solo funcionan en el contenido de los paneles. Si pones una en
---
-## Notación matemática y científica (LaTeX)
+## Notación matemática y científica (LaTeX) {#notación-matemática-y-científica-latex}
Telar permite representar fórmulas matemáticas mediante [KaTeX](https://katex.org/). Puedes incluir fórmulas, ecuaciones químicas y notación científica en cualquier lugar donde se use Markdown: paneles de historias, definiciones del glosario, descripciones de objetos y páginas personalizadas.
-### Cómo funciona
+### Cómo funciona {#cómo-funciona}
Telar detecta automáticamente el LaTeX en el contenido al construir el sitio. No necesitas configurar nada — si el texto contiene notación LaTeX, se representará como fórmula formateada.
-### Fórmulas en línea
+### Fórmulas en línea {#fórmulas-en-línea}
Encierra las expresiones entre signos de dólar simples para que aparezcan en línea con el texto:
@@ -323,10 +326,11 @@ El coeficiente es $C = \frac{8}{35}$ y el polinomio es $P_4(x)$.
<p><strong>Se muestra así:</strong> El coeficiente es $C = \frac{8}{35}$ y el polinomio es $P_4(x)$.</p>
-{: .warning }
-> **Heurística del signo de dólar**: para evitar falsos positivos con monedas (ej., "$50"), Telar solo trata `$...$` como fórmula cuando el contenido incluye caracteres propios de LaTeX como `\`, `^`, `_` o `{`. Los signos dobles (`$$...$$`) siempre se tratan como fórmulas.
+{{< callout "warning" >}}
+**Heurística del signo de dólar**: para evitar falsos positivos con monedas (ej., "$50"), Telar solo trata `$...$` como fórmula cuando el contenido incluye caracteres propios de LaTeX como `\`, `^`, `_` o `{`. Los signos dobles (`$$...$$`) siempre se tratan como fórmulas.
+{{< /callout >}}
-### Fórmulas en bloque
+### Fórmulas en bloque {#fórmulas-en-bloque}
Encierra las expresiones entre signos de dólar dobles para obtener ecuaciones centradas e independientes:
@@ -343,7 +347,7 @@ También puedes usar los delimitadores `\[...\]`:
\[E = mc^2\]
```
-### Ecuaciones de varias líneas
+### Ecuaciones de varias líneas {#ecuaciones-de-varias-líneas}
Usa `\begin{align}...\end{align}` para ecuaciones alineadas en varias líneas. Marca los puntos de alineación con `&` y los saltos de línea con `\\`:
@@ -358,7 +362,7 @@ P_2(x) &= \frac{1}{2}(3x^2 - 1)
<p><strong>Se muestra así:</strong></p>
<p>$$\begin{align} P_0(x) &= 1\\ P_1(x) &= x\\ P_2(x) &= \frac{1}{2}(3x^2 - 1) \end{align}$$</p>
-### Entornos compatibles
+### Entornos compatibles {#entornos-compatibles}
| Entorno | Propósito |
|---------|-----------|
@@ -368,7 +372,7 @@ P_2(x) &= \frac{1}{2}(3x^2 - 1)
| `pmatrix` | Matrices con paréntesis |
| `bmatrix` | Matrices con corchetes |
-### Fórmulas químicas
+### Fórmulas químicas {#fórmulas-químicas}
Telar incluye la extensión [mhchem](https://mhchem.github.io/MathJax-mhchem/) para notación química:
@@ -381,7 +385,7 @@ $$\ce{CO2 + C -> 2CO}$$
<p><strong>Se muestra así:</strong> La reacción $\ce{2H2 + O2 -> 2H2O}$ produce agua.</p>
<p>$$\ce{CO2 + C -> 2CO}$$</p>
-### Dónde funciona LaTeX
+### Dónde funciona LaTeX {#dónde-funciona-latex}
| Tipo de contenido | Cómo se carga |
|-------------------|---------------|
@@ -392,15 +396,15 @@ $$\ce{CO2 + C -> 2CO}$$
| Páginas personalizadas | Siempre disponible |
| Historias cifradas | Se carga automáticamente tras descifrar |
-### Referencia completa de sintaxis
+### Referencia completa de sintaxis {#referencia-completa-de-sintaxis}
Para la lista completa de comandos LaTeX compatibles, consulta la [tabla de funciones de KaTeX](https://katex.org/docs/supported).
---
-## Mejores prácticas
+## Mejores prácticas {#mejores-prácticas}
-### Texto alternativo para accesibilidad
+### Texto alternativo para accesibilidad {#texto-alternativo-para-accesibilidad}
Siempre proporciona texto alternativo descriptivo para las imágenes:
@@ -409,7 +413,7 @@ Siempre proporciona texto alternativo descriptivo para las imágenes:
❌ {lg}
```
-### Organización de imágenes
+### Organización de imágenes {#organización-de-imágenes}
Guarda las imágenes de los paneles en `/telar-content/objects/` para encontrarlas fácilmente:
@@ -421,14 +425,14 @@ telar-content/objects/
└── ...
```
-### Longitud del contenido
+### Longitud del contenido {#longitud-del-contenido}
- **Capa 1**: 2–3 párrafos de contexto
- **Capa 2**: Contenido académico más extenso, citas, análisis extendido
Divide los textos largos con encabezados, listas e imágenes para que se lean mejor.
-### Nomenclatura de archivos
+### Nomenclatura de archivos {#nomenclatura-de-archivos}
Usa nombres de archivo descriptivos, en minúsculas con guiones:
@@ -439,17 +443,17 @@ Usa nombres de archivo descriptivos, en minúsculas con guiones:
---
-## Referencia rápida
+## Referencia rápida {#referencia-rápida}
Ejemplos listos para copiar y pegar de las tareas de formato más comunes:
-### Agregar una imagen con pie
+### Agregar una imagen con pie {#agregar-una-imagen-con-pie}
```markdown
{lg}
Detalle de los hilos de urdimbre, circa 1650.
```
-### Agregar un video de YouTube
+### Agregar un video de YouTube {#agregar-un-video-de-youtube}
```html
<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; margin: 1.5rem 0;">
<iframe style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"
@@ -458,31 +462,31 @@ Detalle de los hilos de urdimbre, circa 1650.
</div>
```
-### Agregar una cita con nota al pie
+### Agregar una cita con nota al pie {#agregar-una-cita-con-nota-al-pie}
```markdown
Estudios recientes cuestionan esta interpretación.[^1]
[^1]: García, M. (2023). *Repensando los textiles coloniales*. Editorial Universitaria.
```
-### Enlazar a un término del glosario
+### Enlazar a un término del glosario {#enlazar-a-un-término-del-glosario}
```markdown
El sistema de [[encomienda]] estructuró las relaciones tributarias coloniales.
```
-### Enlazar a otro objeto
+### Enlazar a otro objeto {#enlazar-a-otro-objeto}
```markdown
Compara con el [textil de Lima](/objects/textile-lima/).
```
-### Agregar fórmulas en línea y en bloque
+### Agregar fórmulas en línea y en bloque {#agregar-fórmulas-en-línea-y-en-bloque}
```markdown
El coeficiente es $C = \frac{8}{35}$ y el resultado es:
$$x^4 = \frac{8}{35}P_4(x) + \frac{4}{7}P_2(x) + \frac{1}{5}P_0(x)$$
```
-### Crear una cita en bloque
+### Crear una cita en bloque {#crear-una-cita-en-bloque}
```markdown
> "Los patrones revelan una comprensión sofisticada de la geometría."
> — Autor
@@ -490,7 +494,7 @@ $$x^4 = \frac{8}{35}P_4(x) + \frac{4}{7}P_2(x) + \frac{1}{5}P_0(x)$$
---
-## Limitaciones
+## Limitaciones {#limitaciones}
- **Sin JavaScript**: Markdown se convierte a HTML estático
- **Sin atributos HTML personalizados**: Usa la sintaxis de tamaño proporcionada en lugar de clases personalizadas
@@ -499,7 +503,7 @@ $$x^4 = \frac{8}{35}P_4(x) + \frac{4}{7}P_2(x) + \frac{1}{5}P_0(x)$$
---
-## Próximos pasos
+## Próximos pasos {#próximos-pasos}
- [Tu contenido](/guia/tu-contenido/) — Aprende a organizar tus archivos Markdown
- [Contenido enriquecido con Markdown](/guia/tu-contenido/contenido-enriquecido/) — Crea y edita archivos Markdown
diff --git a/docs/4-7-widgets.es.md b/content/es/guia/tu-contenido/widgets.md
similarity index 85%
rename from docs/4-7-widgets.es.md
rename to content/es/guia/tu-contenido/widgets.md
index 028d91c..ec6ddbe 100644
--- a/docs/4-7-widgets.es.md
+++ b/content/es/guia/tu-contenido/widgets.md
@@ -1,20 +1,18 @@
---
-layout: docs
-title: "4.7. Widgets"
-parent: "4. Tu contenido"
-grand_parent: Documentación
-nav_order: 7
-lang: es
-permalink: /guia/tu-contenido/widgets/
+title: Widgets
+url: /guia/tu-contenido/widgets/
+translationKey: docs-your-content-widgets
+type: guide
+docs_section: reference
---
-# Widgets
+# Widgets {#widgets}
Telar incluye un sistema de widgets interactivos para contenido enriquecido en paneles de historias y páginas personalizadas. Los widgets te permiten insertar carruseles de imágenes, contenido con pestañas y secciones plegables directamente en tu Markdown.
**Disponible desde v0.4.0.**
-## Widgets disponibles
+## Widgets disponibles {#widgets-disponibles}
| Widget | Propósito |
|--------|-----------|
@@ -23,7 +21,7 @@ Telar incluye un sistema de widgets interactivos para contenido enriquecido en p
| **Acordeón** | Secciones plegables para contenido secuencial o jerárquico |
| **Bibliografía** | Citas académicas con sangría francesa |
-## Sintaxis de widgets
+## Sintaxis de widgets {#sintaxis-de-widgets}
Los widgets usan la sintaxis de contenedor estilo CommonMark con triple dos puntos:
@@ -33,11 +31,11 @@ contenido del widget aquí
:::
```
-## Carrusel
+## Carrusel {#carrusel}
Muestra varias imágenes con controles de navegación, leyendas y créditos.
-### Sintaxis
+### Sintaxis {#sintaxis}
```markdown
:::carousel
@@ -55,7 +53,7 @@ credit: Archivo General de Indias
:::
```
-### Campos
+### Campos {#campos}
- **`image`** (obligatorio) — Ruta relativa a `telar-content/objects/`, o una URL completa para imágenes externas
- **`alt`** (recomendado) — Descripción para accesibilidad
@@ -65,7 +63,7 @@ credit: Archivo General de Indias
Separa los elementos del carrusel con `---`.
-### Imágenes externas
+### Imágenes externas {#imágenes-externas}
Puedes usar URLs completas para imágenes alojadas en otros servidores:
@@ -75,11 +73,11 @@ image: https://example.org/images/photo.jpg
Si las imágenes están alojadas en otros servidores, indica `width` (ancho) y `height` (alto) para que no haya que descargar cada una solo para medirla al generar el sitio.
-## Pestañas
+## Pestañas {#pestañas}
Organiza contenido en paneles conmutables — útil para presentar diferentes perspectivas, fuentes o categorías.
-### Sintaxis
+### Sintaxis {#sintaxis-1}
```markdown
:::tabs
@@ -98,18 +96,18 @@ Hoy las personas historiadoras reconocen este evento como...
:::
```
-### Estructura
+### Estructura {#estructura}
- Cada `## Encabezado` crea una pestaña nueva
- El contenido entre encabezados se convierte en el cuerpo de la pestaña
- Se admite la sintaxis estándar de Markdown dentro de las pestañas
- Mínimo 2 pestañas, máximo 4 pestañas
-## Acordeón
+## Acordeón {#acordeón}
Crea paneles plegables para secuencias cronológicas, información jerárquica o detalles opcionales que las personas pueden expandir según su interés.
-### Sintaxis
+### Sintaxis {#sintaxis-2}
```markdown
:::accordion
@@ -126,20 +124,20 @@ Las reformas borbónicas retaron las estructuras de poder existentes...
:::
```
-### Estructura
+### Estructura {#estructura-1}
- Cada `## Encabezado` crea un panel plegable
- Todos los paneles empiezan colapsados
- Se admite la sintaxis estándar de Markdown dentro de los paneles
- Mínimo 2 paneles, máximo 6 paneles
-## Bibliografía
+## Bibliografía {#bibliografía}
Presenta citas académicas con sangría francesa estándar. Cada cita se separa con una línea en blanco.
**Disponible desde v1.1.0.**
-### Sintaxis
+### Sintaxis {#sintaxis-3}
```markdown
:::bibliography
@@ -151,14 +149,14 @@ Muñoz-Arbeláez, S. (2025). *The New Kingdom of Granada: The Making and Unmakin
:::
```
-### Estructura
+### Estructura {#estructura-2}
- Cada cita se separa con una línea en blanco (doble salto de línea)
- La sintaxis estándar de Markdown funciona dentro de las entradas (`*cursivas*` para títulos, `**negrita**`, enlaces)
- Se muestra con sangría francesa — la primera línea queda al margen izquierdo, las líneas siguientes se indentan
- Un bloque de bibliografía vacío produce una advertencia durante el *build*
-## Dónde funcionan los widgets
+## Dónde funcionan los widgets {#dónde-funcionan-los-widgets}
Los widgets se pueden usar en:
@@ -167,12 +165,13 @@ Los widgets se pueden usar en:
Para los paneles de las historias, se recomienda guardar el contenido con widgets en un archivo Markdown (Método 3: indicar un archivo) en lugar de ingresarlo directamente en una celda de la hoja de cálculo, ya que la sintaxis de triple dos puntos es difícil de manejar en línea.
-{: .tip }
-> Los widgets usan automáticamente colores de panel contrastantes para distinción visual. Los widgets de la capa 1 aparecen con los colores de la capa 2 y viceversa.
+{{< callout "tip" >}}
+Los widgets usan automáticamente colores de panel contrastantes para distinción visual. Los widgets de la capa 1 aparecen con los colores de la capa 2 y viceversa.
+{{< /callout >}}
-## Imágenes en widgets
+## Imágenes en widgets {#imágenes-en-widgets}
-### Imágenes locales
+### Imágenes locales {#imágenes-locales}
Pon las imágenes en `telar-content/objects/` y haz referencia a ellas por nombre de archivo:
@@ -194,7 +193,7 @@ Si las imágenes están en subcarpetas, incluye la ruta relativa a `telar-conten
image: story1/map.jpg
```
-### Imágenes externas
+### Imágenes externas {#imágenes-externas-1}
Usa URLs completas para imágenes alojadas en otros servidores:
@@ -203,7 +202,7 @@ image: https://digital-collections.library.edu/iiif/image123.jpg
image: https://archive.org/download/item/photo.jpg
```
-## Validación
+## Validación {#validación}
Telar valida los widgets durante el *build*:
@@ -218,9 +217,9 @@ Telar valida los widgets durante el *build*:
Revisa la salida del *build* para ver mensajes de validación de widgets.
-## Ejemplos
+## Ejemplos {#ejemplos}
-### Línea de tiempo histórica
+### Línea de tiempo histórica {#línea-de-tiempo-histórica}
```markdown
:::accordion
@@ -236,7 +235,7 @@ Se consolidó la economía colonial basada en minería y agricultura...
:::
```
-### Fuentes comparativas
+### Fuentes comparativas {#fuentes-comparativas}
```markdown
:::tabs
@@ -252,7 +251,7 @@ Las excavaciones en el sitio revelaron...
:::
```
-### Comparación de imágenes
+### Comparación de imágenes {#comparación-de-imágenes}
```markdown
:::carousel
@@ -270,7 +269,7 @@ credit: Instituto Nacional de Antropología
:::
```
-### Citas académicas
+### Citas académicas {#citas-académicas}
```markdown
:::bibliography
@@ -280,7 +279,7 @@ Muñoz-Arbeláez, S. (2025). *The New Kingdom of Granada*. Duke University Press
:::
```
-## Véase también
+## Véase también {#véase-también}
- [Historias y Paneles](/guia/tu-contenido/historias-paneles/) — Usar widgets en paneles de historias
- [Páginas Personalizadas](/guia/funciones/paginas-personalizadas/) — Usar widgets en páginas independientes
diff --git a/docs/5-0-your-data.es.md b/content/es/guia/tus-datos/_index.md
similarity index 69%
rename from docs/5-0-your-data.es.md
rename to content/es/guia/tus-datos/_index.md
index 8183029..99245c9 100644
--- a/docs/5-0-your-data.es.md
+++ b/content/es/guia/tus-datos/_index.md
@@ -1,24 +1,23 @@
---
-layout: docs
-title: 5. Tus datos
-parent: Documentación
-nav_order: 5
-lang: es
-permalink: /guia/tus-datos/
-has_children: true
+title: Tus datos
+url: /guia/tus-datos/
+translationKey: docs-your-data
+type: guide
+docs_section: reference
---
-# Tus datos
+# Tus datos {#tus-datos}
Telar usa archivos de hoja de cálculo para definir la estructura de tu exhibición — qué historias existen, qué objetos contienen, dónde hacer zoom en cada imagen y qué términos de glosario incluir.
-Puedes administrar estos datos de dos maneras:
+Estos archivos son el formato de publicación. Elige cómo editar su contenido:
+- **Compositor** — edita visualmente; el editor escribe los archivos al publicar
- **Google Sheets** — edita una hoja de cálculo en tu navegador y Telar la obtiene y convierte a archivos CSV automáticamente durante cada *build*
- **Archivos CSV** — edita los archivos directamente en `telar-content/spreadsheets/`
-Ambos enfoques producen el mismo resultado. La mayoría de las personas comienzan con Google Sheets y nunca tocan un archivo CSV.
+Elige una fuente para la autoría. Si Google Sheets está activo, el build lo descarga y reemplaza sus copias CSV locales. Los [tres manuales](/guia/#build) explican cada proceso.
-## Archivos de datos
+## Archivos de datos {#archivos-de-datos}
| Archivo | Qué define | Referencia |
|---------|-----------|-----------|
@@ -27,7 +26,7 @@ Ambos enfoques producen el mismo resultado. La mayoría de las personas comienza
| `{story-id}.csv` | Pasos, coordenadas, contenido de paneles | [Columnas de historias](/guia/tus-datos/csv-historias/) |
| `glossary.csv` | Términos de glosario y definiciones | [Columnas del glosario](/guia/tus-datos/csv-glosario/) |
-## Soporte bilingüe de columnas
+## Soporte bilingüe de columnas {#soporte-bilingüe-de-columnas}
Todos los archivos de hoja de cálculo admiten nombres de columnas en inglés y en español. Puedes usar cualquiera de los dos idiomas, mezclarlos o incluir encabezados dobles para equipos bilingües:
@@ -37,8 +36,8 @@ orden,id_historia,titulo,subtitulo,firma
1,textiles-coloniales,Textiles Coloniales,Tradiciones de tejido,por Dra. María García
```
-Telar detecta automáticamente y omite la segunda fila de encabezado. También se admiten nombres de archivos en español (`proyecto.csv`, `objetos.csv`). Consulta [Columnas del proyecto](/guia/tus-datos/csv-proyecto/#descripcion-general) para detalles completos sobre la normalización de columnas.
+Telar detecta automáticamente y omite la segunda fila de encabezado. También se admiten nombres de archivos en español (`proyecto.csv`, `objetos.csv`). Consulta [Columnas del proyecto](/guia/tus-datos/csv-proyecto/#descripción-general) para detalles completos sobre la normalización de columnas.
-## Google Sheets
+## Google Sheets {#google-sheets}
Consulta [Google Sheets](/guia/tus-datos/google-sheets/) para la configuración y el flujo de trabajo.
diff --git a/docs/5-5-csv-glossary.es.md b/content/es/guia/tus-datos/csv-glosario.md
similarity index 83%
rename from docs/5-5-csv-glossary.es.md
rename to content/es/guia/tus-datos/csv-glosario.md
index 4a609d1..d59373e 100644
--- a/docs/5-5-csv-glossary.es.md
+++ b/content/es/guia/tus-datos/csv-glosario.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "5.5. Columnas del glosario"
-parent: "5. Tus datos"
-grand_parent: Documentación
-nav_order: 5
-lang: es
-permalink: /guia/tus-datos/csv-glosario/
+title: Columnas del glosario
+url: /guia/tus-datos/csv-glosario/
+translationKey: docs-your-data-csv-glossary
+type: guide
+docs_section: reference
---
-# Columnas del glosario
+# Columnas del glosario {#columnas-del-glosario}
-Referencia completa de las columnas de `glossary.csv` con soporte bilingüe de nombres de columnas. Para la normalización de columnas y soporte de encabezados dobles, consulta [Columnas del proyecto](/guia/tus-datos/csv-proyecto/#descripcion-general).
+Referencia completa de las columnas de `glossary.csv` con soporte bilingüe de nombres de columnas. Para la normalización de columnas y soporte de encabezados dobles, consulta [Columnas del proyecto](/guia/tus-datos/csv-proyecto/#descripción-general).
-## CSV de glosario (glossary.csv)
+## CSV de glosario (glossary.csv) {#csv-de-glosario-glossarycsv}
Define términos de glosario que se pueden enlazar desde los paneles de las historias usando la sintaxis `[[term_id]]`.
@@ -20,7 +18,7 @@ Define términos de glosario que se pueden enlazar desde los paneles de las hist
**Nuevo en v0.8.0.** El formato CSV es el método preferido para los términos de glosario. Los archivos Markdown heredados en `telar-content/texts/glossary/` siguen siendo compatibles, pero el CSV tiene precedencia si ambos existen.
-### Columnas
+### Columnas {#columnas}
| Inglés | Español | Requerido | Descripción |
|--------|---------|-----------|-------------|
@@ -29,7 +27,7 @@ Define términos de glosario que se pueden enlazar desde los paneles de las hist
| `definition` | `definicion` | No | Texto de la definición del término |
| `related_terms` | `terminos_relacionados` | No | IDs de términos relacionados, separados por una barra vertical |
-### Ejemplo
+### Ejemplo {#ejemplo}
**Inglés:**
```csv
@@ -47,27 +45,27 @@ urdimbre,Urdimbre,"El conjunto de hilos longitudinales en un telar, a través de
encomienda,Encomienda,"Un sistema de trabajo en la América colonial española, que otorgaba a los colonos autoridad sobre los trabajadores indígenas.",
```
-### Notas de los campos
+### Notas de los campos {#notas-de-los-campos}
-#### term_id / id_termino
+#### term_id / id_termino {#term_id--id_termino}
- Único entre todos los términos del glosario
- Se usa en la sintaxis de enlace en línea: `[[term_id]]` o `[[term_id|texto visible]]`
- Formato: minúsculas, se recomiendan guiones
- Los términos con prefijo `demo-` se marcan como contenido de demostración
-#### title / titulo
+#### title / titulo {#title--titulo}
- El nombre visible que se muestra en el panel del glosario y como texto del enlace
- Al usar la forma abreviada `[[term_id]]`, el título se usa automáticamente como texto del enlace
-#### definition / definicion
+#### definition / definicion {#definition--definicion}
- El texto de la definición mostrado en la entrada del glosario
- Admite formato Markdown básico
-#### related_terms / terminos_relacionados
+#### related_terms / terminos_relacionados {#related_terms--terminos_relacionados}
- Otros valores `term_id`, separados por `|` (por ejemplo, `urdimbre|telar`)
- Se usa para referencias cruzadas entre entradas del glosario
-### Sintaxis de enlace en línea
+### Sintaxis de enlace en línea {#sintaxis-de-enlace-en-línea}
Enlaza a términos del glosario desde los paneles de las historias usando sintaxis de doble corchete:
@@ -83,7 +81,7 @@ El [[loom|dispositivo de tejido]] era central para la producción textil.
Si el `term_id` no se encuentra en el glosario, un ícono de advertencia y un mensaje de error aparecen en la salida del *build* y en el panel de la historia.
-### Alias del CSV de glosario
+### Alias del CSV de glosario {#alias-del-csv-de-glosario}
| Normalizado | Acepta |
|------------|--------|
@@ -92,7 +90,7 @@ Si el `term_id` no se encuentra en el glosario, un ícono de advertencia y un me
| `definition` | `definition`, `definicion`, `definición` |
| `related_terms` | `related_terms`, `terminos_relacionados`, `términos_relacionados` |
-### CSV vs. glosario en Markdown
+### CSV vs. glosario en Markdown {#csv-vs-glosario-en-markdown}
| Aspecto | CSV (preferido) | Markdown (heredado) |
|---------|----------------|-------------------|
@@ -103,13 +101,13 @@ Si el `term_id` no se encuentra en el glosario, un ícono de advertencia y un me
Si existen tanto un CSV como un glosario en Markdown, se usa el CSV y se ignoran los archivos Markdown (con una advertencia en el *build*).
-## Validación
+## Validación {#validación}
**Advertencias de glosario**:
- `term_id` o `title` faltantes (se omite la fila)
- Enlace de glosario `[[term_id]]` hace referencia a un término inexistente
-## Véase también
+## Véase también {#véase-también}
- [Columnas del proyecto](/guia/tus-datos/csv-proyecto/) — Columnas de project.csv
- [Columnas de objetos](/guia/tus-datos/csv-objetos/) — Columnas de objects.csv
diff --git a/docs/5-4-csv-stories.es.md b/content/es/guia/tus-datos/csv-historias.md
similarity index 88%
rename from docs/5-4-csv-stories.es.md
rename to content/es/guia/tus-datos/csv-historias.md
index 1091b4b..9d5b675 100644
--- a/docs/5-4-csv-stories.es.md
+++ b/content/es/guia/tus-datos/csv-historias.md
@@ -1,18 +1,16 @@
---
-layout: docs
-title: "5.4. Columnas de historias"
-parent: "5. Tus datos"
-grand_parent: Documentación
-nav_order: 4
-lang: es
-permalink: /guia/tus-datos/csv-historias/
+title: Columnas de historias
+url: /guia/tus-datos/csv-historias/
+translationKey: docs-your-data-csv-stories
+type: guide
+docs_section: reference
---
-# Columnas de historias
+# Columnas de historias {#columnas-de-historias}
-Referencia completa de las columnas del CSV de historia con soporte bilingüe de nombres de columnas. Para la normalización de columnas y soporte de encabezados dobles, consulta [Columnas del proyecto](/guia/tus-datos/csv-proyecto/#descripcion-general).
+Referencia completa de las columnas del CSV de historia con soporte bilingüe de nombres de columnas. Para la normalización de columnas y soporte de encabezados dobles, consulta [Columnas del proyecto](/guia/tus-datos/csv-proyecto/#descripción-general).
-## CSV de historia (story-{id}.csv)
+## CSV de historia (story-{id}.csv) {#csv-de-historia-story-idcsv}
Define la navegación paso a paso y el contenido de paneles para cada historia.
@@ -22,7 +20,7 @@ Define la navegación paso a paso y el contenido de paneles para cada historia.
- Si `story_id` está especificado en project.csv: usa ese nombre (ej., `textiles-coloniales.csv`)
- Si `story_id` se omite: usa `story-{order}.csv` (ej., `story-1.csv`, `story-2.csv`)
-### Columnas
+### Columnas {#columnas}
| Inglés | Español | Requerido | Descripción |
|--------|---------|-----------|-------------|
@@ -45,7 +43,7 @@ Define la navegación paso a paso y el contenido de paneles para cada historia.
| `loop` | `bucle` | No | Reproducción en bucle (`true`, `false`, `yes`, `no`, `sí`). Predeterminado: false |
| `alt_text` | `texto_alt` | No | Texto alternativo por paso para accesibilidad |
-### Ejemplo
+### Ejemplo {#ejemplo}
**Inglés (con contenido en línea):**
```csv
@@ -63,26 +61,26 @@ paso,objeto,x,y,zoom,pregunta,respuesta,boton_capa1,contenido_capa1,boton_capa2,
El paso 1 usa contenido en línea para la capa 1, mientras que el paso 2 usa una referencia a archivo. Ambos enfoques funcionan y se pueden mezclar libremente.
-### Notas de los campos
+### Notas de los campos {#notas-de-los-campos}
-#### step / paso
+#### step / paso {#step--paso}
- Deben ser enteros secuenciales comenzando en 1
- No se permiten saltos (1, 2, 3... no 1, 3, 5)
- Determina el orden de navegación
-#### object / objeto
+#### object / objeto {#object--objeto}
- Debe coincidir con un `object_id` del objects.csv
- Dejar vacío para crear una **tarjeta de título** — un paso de solo texto sin objeto asociado. Consulta [Historias y paneles](/guia/tu-contenido/historias-paneles/#tarjetas-de-título). **Actualizado en v1.1.0**
- Varios pasos pueden hacer referencia al mismo objeto
-#### x, y, zoom
+#### x, y, zoom {#x-y-zoom}
- `x` y `y` van de 0 a 1
- **x**: 0 = borde izquierdo, 1 = borde derecho, 0.5 = centro
- **y**: 0 = borde superior, 1 = borde inferior, 0.5 = centro
- **zoom**: con 1 se ve el objeto completo junto a la tarjeta de texto. Con valores mayores, la vista se acerca y el punto que indican `x` y `y` queda en el centro: con 2 se ve más o menos la mitad del objeto y con 4, una cuarta parte. Con valores menores que 1, hasta 0.1, el objeto completo se ve más pequeño y con espacio alrededor. Con 1 o menos, el objeto queda centrado y `x` y `y` no lo mueven. Si el punto está cerca de un borde del objeto, la vista no pasa de ese borde, así que el punto puede no quedar en el centro.
- Usa el selector de coordenadas en las páginas de objetos para encontrar los valores
-#### page / pagina
+#### page / pagina {#page--pagina}
- Solo para objetos de múltiples páginas: un PDF alojado en tu sitio o un manifiesto IIIF externo con varias imágenes
- Los números de página comienzan en 1
- `x`, `y` y `zoom` encuadran la página que indiques en esta columna, no el documento completo
@@ -90,26 +88,26 @@ El paso 1 usa contenido en línea para la capa 1, mientras que el paso 2 usa una
- Si el valor no es un número entero positivo, se ignora y aparece una advertencia que nombra el paso
- Consulta [Documentos PDF](/guia/tu-contenido/documentos-pdf/) e [Imágenes IIIF externas](/guia/tu-contenido/iiif-externo/)
-#### question / pregunta
+#### question / pregunta {#question--pregunta}
- Se muestra como encabezado de la tarjeta de texto
- Solo texto plano, sin procesamiento Markdown
- Pregunta o afirmación breve
- Recomendado: 3-8 palabras
-#### answer / respuesta
+#### answer / respuesta {#answer--respuesta}
- Respuesta breve que se muestra en la tarjeta de texto, debajo de la pregunta
- Solo texto corrido. Consulta [Las respuestas son texto corrido](#las-respuestas-son-texto-corrido)
- Se recorta si pasa de 18 líneas. Consulta [El límite de las respuestas](#el-límite-de-las-respuestas)
- Recomendado: 1-2 oraciones
-#### Botones de las capas
+#### Botones de las capas {#botones-de-las-capas}
- Cadena vacía = texto predeterminado del botón
- Texto personalizado: cualquier cadena (ej., "Ver detalles", "See details")
- Si hay contenido pero el botón está vacío: muestra el texto predeterminado
- Si no hay contenido: el botón se oculta
-#### Contenido de las capas
+#### Contenido de las capas {#contenido-de-las-capas}
El contenido del panel se puede proporcionar de tres maneras:
@@ -135,8 +133,9 @@ Puedes usar formato básico: `**negrita**`, `*cursiva*`, `[texto del enlace](url
Pega texto escrito en un editor de texto plano. Esto admite la gama completa de características de formato, incluyendo encabezados, widgets (acordeón, carrusel, pestañas), controles de tamaño de imagen y un título de panel personalizado usando frontmatter YAML.
-{: .warning }
-> Si copias y pegas desde Microsoft Word, Google Docs o aplicaciones similares, el formato **no** se preservará. Escribe con sintaxis Markdown en su lugar — consulta la [Guía de Sintaxis Markdown](/guia/tu-contenido/sintaxis-markdown/).
+{{< callout "warning" >}}
+Si copias y pegas desde Microsoft Word, Google Docs o aplicaciones similares, el formato **no** se preservará. Escribe con sintaxis Markdown en su lugar — consulta la [Guía de Sintaxis Markdown](/guia/tu-contenido/sintaxis-markdown/).
+{{< /callout >}}
**Método 3: Indicar un archivo Markdown**
@@ -150,27 +149,27 @@ Guarda los archivos Markdown en `telar-content/texts/stories/`. En tu hoja de c
**Cómo decide Telar**: Si lo que ingresas termina en `.md` y el archivo existe, lo carga. De lo contrario, trata el valor como contenido.
-#### clip_start, clip_end / inicio_clip, fin_clip
+#### clip_start, clip_end / inicio_clip, fin_clip {#clip_start-clip_end--inicio_clip-fin_clip}
- **Nuevo en v1.0.0**
- Tiempos de inicio y fin en segundos para objetos de video y audio (ej., `12.5`, `65`)
- Se ignoran para objetos de imagen
- Deja ambos vacíos para reproducir el archivo completo
- Puedes fijar los valores del clip de forma visual en el [Compositor](/guia/el-compositor/video-y-audio/)
-#### loop / bucle
+#### loop / bucle {#loop--bucle}
- **Nuevo en v1.0.0**
- Controla si la reproducción de video o audio se repite en bucle
- Acepta `true`, `false`, `yes`, `no`, `sí`
- Predeterminado: `false` si se deja vacío
- Se ignora para objetos de imagen
-#### alt_text / texto_alt
+#### alt_text / texto_alt {#alt_text--texto_alt}
- **Nuevo en v1.0.0**
- Texto alternativo por paso para accesibilidad
- Si se deja vacío, usa el texto alternativo del objeto (de `objects.csv`) y luego el `title` del objeto
- Úsalo para proporcionar contexto específico de lo que muestra el paso — ej., un detalle ampliado que difiere de la descripción general del objeto
-### Elegir el método correcto
+### Elegir el método correcto {#elegir-el-método-correcto}
| Escenario | Método recomendado |
|----------|-------------------|
@@ -180,7 +179,7 @@ Guarda los archivos Markdown en `telar-content/texts/stories/`. En tu hoja de c
| Mismo contenido usado en varios lugares | Método 3: Archivo |
| Ediciones rápidas sin salir de la hoja de cálculo | Método 1 o 2 |
-### Alias del CSV de historia
+### Alias del CSV de historia {#alias-del-csv-de-historia}
| Normalizado | Acepta |
|------------|--------|
@@ -203,10 +202,11 @@ Guarda los archivos Markdown en `telar-content/texts/stories/`. En tu hoja de c
| `loop` | `loop`, `bucle` |
| `alt_text` | `alt_text`, `texto_alt` |
-{: .note }
-> Los nombres de columna `layer_file` / `archivo_capa` son alias heredados de antes de v0.6.3. Los nombres preferidos son `layer_content` / `contenido_capa`.
+{{< callout "note" >}}
+Los nombres de columna `layer_file` / `archivo_capa` son alias heredados de antes de v0.6.3. Los nombres preferidos son `layer_content` / `contenido_capa`.
+{{< /callout >}}
-## Las respuestas son texto corrido
+## Las respuestas son texto corrido {#las-respuestas-son-texto-corrido}
El campo `answer` aparece en la tarjeta de texto, debajo de la pregunta. En pantallas de escritorio esa tarjeta tiene un tamaño fijo y no se desplaza, así que lo que se salga del borde no le llega a quien lee.
@@ -235,7 +235,7 @@ Lo que desaparece por completo, junto con el texto que lleve adentro:
- **Bloques de código**
- **Líneas divisorias**
-### El límite de las respuestas
+### El límite de las respuestas {#el-límite-de-las-respuestas}
La respuesta tiene que caber entera en la tarjeta, sin que quien lee tenga que desplazarse. Por eso Telar no la mide en palabras sino en líneas: cuenta 53 caracteres por línea y dos líneas más por cada párrafo después del primero. Una respuesta puede tener hasta 18 líneas y cinco párrafos. En un solo párrafo, eso da para unas 150 palabras; si la divides en párrafos, para menos. Si pasa de 15 líneas, se muestra con letra un poco más pequeña.
@@ -243,7 +243,7 @@ Telar recorta toda respuesta que pase del límite y lo anota en la salida del *b
Escribe una o dos oraciones. Cuando necesites más espacio, pasa el detalle a un panel: los paneles admiten todo lo que describe la [Referencia de sintaxis de Markdown](/guia/tu-contenido/sintaxis-markdown/), incluidas las notas al pie, las tablas, las imágenes y los widgets.
-## Consejos para la entrada de datos
+## Consejos para la entrada de datos {#consejos-para-la-entrada-de-datos}
**Coordenadas**: Usa el selector de coordenadas en las páginas de objetos para encontrar los valores x, y y zoom, y cópialos directamente a tu CSV.
@@ -254,7 +254,7 @@ Escribe una o dos oraciones. Cuando necesites más espacio, pasa el detalle a un
**Contenido de paneles**: Usa referencias a archivos (Método 3) para contenido complejo con widgets. Usa texto en línea (Método 1) para paneles cortos.
-## Validación
+## Validación {#validación}
Telar valida los datos CSV de historias durante el *build*:
@@ -269,7 +269,7 @@ Telar valida los datos CSV de historias durante el *build*:
- ID de objeto no encontrado en objects.csv
- Formato quitado de la respuesta de un paso, o respuesta recortada a 18 líneas
-## Véase también
+## Véase también {#véase-también}
- [Columnas del proyecto](/guia/tus-datos/csv-proyecto/) — Columnas de project.csv
- [Columnas de objetos](/guia/tus-datos/csv-objetos/) — Columnas de objects.csv
diff --git a/docs/5-3-csv-objects.es.md b/content/es/guia/tus-datos/csv-objetos.md
similarity index 85%
rename from docs/5-3-csv-objects.es.md
rename to content/es/guia/tus-datos/csv-objetos.md
index b13996d..8baa96f 100644
--- a/docs/5-3-csv-objects.es.md
+++ b/content/es/guia/tus-datos/csv-objetos.md
@@ -1,27 +1,26 @@
---
-layout: docs
-title: "5.3. Columnas de objetos"
-parent: "5. Tus datos"
-grand_parent: Documentación
-nav_order: 3
-lang: es
-permalink: /guia/tus-datos/csv-objetos/
+title: Columnas de objetos
+url: /guia/tus-datos/csv-objetos/
+translationKey: docs-your-data-csv-objects
+type: guide
+docs_section: reference
---
-# Columnas de objetos
+# Columnas de objetos {#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](/guia/tus-datos/csv-proyecto/#descripcion-general).
+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](/guia/tus-datos/csv-proyecto/#descripción-general).
-## CSV de objetos (objects.csv / objetos.csv)
+## CSV de objetos (objects.csv / objetos.csv) {#csv-de-objetos-objectscsv--objetoscsv}
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`
-{: .tip }
-> Si usas el [Compositor](/guia/el-compositor/objetos/), este gestiona `objects.csv` visualmente — no es necesario editar el archivo directamente.
+{{< callout "tip" >}}
+Si usas el [Compositor](/guia/el-compositor/objetos/), este gestiona `objects.csv` visualmente — no es necesario editar el archivo directamente.
+{{< /callout >}}
-### Columnas
+### Columnas {#columnas}
| Inglés | Español | Requerido | Descripción |
|--------|---------|-----------|-------------|
@@ -42,7 +41,7 @@ Cataloga todos los objetos usados en las historias y mostrados en 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
+### Columnas de metadatos personalizados {#columnas-de-metadatos-personalizados}
Cualquier columna que agregues más allá de las 16 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.
@@ -55,7 +54,7 @@ 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
+### Ejemplo {#ejemplo}
**Inglés:**
```csv
@@ -71,37 +70,37 @@ textil-001,Textil Colonial,Un fragmento tejido con patrones complejos...,Descono
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
+### Notas de los campos {#notas-de-los-campos}
-#### object_id / id_objeto
+#### object_id / id_objeto {#object_id--id_objeto}
- Único entre todos los objetos
- Referenciado en los CSV de historias
- Se usa en las URLs: `/objects/{object_id}/`
- Formato: minúsculas, guiones, guiones bajos
-#### description / descripcion
+#### description / descripcion {#description--descripcion}
- Admite Markdown
- Se muestra en las páginas de objetos
- Puede incluir encabezados, listas, enlaces, énfasis
-#### source_url / url_fuente
+#### source_url / url_fuente {#source_url--url_fuente}
- URL a la Image API IIIF info.json o la Presentation API IIIF manifiesto
- Úsalo para objetos de servidores IIIF externos
- Déjalo vacío para imágenes autoalojadas (las teselas se generan automáticamente)
- **v0.5.0+**: Preferido sobre la columna heredada `iiif_manifest` (que aún funciona)
-#### year / año
+#### year / año {#year--año}
- **Nuevo en v0.8.0**
- Se usa para ordenar objetos en la galería (ordenar por año)
- Formato flexible: `1650`, `1685`, `1750`
- Acepta `año` o `ano` (sin tilde) como alias en español
-#### source / fuente
+#### source / fuente {#source--fuente}
- **Renombrado en v0.8.0** desde `location`
- Ubicación actual o repositorio que lo alberga
- El nombre antiguo `location` (y los alias en español `ubicacion`, `locacion`) sigue funcionando por compatibilidad
-#### medium / medio_genero
+#### medium / medio_genero {#medium--medio_genero}
- **Renombrado en v1.0.0** desde `object_type` / `tipo_objeto`
- Describe el género o medio del objeto — no el tipo de medio (imagen, video, audio), que ahora se detecta automáticamente desde la fuente del objeto
- Ejemplos: `Fotografía`, `Óleo sobre lienzo`, `Textil`, `Mapa`
@@ -109,42 +108,42 @@ mapa-lima,Mapa de Lima,Mapa colonial temprano...,Juan de Cuellar,1685,mapa,"cart
- El nombre antiguo `object_type` (y el alias en español `tipo_objeto`) sigue funcionando por compatibilidad
- También acepta `medium_genre` como alias en inglés
-#### alt_text / texto_alt
+#### alt_text / texto_alt {#alt_text--texto_alt}
- **Nuevo en v1.0.0**
- Texto alternativo para la imagen del objeto, usado para accesibilidad
- Usa el `title` del objeto si se deja vacío
- Se muestra en el atributo `alt` de las imágenes del objeto en todo el sitio
-#### object_type / tipo_objeto
+#### object_type / tipo_objeto {#object_type--tipo_objeto}
- **Obsoleto en v1.0.0** — usa `medium` / `medio_genero` en su lugar
- Sigue funcionando como alias de `medium` por compatibilidad
- Clasificación del objeto usada como faceta en la barra lateral de filtros de la galería
- Ejemplos: `mapa`, `textil`, `fotografía`, `pintura`
- Aparece como categoría de filtro cuando `browse_and_search: true`
-#### subjects / temas
+#### subjects / temas {#subjects--temas}
- **Nuevo en v0.8.0**
- Temas separados por comas usados como facetas en la barra lateral de filtros de la galería
- Ejemplos: `"tejido, colonial, textiles"`, `"cartografía, Lima, urbanismo"`
- También acepta alias en español: `materias`, `materia`
-#### featured / destacado
+#### featured / destacado {#featured--destacado}
- **Nuevo en v0.8.0**
- Pon `yes` para destacar este objeto en la página principal
- Los objetos destacados se priorizan cuando `show_sample_on_homepage: true` en la configuración
- La cantidad mostrada se controla con `featured_count` (predeterminado: 4)
-#### credit / credito
+#### credit / credito {#credit--credito}
- Se muestra como etiqueta en la esquina superior derecha de las imágenes (si `show_object_credits: true`)
- También se muestra en la tabla de metadatos
- Úsalo para atribución: `Dominio Público`, `CC BY 4.0`, `Cortesía del Archivo Nacional`
-#### thumbnail / miniatura
+#### thumbnail / miniatura {#thumbnail--miniatura}
- Ruta a un archivo de imagen en miniatura
- Relativa a la raíz del repositorio
- Si se omite, Telar genera miniaturas desde la fuente IIIF
-### Alias del CSV de objetos
+### Alias del CSV de objetos {#alias-del-csv-de-objetos}
| Normalizado | Acepta |
|------------|--------|
@@ -165,9 +164,9 @@ mapa-lima,Mapa de Lima,Mapa colonial temprano...,Juan de Cuellar,1685,mapa,"cart
| `source_url` | `source_url`, `url_fuente` |
| `iiif_manifest` | `iiif_manifest`, `manifiesto_iiif` (heredado) |
-## Buenas prácticas
+## Buenas prácticas {#buenas-prácticas}
-### Elegir nombres de columnas
+### Elegir nombres de columnas {#elegir-nombres-de-columnas}
**Sitios monolingües**: Usa tu idioma preferido de forma consistente
```csv
@@ -184,7 +183,7 @@ order,story_id,title,subtitle,byline
orden,id_historia,titulo,subtitulo,firma
```
-### Organización de archivos
+### Organización de archivos {#organización-de-archivos}
```
telar-content/spreadsheets/
@@ -195,7 +194,7 @@ telar-content/spreadsheets/
└── glossary.csv # Términos de glosario (opcional)
```
-### Consejos para los metadatos de la galería
+### Consejos para los metadatos de la galería {#consejos-para-los-metadatos-de-la-galería}
Para la mejor experiencia de galería con exploración, búsqueda y filtrado:
@@ -205,9 +204,9 @@ Para la mejor experiencia de galería con exploración, búsqueda y filtrado:
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
+## Migración de v0.7.x a v0.8.0 {#migración-de-v07x-a-v080}
-### Columnas nuevas (opcionales)
+### Columnas nuevas (opcionales) {#columnas-nuevas-opcionales}
Agrega estas a tu objects.csv si deseas filtrado y ordenación en la galería:
@@ -218,13 +217,13 @@ Agrega estas a tu objects.csv si deseas filtrado y ordenación en la galería:
| `subjects` | Habilita el filtro de temas en la barra lateral |
| `featured` | Controla la muestra de objetos en la página principal |
-### Columnas renombradas
+### Columnas renombradas {#columnas-renombradas}
| Anterior (v0.7.x) | Nuevo (v0.8.0) | Notas |
|-------------------|----------------|-------|
| `location` | `source` | El nombre anterior sigue funcionando |
-### Nueva columna en project.csv
+### Nueva columna en project.csv {#nueva-columna-en-projectcsv}
| Columna | Propósito |
|---------|-----------|
@@ -232,7 +231,7 @@ Agrega estas a tu objects.csv si deseas filtrado y ordenación en la galería:
**Sin cambios que rompan compatibilidad.** Todos los CSV de v0.7.x funcionan sin modificación.
-## Validación
+## Validación {#validación}
Telar revisa los datos del CSV de objetos durante el *build* y escribe mensajes en la salida del *build*.
@@ -248,7 +247,7 @@ Telar revisa los datos del CSV de objetos durante el *build* y escribe mensajes
Todas las advertencias aparecen en la salida del *build*. Revisa la salida en busca de mensajes marcados con `[WARN]` para detectar problemas en los datos antes de publicar.
-## Véase también
+## Véase también {#véase-también}
- [Columnas del proyecto](/guia/tus-datos/csv-proyecto/) — Columnas de project.csv
- [Columnas de historias](/guia/tus-datos/csv-historias/) — Columnas de los CSV de historia
diff --git a/docs/5-2-csv-project.es.md b/content/es/guia/tus-datos/csv-proyecto.md
similarity index 87%
rename from docs/5-2-csv-project.es.md
rename to content/es/guia/tus-datos/csv-proyecto.md
index 658340d..a8b1a5d 100644
--- a/docs/5-2-csv-project.es.md
+++ b/content/es/guia/tus-datos/csv-proyecto.md
@@ -1,22 +1,20 @@
---
-layout: docs
-title: "5.2. Columnas del proyecto"
-parent: "5. Tus datos"
-grand_parent: Documentación
-nav_order: 2
-lang: es
-permalink: /guia/tus-datos/csv-proyecto/
+title: Columnas del proyecto
+url: /guia/tus-datos/csv-proyecto/
+translationKey: docs-your-data-csv-project
+type: guide
+docs_section: reference
---
-# Columnas del proyecto
+# Columnas del proyecto {#columnas-del-proyecto}
Referencia completa de las columnas de `project.csv` con soporte bilingüe de nombres de columnas.
-## Descripción general
+## Descripción general {#descripción-general}
Telar v0.6.0+ admite columnas CSV en inglés y español. Puedes usar cualquiera de los dos idiomas de forma consistente, mezclarlos o incluir encabezados dobles para referencia bilingüe.
-### Normalización de columnas
+### Normalización de columnas {#normalización-de-columnas}
Todos los nombres de columnas se normalizan durante el procesamiento:
- Sin distinción entre mayúsculas y minúsculas (`Title` = `title` = `TITLE`)
@@ -24,7 +22,7 @@ Todos los nombres de columnas se normalizan durante el procesamiento:
- Nombres en español mapeados a equivalentes en inglés
- Caracteres con tilde admitidos
-### Soporte de encabezados dobles
+### Soporte de encabezados dobles {#soporte-de-encabezados-dobles}
Incluye encabezados en inglés y español para equipos bilingües:
@@ -37,13 +35,13 @@ orden,id_historia,titulo,subtitulo,firma
Telar detecta automáticamente y omite la segunda fila de encabezado.
-## CSV de proyecto (project.csv / proyecto.csv)
+## CSV de proyecto (project.csv / proyecto.csv) {#csv-de-proyecto-projectcsv--proyectocsv}
Define las historias y su orden de visualización en la página principal.
**Ubicación**: `telar-content/spreadsheets/project.csv` o `telar-content/spreadsheets/proyecto.csv`
-### Columnas
+### Columnas {#columnas}
| Inglés | Español | Requerido | Descripción |
|--------|---------|-----------|-------------|
@@ -55,7 +53,7 @@ Define las historias y su orden de visualización en la página principal.
| `private` | `privada` | No | Pon `yes` para encriptar esta historia (requiere `story_key` en la configuración); también se aceptan `protected`/`protegida` |
| `show_sections` | `mostrar_secciones` | No | Pon `si` para mostrar una tabla de contenidos en la tarjeta de inicio de la historia. Consulta [Historias y paneles: Tabla de contenidos de secciones](/guia/tu-contenido/historias-paneles/#tabla-de-contenidos-de-secciones). **Nuevo en v1.2.0** |
-### Ejemplo
+### Ejemplo {#ejemplo}
**Inglés:**
```csv
@@ -71,33 +69,33 @@ orden,id_historia,titulo,subtitulo,firma,privada,mostrar_secciones
2,rutas-comerciales,Rutas Comerciales,Siguiendo los hilos del comercio,basado en [investigación original](https://ejemplo.com),si,
```
-### Notas de los campos
+### Notas de los campos {#notas-de-los-campos}
-#### order
+#### order {#order}
- Deben ser enteros únicos
- Determina el orden de las tarjetas en la página principal
- Se permiten saltos (1, 2, 5 funciona bien)
- Se renumera automáticamente si se incluye contenido de demostración
-#### story_id
+#### story_id {#story_id}
- **Nuevo en v0.6.0**
- Solo minúsculas, guiones y guiones bajos
- Se usa para: nombre del archivo CSV de la historia, URL de la historia, referencias internas
- Si se omite: se usa `story-1`, `story-2`, etc. según el orden
- Ejemplos: `textiles-coloniales`, `paisajes_coloniales`, `story-one`
-#### title
+#### title {#title}
- Se muestra en las tarjetas de la página principal y en los encabezados de la historia
- Sin procesamiento Markdown (solo texto plano)
- Recomendado: 2-6 palabras
-#### subtitle
+#### subtitle {#subtitle}
- Se muestra debajo del título en las tarjetas de la página principal
- Sin procesamiento Markdown
- Recomendado: 5-12 palabras
- Describe brevemente el contenido de la historia
-#### byline
+#### byline {#byline}
- **Admite Markdown** (v0.6.0+)
- Página principal: se renderiza como texto plano
- Página de la historia: renderiza enlaces Markdown como clicables
@@ -107,7 +105,7 @@ orden,id_historia,titulo,subtitulo,firma,privada,mostrar_secciones
- `basado en [investigación original](https://example.com)`
- `curado por *Proyecto de Archivo Digital*`
-#### private
+#### private {#private}
- **Nuevo en v0.8.0**
- Pon `yes` para encriptar la historia cuando el *build* termina (durante el *build* de Jekyll la historia se genera normalmente; la encriptación es un paso aparte que corre después)
- Requiere `story_key` en `_config.yml` — si falta la clave, el *build* falla en lugar de publicar la historia en texto plano
@@ -116,14 +114,14 @@ orden,id_historia,titulo,subtitulo,firma,privada,mostrar_secciones
- Déjalo vacío u omítelo para historias públicas
- Consulta [Historias Privadas](/guia/funciones/historias-privadas/) para detalles
-#### show_sections
+#### show_sections {#show_sections}
- **Nuevo en v1.2.0**
- Pon `si` para mostrar una tabla de contenidos navegable en la tarjeta de inicio
- La tabla de contenidos genera enlaces automáticamente a cada tarjeta de título de la historia
- Déjalo vacío u omítelo para mostrar la tarjeta de inicio sin tabla de contenidos
- Consulta [Historias y paneles](/guia/tu-contenido/historias-paneles/#tabla-de-contenidos-de-secciones) para detalles
-### Alias del CSV de proyecto
+### Alias del CSV de proyecto {#alias-del-csv-de-proyecto}
| Normalizado | Acepta |
|------------|--------|
@@ -135,7 +133,7 @@ orden,id_historia,titulo,subtitulo,firma,privada,mostrar_secciones
| `private` | `private`, `privada`, `protected`, `protegida` |
| `show_sections` | `show_sections`, `mostrar_secciones` |
-## Véase también
+## Véase también {#véase-también}
- [Columnas de objetos](/guia/tus-datos/csv-objetos/) — Columnas de objects.csv
- [Columnas de historias](/guia/tus-datos/csv-historias/) — Columnas de los CSV de historia
diff --git a/content/es/guia/tus-datos/google-sheets.md b/content/es/guia/tus-datos/google-sheets.md
new file mode 100644
index 0000000..e5d9fb9
--- /dev/null
+++ b/content/es/guia/tus-datos/google-sheets.md
@@ -0,0 +1,71 @@
+---
+title: Entiende la hoja de cálculo
+url: /guia/tus-datos/google-sheets/
+translationKey: docs-your-data-google-sheets
+type: guide
+docs_section: sheets
+---
+
+# Entiende la hoja de cálculo {#entiende-la-hoja-de-cálculo}
+
+<span class="anchor-alias" id="véase-también"></span>
+
+<span class="anchor-alias" id="solución-de-problemas"></span>
+
+<span class="anchor-alias" id="referencia-de-columnas-resumen"></span>
+
+<span class="anchor-alias" id="obtener-datos-solo-desarrollo-local"></span>
+
+<span class="anchor-alias" id="integración-con-google-sheets"></span>
+
+<span class="anchor-alias" id="inicio-rápido"></span>
+
+<span class="anchor-alias" id="configurar-_configyml"></span>
+
+Tu hoja de Google Sheets es la fuente de una versión generada de la exhibición. Editar una celda no cambia inmediatamente el sitio público: el siguiente build descarga y procesa la hoja publicada.
+
+## Cómo se conectan las pestañas {#cómo-se-conectan-las-pestañas}
+
+| Pestaña | Función | Relación |
+|---|---|---|
+| `project` | Enumera historias y su orden | `story_id` identifica la pestaña de una historia |
+| `objects` | Describe la colección compartida | `object_id` se usa en los pasos |
+| Una pestaña por historia | Enumera pasos, vistas, preguntas y paneles | `object` corresponde al ID de un objeto |
+| `glossary` | Define términos recurrentes | `term_id` se usa en enlaces del texto |
+
+La plantilla incluye instrucciones y encabezados bilingües. Conserva los nombres de columnas que procesa Telar. Se ignoran las filas o columnas que comienzan con `#`.
+
+## Empieza con la plantilla {#empieza-con-la-plantilla}
+
+Usa la plantilla enlazada en [la configuración guiada](/guia/primeros-pasos/google-sheets/). Haz tu propia copia y publícala mediante **Archivo → Compartir → Publicar en la Web**.
+
+El enlace de edición es distinto del publicado. La configuración necesita este último:
+
+```yaml
+google_sheets:
+ enabled: true
+ published_url: "URL-PUBLICADA-DE-TU-HOJA"
+```
+
+Publica las pestañas que necesita Telar. No pongas notas confidenciales en contenido publicado en la web.
+
+## Mantén IDs consistentes {#mantén-ids-consistentes}
+
+Usa IDs breves y estables, en minúsculas y con guiones. El ID de historia debe coincidir con su pestaña. La referencia de un objeto debe coincidir con su ID en `objects`. Un enlace al glosario debe corresponder al ID del término.
+
+Los títulos pueden cambiar sin alterar estas relaciones. Si cambias un ID, actualiza sus referencias.
+
+## Usa texto y referencias a archivos {#usa-texto-y-referencias-a-archivos}
+
+Puedes escribir un panel breve en `layer1_content` o `layer2_content`. Usa Markdown para el formato. Una ruta terminada en `.md` puede referirse a un texto más extenso en la carpeta de textos de historias del repositorio.
+
+Las respuestas son prosa breve y sin formato enriquecido. Los paneles sirven para ampliar el contexto. Consulta los campos en [columnas de historias](/guia/tus-datos/csv-historias/).
+
+<span class="anchor-alias" id="estructura-de-la-hoja"></span>
+## Elige la hoja como fuente {#elige-la-hoja-como-fuente}
+
+Si pasas al Compositor, revisa la importación y cambia deliberadamente la fuente de contenido. El Compositor no devuelve tus ediciones visuales a Google Sheets. Si dejas Sheets activo, un build posterior puede reemplazarlas con el contenido de la hoja.
+
+En trabajo local, `python3 scripts/build_local_site.py` descarga Sheets cuando está activo. Los CSV de `telar-content/spreadsheets/` son copias descargadas; edita la hoja si esa es tu fuente.
+
+Sigue con [un objeto y tu primera historia](/guia/primeros-pasos/agrega-contenido/).
diff --git a/content/es/guide-sketch/_index.md b/content/es/guide-sketch/_index.md
new file mode 100644
index 0000000..c26b95b
--- /dev/null
+++ b/content/es/guide-sketch/_index.md
@@ -0,0 +1,5 @@
+---
+build:
+ list: never
+ render: never
+---
diff --git a/content/es/guide-sketch/es/_index.md b/content/es/guide-sketch/es/_index.md
new file mode 100644
index 0000000..ebf90dc
--- /dev/null
+++ b/content/es/guide-sketch/es/_index.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guide-sketch/es/
+translationKey: guide-sketch-index-html
+type: redirect
+docs_section: reference
+redirect_to: /guia/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guide-sketch/es/plan.md b/content/es/guide-sketch/es/plan.md
new file mode 100644
index 0000000..5b8203f
--- /dev/null
+++ b/content/es/guide-sketch/es/plan.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guide-sketch/es/plan/
+translationKey: guide-sketch-plan-html
+type: redirect
+docs_section: reference
+redirect_to: /guia/planear/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/guide-sketch/es/quick-start.md b/content/es/guide-sketch/es/quick-start.md
new file mode 100644
index 0000000..40aecae
--- /dev/null
+++ b/content/es/guide-sketch/es/quick-start.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /guide-sketch/es/quick-start/
+translationKey: guide-sketch-quick-html
+type: redirect
+docs_section: reference
+redirect_to: /empezar/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/manual/_index.md b/content/es/manual/_index.md
new file mode 100644
index 0000000..c26b95b
--- /dev/null
+++ b/content/es/manual/_index.md
@@ -0,0 +1,5 @@
+---
+build:
+ list: never
+ render: never
+---
diff --git a/content/es/manual/es/_index.md b/content/es/manual/es/_index.md
new file mode 100644
index 0000000..f0b1112
--- /dev/null
+++ b/content/es/manual/es/_index.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /manual/es/
+translationKey: manual-index-html
+type: redirect
+docs_section: reference
+redirect_to: /guia/el-compositor/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/manual/es/iiif-a-historia.md b/content/es/manual/es/iiif-a-historia.md
new file mode 100644
index 0000000..2b1258b
--- /dev/null
+++ b/content/es/manual/es/iiif-a-historia.md
@@ -0,0 +1,11 @@
+---
+title: Telar
+url: /manual/es/iiif-a-historia/
+translationKey: manual-iiif-md
+type: redirect
+docs_section: reference
+redirect_to: /guia/el-compositor/iiif-a-historia/
+sitemap:
+ disable: true
+robots: noindex,follow
+---
diff --git a/content/es/manual/review.md b/content/es/manual/review.md
new file mode 100644
index 0000000..3172b24
--- /dev/null
+++ b/content/es/manual/review.md
@@ -0,0 +1,13 @@
+---
+title: Revisión del piloto y cobertura
+url: /manual/review/
+translationKey: manual-review-html
+type: guide
+docs_section: compositor
+robots: noindex,nofollow
+no_search: true
+extra_css:
+- compositor-manual
+---
+
+{{< template "manual-review-es" >}}
diff --git a/content/es/proyectos/_index.md b/content/es/proyectos/_index.md
new file mode 100644
index 0000000..36db0ef
--- /dev/null
+++ b/content/es/proyectos/_index.md
@@ -0,0 +1,13 @@
+---
+title: Proyectos hechos con Telar
+url: /proyectos/
+translationKey: showcase
+type: section
+description: Exposiciones, investigaciones y trabajos de clase hechos con Telar.
+extra_css:
+- showcase
+section_title: Proyectos
+docs_section: reference
+---
+
+{{< section-body "showcase-es" >}}
diff --git a/content/es/proyectos/compartir.md b/content/es/proyectos/compartir.md
new file mode 100644
index 0000000..8bd43f8
--- /dev/null
+++ b/content/es/proyectos/compartir.md
@@ -0,0 +1,14 @@
+---
+title: Comparte tu proyecto hecho con Telar
+url: /proyectos/compartir/
+translationKey: showcase-submit
+type: section
+description: Cuéntanos del sitio que hiciste con Telar para que lo incluyamos en la
+ sección de proyectos.
+extra_css:
+- showcase
+section_title: Proyectos
+docs_section: reference
+---
+
+{{< section-body "showcase-submit-es" >}}
diff --git a/data/compositor_manual.json b/data/compositor_manual.json
new file mode 100644
index 0000000..57561d7
--- /dev/null
+++ b/data/compositor_manual.json
@@ -0,0 +1,1066 @@
+{
+ "date": "2026-10-31",
+ "compositor_version": "1.5.5-beta",
+ "baselines": [
+ {
+ "name": "telar",
+ "sha": "a579828e89b7553c1078ce1605be86f436131f6a",
+ "branch": "v1.8.3"
+ },
+ {
+ "name": "telar-compositor",
+ "sha": "b117ab969feec70a493beb78999446dd07fffccb",
+ "branch": "main"
+ },
+ {
+ "name": "telar-docs",
+ "sha": "46d18487e56f3b3d209894e35d7bd6170fb5f0f4",
+ "branch": "main"
+ },
+ {
+ "name": "telar-demo-content",
+ "sha": "5126c31adaf5651cc3fdae49f481f9c8822b9390",
+ "branch": "main"
+ },
+ {
+ "name": "telar-showcase",
+ "sha": "6de17b2dba5a84b83b5f558ed622352d40c0e5ee",
+ "branch": "main"
+ }
+ ],
+ "coverage": [
+ {
+ "id": "C01",
+ "chapter": "workspace",
+ "task": "Account and interface language",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.account.tsx",
+ "existing_english_reference": "/docs/the-compositor/getting-started/",
+ "status": "missing-guide",
+ "verification": "source-and-live",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C02",
+ "chapter": "first-site",
+ "task": "Create a new site",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/onboarding.tsx",
+ "existing_english_reference": "/docs/getting-started/compositor/",
+ "status": "needs-update",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C03",
+ "chapter": "first-site",
+ "task": "Connect a repository or import Sheets",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/onboarding.tsx",
+ "existing_english_reference": "/docs/the-compositor/getting-started/",
+ "status": "needs-update",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C04",
+ "chapter": "workspace",
+ "task": "Start and the six setup tasks",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.start.tsx",
+ "existing_english_reference": "/docs/the-compositor/dashboard/",
+ "status": "needs-update",
+ "verification": "live-inspected",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C05",
+ "chapter": "objects",
+ "task": "Fetch an external IIIF manifest",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/components/features/objects/AddObjectDialog.tsx",
+ "existing_english_reference": "/docs/the-compositor/objects/",
+ "status": "pilot-draft",
+ "verification": "source-and-live",
+ "recording": "Pilot script"
+ },
+ {
+ "id": "C06",
+ "chapter": "objects",
+ "task": "Review imported metadata and add the object",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.objects.tsx",
+ "existing_english_reference": "/docs/the-compositor/objects/",
+ "status": "pilot-draft",
+ "verification": "source-checked",
+ "recording": "Pilot script"
+ },
+ {
+ "id": "C07",
+ "chapter": "objects",
+ "task": "Upload images, PDF, WEBP and audio",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/components/features/objects/AddObjectDialog.tsx",
+ "existing_english_reference": "/docs/the-compositor/objects/",
+ "status": "needs-update",
+ "verification": "source-checked",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C08",
+ "chapter": "objects",
+ "task": "Add external video or audio",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/components/features/objects/AddObjectDialog.tsx",
+ "existing_english_reference": "/docs/the-compositor/video-audio/",
+ "status": "needs-update",
+ "verification": "source-checked",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C09",
+ "chapter": "objects",
+ "task": "Metadata, credits and alternative text",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.objects.$objectId.tsx",
+ "existing_english_reference": "/docs/the-compositor/objects/",
+ "status": "needs-illustrations",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C10",
+ "chapter": "objects",
+ "task": "Find, feature, rename and remove objects",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.objects.tsx",
+ "existing_english_reference": "/docs/the-compositor/objects/",
+ "status": "needs-update",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C11",
+ "chapter": "stories",
+ "task": "Create a story and its title card",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.stories.tsx",
+ "existing_english_reference": "/docs/the-compositor/story-editor/",
+ "status": "needs-update",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C12",
+ "chapter": "stories",
+ "task": "Add steps and choose objects",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.stories.$storyId.tsx",
+ "existing_english_reference": "/docs/the-compositor/story-editor/",
+ "status": "pilot-draft",
+ "verification": "source-checked",
+ "recording": "Pilot script"
+ },
+ {
+ "id": "C13",
+ "chapter": "stories",
+ "task": "Reorder steps and add sections",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.stories.$storyId.tsx",
+ "existing_english_reference": "/docs/the-compositor/story-editor/",
+ "status": "needs-illustrations",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C14",
+ "chapter": "framing",
+ "task": "Frame an image and press Capture position",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/components/features/editor/ViewerBottomBar.tsx",
+ "existing_english_reference": "/docs/the-compositor/story-editor/",
+ "status": "pilot-draft",
+ "verification": "source-checked",
+ "recording": "Pilot script"
+ },
+ {
+ "id": "C15",
+ "chapter": "framing",
+ "task": "Frame, centre, whole area and text limit",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/components/features/editor/StoryStage.tsx",
+ "existing_english_reference": "/docs/the-compositor/story-editor/",
+ "status": "missing-guide",
+ "verification": "source-checked",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C16",
+ "chapter": "panels",
+ "task": "Edit answers and layered panels",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.stories.$storyId.tsx",
+ "existing_english_reference": "/docs/the-compositor/story-editor/",
+ "status": "needs-update",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C17",
+ "chapter": "panels",
+ "task": "Widgets, footnotes and mathematics",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.stories.$storyId.tsx",
+ "existing_english_reference": "/docs/your-content/widgets/",
+ "status": "missing-guide",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C18",
+ "chapter": "media",
+ "task": "Capture media clips and looping",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.stories.$storyId.tsx",
+ "existing_english_reference": "/docs/the-compositor/video-audio/",
+ "status": "needs-illustrations",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C19",
+ "chapter": "glossary",
+ "task": "Terms, aliases, kinds and links",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.glossary.tsx",
+ "existing_english_reference": "/docs/site-features/glossary/",
+ "status": "missing-guide",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C20",
+ "chapter": "pages",
+ "task": "Edit the homepage",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.homepage.tsx",
+ "existing_english_reference": "/docs/customization/home-page/",
+ "status": "missing-guide",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C21",
+ "chapter": "pages",
+ "task": "Create pages and arrange navigation",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.pages.tsx",
+ "existing_english_reference": "/docs/site-features/custom-pages/",
+ "status": "missing-guide",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C22",
+ "chapter": "pages",
+ "task": "Themes, site language and settings",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.config.tsx",
+ "existing_english_reference": "/docs/configure/configuration/",
+ "status": "missing-guide",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C23",
+ "chapter": "team",
+ "task": "Invitations, roles and repository access",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.team.tsx",
+ "existing_english_reference": "",
+ "status": "missing-guide",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C24",
+ "chapter": "team",
+ "task": "Presence and simultaneous editing",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.tsx",
+ "existing_english_reference": "",
+ "status": "missing-guide",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C25",
+ "chapter": "team",
+ "task": "Contribution record and its limits",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.contributions.tsx",
+ "existing_english_reference": "",
+ "status": "missing-guide",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C26",
+ "chapter": "courses",
+ "task": "Set up a course and shared objects",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.course.tsx",
+ "existing_english_reference": "",
+ "status": "missing-guide",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C27",
+ "chapter": "courses",
+ "task": "Join a course or join as staff",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.account.tsx",
+ "existing_english_reference": "",
+ "status": "missing-guide",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C28",
+ "chapter": "publish",
+ "task": "Draft, saved state and published site",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.publish.tsx",
+ "existing_english_reference": "/docs/the-compositor/publishing/",
+ "status": "needs-update",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C29",
+ "chapter": "publish",
+ "task": "Validation, publishing and build results",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.publish.tsx",
+ "existing_english_reference": "/docs/the-compositor/publishing/",
+ "status": "needs-illustrations",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C30",
+ "chapter": "sync",
+ "task": "Review individual changes made on GitHub",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.publish.tsx",
+ "existing_english_reference": "/docs/the-compositor/sync-updates/",
+ "status": "needs-update",
+ "verification": "source-checked",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C31",
+ "chapter": "sync",
+ "task": "Upgrade and interpret build outcomes",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.upgrade.tsx",
+ "existing_english_reference": "/docs/the-compositor/sync-updates/",
+ "status": "needs-update",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "C32",
+ "chapter": "recovery",
+ "task": "Reconnect, identify saved work and get help",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/routes/_app.tsx",
+ "existing_english_reference": "",
+ "status": "missing-guide",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "R01",
+ "chapter": "workspace",
+ "task": "Browse a site and its stories",
+ "repository": "telar",
+ "source": "telar/assets/js/telar-story/main.js",
+ "existing_english_reference": "",
+ "status": "missing-reader-guide",
+ "verification": "live-inspected",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "R02",
+ "chapter": "framing",
+ "task": "Scroll, arrow keys, zoom and navigation",
+ "repository": "telar",
+ "source": "telar/assets/js/telar-story/navigation.js",
+ "existing_english_reference": "/docs/developers/story-engine/",
+ "status": "needs-reader-guide",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "R03",
+ "chapter": "panels",
+ "task": "Open panels and glossary definitions",
+ "repository": "telar",
+ "source": "telar/assets/js/telar-story/panels.js",
+ "existing_english_reference": "/docs/site-features/glossary/",
+ "status": "needs-reader-guide",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "R04",
+ "chapter": "objects",
+ "task": "Browse, search and filter the collection",
+ "repository": "telar",
+ "source": "telar/scripts/telar/processors/objects/__init__.py",
+ "existing_english_reference": "/docs/site-features/objects-gallery/",
+ "status": "needs-reader-guide",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "R05",
+ "chapter": "media",
+ "task": "Play video and audio in stories",
+ "repository": "telar",
+ "source": "telar/assets/js/telar-story/media-arrangement.js",
+ "existing_english_reference": "/docs/your-content/video-objects/",
+ "status": "needs-reader-guide",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "R06",
+ "chapter": "publish",
+ "task": "Share and embed in an LMS",
+ "repository": "telar",
+ "source": "telar/assets/js/embed.js",
+ "existing_english_reference": "/docs/site-features/embedding/",
+ "status": "existing-reference",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "R07",
+ "chapter": "recovery",
+ "task": "Private stories and unlocking",
+ "repository": "telar",
+ "source": "telar/assets/js/story-unlock.js",
+ "existing_english_reference": "/docs/site-features/private-stories/",
+ "status": "existing-reference",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "A01",
+ "chapter": "first-site",
+ "task": "Google Sheets setup",
+ "repository": "telar",
+ "source": "telar/scripts/fetch_google_sheets.py",
+ "existing_english_reference": "/docs/getting-started/google-sheets/",
+ "status": "needs-journey-review",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "A02",
+ "chapter": "stories",
+ "task": "CSV object and story authoring",
+ "repository": "telar",
+ "source": "telar/scripts/telar/processors/stories.py",
+ "existing_english_reference": "/docs/your-data/csv-stories/",
+ "status": "existing-reference",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "A03",
+ "chapter": "objects",
+ "task": "Generate IIIF tiles and process PDFs",
+ "repository": "telar",
+ "source": "telar/scripts/generate_iiif.py",
+ "existing_english_reference": "/docs/your-content/self-hosted-images/",
+ "status": "existing-reference",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "A04",
+ "chapter": "recovery",
+ "task": "Build and preview locally",
+ "repository": "telar",
+ "source": "telar/scripts/build_local_site.py",
+ "existing_english_reference": "/docs/developers/local-development/",
+ "status": "existing-reference",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "A05",
+ "chapter": "sync",
+ "task": "Upgrade through scripts and migrations",
+ "repository": "telar",
+ "source": "telar/scripts/telar_upgrade.py",
+ "existing_english_reference": "/docs/setup/upgrading/",
+ "status": "needs-task-first-guide",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "D01",
+ "chapter": "workspace",
+ "task": "Bilingual navigation and search",
+ "repository": "telar-docs",
+ "source": "telar-docs/_layouts/docs.html",
+ "existing_english_reference": "/docs/",
+ "status": "needs-fixes",
+ "verification": "source-and-live",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "D02",
+ "chapter": "first-site",
+ "task": "Setup generator and validator",
+ "repository": "telar-docs",
+ "source": "telar-docs/docs/1-2-google-sheets-option.md",
+ "existing_english_reference": "/docs/getting-started/google-sheets/",
+ "status": "needs-accessibility-fixes",
+ "verification": "source-and-live",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "D03",
+ "chapter": "workspace",
+ "task": "Contextual help inside the editor",
+ "repository": "telar-compositor",
+ "source": "telar-compositor/app/lib/docs-content.ts",
+ "existing_english_reference": "",
+ "status": "needs-content-sync",
+ "verification": "source-checked",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "D04",
+ "chapter": "objects",
+ "task": "Versioned multilingual demo bundles",
+ "repository": "telar-demo-content",
+ "source": "telar-demo-content/generator/build-demos.py",
+ "existing_english_reference": "/docs/customization/demo-content/",
+ "status": "existing-reference",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "D05",
+ "chapter": "publish",
+ "task": "Submit a project to the showcase",
+ "repository": "telar-showcase",
+ "source": "telar-showcase/src/index.ts",
+ "existing_english_reference": "/showcase/submit/",
+ "status": "missing-guide",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ },
+ {
+ "id": "D06",
+ "chapter": "publish",
+ "task": "Public showcase and consent",
+ "repository": "telar-docs",
+ "source": "telar-docs/showcase-submit.md",
+ "existing_english_reference": "/showcase/submit/",
+ "status": "needs-journey-review",
+ "verification": "source-mapped",
+ "recording": "To scope during chapter rehearsal"
+ }
+ ],
+ "chapters": [
+ {
+ "id": "workspace",
+ "es": "Tu espacio de trabajo",
+ "en": "Your workspace",
+ "outcome_es": "Distinguir objetos, historias, pasos, paneles y glosario.",
+ "outcome_en": "Understand objects, stories, steps, panels and glossary."
+ },
+ {
+ "id": "first-site",
+ "es": "Tu primer sitio",
+ "en": "Your first site",
+ "outcome_es": "Crear un sitio o conectar uno existente.",
+ "outcome_en": "Create a site or connect an existing one."
+ },
+ {
+ "id": "objects",
+ "es": "Objetos y colecciones",
+ "en": "Objects and collections",
+ "outcome_es": "Importar, describir y organizar tus materiales.",
+ "outcome_en": "Import, describe and organise your materials."
+ },
+ {
+ "id": "stories",
+ "es": "Historias y pasos",
+ "en": "Stories and steps",
+ "outcome_es": "Construir una secuencia de preguntas, respuestas e invitaciones.",
+ "outcome_en": "Build a sequence of questions, answers and invitations."
+ },
+ {
+ "id": "framing",
+ "es": "Encuadre y posición",
+ "en": "Framing and position",
+ "outcome_es": "Elegir qué verá el público y capturar esa vista.",
+ "outcome_en": "Choose what visitors will see and capture that view."
+ },
+ {
+ "id": "panels",
+ "es": "Textos y paneles",
+ "en": "Text and panels",
+ "outcome_es": "Desarrollar el relato con formato, imágenes y contenido contextual.",
+ "outcome_en": "Develop your narrative with formatting, images and contextual content."
+ },
+ {
+ "id": "media",
+ "es": "Video y audio",
+ "en": "Video and audio",
+ "outcome_es": "Usar clips, reproducción y bucles.",
+ "outcome_en": "Work with clips, playback and loops."
+ },
+ {
+ "id": "glossary",
+ "es": "Glosario",
+ "en": "Glossary",
+ "outcome_es": "Crear definiciones y enlazarlas desde tus textos.",
+ "outcome_en": "Create definitions and link them from your text."
+ },
+ {
+ "id": "pages",
+ "es": "Inicio, páginas y apariencia",
+ "en": "Home, pages and appearance",
+ "outcome_es": "Configurar la portada, la navegación y la presentación.",
+ "outcome_en": "Configure the homepage, navigation and appearance."
+ },
+ {
+ "id": "team",
+ "es": "Trabajar en equipo",
+ "en": "Working together",
+ "outcome_es": "Invitar a otras personas y comprender los roles.",
+ "outcome_en": "Invite other people and understand the roles."
+ },
+ {
+ "id": "courses",
+ "es": "Enseñar con Telar",
+ "en": "Teaching with Telar",
+ "outcome_es": "Organizar cursos, grupos y objetos compartidos.",
+ "outcome_en": "Organise courses, groups and shared objects."
+ },
+ {
+ "id": "publish",
+ "es": "Publicar",
+ "en": "Publishing",
+ "outcome_es": "Revisar cambios, corregir avisos y seguir la construcción.",
+ "outcome_en": "Review changes, address notices and follow the build."
+ },
+ {
+ "id": "sync",
+ "es": "Cambios en GitHub y actualizaciones",
+ "en": "GitHub changes and upgrades",
+ "outcome_es": "Revisar cambios externos y actualizar el sitio.",
+ "outcome_en": "Review external changes and upgrade your site."
+ },
+ {
+ "id": "recovery",
+ "es": "Mantenimiento y recuperación",
+ "en": "Maintenance and recovery",
+ "outcome_es": "Reconocer problemas y recuperar el trabajo.",
+ "outcome_en": "Recognise problems and recover work."
+ }
+ ],
+ "captions": [
+ {
+ "start": 0,
+ "end": 7,
+ "es": "Conecta un objeto IIIF con un paso de tu historia.",
+ "en": "Connect an IIIF object to a step in your story.",
+ "action": "Show the object and the intended story result."
+ },
+ {
+ "start": 7,
+ "end": 15,
+ "es": "En Objetos, pulsa Agregar objeto y elige Manifiesto IIIF.",
+ "en": "In Objects, choose Add object, then IIIF manifest.",
+ "action": "Open the existing dialog. Keep the relevant controls legible."
+ },
+ {
+ "start": 15,
+ "end": 25,
+ "es": "Pega la URL del manifiesto y pulsa Obtener manifiesto.",
+ "en": "Paste the manifest URL and choose Fetch manifest.",
+ "action": "Paste the complete URL. Hold after the click; shorten a long wait with an explicit editorial note."
+ },
+ {
+ "start": 25,
+ "end": 37,
+ "es": "Revisa el título, la fuente y el crédito antes de agregar el objeto.",
+ "en": "Review the title, source and credit before adding the object.",
+ "action": "Show imported metadata. Do not invent missing cataloguing data."
+ },
+ {
+ "start": 37,
+ "end": 46,
+ "es": "Abre tu historia y agrega un paso.",
+ "en": "Open your story and add a step.",
+ "action": "Use the dedicated documentation fixture for the actual recording."
+ },
+ {
+ "start": 46,
+ "end": 57,
+ "es": "Elige el objeto que acabas de agregar.",
+ "en": "Choose the object you have just added.",
+ "action": "Show the object picker and the resulting viewer."
+ },
+ {
+ "start": 57,
+ "end": 68,
+ "es": "Escribe una pregunta y una respuesta breve.",
+ "en": "Write a question and a short answer.",
+ "action": "Use the reviewed example text from the guide."
+ },
+ {
+ "start": 68,
+ "end": 82,
+ "es": "Encuadra el detalle y pulsa Capturar posición.",
+ "en": "Frame the detail and choose Capture position.",
+ "action": "Show the action and its Captured confirmation. Leave time to read the guides."
+ },
+ {
+ "start": 82,
+ "end": 94,
+ "es": "Usa los paneles para desarrollar el contexto.",
+ "en": "Use panels to develop the context.",
+ "action": "Open one panel and show how it relates to the step."
+ },
+ {
+ "start": 94,
+ "end": 106,
+ "es": "Revisa tus cambios en Publicar antes de llevarlos al sitio.",
+ "en": "Review your changes in Publish before sending them to your site.",
+ "action": "Show the review. Publishing rehearsal on a dedicated fixture remains to do."
+ },
+ {
+ "start": 106,
+ "end": 116,
+ "es": "Comprueba el objeto, el encuadre y el panel en el sitio publicado.",
+ "en": "Check the object, framing and panel on the published site.",
+ "action": "Finish on the reader result. The pilot film is not recorded before copy review."
+ }
+ ],
+ "ui_strings": [
+ {
+ "language": "en",
+ "namespace": "objects",
+ "key": "title",
+ "text": "Objects"
+ },
+ {
+ "language": "en",
+ "namespace": "objects",
+ "key": "add_object_button",
+ "text": "+ Add object"
+ },
+ {
+ "language": "en",
+ "namespace": "objects",
+ "key": "tab_iiif",
+ "text": "IIIF manifest"
+ },
+ {
+ "language": "en",
+ "namespace": "objects",
+ "key": "add_iiif_url_label",
+ "text": "IIIF manifest URL"
+ },
+ {
+ "language": "en",
+ "namespace": "objects",
+ "key": "add_iiif_fetch",
+ "text": "Fetch manifest"
+ },
+ {
+ "language": "en",
+ "namespace": "objects",
+ "key": "add_iiif_confirm",
+ "text": "Add object"
+ },
+ {
+ "language": "en",
+ "namespace": "objects",
+ "key": "field_title",
+ "text": "Title"
+ },
+ {
+ "language": "en",
+ "namespace": "objects",
+ "key": "field_creator",
+ "text": "Creator"
+ },
+ {
+ "language": "en",
+ "namespace": "objects",
+ "key": "field_source",
+ "text": "Source"
+ },
+ {
+ "language": "en",
+ "namespace": "objects",
+ "key": "field_credit",
+ "text": "Credit"
+ },
+ {
+ "language": "en",
+ "namespace": "objects",
+ "key": "field_alt_text",
+ "text": "Description for accessibility"
+ },
+ {
+ "language": "en",
+ "namespace": "editor",
+ "key": "viewer.capture_position",
+ "text": "Capture position"
+ },
+ {
+ "language": "en",
+ "namespace": "editor",
+ "key": "viewer.captured",
+ "text": "Captured"
+ },
+ {
+ "language": "en",
+ "namespace": "editor",
+ "key": "viewer.change_object",
+ "text": "Change object"
+ },
+ {
+ "language": "en",
+ "namespace": "editor",
+ "key": "step.add_step",
+ "text": "+ Add step"
+ },
+ {
+ "language": "en",
+ "namespace": "stories",
+ "key": "title",
+ "text": "Stories"
+ },
+ {
+ "language": "en",
+ "namespace": "stories",
+ "key": "new_story_button",
+ "text": "+ New Story"
+ },
+ {
+ "language": "en",
+ "namespace": "stories",
+ "key": "save",
+ "text": "Save"
+ },
+ {
+ "language": "es",
+ "namespace": "objects",
+ "key": "title",
+ "text": "Objetos"
+ },
+ {
+ "language": "es",
+ "namespace": "objects",
+ "key": "add_object_button",
+ "text": "+ Agregar objeto"
+ },
+ {
+ "language": "es",
+ "namespace": "objects",
+ "key": "tab_iiif",
+ "text": "Manifiesto IIIF"
+ },
+ {
+ "language": "es",
+ "namespace": "objects",
+ "key": "add_iiif_url_label",
+ "text": "URL del manifiesto IIIF"
+ },
+ {
+ "language": "es",
+ "namespace": "objects",
+ "key": "add_iiif_fetch",
+ "text": "Obtener manifiesto"
+ },
+ {
+ "language": "es",
+ "namespace": "objects",
+ "key": "add_iiif_confirm",
+ "text": "Agregar objeto"
+ },
+ {
+ "language": "es",
+ "namespace": "objects",
+ "key": "field_title",
+ "text": "Título"
+ },
+ {
+ "language": "es",
+ "namespace": "objects",
+ "key": "field_creator",
+ "text": "Creador"
+ },
+ {
+ "language": "es",
+ "namespace": "objects",
+ "key": "field_source",
+ "text": "Fuente"
+ },
+ {
+ "language": "es",
+ "namespace": "objects",
+ "key": "field_credit",
+ "text": "Crédito"
+ },
+ {
+ "language": "es",
+ "namespace": "objects",
+ "key": "field_alt_text",
+ "text": "Descripción para accesibilidad"
+ },
+ {
+ "language": "es",
+ "namespace": "editor",
+ "key": "viewer.capture_position",
+ "text": "Capturar posición"
+ },
+ {
+ "language": "es",
+ "namespace": "editor",
+ "key": "viewer.captured",
+ "text": "Capturada"
+ },
+ {
+ "language": "es",
+ "namespace": "editor",
+ "key": "viewer.change_object",
+ "text": "Cambiar objeto"
+ },
+ {
+ "language": "es",
+ "namespace": "editor",
+ "key": "step.add_step",
+ "text": "+ Agregar paso"
+ },
+ {
+ "language": "es",
+ "namespace": "stories",
+ "key": "title",
+ "text": "Historias"
+ },
+ {
+ "language": "es",
+ "namespace": "stories",
+ "key": "new_story_button",
+ "text": "+ Nueva historia"
+ },
+ {
+ "language": "es",
+ "namespace": "stories",
+ "key": "save",
+ "text": "Guardar"
+ },
+ {
+ "language": "en",
+ "namespace": "editor",
+ "key": "layer.add_panel",
+ "text": "+ Add panel"
+ },
+ {
+ "language": "en",
+ "namespace": "editor",
+ "key": "stage.edit_panel_title",
+ "text": "Edit panel title"
+ },
+ {
+ "language": "en",
+ "namespace": "editor",
+ "key": "stage.edit_panel_text",
+ "text": "Edit panel text"
+ },
+ {
+ "language": "es",
+ "namespace": "editor",
+ "key": "layer.add_panel",
+ "text": "+ Agregar panel"
+ },
+ {
+ "language": "es",
+ "namespace": "editor",
+ "key": "stage.edit_panel_title",
+ "text": "Editar título del panel"
+ },
+ {
+ "language": "es",
+ "namespace": "editor",
+ "key": "stage.edit_panel_text",
+ "text": "Editar texto del panel"
+ },
+ {
+ "language": "en",
+ "namespace": "objects",
+ "key": "field_year",
+ "text": "Year"
+ },
+ {
+ "language": "en",
+ "namespace": "objects",
+ "key": "field_description",
+ "text": "Description"
+ },
+ {
+ "language": "en",
+ "namespace": "editor",
+ "key": "step.new_step_dialog.choose",
+ "text": "Choose another object"
+ },
+ {
+ "language": "en",
+ "namespace": "publish",
+ "key": "title",
+ "text": "Publish"
+ },
+ {
+ "language": "es",
+ "namespace": "objects",
+ "key": "field_year",
+ "text": "Año"
+ },
+ {
+ "language": "es",
+ "namespace": "objects",
+ "key": "field_description",
+ "text": "Descripción"
+ },
+ {
+ "language": "es",
+ "namespace": "editor",
+ "key": "step.new_step_dialog.choose",
+ "text": "Elegir otro objeto"
+ },
+ {
+ "language": "es",
+ "namespace": "publish",
+ "key": "title",
+ "text": "Publicar"
+ }
+ ],
+ "manifest": "https://juancobo.com/138la/iiif/khipu/p7/manifest.json",
+ "pilot_status": "Draft for copy review. Import preview checked in both languages. Existing khipu selected in an authorised unpublished draft step; framing captured and illustrated in both languages. Object creation, panel authoring and publishing remain to rehearse."
+}
diff --git a/data/docs_anchor_aliases.json b/data/docs_anchor_aliases.json
new file mode 100644
index 0000000..06692f1
--- /dev/null
+++ b/data/docs_anchor_aliases.json
@@ -0,0 +1,40 @@
+{
+ "/docs/": {
+ "top": [
+ "documentation"
+ ],
+ "planning": [
+ "getting-started"
+ ],
+ "build": [
+ "set-up-your-site"
+ ],
+ "reference": [
+ "configure-your-site",
+ "customization",
+ "for-developers",
+ "site-features",
+ "your-content",
+ "your-data"
+ ]
+ },
+ "/guia/": {
+ "top": [
+ "documentación"
+ ],
+ "planning": [
+ "primeros-pasos"
+ ],
+ "build": [
+ "configura-tu-sitio"
+ ],
+ "reference": [
+ "configura-tu-proyecto",
+ "funciones-del-sitio",
+ "para-desarrolladores",
+ "personalización",
+ "tu-contenido",
+ "tus-datos"
+ ]
+ }
+}
diff --git a/data/docs_media.json b/data/docs_media.json
new file mode 100644
index 0000000..0344300
--- /dev/null
+++ b/data/docs_media.json
@@ -0,0 +1,368 @@
+{
+ "labels": {
+ "en": {
+ "play": "Play steps",
+ "stop": "Stop animation",
+ "open": "Open full-size screenshot",
+ "gif": "Download GIF"
+ },
+ "es": {
+ "play": "Ver los pasos",
+ "stop": "Detener animación",
+ "open": "Ampliar captura",
+ "gif": "Descargar GIF"
+ }
+ },
+ "items": {
+ "public-object": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-public-object.jpg",
+ "width": 1280,
+ "height": 720,
+ "alt": "The khipu object page generated locally by Telar.",
+ "caption": "The local build produces a zoomable object page with its catalogue information and manifest link.",
+ "overview": false
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-public-object.jpg",
+ "width": 1280,
+ "height": 720,
+ "alt": "La página del khipu generada localmente por Telar.",
+ "caption": "El build local genera una página ampliable con la información de catálogo y el enlace al manifiesto.",
+ "overview": false
+ }
+ },
+ "create-site": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-create-site.jpg",
+ "width": 640,
+ "height": 550,
+ "alt": "The new-site form with repository name, visible title, language and theme.",
+ "caption": "Choose the repository name, title, language and theme before creating the site.",
+ "overview": false
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-create-site.jpg",
+ "width": 640,
+ "height": 550,
+ "alt": "El formulario del sitio con nombre de repositorio, título visible, idioma y tema.",
+ "caption": "Elige el nombre del repositorio, el título, el idioma y el tema antes de crear el sitio.",
+ "overview": false
+ }
+ },
+ "objects": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-objects.jpg",
+ "width": 1280,
+ "height": 664,
+ "alt": "The Objects list with thumbnails, IDs, usage counts, status and the Add object control.",
+ "caption": "Each row connects an object to its thumbnail, ID, usage and status. Filter the list or open an object to inspect it.",
+ "overview": false
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-objects.jpg",
+ "width": 1280,
+ "height": 664,
+ "alt": "La lista de Objetos con miniaturas, IDs, usos, estado y el control Agregar objeto.",
+ "caption": "Cada fila relaciona un objeto con su miniatura, ID, usos y estado. Filtra la lista o abre el objeto para revisarlo.",
+ "overview": false
+ }
+ },
+ "object-metadata": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-object-metadata.jpg",
+ "width": 1280,
+ "height": 664,
+ "alt": "The khipu image beside its title, description and catalogue fields.",
+ "caption": "The image and metadata describe the same khipu. Continue down the form for source, credit and accessibility text.",
+ "overview": false
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-object-metadata.jpg",
+ "width": 1280,
+ "height": 664,
+ "alt": "La imagen del khipu junto al título, la descripción y los campos de catálogo.",
+ "caption": "La imagen y los metadatos describen el mismo khipu. Más abajo están la fuente, el crédito y el texto de accesibilidad.",
+ "overview": false
+ }
+ },
+ "editor-overview": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-editor-overview.jpg",
+ "width": 1280,
+ "height": 622,
+ "alt": "The story outline, step card and khipu viewer in the Compositor.",
+ "caption": "The outline is on the left, the step text in the centre and the object on the right. Capture position records the view for the selected step.",
+ "overview": false
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-editor-overview.jpg",
+ "width": 1280,
+ "height": 580,
+ "alt": "El esquema de la historia, la tarjeta del paso y el visor del khipu en el Compositor.",
+ "caption": "A la izquierda está el esquema; en el centro, el texto del paso; a la derecha, el objeto. Capturar posición guarda la vista del paso seleccionado.",
+ "overview": false
+ }
+ },
+ "glossary": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-glossary.jpg",
+ "width": 1232,
+ "height": 540,
+ "alt": "A glossary term with its title, kind, ID, usage list, definition editor and reader preview.",
+ "caption": "The ID connects links to this entry. Edit the definition in the middle and check the reader preview on the right.",
+ "overview": false
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-glossary.jpg",
+ "width": 1232,
+ "height": 540,
+ "alt": "Un término del glosario con título, tipo, ID, usos, editor de definición y vista previa.",
+ "caption": "El ID relaciona los enlaces con esta entrada. Edita la definición en el centro y revisa la vista del lector a la derecha.",
+ "overview": false
+ }
+ },
+ "pages": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-pages.jpg",
+ "width": 1280,
+ "height": 664,
+ "alt": "A supporting page with its title, address and content below the navigation preview.",
+ "caption": "A supporting page has its own title, address and content. The menu preview above shows how readers will find it.",
+ "overview": false
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-pages.jpg",
+ "width": 1280,
+ "height": 664,
+ "alt": "Una página de apoyo con título, dirección y contenido bajo la vista previa del menú.",
+ "caption": "Cada página de apoyo tiene título, dirección y contenido propios. La vista previa superior muestra cómo la encontrará el público.",
+ "overview": false
+ }
+ },
+ "homepage": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-homepage.jpg",
+ "width": 1232,
+ "height": 585,
+ "alt": "The pinned Home entry selected beside the homepage title and description fields.",
+ "caption": "Choose the pinned Home entry to edit the introduction. Its editing position is separate from the order of the published menu.",
+ "overview": false
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-homepage.jpg",
+ "width": 1232,
+ "height": 585,
+ "alt": "La entrada Inicio seleccionada junto a los campos de título y descripción.",
+ "caption": "Selecciona Inicio en la barra lateral para editar la presentación. Su posición en el editor es independiente del orden del menú público.",
+ "overview": false
+ }
+ },
+ "theme-language": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-theme-language.jpg",
+ "width": 800,
+ "height": 580,
+ "alt": "Site theme swatches, logo field, exhibition language and hosting settings.",
+ "caption": "These settings affect the exhibition. The language here controls the site's interface; it does not translate your written content.",
+ "overview": false
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-theme-language.jpg",
+ "width": 800,
+ "height": 580,
+ "alt": "Los temas, el campo del logo, el idioma de la exhibición y los ajustes de alojamiento.",
+ "caption": "Estos ajustes afectan la exhibición. El idioma de esta página controla la interfaz del sitio; no traduce el contenido que escribiste.",
+ "overview": false
+ }
+ },
+ "preferences": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-preferences.jpg",
+ "width": 720,
+ "height": 268,
+ "alt": "Account Preferences with the English and Spanish interface-language options.",
+ "caption": "Account → Preferences changes the Compositor's interface language. The exhibition's language is a separate site setting.",
+ "overview": false
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-preferences.jpg",
+ "width": 720,
+ "height": 268,
+ "alt": "Preferencias de la cuenta con las opciones de idioma de interfaz EN y ES.",
+ "caption": "Cuenta → Preferencias cambia el idioma de la interfaz del Compositor. El idioma de la exhibición es un ajuste separado del sitio.",
+ "overview": false
+ }
+ },
+ "stories": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-stories.jpg",
+ "width": 1232,
+ "height": 555,
+ "alt": "The story list with order handles, Draft and Private switches and Edit links.",
+ "caption": "Draft excludes a story from publication; Private uses the site's key. Dragging a row changes the story order.",
+ "overview": false
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-stories.jpg",
+ "width": 1232,
+ "height": 555,
+ "alt": "La lista de historias con controles de orden, Borrador, Privada y Editar.",
+ "caption": "Borrador excluye una historia de la publicación; Privada utiliza la clave del sitio. Arrastrar una fila cambia el orden.",
+ "overview": false
+ }
+ },
+ "panel-editor": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-panel-editor.jpg",
+ "width": 640,
+ "height": 480,
+ "alt": "A contextual panel with its text editor and formatting toolbar open.",
+ "caption": "Click the panel text to enter editing mode. The toolbar offers formatting, links, images and other content controls.",
+ "overview": false
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-panel-editor.jpg",
+ "width": 640,
+ "height": 480,
+ "alt": "Un panel contextual con el editor de texto y su barra de formato abiertos.",
+ "caption": "Haz clic en el texto del panel para editarlo. La barra ofrece formato, enlaces, imágenes y otros controles de contenido.",
+ "overview": false
+ }
+ },
+ "upgrade": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-upgrade.jpg",
+ "width": 800,
+ "height": 460,
+ "alt": "An example upgrade notice comparing Telar 1.8.2 with 1.8.3.",
+ "caption": "An example version notice before publication. Compare the versions and review the proposed file changes; the versions shown will vary.",
+ "overview": false
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-upgrade.jpg",
+ "width": 800,
+ "height": 460,
+ "alt": "Un aviso de actualización que compara, como ejemplo, Telar 1.8.2 y 1.8.3.",
+ "caption": "Un ejemplo del aviso previo a publicar. Compara las versiones y revisa los archivos propuestos; los números cambian según tu sitio.",
+ "overview": false
+ }
+ },
+ "external-media": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-external-media.jpg",
+ "width": 512,
+ "height": 614,
+ "alt": "The External media form recognising a Vimeo address and showing a title and object ID.",
+ "caption": "External media recognises the host from its address. Add a useful title and check the object ID before adding it.",
+ "overview": false
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-external-media.jpg",
+ "width": 512,
+ "height": 614,
+ "alt": "El formulario Medio externo reconoce una dirección de Vimeo y muestra título e ID.",
+ "caption": "Medio externo reconoce el proveedor por la dirección. Agrega un título útil y revisa el ID antes de incorporarlo.",
+ "overview": false
+ }
+ },
+ "public-home": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-public-home.jpg",
+ "width": 1280,
+ "height": 1862,
+ "alt": "The full exhibition homepage with introduction, story cards, featured objects and navigation.",
+ "caption": "A complete homepage connects the introduction, story choices and object collection. Open the full-size image to examine the layout.",
+ "overview": true
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-public-home.jpg",
+ "width": 1280,
+ "height": 1830,
+ "alt": "La página de inicio completa con presentación, tarjetas de historias, objetos y navegación.",
+ "caption": "El inicio conecta la presentación, las historias y la colección de objetos. Abre la captura completa para examinar la organización.",
+ "overview": true
+ }
+ },
+ "import": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-import-poster.jpg",
+ "animation": "/assets/manual/tutorials/en-import.gif",
+ "width": 512,
+ "height": 640,
+ "alt": "The IIIF dialog moves from an empty URL to the pasted manifest and the fetched khipu preview.",
+ "caption": "Paste the manifest, fetch it, then check the returned khipu and metadata. Adding the object is a separate action.",
+ "bytes": 127917
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-import-poster.jpg",
+ "animation": "/assets/manual/tutorials/es-import.gif",
+ "width": 512,
+ "height": 640,
+ "alt": "La ventana IIIF pasa de la URL vacía al manifiesto escrito y a la vista previa del khipu.",
+ "caption": "Pega el manifiesto, obtén los datos y revisa el khipu y sus metadatos. Agregar el objeto es una acción posterior.",
+ "bytes": 134700
+ }
+ },
+ "framing": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-framing-poster.jpg",
+ "animation": "/assets/manual/tutorials/en-framing.gif",
+ "width": 612,
+ "height": 576,
+ "alt": "The khipu view changes, then Capture position confirms that it has been captured.",
+ "caption": "Adjust the view, choose Capture position and look for Captured. The same khipu is shown throughout.",
+ "bytes": 621200
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-framing-poster.jpg",
+ "animation": "/assets/manual/tutorials/es-framing.gif",
+ "width": 612,
+ "height": 534,
+ "alt": "Cambia el encuadre del khipu y Capturar posición confirma que quedó guardado.",
+ "caption": "Ajusta la vista, pulsa Capturar posición y comprueba Capturada. Todo el recorrido muestra el mismo khipu.",
+ "bytes": 596146
+ }
+ },
+ "panels": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-panels-poster.jpg",
+ "animation": "/assets/manual/tutorials/en-panels.gif",
+ "width": 900,
+ "height": 496,
+ "alt": "A story step opens its contextual panel alongside the main card.",
+ "caption": "Open the step's panel to develop its context. This example uses the existing map-and-painting story.",
+ "bytes": 470738
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-panels-poster.jpg",
+ "animation": "/assets/manual/tutorials/es-panels.gif",
+ "width": 900,
+ "height": 496,
+ "alt": "Un paso abre su panel contextual junto a la tarjeta principal.",
+ "caption": "Abre el panel del paso para desarrollar el contexto. Este ejemplo usa la historia existente sobre el mapa y la pintura.",
+ "bytes": 465607
+ }
+ },
+ "coordinates": {
+ "en": {
+ "image": "/assets/manual/tutorials/en-coordinates-poster.jpg",
+ "animation": "/assets/manual/tutorials/en-coordinates.gif",
+ "width": 736,
+ "height": 600,
+ "alt": "The khipu is framed on its object page, then the coordinate panel copies X, Y and Zoom for Sheets.",
+ "caption": "Frame the khipu, scroll to the coordinate panel and copy the values for Sheets or CSV. This is a local example built with Telar.",
+ "bytes": 469459
+ },
+ "es": {
+ "image": "/assets/manual/tutorials/es-coordinates-poster.jpg",
+ "animation": "/assets/manual/tutorials/es-coordinates.gif",
+ "width": 736,
+ "height": 600,
+ "alt": "Se encuadra el khipu en su página y después se copian X, Y y Zoom desde el panel de coordenadas.",
+ "caption": "Encuadra el khipu, baja al panel y copia los valores para Sheets o CSV. Es un ejemplo local construido con Telar.",
+ "bytes": 466531
+ }
+ }
+ }
+}
diff --git a/data/docs_navigation.json b/data/docs_navigation.json
new file mode 100644
index 0000000..7db2b92
--- /dev/null
+++ b/data/docs_navigation.json
@@ -0,0 +1,3204 @@
+{
+ "routes": {
+ "en": {
+ "home": "/docs/",
+ "quick": "/start/",
+ "planning": "/docs/plan/",
+ "compositor": "/docs/the-compositor/",
+ "sheets": "/docs/google-sheets/",
+ "local": "/docs/local-authoring/",
+ "reference": "/docs/reference/",
+ "teaching": "/docs/teaching/",
+ "developers": "/docs/developers/",
+ "iiif": "/docs/the-compositor/iiif-to-story/"
+ },
+ "es": {
+ "home": "/guia/",
+ "quick": "/empezar/",
+ "planning": "/guia/planear/",
+ "compositor": "/guia/el-compositor/",
+ "sheets": "/guia/google-sheets/",
+ "local": "/guia/autoria-local/",
+ "reference": "/guia/referencia/",
+ "teaching": "/guia/ensenar/",
+ "developers": "/guia/desarrolladores/",
+ "iiif": "/guia/el-compositor/iiif-a-historia/"
+ }
+ },
+ "labels": {
+ "en": {
+ "browse": "Browse guides",
+ "contents": "In this guide",
+ "all_guides": "All guides",
+ "search": "Search the guides",
+ "close_search": "Close search",
+ "search_hint": "Search by task, feature or question.",
+ "search_unavailable": "Search is unavailable.",
+ "previous": "Previous",
+ "next": "Next",
+ "on_page": "On this page",
+ "copy_code": "Copy code",
+ "copied": "Copied",
+ "copy_link": "Copy link to this section",
+ "link_copied": "Section link copied",
+ "copy_failed": "Copy was unavailable. Select the text and copy it.",
+ "table": "Scrollable table",
+ "preview": "Documentation preview",
+ "reference": "Shared reference",
+ "help": "Help improve the guides",
+ "section": "Guide section",
+ "index": "Overview",
+ "code": "Code example",
+ "open_menu": "Guide contents",
+ "footer": "Telar is developed by Neogranadina, the UCSB Archives, Memory, and Preservation Lab, the UT Archives, Mapping, and Pedagogy Lab, and collaborators."
+ },
+ "es": {
+ "browse": "Explora las guías",
+ "contents": "En esta guía",
+ "all_guides": "Todas las guías",
+ "search": "Busca en las guías",
+ "close_search": "Cerrar búsqueda",
+ "search_hint": "Busca por tarea, función o pregunta.",
+ "search_unavailable": "La búsqueda no está disponible.",
+ "previous": "Anterior",
+ "next": "Siguiente",
+ "on_page": "En esta página",
+ "copy_code": "Copiar código",
+ "copied": "Copiado",
+ "copy_link": "Copiar enlace a esta sección",
+ "link_copied": "Enlace de la sección copiado",
+ "copy_failed": "No se pudo copiar. Selecciona el texto y cópialo.",
+ "table": "Tabla desplazable",
+ "preview": "Vista previa de la documentación",
+ "reference": "Referencia compartida",
+ "help": "Ayuda a mejorar las guías",
+ "section": "Sección de la guía",
+ "index": "Presentación",
+ "code": "Ejemplo de código",
+ "open_menu": "Contenido de la guía",
+ "footer": "Telar lo desarrollan Neogranadina, el UCSB Archives, Memory, and Preservation Lab, el UT Archives, Mapping, and Pedagogy Lab y quienes colaboran con el proyecto."
+ }
+ },
+ "order": [
+ "quick",
+ "planning",
+ "compositor",
+ "sheets",
+ "local",
+ "reference",
+ "teaching",
+ "developers"
+ ],
+ "sections": {
+ "en": {
+ "quick": {
+ "id": "quick",
+ "title": "Workshop quick guide",
+ "url": "/start/",
+ "items": [
+ {
+ "url": "/start/",
+ "title": "Workshop quick guide",
+ "section": "quick",
+ "group": "main",
+ "other_url": "/empezar/",
+ "path": "start.html"
+ }
+ ],
+ "groups": [
+ {
+ "id": "main",
+ "title": "Guide contents",
+ "items": [
+ {
+ "url": "/start/",
+ "title": "Workshop quick guide",
+ "section": "quick",
+ "group": "main",
+ "other_url": "/empezar/",
+ "path": "start.html"
+ }
+ ]
+ }
+ ]
+ },
+ "planning": {
+ "id": "planning",
+ "title": "Plan an exhibition",
+ "url": "/docs/plan/",
+ "items": [
+ {
+ "url": "/docs/plan/",
+ "title": "Plan an exhibition",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/guia/planear/",
+ "path": "guides/planning.en.html"
+ },
+ {
+ "url": "/docs/getting-started/narrative-structure/",
+ "title": "Sketch the narrative arc",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/guia/primeros-pasos/estructura-narrativa/",
+ "path": "docs/1-4-narrative-structure.md"
+ },
+ {
+ "url": "/docs/plan/sources-and-framing/",
+ "title": "Choose sources and framing",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/guia/planear/fuentes-y-encuadres/",
+ "path": "guides/planning-sources.en.md"
+ },
+ {
+ "url": "/docs/plan/layers-and-glossary/",
+ "title": "Plan panels and glossary links",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/guia/planear/capas-y-glosario/",
+ "path": "guides/planning-layers.en.md"
+ },
+ {
+ "url": "/docs/plan/exhibition-layout/",
+ "title": "Arrange the whole exhibition",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/guia/planear/organizar-la-exhibicion/",
+ "path": "guides/planning-layout.en.md"
+ },
+ {
+ "url": "/docs/plan/review/",
+ "title": "Test the exhibition with readers",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/guia/planear/revision/",
+ "path": "guides/planning-review.en.md"
+ }
+ ],
+ "groups": [
+ {
+ "id": "main",
+ "title": "Contents",
+ "items": [
+ {
+ "url": "/docs/plan/",
+ "title": "Plan an exhibition",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/guia/planear/",
+ "path": "guides/planning.en.html"
+ },
+ {
+ "url": "/docs/getting-started/narrative-structure/",
+ "title": "Sketch the narrative arc",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/guia/primeros-pasos/estructura-narrativa/",
+ "path": "docs/1-4-narrative-structure.md"
+ },
+ {
+ "url": "/docs/plan/sources-and-framing/",
+ "title": "Choose sources and framing",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/guia/planear/fuentes-y-encuadres/",
+ "path": "guides/planning-sources.en.md"
+ },
+ {
+ "url": "/docs/plan/layers-and-glossary/",
+ "title": "Plan panels and glossary links",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/guia/planear/capas-y-glosario/",
+ "path": "guides/planning-layers.en.md"
+ },
+ {
+ "url": "/docs/plan/exhibition-layout/",
+ "title": "Arrange the whole exhibition",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/guia/planear/organizar-la-exhibicion/",
+ "path": "guides/planning-layout.en.md"
+ },
+ {
+ "url": "/docs/plan/review/",
+ "title": "Test the exhibition with readers",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/guia/planear/revision/",
+ "path": "guides/planning-review.en.md"
+ }
+ ]
+ }
+ ]
+ },
+ "compositor": {
+ "id": "compositor",
+ "title": "Compositor manual",
+ "url": "/docs/the-compositor/",
+ "items": [
+ {
+ "url": "/docs/the-compositor/",
+ "title": "Compositor manual",
+ "section": "compositor",
+ "group": "main",
+ "other_url": "/guia/el-compositor/",
+ "path": "docs/9-0-compositor.md",
+ "order": 9
+ },
+ {
+ "url": "/docs/getting-started/compositor/",
+ "title": "Use the Compositor",
+ "section": "compositor",
+ "group": "begin",
+ "other_url": "/guia/primeros-pasos/compositor/",
+ "path": "docs/1-1-compositor.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/the-compositor/getting-started/",
+ "title": "Connect an existing site",
+ "section": "compositor",
+ "group": "begin",
+ "other_url": "/guia/el-compositor/primeros-pasos/",
+ "path": "docs/9-1-getting-started.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/the-compositor/dashboard/",
+ "title": "Start and navigation",
+ "section": "compositor",
+ "group": "begin",
+ "other_url": "/guia/el-compositor/panel-de-control/",
+ "path": "docs/9-2-dashboard.md",
+ "order": 2
+ },
+ {
+ "url": "/docs/the-compositor/objects/",
+ "title": "Objects",
+ "section": "compositor",
+ "group": "compose",
+ "other_url": "/guia/el-compositor/objetos/",
+ "path": "docs/9-3-objects.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/the-compositor/iiif-to-story/",
+ "title": "Use an IIIF object in a story",
+ "section": "compositor",
+ "group": "compose",
+ "other_url": "/guia/el-compositor/iiif-a-historia/",
+ "path": "guides/iiif.en.md"
+ },
+ {
+ "url": "/docs/the-compositor/story-editor/",
+ "title": "Story Editor",
+ "section": "compositor",
+ "group": "compose",
+ "other_url": "/guia/el-compositor/editor-historias/",
+ "path": "docs/9-4-story-editor.md",
+ "order": 4
+ },
+ {
+ "url": "/docs/the-compositor/video-audio/",
+ "title": "Video and Audio",
+ "section": "compositor",
+ "group": "compose",
+ "other_url": "/guia/el-compositor/video-y-audio/",
+ "path": "docs/9-5-video-audio.md",
+ "order": 5
+ },
+ {
+ "url": "/docs/the-compositor/glossary/",
+ "title": "Create and link glossary entries",
+ "section": "compositor",
+ "group": "exhibition",
+ "other_url": "/guia/el-compositor/glosario/",
+ "path": "guides/compositor-glossary.en.md"
+ },
+ {
+ "url": "/docs/the-compositor/pages/",
+ "title": "Arrange the homepage and pages",
+ "section": "compositor",
+ "group": "exhibition",
+ "other_url": "/guia/el-compositor/paginas/",
+ "path": "guides/compositor-pages.en.md"
+ },
+ {
+ "url": "/docs/the-compositor/settings/",
+ "title": "Adjust appearance and site settings",
+ "section": "compositor",
+ "group": "exhibition",
+ "other_url": "/guia/el-compositor/configuracion/",
+ "path": "guides/compositor-settings.en.md"
+ },
+ {
+ "url": "/docs/the-compositor/team/",
+ "title": "Work with a team",
+ "section": "compositor",
+ "group": "team",
+ "other_url": "/guia/el-compositor/equipo/",
+ "path": "guides/compositor-team.en.md"
+ },
+ {
+ "url": "/docs/the-compositor/courses/",
+ "title": "Run a course with student sites",
+ "section": "compositor",
+ "group": "team",
+ "other_url": "/guia/el-compositor/cursos/",
+ "path": "guides/compositor-courses.en.md"
+ },
+ {
+ "url": "/docs/the-compositor/publishing/",
+ "title": "Publishing",
+ "section": "compositor",
+ "group": "publish",
+ "other_url": "/guia/el-compositor/publicacion/",
+ "path": "docs/9-6-publishing.md",
+ "order": 6
+ },
+ {
+ "url": "/docs/the-compositor/sync-updates/",
+ "title": "Sync and Updates",
+ "section": "compositor",
+ "group": "publish",
+ "other_url": "/guia/el-compositor/sincronizacion-y-actualizaciones/",
+ "path": "docs/9-7-sync-updates.md",
+ "order": 7
+ },
+ {
+ "url": "/docs/the-compositor/troubleshooting/",
+ "title": "Resolve problems and recover stories",
+ "section": "compositor",
+ "group": "publish",
+ "other_url": "/guia/el-compositor/solucionar-problemas/",
+ "path": "guides/compositor-recovery.en.md"
+ }
+ ],
+ "groups": [
+ {
+ "id": "main",
+ "title": "Overview",
+ "items": [
+ {
+ "url": "/docs/the-compositor/",
+ "title": "Compositor manual",
+ "section": "compositor",
+ "group": "main",
+ "other_url": "/guia/el-compositor/",
+ "path": "docs/9-0-compositor.md",
+ "order": 9
+ }
+ ]
+ },
+ {
+ "id": "begin",
+ "title": "Get started",
+ "items": [
+ {
+ "url": "/docs/getting-started/compositor/",
+ "title": "Use the Compositor",
+ "section": "compositor",
+ "group": "begin",
+ "other_url": "/guia/primeros-pasos/compositor/",
+ "path": "docs/1-1-compositor.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/the-compositor/getting-started/",
+ "title": "Connect an existing site",
+ "section": "compositor",
+ "group": "begin",
+ "other_url": "/guia/el-compositor/primeros-pasos/",
+ "path": "docs/9-1-getting-started.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/the-compositor/dashboard/",
+ "title": "Start and navigation",
+ "section": "compositor",
+ "group": "begin",
+ "other_url": "/guia/el-compositor/panel-de-control/",
+ "path": "docs/9-2-dashboard.md",
+ "order": 2
+ }
+ ]
+ },
+ {
+ "id": "compose",
+ "title": "Sources and stories",
+ "items": [
+ {
+ "url": "/docs/the-compositor/objects/",
+ "title": "Objects",
+ "section": "compositor",
+ "group": "compose",
+ "other_url": "/guia/el-compositor/objetos/",
+ "path": "docs/9-3-objects.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/the-compositor/iiif-to-story/",
+ "title": "Use an IIIF object in a story",
+ "section": "compositor",
+ "group": "compose",
+ "other_url": "/guia/el-compositor/iiif-a-historia/",
+ "path": "guides/iiif.en.md"
+ },
+ {
+ "url": "/docs/the-compositor/story-editor/",
+ "title": "Story Editor",
+ "section": "compositor",
+ "group": "compose",
+ "other_url": "/guia/el-compositor/editor-historias/",
+ "path": "docs/9-4-story-editor.md",
+ "order": 4
+ },
+ {
+ "url": "/docs/the-compositor/video-audio/",
+ "title": "Video and Audio",
+ "section": "compositor",
+ "group": "compose",
+ "other_url": "/guia/el-compositor/video-y-audio/",
+ "path": "docs/9-5-video-audio.md",
+ "order": 5
+ }
+ ]
+ },
+ {
+ "id": "exhibition",
+ "title": "The exhibition",
+ "items": [
+ {
+ "url": "/docs/the-compositor/glossary/",
+ "title": "Create and link glossary entries",
+ "section": "compositor",
+ "group": "exhibition",
+ "other_url": "/guia/el-compositor/glosario/",
+ "path": "guides/compositor-glossary.en.md"
+ },
+ {
+ "url": "/docs/the-compositor/pages/",
+ "title": "Arrange the homepage and pages",
+ "section": "compositor",
+ "group": "exhibition",
+ "other_url": "/guia/el-compositor/paginas/",
+ "path": "guides/compositor-pages.en.md"
+ },
+ {
+ "url": "/docs/the-compositor/settings/",
+ "title": "Adjust appearance and site settings",
+ "section": "compositor",
+ "group": "exhibition",
+ "other_url": "/guia/el-compositor/configuracion/",
+ "path": "guides/compositor-settings.en.md"
+ }
+ ]
+ },
+ {
+ "id": "team",
+ "title": "Team and courses",
+ "items": [
+ {
+ "url": "/docs/the-compositor/team/",
+ "title": "Work with a team",
+ "section": "compositor",
+ "group": "team",
+ "other_url": "/guia/el-compositor/equipo/",
+ "path": "guides/compositor-team.en.md"
+ },
+ {
+ "url": "/docs/the-compositor/courses/",
+ "title": "Run a course with student sites",
+ "section": "compositor",
+ "group": "team",
+ "other_url": "/guia/el-compositor/cursos/",
+ "path": "guides/compositor-courses.en.md"
+ }
+ ]
+ },
+ {
+ "id": "publish",
+ "title": "Publish and maintain",
+ "items": [
+ {
+ "url": "/docs/the-compositor/publishing/",
+ "title": "Publishing",
+ "section": "compositor",
+ "group": "publish",
+ "other_url": "/guia/el-compositor/publicacion/",
+ "path": "docs/9-6-publishing.md",
+ "order": 6
+ },
+ {
+ "url": "/docs/the-compositor/sync-updates/",
+ "title": "Sync and Updates",
+ "section": "compositor",
+ "group": "publish",
+ "other_url": "/guia/el-compositor/sincronizacion-y-actualizaciones/",
+ "path": "docs/9-7-sync-updates.md",
+ "order": 7
+ },
+ {
+ "url": "/docs/the-compositor/troubleshooting/",
+ "title": "Resolve problems and recover stories",
+ "section": "compositor",
+ "group": "publish",
+ "other_url": "/guia/el-compositor/solucionar-problemas/",
+ "path": "guides/compositor-recovery.en.md"
+ }
+ ]
+ }
+ ]
+ },
+ "sheets": {
+ "id": "sheets",
+ "title": "Google Sheets manual",
+ "url": "/docs/google-sheets/",
+ "items": [
+ {
+ "url": "/docs/google-sheets/",
+ "title": "Google Sheets manual",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/guia/google-sheets/",
+ "path": "guides/sheets.en.html"
+ },
+ {
+ "url": "/docs/getting-started/google-sheets/",
+ "title": "Set Up with Google Sheets",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/guia/primeros-pasos/google-sheets/",
+ "path": "docs/1-2-google-sheets-option.md",
+ "order": 2
+ },
+ {
+ "url": "/docs/setup/manual/",
+ "title": "Manual Setup",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/guia/configuracion/configuracion-manual/",
+ "path": "docs/2-1-manual-setup.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/your-data/google-sheets/",
+ "title": "Understand the spreadsheet",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/guia/tus-datos/google-sheets/",
+ "path": "docs/5-1-google-sheets.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/getting-started/add-content/",
+ "title": "Add an object and a first story",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/guia/primeros-pasos/agrega-contenido/",
+ "path": "docs/1-5-add-content.md",
+ "order": 5
+ },
+ {
+ "url": "/docs/getting-started/review-refine/",
+ "title": "Frame, review and publish from Sheets",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/guia/primeros-pasos/revisa-y-perfecciona/",
+ "path": "docs/1-6-review-refine.md",
+ "order": 6
+ }
+ ],
+ "groups": [
+ {
+ "id": "main",
+ "title": "Guide contents",
+ "items": [
+ {
+ "url": "/docs/google-sheets/",
+ "title": "Google Sheets manual",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/guia/google-sheets/",
+ "path": "guides/sheets.en.html"
+ },
+ {
+ "url": "/docs/getting-started/google-sheets/",
+ "title": "Set Up with Google Sheets",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/guia/primeros-pasos/google-sheets/",
+ "path": "docs/1-2-google-sheets-option.md",
+ "order": 2
+ },
+ {
+ "url": "/docs/setup/manual/",
+ "title": "Manual Setup",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/guia/configuracion/configuracion-manual/",
+ "path": "docs/2-1-manual-setup.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/your-data/google-sheets/",
+ "title": "Understand the spreadsheet",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/guia/tus-datos/google-sheets/",
+ "path": "docs/5-1-google-sheets.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/getting-started/add-content/",
+ "title": "Add an object and a first story",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/guia/primeros-pasos/agrega-contenido/",
+ "path": "docs/1-5-add-content.md",
+ "order": 5
+ },
+ {
+ "url": "/docs/getting-started/review-refine/",
+ "title": "Frame, review and publish from Sheets",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/guia/primeros-pasos/revisa-y-perfecciona/",
+ "path": "docs/1-6-review-refine.md",
+ "order": 6
+ }
+ ]
+ }
+ ]
+ },
+ "local": {
+ "id": "local",
+ "title": "Local authoring & builds",
+ "url": "/docs/local-authoring/",
+ "items": [
+ {
+ "url": "/docs/local-authoring/",
+ "title": "Local authoring & builds",
+ "section": "local",
+ "group": "main",
+ "other_url": "/guia/autoria-local/",
+ "path": "guides/local.en.html"
+ },
+ {
+ "url": "/docs/getting-started/local-dev/",
+ "title": "Install and run Telar locally",
+ "section": "local",
+ "group": "main",
+ "other_url": "/guia/primeros-pasos/desarrollo-local/",
+ "path": "docs/1-3-local-dev.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/local-authoring/content/",
+ "title": "Edit objects, stories and text files",
+ "section": "local",
+ "group": "main",
+ "other_url": "/guia/autoria-local/contenido/",
+ "path": "guides/local-content.en.md"
+ },
+ {
+ "url": "/docs/local-authoring/preview/",
+ "title": "Rebuild and inspect the local site",
+ "section": "local",
+ "group": "main",
+ "other_url": "/guia/autoria-local/vista-previa/",
+ "path": "guides/local-preview.en.md"
+ },
+ {
+ "url": "/docs/local-authoring/publish/",
+ "title": "Publish and maintain a local project",
+ "section": "local",
+ "group": "main",
+ "other_url": "/guia/autoria-local/publicar/",
+ "path": "guides/local-publish.en.md"
+ }
+ ],
+ "groups": [
+ {
+ "id": "main",
+ "title": "Contents",
+ "items": [
+ {
+ "url": "/docs/local-authoring/",
+ "title": "Local authoring & builds",
+ "section": "local",
+ "group": "main",
+ "other_url": "/guia/autoria-local/",
+ "path": "guides/local.en.html"
+ },
+ {
+ "url": "/docs/getting-started/local-dev/",
+ "title": "Install and run Telar locally",
+ "section": "local",
+ "group": "main",
+ "other_url": "/guia/primeros-pasos/desarrollo-local/",
+ "path": "docs/1-3-local-dev.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/local-authoring/content/",
+ "title": "Edit objects, stories and text files",
+ "section": "local",
+ "group": "main",
+ "other_url": "/guia/autoria-local/contenido/",
+ "path": "guides/local-content.en.md"
+ },
+ {
+ "url": "/docs/local-authoring/preview/",
+ "title": "Rebuild and inspect the local site",
+ "section": "local",
+ "group": "main",
+ "other_url": "/guia/autoria-local/vista-previa/",
+ "path": "guides/local-preview.en.md"
+ },
+ {
+ "url": "/docs/local-authoring/publish/",
+ "title": "Publish and maintain a local project",
+ "section": "local",
+ "group": "main",
+ "other_url": "/guia/autoria-local/publicar/",
+ "path": "guides/local-publish.en.md"
+ }
+ ]
+ }
+ ]
+ },
+ "reference": {
+ "id": "reference",
+ "title": "Reference",
+ "url": "/docs/reference/",
+ "items": [
+ {
+ "url": "/docs/setup/",
+ "title": "Set Up Your Site",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/guia/configuracion/",
+ "path": "docs/2-0-setup.md",
+ "order": 2
+ },
+ {
+ "url": "/docs/setup/upgrading/",
+ "title": "Upgrading Telar",
+ "section": "reference",
+ "group": "support",
+ "other_url": "/guia/configuracion/actualizacion/",
+ "path": "docs/2-3-upgrading.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/configure/",
+ "title": "Configure Your Site",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/guia/configurar/",
+ "path": "docs/3-0-configure.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/configure/config-generator/",
+ "title": "Config Generator and Editor",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/guia/configurar/generador-de-configuracion/",
+ "path": "docs/3-1-config-generator.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/configure/configuration/",
+ "title": "Configuration",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/guia/configurar/configuracion/",
+ "path": "docs/3-2-configuration.md",
+ "order": 2
+ },
+ {
+ "url": "/docs/configure/config-validator/",
+ "title": "Config Validator",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/guia/configurar/validador-de-configuracion/",
+ "path": "docs/3-3-config-validator.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/your-content/",
+ "title": "Your Content",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/",
+ "path": "docs/4-0-your-content.md",
+ "order": 4
+ },
+ {
+ "url": "/docs/your-content/objects/",
+ "title": "Objects",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/objetos/",
+ "path": "docs/4-1-objects.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/your-content/audio-objects/",
+ "title": "Audio Objects",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/objetos-de-audio/",
+ "path": "docs/4-10-audio-objects.md",
+ "order": 10
+ },
+ {
+ "url": "/docs/your-content/self-hosted-images/",
+ "title": "Self-Hosted Images",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/imagenes-autoalojadas/",
+ "path": "docs/4-2-self-hosted-images.md",
+ "order": 2
+ },
+ {
+ "url": "/docs/your-content/external-iiif/",
+ "title": "External IIIF Images",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/iiif-externo/",
+ "path": "docs/4-3-external-iiif.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/your-content/stories-panels/",
+ "title": "Stories & Panels",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/historias-paneles/",
+ "path": "docs/4-4-stories-panels.md",
+ "order": 4
+ },
+ {
+ "url": "/docs/your-content/rich-content/",
+ "title": "Rich Content with Markdown",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/contenido-enriquecido/",
+ "path": "docs/4-5-rich-content.md",
+ "order": 5
+ },
+ {
+ "url": "/docs/your-content/markdown-syntax/",
+ "title": "Markdown Syntax Reference",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/sintaxis-markdown/",
+ "path": "docs/4-6-markdown-syntax.md",
+ "order": 6
+ },
+ {
+ "url": "/docs/your-content/widgets/",
+ "title": "Widgets",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/widgets/",
+ "path": "docs/4-7-widgets.md",
+ "order": 7
+ },
+ {
+ "url": "/docs/your-content/pdf-documents/",
+ "title": "PDF Documents",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/documentos-pdf/",
+ "path": "docs/4-8-pdf-documents.md",
+ "order": 8
+ },
+ {
+ "url": "/docs/your-content/video-objects/",
+ "title": "Video Objects",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/objetos-de-video/",
+ "path": "docs/4-9-video-objects.md",
+ "order": 9
+ },
+ {
+ "url": "/docs/your-data/",
+ "title": "Your Data",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/guia/tus-datos/",
+ "path": "docs/5-0-your-data.md",
+ "order": 5
+ },
+ {
+ "url": "/docs/your-data/csv-project/",
+ "title": "Project Columns",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/guia/tus-datos/csv-proyecto/",
+ "path": "docs/5-2-csv-project.md",
+ "order": 2
+ },
+ {
+ "url": "/docs/your-data/csv-objects/",
+ "title": "Object Columns",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/guia/tus-datos/csv-objetos/",
+ "path": "docs/5-3-csv-objects.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/your-data/csv-stories/",
+ "title": "Story Columns",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/guia/tus-datos/csv-historias/",
+ "path": "docs/5-4-csv-stories.md",
+ "order": 4
+ },
+ {
+ "url": "/docs/your-data/csv-glossary/",
+ "title": "Glossary Columns",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/guia/tus-datos/csv-glosario/",
+ "path": "docs/5-5-csv-glossary.md",
+ "order": 5
+ },
+ {
+ "url": "/docs/site-features/",
+ "title": "Site Features",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/guia/funciones/",
+ "path": "docs/6-0-site-features.md",
+ "order": 6
+ },
+ {
+ "url": "/docs/site-features/objects-gallery/",
+ "title": "Objects Gallery",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/guia/funciones/galeria-objetos/",
+ "path": "docs/6-1-objects-gallery.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/site-features/glossary/",
+ "title": "Glossary",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/guia/funciones/glosario/",
+ "path": "docs/6-2-glossary.md",
+ "order": 2
+ },
+ {
+ "url": "/docs/site-features/private-stories/",
+ "title": "Private Stories",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/guia/funciones/historias-privadas/",
+ "path": "docs/6-3-private-stories.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/site-features/custom-pages/",
+ "title": "Custom Pages",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/guia/funciones/paginas-personalizadas/",
+ "path": "docs/6-4-custom-pages.md",
+ "order": 4
+ },
+ {
+ "url": "/docs/site-features/embedding/",
+ "title": "Embedding Telar Stories in LMS & Websites",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/guia/funciones/insercion/",
+ "path": "docs/6-5-embedding.md",
+ "order": 5
+ },
+ {
+ "url": "/docs/customization/",
+ "title": "Customization",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/guia/personalizacion/",
+ "path": "docs/7-0-customization.md",
+ "order": 7
+ },
+ {
+ "url": "/docs/customization/themes/",
+ "title": "Themes",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/guia/personalizacion/temas/",
+ "path": "docs/7-1-themes.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/customization/home-page/",
+ "title": "Customizing the Home Page",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/guia/personalizacion/pagina-de-inicio/",
+ "path": "docs/7-2-home-page.md",
+ "order": 2
+ },
+ {
+ "url": "/docs/customization/navigation-menu/",
+ "title": "Navigation Menu Configuration",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/guia/personalizacion/menu-navegacion/",
+ "path": "docs/7-3-navigation-menu.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/customization/demo-content/",
+ "title": "Demo Content",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/guia/personalizacion/contenido-demostracion/",
+ "path": "docs/7-4-demo-content.md",
+ "order": 4
+ },
+ {
+ "url": "/docs/reference/",
+ "title": "Reference",
+ "section": "reference",
+ "group": "main",
+ "other_url": "/guia/referencia/",
+ "path": "guides/reference.en.html"
+ }
+ ],
+ "groups": [
+ {
+ "id": "configuration",
+ "title": "Configuration and hosting",
+ "items": [
+ {
+ "url": "/docs/setup/",
+ "title": "Set Up Your Site",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/guia/configuracion/",
+ "path": "docs/2-0-setup.md",
+ "order": 2
+ },
+ {
+ "url": "/docs/configure/",
+ "title": "Configure Your Site",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/guia/configurar/",
+ "path": "docs/3-0-configure.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/configure/config-generator/",
+ "title": "Config Generator and Editor",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/guia/configurar/generador-de-configuracion/",
+ "path": "docs/3-1-config-generator.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/configure/configuration/",
+ "title": "Configuration",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/guia/configurar/configuracion/",
+ "path": "docs/3-2-configuration.md",
+ "order": 2
+ },
+ {
+ "url": "/docs/configure/config-validator/",
+ "title": "Config Validator",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/guia/configurar/validador-de-configuracion/",
+ "path": "docs/3-3-config-validator.md",
+ "order": 3
+ }
+ ]
+ },
+ {
+ "id": "content",
+ "title": "Sources and content",
+ "items": [
+ {
+ "url": "/docs/your-content/",
+ "title": "Your Content",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/",
+ "path": "docs/4-0-your-content.md",
+ "order": 4
+ },
+ {
+ "url": "/docs/your-content/objects/",
+ "title": "Objects",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/objetos/",
+ "path": "docs/4-1-objects.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/your-content/audio-objects/",
+ "title": "Audio Objects",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/objetos-de-audio/",
+ "path": "docs/4-10-audio-objects.md",
+ "order": 10
+ },
+ {
+ "url": "/docs/your-content/self-hosted-images/",
+ "title": "Self-Hosted Images",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/imagenes-autoalojadas/",
+ "path": "docs/4-2-self-hosted-images.md",
+ "order": 2
+ },
+ {
+ "url": "/docs/your-content/external-iiif/",
+ "title": "External IIIF Images",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/iiif-externo/",
+ "path": "docs/4-3-external-iiif.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/your-content/stories-panels/",
+ "title": "Stories & Panels",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/historias-paneles/",
+ "path": "docs/4-4-stories-panels.md",
+ "order": 4
+ },
+ {
+ "url": "/docs/your-content/rich-content/",
+ "title": "Rich Content with Markdown",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/contenido-enriquecido/",
+ "path": "docs/4-5-rich-content.md",
+ "order": 5
+ },
+ {
+ "url": "/docs/your-content/markdown-syntax/",
+ "title": "Markdown Syntax Reference",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/sintaxis-markdown/",
+ "path": "docs/4-6-markdown-syntax.md",
+ "order": 6
+ },
+ {
+ "url": "/docs/your-content/widgets/",
+ "title": "Widgets",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/widgets/",
+ "path": "docs/4-7-widgets.md",
+ "order": 7
+ },
+ {
+ "url": "/docs/your-content/pdf-documents/",
+ "title": "PDF Documents",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/documentos-pdf/",
+ "path": "docs/4-8-pdf-documents.md",
+ "order": 8
+ },
+ {
+ "url": "/docs/your-content/video-objects/",
+ "title": "Video Objects",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/guia/tu-contenido/objetos-de-video/",
+ "path": "docs/4-9-video-objects.md",
+ "order": 9
+ }
+ ]
+ },
+ {
+ "id": "data",
+ "title": "Data formats",
+ "items": [
+ {
+ "url": "/docs/your-data/",
+ "title": "Your Data",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/guia/tus-datos/",
+ "path": "docs/5-0-your-data.md",
+ "order": 5
+ },
+ {
+ "url": "/docs/your-data/csv-project/",
+ "title": "Project Columns",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/guia/tus-datos/csv-proyecto/",
+ "path": "docs/5-2-csv-project.md",
+ "order": 2
+ },
+ {
+ "url": "/docs/your-data/csv-objects/",
+ "title": "Object Columns",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/guia/tus-datos/csv-objetos/",
+ "path": "docs/5-3-csv-objects.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/your-data/csv-stories/",
+ "title": "Story Columns",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/guia/tus-datos/csv-historias/",
+ "path": "docs/5-4-csv-stories.md",
+ "order": 4
+ },
+ {
+ "url": "/docs/your-data/csv-glossary/",
+ "title": "Glossary Columns",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/guia/tus-datos/csv-glosario/",
+ "path": "docs/5-5-csv-glossary.md",
+ "order": 5
+ }
+ ]
+ },
+ {
+ "id": "features",
+ "title": "Reader features",
+ "items": [
+ {
+ "url": "/docs/site-features/",
+ "title": "Site Features",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/guia/funciones/",
+ "path": "docs/6-0-site-features.md",
+ "order": 6
+ },
+ {
+ "url": "/docs/site-features/objects-gallery/",
+ "title": "Objects Gallery",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/guia/funciones/galeria-objetos/",
+ "path": "docs/6-1-objects-gallery.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/site-features/glossary/",
+ "title": "Glossary",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/guia/funciones/glosario/",
+ "path": "docs/6-2-glossary.md",
+ "order": 2
+ },
+ {
+ "url": "/docs/site-features/private-stories/",
+ "title": "Private Stories",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/guia/funciones/historias-privadas/",
+ "path": "docs/6-3-private-stories.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/site-features/custom-pages/",
+ "title": "Custom Pages",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/guia/funciones/paginas-personalizadas/",
+ "path": "docs/6-4-custom-pages.md",
+ "order": 4
+ },
+ {
+ "url": "/docs/site-features/embedding/",
+ "title": "Embedding Telar Stories in LMS & Websites",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/guia/funciones/insercion/",
+ "path": "docs/6-5-embedding.md",
+ "order": 5
+ }
+ ]
+ },
+ {
+ "id": "appearance",
+ "title": "Appearance and navigation",
+ "items": [
+ {
+ "url": "/docs/customization/",
+ "title": "Customization",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/guia/personalizacion/",
+ "path": "docs/7-0-customization.md",
+ "order": 7
+ },
+ {
+ "url": "/docs/customization/themes/",
+ "title": "Themes",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/guia/personalizacion/temas/",
+ "path": "docs/7-1-themes.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/customization/home-page/",
+ "title": "Customizing the Home Page",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/guia/personalizacion/pagina-de-inicio/",
+ "path": "docs/7-2-home-page.md",
+ "order": 2
+ },
+ {
+ "url": "/docs/customization/navigation-menu/",
+ "title": "Navigation Menu Configuration",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/guia/personalizacion/menu-navegacion/",
+ "path": "docs/7-3-navigation-menu.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/customization/demo-content/",
+ "title": "Demo Content",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/guia/personalizacion/contenido-demostracion/",
+ "path": "docs/7-4-demo-content.md",
+ "order": 4
+ }
+ ]
+ },
+ {
+ "id": "support",
+ "title": "Maintenance",
+ "items": [
+ {
+ "url": "/docs/setup/upgrading/",
+ "title": "Upgrading Telar",
+ "section": "reference",
+ "group": "support",
+ "other_url": "/guia/configuracion/actualizacion/",
+ "path": "docs/2-3-upgrading.md",
+ "order": 3
+ }
+ ]
+ },
+ {
+ "id": "main",
+ "title": "Guide contents",
+ "items": [
+ {
+ "url": "/docs/reference/",
+ "title": "Reference",
+ "section": "reference",
+ "group": "main",
+ "other_url": "/guia/referencia/",
+ "path": "guides/reference.en.html"
+ }
+ ]
+ }
+ ]
+ },
+ "teaching": {
+ "id": "teaching",
+ "title": "Teaching with Telar",
+ "url": "/docs/teaching/",
+ "items": [
+ {
+ "url": "/docs/teaching/",
+ "title": "Teaching with Telar",
+ "section": "teaching",
+ "group": "main",
+ "other_url": "/guia/ensenar/",
+ "path": "guides/teaching.en.html"
+ },
+ {
+ "url": "/docs/teaching/request-access/",
+ "title": "Request teaching-mode access",
+ "section": "teaching",
+ "group": "main",
+ "other_url": "/guia/ensenar/solicitar-acceso/",
+ "path": "guides/teaching-request.en.html"
+ }
+ ],
+ "groups": [
+ {
+ "id": "main",
+ "title": "Guide contents",
+ "items": [
+ {
+ "url": "/docs/teaching/",
+ "title": "Teaching with Telar",
+ "section": "teaching",
+ "group": "main",
+ "other_url": "/guia/ensenar/",
+ "path": "guides/teaching.en.html"
+ },
+ {
+ "url": "/docs/teaching/request-access/",
+ "title": "Request teaching-mode access",
+ "section": "teaching",
+ "group": "main",
+ "other_url": "/guia/ensenar/solicitar-acceso/",
+ "path": "guides/teaching-request.en.html"
+ }
+ ]
+ }
+ ]
+ },
+ "developers": {
+ "id": "developers",
+ "title": "For developers",
+ "url": "/docs/developers/",
+ "items": [
+ {
+ "url": "/docs/developers/",
+ "title": "For Developers",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/guia/desarrolladores/",
+ "path": "docs/8-0-for-developers.md",
+ "order": 8
+ },
+ {
+ "url": "/docs/developers/local-development/",
+ "title": "Local Development",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/guia/desarrolladores/desarrollo-local/",
+ "path": "docs/8-1-local-development.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/developers/github-actions/",
+ "title": "GitHub Actions Workflow",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/guia/desarrolladores/github-actions/",
+ "path": "docs/8-2-github-actions.md",
+ "order": 2
+ },
+ {
+ "url": "/docs/developers/demo-system/",
+ "title": "Demo System Architecture",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/guia/desarrolladores/sistema-demos/",
+ "path": "docs/8-3-demo-system-architecture.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/developers/embedding-system/",
+ "title": "Embedding System Reference",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/guia/desarrolladores/sistema-insercion/",
+ "path": "docs/8-4-embedding-system.md",
+ "order": 4
+ },
+ {
+ "url": "/docs/developers/styling/",
+ "title": "Advanced Styling",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/guia/desarrolladores/estilos/",
+ "path": "docs/8-5-styling.md",
+ "order": 5
+ },
+ {
+ "url": "/docs/developers/mobile/",
+ "title": "Layouts and Small Screens",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/guia/desarrolladores/moviles/",
+ "path": "docs/8-6-mobile.md",
+ "order": 6
+ },
+ {
+ "url": "/docs/developers/story-engine/",
+ "title": "Story Engine Vocabulary",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/guia/desarrolladores/motor-de-historias/",
+ "path": "docs/8-7-story-engine.md",
+ "order": 7
+ }
+ ],
+ "groups": [
+ {
+ "id": "main",
+ "title": "Guide contents",
+ "items": [
+ {
+ "url": "/docs/developers/",
+ "title": "For Developers",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/guia/desarrolladores/",
+ "path": "docs/8-0-for-developers.md",
+ "order": 8
+ },
+ {
+ "url": "/docs/developers/local-development/",
+ "title": "Local Development",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/guia/desarrolladores/desarrollo-local/",
+ "path": "docs/8-1-local-development.md",
+ "order": 1
+ },
+ {
+ "url": "/docs/developers/github-actions/",
+ "title": "GitHub Actions Workflow",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/guia/desarrolladores/github-actions/",
+ "path": "docs/8-2-github-actions.md",
+ "order": 2
+ },
+ {
+ "url": "/docs/developers/demo-system/",
+ "title": "Demo System Architecture",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/guia/desarrolladores/sistema-demos/",
+ "path": "docs/8-3-demo-system-architecture.md",
+ "order": 3
+ },
+ {
+ "url": "/docs/developers/embedding-system/",
+ "title": "Embedding System Reference",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/guia/desarrolladores/sistema-insercion/",
+ "path": "docs/8-4-embedding-system.md",
+ "order": 4
+ },
+ {
+ "url": "/docs/developers/styling/",
+ "title": "Advanced Styling",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/guia/desarrolladores/estilos/",
+ "path": "docs/8-5-styling.md",
+ "order": 5
+ },
+ {
+ "url": "/docs/developers/mobile/",
+ "title": "Layouts and Small Screens",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/guia/desarrolladores/moviles/",
+ "path": "docs/8-6-mobile.md",
+ "order": 6
+ },
+ {
+ "url": "/docs/developers/story-engine/",
+ "title": "Story Engine Vocabulary",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/guia/desarrolladores/motor-de-historias/",
+ "path": "docs/8-7-story-engine.md",
+ "order": 7
+ }
+ ]
+ }
+ ]
+ },
+ "guides": {
+ "id": "guides",
+ "title": "Guides",
+ "url": "/docs/",
+ "items": [],
+ "groups": []
+ }
+ },
+ "es": {
+ "quick": {
+ "id": "quick",
+ "title": "Guía rápida para talleres",
+ "url": "/empezar/",
+ "items": [
+ {
+ "url": "/empezar/",
+ "title": "Guía rápida para talleres",
+ "section": "quick",
+ "group": "main",
+ "other_url": "/start/",
+ "path": "empezar.html"
+ }
+ ],
+ "groups": [
+ {
+ "id": "main",
+ "title": "Contenido de la guía",
+ "items": [
+ {
+ "url": "/empezar/",
+ "title": "Guía rápida para talleres",
+ "section": "quick",
+ "group": "main",
+ "other_url": "/start/",
+ "path": "empezar.html"
+ }
+ ]
+ }
+ ]
+ },
+ "planning": {
+ "id": "planning",
+ "title": "Planear una exhibición",
+ "url": "/guia/planear/",
+ "items": [
+ {
+ "url": "/guia/planear/",
+ "title": "Planear una exhibición",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/docs/plan/",
+ "path": "guides/planning.es.html"
+ },
+ {
+ "url": "/guia/primeros-pasos/estructura-narrativa/",
+ "title": "Planea el recorrido de la historia",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/docs/getting-started/narrative-structure/",
+ "path": "docs/1-4-narrative-structure.es.md"
+ },
+ {
+ "url": "/guia/planear/fuentes-y-encuadres/",
+ "title": "Elige fuentes y encuadres",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/docs/plan/sources-and-framing/",
+ "path": "guides/planning-sources.es.md"
+ },
+ {
+ "url": "/guia/planear/capas-y-glosario/",
+ "title": "Planea los paneles y el glosario",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/docs/plan/layers-and-glossary/",
+ "path": "guides/planning-layers.es.md"
+ },
+ {
+ "url": "/guia/planear/organizar-la-exhibicion/",
+ "title": "Organiza toda la exhibición",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/docs/plan/exhibition-layout/",
+ "path": "guides/planning-layout.es.md"
+ },
+ {
+ "url": "/guia/planear/revision/",
+ "title": "Prueba la exhibición con lectores",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/docs/plan/review/",
+ "path": "guides/planning-review.es.md"
+ }
+ ],
+ "groups": [
+ {
+ "id": "main",
+ "title": "Contenido",
+ "items": [
+ {
+ "url": "/guia/planear/",
+ "title": "Planear una exhibición",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/docs/plan/",
+ "path": "guides/planning.es.html"
+ },
+ {
+ "url": "/guia/primeros-pasos/estructura-narrativa/",
+ "title": "Planea el recorrido de la historia",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/docs/getting-started/narrative-structure/",
+ "path": "docs/1-4-narrative-structure.es.md"
+ },
+ {
+ "url": "/guia/planear/fuentes-y-encuadres/",
+ "title": "Elige fuentes y encuadres",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/docs/plan/sources-and-framing/",
+ "path": "guides/planning-sources.es.md"
+ },
+ {
+ "url": "/guia/planear/capas-y-glosario/",
+ "title": "Planea los paneles y el glosario",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/docs/plan/layers-and-glossary/",
+ "path": "guides/planning-layers.es.md"
+ },
+ {
+ "url": "/guia/planear/organizar-la-exhibicion/",
+ "title": "Organiza toda la exhibición",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/docs/plan/exhibition-layout/",
+ "path": "guides/planning-layout.es.md"
+ },
+ {
+ "url": "/guia/planear/revision/",
+ "title": "Prueba la exhibición con lectores",
+ "section": "planning",
+ "group": "main",
+ "other_url": "/docs/plan/review/",
+ "path": "guides/planning-review.es.md"
+ }
+ ]
+ }
+ ]
+ },
+ "compositor": {
+ "id": "compositor",
+ "title": "Manual del Compositor",
+ "url": "/guia/el-compositor/",
+ "items": [
+ {
+ "url": "/guia/el-compositor/",
+ "title": "Manual del Compositor",
+ "section": "compositor",
+ "group": "main",
+ "other_url": "/docs/the-compositor/",
+ "path": "docs/9-0-compositor.es.md",
+ "order": 9
+ },
+ {
+ "url": "/guia/primeros-pasos/compositor/",
+ "title": "Usa el Compositor",
+ "section": "compositor",
+ "group": "begin",
+ "other_url": "/docs/getting-started/compositor/",
+ "path": "docs/1-1-compositor.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/el-compositor/primeros-pasos/",
+ "title": "Conectar un sitio existente",
+ "section": "compositor",
+ "group": "begin",
+ "other_url": "/docs/the-compositor/getting-started/",
+ "path": "docs/9-1-getting-started.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/el-compositor/panel-de-control/",
+ "title": "Inicio y navegación",
+ "section": "compositor",
+ "group": "begin",
+ "other_url": "/docs/the-compositor/dashboard/",
+ "path": "docs/9-2-dashboard.es.md",
+ "order": 2
+ },
+ {
+ "url": "/guia/el-compositor/objetos/",
+ "title": "Objetos",
+ "section": "compositor",
+ "group": "compose",
+ "other_url": "/docs/the-compositor/objects/",
+ "path": "docs/9-3-objects.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/el-compositor/iiif-a-historia/",
+ "title": "Usar un objeto IIIF en una historia",
+ "section": "compositor",
+ "group": "compose",
+ "other_url": "/docs/the-compositor/iiif-to-story/",
+ "path": "guides/iiif.es.md"
+ },
+ {
+ "url": "/guia/el-compositor/editor-historias/",
+ "title": "Editor de historias",
+ "section": "compositor",
+ "group": "compose",
+ "other_url": "/docs/the-compositor/story-editor/",
+ "path": "docs/9-4-story-editor.es.md",
+ "order": 4
+ },
+ {
+ "url": "/guia/el-compositor/video-y-audio/",
+ "title": "Video y audio",
+ "section": "compositor",
+ "group": "compose",
+ "other_url": "/docs/the-compositor/video-audio/",
+ "path": "docs/9-5-video-audio.es.md",
+ "order": 5
+ },
+ {
+ "url": "/guia/el-compositor/glosario/",
+ "title": "Crea y enlaza entradas del glosario",
+ "section": "compositor",
+ "group": "exhibition",
+ "other_url": "/docs/the-compositor/glossary/",
+ "path": "guides/compositor-glossary.es.md"
+ },
+ {
+ "url": "/guia/el-compositor/paginas/",
+ "title": "Organiza el inicio y las páginas",
+ "section": "compositor",
+ "group": "exhibition",
+ "other_url": "/docs/the-compositor/pages/",
+ "path": "guides/compositor-pages.es.md"
+ },
+ {
+ "url": "/guia/el-compositor/configuracion/",
+ "title": "Ajusta la apariencia y la configuración",
+ "section": "compositor",
+ "group": "exhibition",
+ "other_url": "/docs/the-compositor/settings/",
+ "path": "guides/compositor-settings.es.md"
+ },
+ {
+ "url": "/guia/el-compositor/equipo/",
+ "title": "Trabaja en equipo",
+ "section": "compositor",
+ "group": "team",
+ "other_url": "/docs/the-compositor/team/",
+ "path": "guides/compositor-team.es.md"
+ },
+ {
+ "url": "/guia/el-compositor/cursos/",
+ "title": "Organiza un curso con sitios de estudiantes",
+ "section": "compositor",
+ "group": "team",
+ "other_url": "/docs/the-compositor/courses/",
+ "path": "guides/compositor-courses.es.md"
+ },
+ {
+ "url": "/guia/el-compositor/publicacion/",
+ "title": "Publicación",
+ "section": "compositor",
+ "group": "publish",
+ "other_url": "/docs/the-compositor/publishing/",
+ "path": "docs/9-6-publishing.es.md",
+ "order": 6
+ },
+ {
+ "url": "/guia/el-compositor/sincronizacion-y-actualizaciones/",
+ "title": "Sincronización y actualizaciones",
+ "section": "compositor",
+ "group": "publish",
+ "other_url": "/docs/the-compositor/sync-updates/",
+ "path": "docs/9-7-sync-updates.es.md",
+ "order": 7
+ },
+ {
+ "url": "/guia/el-compositor/solucionar-problemas/",
+ "title": "Resuelve problemas y recupera historias",
+ "section": "compositor",
+ "group": "publish",
+ "other_url": "/docs/the-compositor/troubleshooting/",
+ "path": "guides/compositor-recovery.es.md"
+ }
+ ],
+ "groups": [
+ {
+ "id": "main",
+ "title": "Presentación",
+ "items": [
+ {
+ "url": "/guia/el-compositor/",
+ "title": "Manual del Compositor",
+ "section": "compositor",
+ "group": "main",
+ "other_url": "/docs/the-compositor/",
+ "path": "docs/9-0-compositor.es.md",
+ "order": 9
+ }
+ ]
+ },
+ {
+ "id": "begin",
+ "title": "Comenzar",
+ "items": [
+ {
+ "url": "/guia/primeros-pasos/compositor/",
+ "title": "Usa el Compositor",
+ "section": "compositor",
+ "group": "begin",
+ "other_url": "/docs/getting-started/compositor/",
+ "path": "docs/1-1-compositor.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/el-compositor/primeros-pasos/",
+ "title": "Conectar un sitio existente",
+ "section": "compositor",
+ "group": "begin",
+ "other_url": "/docs/the-compositor/getting-started/",
+ "path": "docs/9-1-getting-started.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/el-compositor/panel-de-control/",
+ "title": "Inicio y navegación",
+ "section": "compositor",
+ "group": "begin",
+ "other_url": "/docs/the-compositor/dashboard/",
+ "path": "docs/9-2-dashboard.es.md",
+ "order": 2
+ }
+ ]
+ },
+ {
+ "id": "compose",
+ "title": "Fuentes e historias",
+ "items": [
+ {
+ "url": "/guia/el-compositor/objetos/",
+ "title": "Objetos",
+ "section": "compositor",
+ "group": "compose",
+ "other_url": "/docs/the-compositor/objects/",
+ "path": "docs/9-3-objects.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/el-compositor/iiif-a-historia/",
+ "title": "Usar un objeto IIIF en una historia",
+ "section": "compositor",
+ "group": "compose",
+ "other_url": "/docs/the-compositor/iiif-to-story/",
+ "path": "guides/iiif.es.md"
+ },
+ {
+ "url": "/guia/el-compositor/editor-historias/",
+ "title": "Editor de historias",
+ "section": "compositor",
+ "group": "compose",
+ "other_url": "/docs/the-compositor/story-editor/",
+ "path": "docs/9-4-story-editor.es.md",
+ "order": 4
+ },
+ {
+ "url": "/guia/el-compositor/video-y-audio/",
+ "title": "Video y audio",
+ "section": "compositor",
+ "group": "compose",
+ "other_url": "/docs/the-compositor/video-audio/",
+ "path": "docs/9-5-video-audio.es.md",
+ "order": 5
+ }
+ ]
+ },
+ {
+ "id": "exhibition",
+ "title": "La exhibición",
+ "items": [
+ {
+ "url": "/guia/el-compositor/glosario/",
+ "title": "Crea y enlaza entradas del glosario",
+ "section": "compositor",
+ "group": "exhibition",
+ "other_url": "/docs/the-compositor/glossary/",
+ "path": "guides/compositor-glossary.es.md"
+ },
+ {
+ "url": "/guia/el-compositor/paginas/",
+ "title": "Organiza el inicio y las páginas",
+ "section": "compositor",
+ "group": "exhibition",
+ "other_url": "/docs/the-compositor/pages/",
+ "path": "guides/compositor-pages.es.md"
+ },
+ {
+ "url": "/guia/el-compositor/configuracion/",
+ "title": "Ajusta la apariencia y la configuración",
+ "section": "compositor",
+ "group": "exhibition",
+ "other_url": "/docs/the-compositor/settings/",
+ "path": "guides/compositor-settings.es.md"
+ }
+ ]
+ },
+ {
+ "id": "team",
+ "title": "Equipo y cursos",
+ "items": [
+ {
+ "url": "/guia/el-compositor/equipo/",
+ "title": "Trabaja en equipo",
+ "section": "compositor",
+ "group": "team",
+ "other_url": "/docs/the-compositor/team/",
+ "path": "guides/compositor-team.es.md"
+ },
+ {
+ "url": "/guia/el-compositor/cursos/",
+ "title": "Organiza un curso con sitios de estudiantes",
+ "section": "compositor",
+ "group": "team",
+ "other_url": "/docs/the-compositor/courses/",
+ "path": "guides/compositor-courses.es.md"
+ }
+ ]
+ },
+ {
+ "id": "publish",
+ "title": "Publicar y mantener",
+ "items": [
+ {
+ "url": "/guia/el-compositor/publicacion/",
+ "title": "Publicación",
+ "section": "compositor",
+ "group": "publish",
+ "other_url": "/docs/the-compositor/publishing/",
+ "path": "docs/9-6-publishing.es.md",
+ "order": 6
+ },
+ {
+ "url": "/guia/el-compositor/sincronizacion-y-actualizaciones/",
+ "title": "Sincronización y actualizaciones",
+ "section": "compositor",
+ "group": "publish",
+ "other_url": "/docs/the-compositor/sync-updates/",
+ "path": "docs/9-7-sync-updates.es.md",
+ "order": 7
+ },
+ {
+ "url": "/guia/el-compositor/solucionar-problemas/",
+ "title": "Resuelve problemas y recupera historias",
+ "section": "compositor",
+ "group": "publish",
+ "other_url": "/docs/the-compositor/troubleshooting/",
+ "path": "guides/compositor-recovery.es.md"
+ }
+ ]
+ }
+ ]
+ },
+ "sheets": {
+ "id": "sheets",
+ "title": "Manual de Google Sheets",
+ "url": "/guia/google-sheets/",
+ "items": [
+ {
+ "url": "/guia/google-sheets/",
+ "title": "Manual de Google Sheets",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/docs/google-sheets/",
+ "path": "guides/sheets.es.html"
+ },
+ {
+ "url": "/guia/primeros-pasos/google-sheets/",
+ "title": "Configura con Google Sheets",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/docs/getting-started/google-sheets/",
+ "path": "docs/1-2-google-sheets-option.es.md",
+ "order": 2
+ },
+ {
+ "url": "/guia/configuracion/configuracion-manual/",
+ "title": "Configuración manual",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/docs/setup/manual/",
+ "path": "docs/2-1-manual-setup.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/tus-datos/google-sheets/",
+ "title": "Entiende la hoja de cálculo",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/docs/your-data/google-sheets/",
+ "path": "docs/5-1-google-sheets.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/primeros-pasos/agrega-contenido/",
+ "title": "Agrega un objeto y una primera historia",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/docs/getting-started/add-content/",
+ "path": "docs/1-5-add-content.es.md",
+ "order": 5
+ },
+ {
+ "url": "/guia/primeros-pasos/revisa-y-perfecciona/",
+ "title": "Encuadra, revisa y publica desde Sheets",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/docs/getting-started/review-refine/",
+ "path": "docs/1-6-review-refine.es.md",
+ "order": 6
+ }
+ ],
+ "groups": [
+ {
+ "id": "main",
+ "title": "Contenido de la guía",
+ "items": [
+ {
+ "url": "/guia/google-sheets/",
+ "title": "Manual de Google Sheets",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/docs/google-sheets/",
+ "path": "guides/sheets.es.html"
+ },
+ {
+ "url": "/guia/primeros-pasos/google-sheets/",
+ "title": "Configura con Google Sheets",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/docs/getting-started/google-sheets/",
+ "path": "docs/1-2-google-sheets-option.es.md",
+ "order": 2
+ },
+ {
+ "url": "/guia/configuracion/configuracion-manual/",
+ "title": "Configuración manual",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/docs/setup/manual/",
+ "path": "docs/2-1-manual-setup.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/tus-datos/google-sheets/",
+ "title": "Entiende la hoja de cálculo",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/docs/your-data/google-sheets/",
+ "path": "docs/5-1-google-sheets.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/primeros-pasos/agrega-contenido/",
+ "title": "Agrega un objeto y una primera historia",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/docs/getting-started/add-content/",
+ "path": "docs/1-5-add-content.es.md",
+ "order": 5
+ },
+ {
+ "url": "/guia/primeros-pasos/revisa-y-perfecciona/",
+ "title": "Encuadra, revisa y publica desde Sheets",
+ "section": "sheets",
+ "group": "main",
+ "other_url": "/docs/getting-started/review-refine/",
+ "path": "docs/1-6-review-refine.es.md",
+ "order": 6
+ }
+ ]
+ }
+ ]
+ },
+ "local": {
+ "id": "local",
+ "title": "Autoría local",
+ "url": "/guia/autoria-local/",
+ "items": [
+ {
+ "url": "/guia/autoria-local/",
+ "title": "Autoría local",
+ "section": "local",
+ "group": "main",
+ "other_url": "/docs/local-authoring/",
+ "path": "guides/local.es.html"
+ },
+ {
+ "url": "/guia/primeros-pasos/desarrollo-local/",
+ "title": "Instala y ejecuta Telar localmente",
+ "section": "local",
+ "group": "main",
+ "other_url": "/docs/getting-started/local-dev/",
+ "path": "docs/1-3-local-dev.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/autoria-local/contenido/",
+ "title": "Edita objetos, historias y textos",
+ "section": "local",
+ "group": "main",
+ "other_url": "/docs/local-authoring/content/",
+ "path": "guides/local-content.es.md"
+ },
+ {
+ "url": "/guia/autoria-local/vista-previa/",
+ "title": "Genera y revisa el sitio local",
+ "section": "local",
+ "group": "main",
+ "other_url": "/docs/local-authoring/preview/",
+ "path": "guides/local-preview.es.md"
+ },
+ {
+ "url": "/guia/autoria-local/publicar/",
+ "title": "Publica y mantén un proyecto local",
+ "section": "local",
+ "group": "main",
+ "other_url": "/docs/local-authoring/publish/",
+ "path": "guides/local-publish.es.md"
+ }
+ ],
+ "groups": [
+ {
+ "id": "main",
+ "title": "Contenido",
+ "items": [
+ {
+ "url": "/guia/autoria-local/",
+ "title": "Autoría local",
+ "section": "local",
+ "group": "main",
+ "other_url": "/docs/local-authoring/",
+ "path": "guides/local.es.html"
+ },
+ {
+ "url": "/guia/primeros-pasos/desarrollo-local/",
+ "title": "Instala y ejecuta Telar localmente",
+ "section": "local",
+ "group": "main",
+ "other_url": "/docs/getting-started/local-dev/",
+ "path": "docs/1-3-local-dev.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/autoria-local/contenido/",
+ "title": "Edita objetos, historias y textos",
+ "section": "local",
+ "group": "main",
+ "other_url": "/docs/local-authoring/content/",
+ "path": "guides/local-content.es.md"
+ },
+ {
+ "url": "/guia/autoria-local/vista-previa/",
+ "title": "Genera y revisa el sitio local",
+ "section": "local",
+ "group": "main",
+ "other_url": "/docs/local-authoring/preview/",
+ "path": "guides/local-preview.es.md"
+ },
+ {
+ "url": "/guia/autoria-local/publicar/",
+ "title": "Publica y mantén un proyecto local",
+ "section": "local",
+ "group": "main",
+ "other_url": "/docs/local-authoring/publish/",
+ "path": "guides/local-publish.es.md"
+ }
+ ]
+ }
+ ]
+ },
+ "reference": {
+ "id": "reference",
+ "title": "Referencia",
+ "url": "/guia/referencia/",
+ "items": [
+ {
+ "url": "/guia/configuracion/",
+ "title": "Configura tu sitio",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/docs/setup/",
+ "path": "docs/2-0-setup.es.md",
+ "order": 2
+ },
+ {
+ "url": "/guia/configuracion/actualizacion/",
+ "title": "Actualizar Telar",
+ "section": "reference",
+ "group": "support",
+ "other_url": "/docs/setup/upgrading/",
+ "path": "docs/2-3-upgrading.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/configurar/",
+ "title": "Configura tu proyecto",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/docs/configure/",
+ "path": "docs/3-0-configure.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/configurar/generador-de-configuracion/",
+ "title": "Generador y editor de configuración",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/docs/configure/config-generator/",
+ "path": "docs/3-1-config-generator.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/configurar/configuracion/",
+ "title": "Configuración",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/docs/configure/configuration/",
+ "path": "docs/3-2-configuration.es.md",
+ "order": 2
+ },
+ {
+ "url": "/guia/configurar/validador-de-configuracion/",
+ "title": "Validador de Configuración",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/docs/configure/config-validator/",
+ "path": "docs/3-3-config-validator.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/tu-contenido/",
+ "title": "Tu contenido",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/",
+ "path": "docs/4-0-your-content.es.md",
+ "order": 4
+ },
+ {
+ "url": "/guia/tu-contenido/objetos/",
+ "title": "Objetos",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/objects/",
+ "path": "docs/4-1-objects.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/tu-contenido/objetos-de-audio/",
+ "title": "Objetos de audio",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/audio-objects/",
+ "path": "docs/4-10-audio-objects.es.md",
+ "order": 10
+ },
+ {
+ "url": "/guia/tu-contenido/imagenes-autoalojadas/",
+ "title": "Imágenes autoalojadas",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/self-hosted-images/",
+ "path": "docs/4-2-self-hosted-images.es.md",
+ "order": 2
+ },
+ {
+ "url": "/guia/tu-contenido/iiif-externo/",
+ "title": "Imágenes IIIF externas",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/external-iiif/",
+ "path": "docs/4-3-external-iiif.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/tu-contenido/historias-paneles/",
+ "title": "Historias y paneles",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/stories-panels/",
+ "path": "docs/4-4-stories-panels.es.md",
+ "order": 4
+ },
+ {
+ "url": "/guia/tu-contenido/contenido-enriquecido/",
+ "title": "Contenido enriquecido con Markdown",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/rich-content/",
+ "path": "docs/4-5-rich-content.es.md",
+ "order": 5
+ },
+ {
+ "url": "/guia/tu-contenido/sintaxis-markdown/",
+ "title": "Referencia de sintaxis de Markdown",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/markdown-syntax/",
+ "path": "docs/4-6-markdown-syntax.es.md",
+ "order": 6
+ },
+ {
+ "url": "/guia/tu-contenido/widgets/",
+ "title": "Widgets",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/widgets/",
+ "path": "docs/4-7-widgets.es.md",
+ "order": 7
+ },
+ {
+ "url": "/guia/tu-contenido/documentos-pdf/",
+ "title": "Documentos PDF",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/pdf-documents/",
+ "path": "docs/4-8-pdf-documents.es.md",
+ "order": 8
+ },
+ {
+ "url": "/guia/tu-contenido/objetos-de-video/",
+ "title": "Objetos de video",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/video-objects/",
+ "path": "docs/4-9-video-objects.es.md",
+ "order": 9
+ },
+ {
+ "url": "/guia/tus-datos/",
+ "title": "Tus datos",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/docs/your-data/",
+ "path": "docs/5-0-your-data.es.md",
+ "order": 5
+ },
+ {
+ "url": "/guia/tus-datos/csv-proyecto/",
+ "title": "Columnas del proyecto",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/docs/your-data/csv-project/",
+ "path": "docs/5-2-csv-project.es.md",
+ "order": 2
+ },
+ {
+ "url": "/guia/tus-datos/csv-objetos/",
+ "title": "Columnas de objetos",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/docs/your-data/csv-objects/",
+ "path": "docs/5-3-csv-objects.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/tus-datos/csv-historias/",
+ "title": "Columnas de historias",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/docs/your-data/csv-stories/",
+ "path": "docs/5-4-csv-stories.es.md",
+ "order": 4
+ },
+ {
+ "url": "/guia/tus-datos/csv-glosario/",
+ "title": "Columnas del glosario",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/docs/your-data/csv-glossary/",
+ "path": "docs/5-5-csv-glossary.es.md",
+ "order": 5
+ },
+ {
+ "url": "/guia/funciones/",
+ "title": "Funciones del sitio",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/docs/site-features/",
+ "path": "docs/6-0-site-features.es.md",
+ "order": 6
+ },
+ {
+ "url": "/guia/funciones/galeria-objetos/",
+ "title": "Galería de objetos",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/docs/site-features/objects-gallery/",
+ "path": "docs/6-1-objects-gallery.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/funciones/glosario/",
+ "title": "Glosario",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/docs/site-features/glossary/",
+ "path": "docs/6-2-glossary.es.md",
+ "order": 2
+ },
+ {
+ "url": "/guia/funciones/historias-privadas/",
+ "title": "Historias privadas",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/docs/site-features/private-stories/",
+ "path": "docs/6-3-private-stories.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/funciones/paginas-personalizadas/",
+ "title": "Páginas personalizadas",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/docs/site-features/custom-pages/",
+ "path": "docs/6-4-custom-pages.es.md",
+ "order": 4
+ },
+ {
+ "url": "/guia/funciones/insercion/",
+ "title": "Insertar historias de Telar en LMS y sitios web",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/docs/site-features/embedding/",
+ "path": "docs/6-5-embedding.es.md",
+ "order": 5
+ },
+ {
+ "url": "/guia/personalizacion/",
+ "title": "Personalización",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/docs/customization/",
+ "path": "docs/7-0-customization.es.md",
+ "order": 7
+ },
+ {
+ "url": "/guia/personalizacion/temas/",
+ "title": "Temas",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/docs/customization/themes/",
+ "path": "docs/7-1-themes.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/personalizacion/pagina-de-inicio/",
+ "title": "Personalizar la página de inicio",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/docs/customization/home-page/",
+ "path": "docs/7-2-home-page.es.md",
+ "order": 2
+ },
+ {
+ "url": "/guia/personalizacion/menu-navegacion/",
+ "title": "Configuración del menú de navegación",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/docs/customization/navigation-menu/",
+ "path": "docs/7-3-navigation-menu.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/personalizacion/contenido-demostracion/",
+ "title": "Contenido de demostración",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/docs/customization/demo-content/",
+ "path": "docs/7-4-demo-content.es.md",
+ "order": 4
+ },
+ {
+ "url": "/guia/referencia/",
+ "title": "Referencia",
+ "section": "reference",
+ "group": "main",
+ "other_url": "/docs/reference/",
+ "path": "guides/reference.es.html"
+ }
+ ],
+ "groups": [
+ {
+ "id": "configuration",
+ "title": "Configuración y alojamiento",
+ "items": [
+ {
+ "url": "/guia/configuracion/",
+ "title": "Configura tu sitio",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/docs/setup/",
+ "path": "docs/2-0-setup.es.md",
+ "order": 2
+ },
+ {
+ "url": "/guia/configurar/",
+ "title": "Configura tu proyecto",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/docs/configure/",
+ "path": "docs/3-0-configure.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/configurar/generador-de-configuracion/",
+ "title": "Generador y editor de configuración",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/docs/configure/config-generator/",
+ "path": "docs/3-1-config-generator.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/configurar/configuracion/",
+ "title": "Configuración",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/docs/configure/configuration/",
+ "path": "docs/3-2-configuration.es.md",
+ "order": 2
+ },
+ {
+ "url": "/guia/configurar/validador-de-configuracion/",
+ "title": "Validador de Configuración",
+ "section": "reference",
+ "group": "configuration",
+ "other_url": "/docs/configure/config-validator/",
+ "path": "docs/3-3-config-validator.es.md",
+ "order": 3
+ }
+ ]
+ },
+ {
+ "id": "content",
+ "title": "Fuentes y contenido",
+ "items": [
+ {
+ "url": "/guia/tu-contenido/",
+ "title": "Tu contenido",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/",
+ "path": "docs/4-0-your-content.es.md",
+ "order": 4
+ },
+ {
+ "url": "/guia/tu-contenido/objetos/",
+ "title": "Objetos",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/objects/",
+ "path": "docs/4-1-objects.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/tu-contenido/objetos-de-audio/",
+ "title": "Objetos de audio",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/audio-objects/",
+ "path": "docs/4-10-audio-objects.es.md",
+ "order": 10
+ },
+ {
+ "url": "/guia/tu-contenido/imagenes-autoalojadas/",
+ "title": "Imágenes autoalojadas",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/self-hosted-images/",
+ "path": "docs/4-2-self-hosted-images.es.md",
+ "order": 2
+ },
+ {
+ "url": "/guia/tu-contenido/iiif-externo/",
+ "title": "Imágenes IIIF externas",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/external-iiif/",
+ "path": "docs/4-3-external-iiif.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/tu-contenido/historias-paneles/",
+ "title": "Historias y paneles",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/stories-panels/",
+ "path": "docs/4-4-stories-panels.es.md",
+ "order": 4
+ },
+ {
+ "url": "/guia/tu-contenido/contenido-enriquecido/",
+ "title": "Contenido enriquecido con Markdown",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/rich-content/",
+ "path": "docs/4-5-rich-content.es.md",
+ "order": 5
+ },
+ {
+ "url": "/guia/tu-contenido/sintaxis-markdown/",
+ "title": "Referencia de sintaxis de Markdown",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/markdown-syntax/",
+ "path": "docs/4-6-markdown-syntax.es.md",
+ "order": 6
+ },
+ {
+ "url": "/guia/tu-contenido/widgets/",
+ "title": "Widgets",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/widgets/",
+ "path": "docs/4-7-widgets.es.md",
+ "order": 7
+ },
+ {
+ "url": "/guia/tu-contenido/documentos-pdf/",
+ "title": "Documentos PDF",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/pdf-documents/",
+ "path": "docs/4-8-pdf-documents.es.md",
+ "order": 8
+ },
+ {
+ "url": "/guia/tu-contenido/objetos-de-video/",
+ "title": "Objetos de video",
+ "section": "reference",
+ "group": "content",
+ "other_url": "/docs/your-content/video-objects/",
+ "path": "docs/4-9-video-objects.es.md",
+ "order": 9
+ }
+ ]
+ },
+ {
+ "id": "data",
+ "title": "Formatos de datos",
+ "items": [
+ {
+ "url": "/guia/tus-datos/",
+ "title": "Tus datos",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/docs/your-data/",
+ "path": "docs/5-0-your-data.es.md",
+ "order": 5
+ },
+ {
+ "url": "/guia/tus-datos/csv-proyecto/",
+ "title": "Columnas del proyecto",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/docs/your-data/csv-project/",
+ "path": "docs/5-2-csv-project.es.md",
+ "order": 2
+ },
+ {
+ "url": "/guia/tus-datos/csv-objetos/",
+ "title": "Columnas de objetos",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/docs/your-data/csv-objects/",
+ "path": "docs/5-3-csv-objects.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/tus-datos/csv-historias/",
+ "title": "Columnas de historias",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/docs/your-data/csv-stories/",
+ "path": "docs/5-4-csv-stories.es.md",
+ "order": 4
+ },
+ {
+ "url": "/guia/tus-datos/csv-glosario/",
+ "title": "Columnas del glosario",
+ "section": "reference",
+ "group": "data",
+ "other_url": "/docs/your-data/csv-glossary/",
+ "path": "docs/5-5-csv-glossary.es.md",
+ "order": 5
+ }
+ ]
+ },
+ {
+ "id": "features",
+ "title": "Funciones de lectura",
+ "items": [
+ {
+ "url": "/guia/funciones/",
+ "title": "Funciones del sitio",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/docs/site-features/",
+ "path": "docs/6-0-site-features.es.md",
+ "order": 6
+ },
+ {
+ "url": "/guia/funciones/galeria-objetos/",
+ "title": "Galería de objetos",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/docs/site-features/objects-gallery/",
+ "path": "docs/6-1-objects-gallery.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/funciones/glosario/",
+ "title": "Glosario",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/docs/site-features/glossary/",
+ "path": "docs/6-2-glossary.es.md",
+ "order": 2
+ },
+ {
+ "url": "/guia/funciones/historias-privadas/",
+ "title": "Historias privadas",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/docs/site-features/private-stories/",
+ "path": "docs/6-3-private-stories.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/funciones/paginas-personalizadas/",
+ "title": "Páginas personalizadas",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/docs/site-features/custom-pages/",
+ "path": "docs/6-4-custom-pages.es.md",
+ "order": 4
+ },
+ {
+ "url": "/guia/funciones/insercion/",
+ "title": "Insertar historias de Telar en LMS y sitios web",
+ "section": "reference",
+ "group": "features",
+ "other_url": "/docs/site-features/embedding/",
+ "path": "docs/6-5-embedding.es.md",
+ "order": 5
+ }
+ ]
+ },
+ {
+ "id": "appearance",
+ "title": "Apariencia y navegación",
+ "items": [
+ {
+ "url": "/guia/personalizacion/",
+ "title": "Personalización",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/docs/customization/",
+ "path": "docs/7-0-customization.es.md",
+ "order": 7
+ },
+ {
+ "url": "/guia/personalizacion/temas/",
+ "title": "Temas",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/docs/customization/themes/",
+ "path": "docs/7-1-themes.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/personalizacion/pagina-de-inicio/",
+ "title": "Personalizar la página de inicio",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/docs/customization/home-page/",
+ "path": "docs/7-2-home-page.es.md",
+ "order": 2
+ },
+ {
+ "url": "/guia/personalizacion/menu-navegacion/",
+ "title": "Configuración del menú de navegación",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/docs/customization/navigation-menu/",
+ "path": "docs/7-3-navigation-menu.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/personalizacion/contenido-demostracion/",
+ "title": "Contenido de demostración",
+ "section": "reference",
+ "group": "appearance",
+ "other_url": "/docs/customization/demo-content/",
+ "path": "docs/7-4-demo-content.es.md",
+ "order": 4
+ }
+ ]
+ },
+ {
+ "id": "support",
+ "title": "Mantenimiento",
+ "items": [
+ {
+ "url": "/guia/configuracion/actualizacion/",
+ "title": "Actualizar Telar",
+ "section": "reference",
+ "group": "support",
+ "other_url": "/docs/setup/upgrading/",
+ "path": "docs/2-3-upgrading.es.md",
+ "order": 3
+ }
+ ]
+ },
+ {
+ "id": "main",
+ "title": "Contenido de la guía",
+ "items": [
+ {
+ "url": "/guia/referencia/",
+ "title": "Referencia",
+ "section": "reference",
+ "group": "main",
+ "other_url": "/docs/reference/",
+ "path": "guides/reference.es.html"
+ }
+ ]
+ }
+ ]
+ },
+ "teaching": {
+ "id": "teaching",
+ "title": "Enseñar con Telar",
+ "url": "/guia/ensenar/",
+ "items": [
+ {
+ "url": "/guia/ensenar/",
+ "title": "Enseñar con Telar",
+ "section": "teaching",
+ "group": "main",
+ "other_url": "/docs/teaching/",
+ "path": "guides/teaching.es.html"
+ },
+ {
+ "url": "/guia/ensenar/solicitar-acceso/",
+ "title": "Solicita acceso al modo docente",
+ "section": "teaching",
+ "group": "main",
+ "other_url": "/docs/teaching/request-access/",
+ "path": "guides/teaching-request.es.html"
+ }
+ ],
+ "groups": [
+ {
+ "id": "main",
+ "title": "Contenido de la guía",
+ "items": [
+ {
+ "url": "/guia/ensenar/",
+ "title": "Enseñar con Telar",
+ "section": "teaching",
+ "group": "main",
+ "other_url": "/docs/teaching/",
+ "path": "guides/teaching.es.html"
+ },
+ {
+ "url": "/guia/ensenar/solicitar-acceso/",
+ "title": "Solicita acceso al modo docente",
+ "section": "teaching",
+ "group": "main",
+ "other_url": "/docs/teaching/request-access/",
+ "path": "guides/teaching-request.es.html"
+ }
+ ]
+ }
+ ]
+ },
+ "developers": {
+ "id": "developers",
+ "title": "Para desarrolladores",
+ "url": "/guia/desarrolladores/",
+ "items": [
+ {
+ "url": "/guia/desarrolladores/",
+ "title": "Para desarrolladores",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/docs/developers/",
+ "path": "docs/8-0-for-developers.es.md",
+ "order": 8
+ },
+ {
+ "url": "/guia/desarrolladores/desarrollo-local/",
+ "title": "Desarrollo local",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/docs/developers/local-development/",
+ "path": "docs/8-1-local-development.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/desarrolladores/github-actions/",
+ "title": "GitHub Actions",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/docs/developers/github-actions/",
+ "path": "docs/8-2-github-actions.es.md",
+ "order": 2
+ },
+ {
+ "url": "/guia/desarrolladores/sistema-demos/",
+ "title": "Arquitectura del contenido de demostración",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/docs/developers/demo-system/",
+ "path": "docs/8-3-demo-system-architecture.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/desarrolladores/sistema-insercion/",
+ "title": "Referencia del sistema de inserción",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/docs/developers/embedding-system/",
+ "path": "docs/8-4-embedding-system.es.md",
+ "order": 4
+ },
+ {
+ "url": "/guia/desarrolladores/estilos/",
+ "title": "Estilos avanzados",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/docs/developers/styling/",
+ "path": "docs/8-5-styling.es.md",
+ "order": 5
+ },
+ {
+ "url": "/guia/desarrolladores/moviles/",
+ "title": "Diseños y pantallas pequeñas",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/docs/developers/mobile/",
+ "path": "docs/8-6-mobile.es.md",
+ "order": 6
+ },
+ {
+ "url": "/guia/desarrolladores/motor-de-historias/",
+ "title": "Vocabulario del motor de historias",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/docs/developers/story-engine/",
+ "path": "docs/8-7-story-engine.es.md",
+ "order": 7
+ }
+ ],
+ "groups": [
+ {
+ "id": "main",
+ "title": "Contenido de la guía",
+ "items": [
+ {
+ "url": "/guia/desarrolladores/",
+ "title": "Para desarrolladores",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/docs/developers/",
+ "path": "docs/8-0-for-developers.es.md",
+ "order": 8
+ },
+ {
+ "url": "/guia/desarrolladores/desarrollo-local/",
+ "title": "Desarrollo local",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/docs/developers/local-development/",
+ "path": "docs/8-1-local-development.es.md",
+ "order": 1
+ },
+ {
+ "url": "/guia/desarrolladores/github-actions/",
+ "title": "GitHub Actions",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/docs/developers/github-actions/",
+ "path": "docs/8-2-github-actions.es.md",
+ "order": 2
+ },
+ {
+ "url": "/guia/desarrolladores/sistema-demos/",
+ "title": "Arquitectura del contenido de demostración",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/docs/developers/demo-system/",
+ "path": "docs/8-3-demo-system-architecture.es.md",
+ "order": 3
+ },
+ {
+ "url": "/guia/desarrolladores/sistema-insercion/",
+ "title": "Referencia del sistema de inserción",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/docs/developers/embedding-system/",
+ "path": "docs/8-4-embedding-system.es.md",
+ "order": 4
+ },
+ {
+ "url": "/guia/desarrolladores/estilos/",
+ "title": "Estilos avanzados",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/docs/developers/styling/",
+ "path": "docs/8-5-styling.es.md",
+ "order": 5
+ },
+ {
+ "url": "/guia/desarrolladores/moviles/",
+ "title": "Diseños y pantallas pequeñas",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/docs/developers/mobile/",
+ "path": "docs/8-6-mobile.es.md",
+ "order": 6
+ },
+ {
+ "url": "/guia/desarrolladores/motor-de-historias/",
+ "title": "Vocabulario del motor de historias",
+ "section": "developers",
+ "group": "main",
+ "other_url": "/docs/developers/story-engine/",
+ "path": "docs/8-7-story-engine.es.md",
+ "order": 7
+ }
+ ]
+ }
+ ]
+ },
+ "guides": {
+ "id": "guides",
+ "title": "Guías",
+ "url": "/guia/",
+ "items": [],
+ "groups": []
+ }
+ }
+ }
+}
diff --git a/data/guides.json b/data/guides.json
new file mode 100644
index 0000000..46ac1c3
--- /dev/null
+++ b/data/guides.json
@@ -0,0 +1,304 @@
+{
+ "copy": {
+ "en": {
+ "guides": "Guides",
+ "explore": "Explore",
+ "teaching": "Teaching",
+ "about": "About",
+ "compositor": "Compositor",
+ "language": "Language",
+ "skip": "Skip to content",
+ "design": "Design sketch",
+ "brand_sub": "Visual storytelling",
+ "hero_tag": "Make an exhibition with Telar",
+ "hero_title": "From your sources to a visual story.",
+ "hero_intro": "Plan what you want to say, choose how to build it, and shape an exhibition your visitors can explore.",
+ "plan_tag": "Start with the story",
+ "plan_title": "Plan your exhibition",
+ "plan_text": "Read your sources closely. Sketch an opening and an ending. Connect your questions to details, then decide where readers can go deeper.",
+ "plan_link": "Start planning",
+ "beginning": "Beginning",
+ "question": "Questions & sources",
+ "layers": "Further layers",
+ "ending": "Ending",
+ "build_tag": "Choose your way of working",
+ "build_title": "Build your exhibition",
+ "build_intro": "There are three ways to author a Telar exhibition: use the Compositor's visual editor, organise your content in Google Sheets, or edit CSV and Markdown files on your computer. Each produces a Telar site; the difference is where you work on the content and how you preview and publish it.",
+ "reference_title": "Find a specific answer",
+ "reference_text": "Content formats, configuration, media, accessibility and troubleshooting. Shared reference for all three ways of building.",
+ "reference_link": "Browse the reference",
+ "teach_title": "Teach and learn with Telar",
+ "teach_text": "Workshop slides, a narrative planner and guides for developing visual stories in the classroom.",
+ "workshop": "Workshop slides",
+ "worksheet": "Download the planner",
+ "examples_title": "See the choices behind an exhibition",
+ "examples_text": "Explore finished projects to see how sources, image details and optional layers work together.",
+ "examples_link": "Explore projects",
+ "outline": "In this chapter",
+ "planning": "Plan an exhibition",
+ "chapter": "1. Purpose, audience and sources",
+ "guide_home": "All guides",
+ "back_build": "Choose how to build",
+ "footer": "Telar guides",
+ "purpose": "Purpose",
+ "audience": "Audience",
+ "source": "Sources",
+ "exercise": "Try it",
+ "next": "What comes next",
+ "nav_prefix": "Guide contents",
+ "book_link": "Compositor manual preview",
+ "preview_note": "Proposed structure · English and Spanish",
+ "site_home": "/",
+ "build_guidance": "Choose the approach that suits you and your collaborators. Each manual walks you through setup and a first story, then covers the tasks that follow. The planning guides and shared reference apply to all three."
+ },
+ "es": {
+ "guides": "Guías",
+ "explore": "Explorar",
+ "teaching": "Enseñar",
+ "about": "Acerca de",
+ "compositor": "Compositor",
+ "language": "Idioma",
+ "skip": "Saltar al contenido",
+ "design": "Boceto de diseño",
+ "brand_sub": "Narrativas visuales",
+ "hero_tag": "Crea una exhibición con Telar",
+ "hero_title": "De tus fuentes a una narrativa visual.",
+ "hero_intro": "Planea lo que quieres contar, elige cómo construirlo y crea una exhibición que tus visitantes puedan explorar.",
+ "plan_tag": "Empieza por la historia",
+ "plan_title": "Planea tu exhibición",
+ "plan_text": "Observa tus fuentes con cuidado. Esboza un inicio y un cierre. Conecta tus preguntas con detalles y decide dónde se puede profundizar.",
+ "plan_link": "Empieza a planear",
+ "beginning": "Inicio",
+ "question": "Preguntas y fuentes",
+ "layers": "Capas adicionales",
+ "ending": "Cierre",
+ "build_tag": "Elige cómo trabajar",
+ "build_title": "Construye tu exhibición",
+ "build_intro": "Hay tres formas de crear una exhibición en Telar: usar el editor visual del Compositor, organizar el contenido en Google Sheets o editar archivos CSV y Markdown en tu computador. Las tres generan un sitio Telar; cambian el lugar donde trabajas en el contenido y la forma de previsualizarlo y publicarlo.",
+ "reference_title": "Encuentra una respuesta concreta",
+ "reference_text": "Formatos de contenido, configuración, medios, accesibilidad y solución de problemas. Una referencia común para las tres formas de construir.",
+ "reference_link": "Consulta la referencia",
+ "teach_title": "Enseña y aprende con Telar",
+ "teach_text": "Diapositivas del taller, un planeador narrativo y guías para desarrollar historias visuales en el aula.",
+ "workshop": "Diapositivas del taller",
+ "worksheet": "Descarga el planeador",
+ "examples_title": "Descubre las decisiones detrás de una exhibición",
+ "examples_text": "Explora proyectos terminados para ver cómo se relacionan las fuentes, los detalles de las imágenes y las capas opcionales.",
+ "examples_link": "Explora los proyectos",
+ "outline": "En este capítulo",
+ "planning": "Planear una exhibición",
+ "chapter": "1. Propósito, público y fuentes",
+ "guide_home": "Todas las guías",
+ "back_build": "Elige cómo construir",
+ "footer": "Guías de Telar",
+ "purpose": "Propósito",
+ "audience": "Público",
+ "source": "Fuentes",
+ "exercise": "Pruébalo",
+ "next": "Qué sigue",
+ "nav_prefix": "Contenido de la guía",
+ "book_link": "Borrador del manual del Compositor",
+ "preview_note": "Estructura propuesta · Inglés y español",
+ "site_home": "/?lang=es",
+ "build_guidance": "Elige la forma de trabajo que mejor se adapte a ti y a tu equipo. Cada manual te acompaña desde la configuración hasta una primera historia y luego desarrolla las tareas que siguen. Las guías de planeación y la referencia compartida sirven para las tres."
+ }
+ },
+ "manuals": [
+ {
+ "id": "compositor",
+ "en": {
+ "title": "Compositor",
+ "tag": "Visual authoring",
+ "text": "Work in your browser. Add objects, write stories, capture views, collaborate and publish.",
+ "link": "Read the manual",
+ "href": "/docs/the-compositor/"
+ },
+ "es": {
+ "title": "Compositor",
+ "tag": "Autoría visual",
+ "text": "Trabaja en el navegador. Agrega objetos, escribe historias, captura encuadres, colabora y publica.",
+ "link": "Lee el manual",
+ "href": "/guia/el-compositor/"
+ }
+ },
+ {
+ "id": "sheets",
+ "en": {
+ "title": "Google Sheets",
+ "tag": "Spreadsheet authoring",
+ "text": "Organise objects, steps and text in a spreadsheet, connect it to your site and preview the result.",
+ "link": "Read the manual",
+ "href": "/docs/google-sheets/"
+ },
+ "es": {
+ "title": "Google Sheets",
+ "tag": "Autoría en hojas de cálculo",
+ "text": "Organiza objetos, pasos y textos en una hoja de cálculo, conéctala con tu sitio y revisa el resultado.",
+ "link": "Lee el manual",
+ "href": "/guia/google-sheets/"
+ }
+ },
+ {
+ "id": "local",
+ "en": {
+ "title": "Local authoring & builds",
+ "tag": "Files and a local preview",
+ "text": "Write in CSV and Markdown, build on your own computer, customise the site and choose your hosting.",
+ "link": "Read the manual",
+ "href": "/docs/local-authoring/"
+ },
+ "es": {
+ "title": "Autoría local",
+ "tag": "Archivos y vista previa local",
+ "text": "Escribe en CSV y Markdown, genera el sitio en tu computador, personalízalo y elige dónde alojarlo.",
+ "link": "Lee el manual",
+ "href": "/guia/autoria-local/"
+ }
+ }
+ ],
+ "quick": {
+ "en": {
+ "title": "Workshop quick guide",
+ "intro": "A short route from a source and a question to your first published story, using the Compositor.",
+ "tag": "Keep this open during the workshop",
+ "hub_title": "Here for a workshop?",
+ "hub_text": "Keep the short guide open while you work. Six steps, the essential controls and links when you need more help.",
+ "hub_link": "Open the quick guide",
+ "contents": "The six steps",
+ "saved": "Drafts and publication",
+ "saved_text": "Your edits are saved as you work. Use Publish to send them to the repository and rebuild the public site.",
+ "help": "If you get stuck",
+ "after": "After the workshop",
+ "after_text": "Return to the planning guide, explore the full Compositor manual, or choose Google Sheets or local authoring.",
+ "print": "Print this guide",
+ "shortlink": "Workshop link: telar.org/start",
+ "shortlink_note": "Keep this address to return to the six steps during or after a workshop.",
+ "labels": [
+ "Plan",
+ "Connect",
+ "Add an object",
+ "Write the story",
+ "Frame and add context",
+ "Publish and check"
+ ]
+ },
+ "es": {
+ "title": "Guía rápida para talleres",
+ "intro": "Un recorrido breve, con el Compositor, desde una fuente y una pregunta hasta tu primera historia publicada.",
+ "tag": "Ten esta guía abierta durante el taller",
+ "hub_title": "¿Vienes a un taller?",
+ "hub_text": "Ten la guía breve abierta mientras trabajas. Seis pasos, los controles esenciales y enlaces para cuando necesites más ayuda.",
+ "hub_link": "Abre la guía rápida",
+ "contents": "Los seis pasos",
+ "saved": "Borradores y publicación",
+ "saved_text": "Tus cambios se guardan mientras trabajas. Usa Publicar para enviarlos al repositorio y regenerar el sitio público.",
+ "help": "Si te atascas",
+ "after": "Después del taller",
+ "after_text": "Retoma la guía de planeación, explora el manual completo del Compositor o elige Google Sheets o autoría local.",
+ "print": "Imprime esta guía",
+ "shortlink": "Enlace para talleres: telar.org/empezar",
+ "shortlink_note": "Guarda esta dirección para volver a los seis pasos durante o después de un taller.",
+ "labels": [
+ "Planear",
+ "Conectar",
+ "Agregar un objeto",
+ "Escribir la historia",
+ "Encuadrar y agregar contexto",
+ "Publicar y revisar"
+ ]
+ }
+ },
+ "quick_steps": [
+ {
+ "id": "plan",
+ "en": {
+ "title": "Start with a source and a question",
+ "text": "Choose one source you can share. Write an opening question, a possible ending and two or three questions to connect them.",
+ "link": "Use the narrative planner",
+ "href": "/assets/templates/telar-worksheet.pdf"
+ },
+ "es": {
+ "title": "Empieza con una fuente y una pregunta",
+ "text": "Elige una fuente que puedas compartir. Escribe una pregunta inicial, un posible cierre y dos o tres preguntas para conectarlos.",
+ "link": "Usa el planeador narrativo",
+ "href": "/assets/templates/telar-worksheet.pdf"
+ }
+ },
+ {
+ "id": "connect",
+ "en": {
+ "title": "Open the Compositor and create your site",
+ "text": "<a href=\"https://compositor.telar.org\">Open the Compositor</a> and sign in with GitHub. Follow the setup instructions, choose <strong>Create a new Telar site</strong> and give it a name with lowercase letters and hyphens. If you already have a site, open or connect that one.",
+ "link": "Setup help",
+ "href": "/docs/the-compositor/getting-started/"
+ },
+ "es": {
+ "title": "Abre el Compositor y crea tu sitio",
+ "text": "<a href=\"https://compositor.telar.org\">Abre el Compositor</a> e inicia sesión con GitHub. Sigue las instrucciones, elige <strong>Crear un nuevo sitio Telar</strong> y usa un nombre con letras minúsculas y guiones. Si ya tienes un sitio, ábrelo o conéctalo.",
+ "link": "Ayuda para empezar",
+ "href": "/guia/el-compositor/primeros-pasos/"
+ }
+ },
+ {
+ "id": "object",
+ "en": {
+ "title": "Add your source to Objects",
+ "text": "In <strong>Objects</strong>, choose <strong>+ Add object</strong>. Upload an image with <strong>Upload file</strong>, or use <strong>IIIF manifest</strong> and <strong>Fetch manifest</strong> for an external collection. Review the title, source and credit.",
+ "link": "Try the khipu IIIF example",
+ "href": "/docs/the-compositor/iiif-to-story/"
+ },
+ "es": {
+ "title": "Agrega tu fuente a Objetos",
+ "text": "En <strong>Objetos</strong>, pulsa <strong>+ Agregar objeto</strong>. Sube una imagen con <strong>Subir archivo</strong>, o usa <strong>Manifiesto IIIF</strong> y <strong>Obtener manifiesto</strong> para una colección externa. Revisa el título, la fuente y el crédito.",
+ "link": "Prueba el ejemplo IIIF del khipu",
+ "href": "/guia/el-compositor/iiif-a-historia/"
+ }
+ },
+ {
+ "id": "story",
+ "en": {
+ "title": "Create a short story",
+ "text": "Open <strong>Stories</strong> and choose <strong>+ New Story</strong>. Give it a title, then use <strong>+ Add step</strong> and <strong>Change object</strong> to select your source. Write a question and a brief answer. Repeat for your next questions.",
+ "link": "Read the story walkthrough",
+ "href": "/docs/the-compositor/iiif-to-story/#choose"
+ },
+ "es": {
+ "title": "Crea una historia breve",
+ "text": "Abre <strong>Historias</strong> y elige <strong>+ Nueva historia</strong>. Ponle un título; después, usa <strong>+ Agregar paso</strong> y <strong>Cambiar objeto</strong> para seleccionar la fuente. Escribe una pregunta y una respuesta breve. Repite con las siguientes preguntas.",
+ "link": "Consulta el recorrido de historias",
+ "href": "/guia/el-compositor/iiif-a-historia/#elegir"
+ }
+ },
+ {
+ "id": "frame",
+ "en": {
+ "title": "Frame the detail and offer context",
+ "text": "On each image step, pan and zoom to the detail you want to discuss, then choose <strong>Capture position</strong>. Use <strong>+ Add panel</strong> when a step needs a longer explanation. Keep the main answer short.",
+ "link": "See the framing controls",
+ "href": "/docs/the-compositor/iiif-to-story/#frame"
+ },
+ "es": {
+ "title": "Encuadra el detalle y ofrece contexto",
+ "text": "En cada paso con imagen, desplázala y ajusta el zoom hasta el detalle que quieras comentar; después, pulsa <strong>Capturar posición</strong>. Usa <strong>+ Agregar panel</strong> cuando necesites una explicación más larga. Mantén breve la respuesta principal.",
+ "link": "Mira los controles de encuadre",
+ "href": "/guia/el-compositor/iiif-a-historia/#encuadrar"
+ }
+ },
+ {
+ "id": "publish",
+ "en": {
+ "title": "Publish, then visit the result",
+ "text": "Open <strong>Publish</strong>, review your changes and resolve any blocking errors. Publish and wait for the build to finish. Visit the public story and check its images, framing, text and credits. If the story is marked Draft, it will not appear in the public exhibition.",
+ "link": "Publishing help",
+ "href": "/docs/the-compositor/publishing/"
+ },
+ "es": {
+ "title": "Publica y visita el resultado",
+ "text": "Abre <strong>Publicar</strong>, revisa los cambios y resuelve los errores que impidan publicar. Publica y espera a que termine de generarse el sitio. Visita la historia pública y revisa imágenes, encuadres, textos y créditos. Si la historia está marcada como borrador, no aparecerá en la exhibición pública.",
+ "link": "Ayuda para publicar",
+ "href": "/guia/el-compositor/publicacion/"
+ }
+ }
+ ],
+ "diagram_end_direction": "up"
+}
diff --git a/data/guides_sketch.json b/data/guides_sketch.json
new file mode 100644
index 0000000..7caa676
--- /dev/null
+++ b/data/guides_sketch.json
@@ -0,0 +1,302 @@
+{
+ "copy": {
+ "en": {
+ "guides": "Guides",
+ "explore": "Explore",
+ "teaching": "Teaching",
+ "about": "About",
+ "compositor": "Compositor",
+ "language": "Language",
+ "skip": "Skip to content",
+ "design": "Design sketch",
+ "brand_sub": "Visual storytelling",
+ "hero_tag": "Make an exhibition with Telar",
+ "hero_title": "From your sources to a visual story.",
+ "hero_intro": "Plan what you want to say, choose how to build it, and shape an exhibition your visitors can explore.",
+ "plan_tag": "Start with the story",
+ "plan_title": "Plan your exhibition",
+ "plan_text": "Read your sources closely. Sketch an opening and an ending. Connect your questions to details, then decide where readers can go deeper.",
+ "plan_link": "Start planning",
+ "beginning": "Beginning",
+ "question": "Questions & sources",
+ "layers": "Further layers",
+ "ending": "Ending",
+ "build_tag": "Choose your way of working",
+ "build_title": "Build your exhibition",
+ "build_intro": "Three manuals, each with a first-story walkthrough and focused guides for the work that follows.",
+ "reference_title": "Find a specific answer",
+ "reference_text": "Content formats, configuration, media, accessibility and troubleshooting. Shared reference for all three ways of building.",
+ "reference_link": "Browse current reference",
+ "teach_title": "Teach and learn with Telar",
+ "teach_text": "Use the workshop and narrative planner to develop a story together. A future teaching section can bring together assignments and classroom guides.",
+ "workshop": "Workshop slides",
+ "worksheet": "Download the planner",
+ "examples_title": "See the choices behind an exhibition",
+ "examples_text": "Explore finished projects. The proposed case studies would explain their sources, storyboards and use of layers, with links to the relevant guides.",
+ "examples_link": "Explore projects",
+ "outline": "In this chapter",
+ "planning": "Plan an exhibition",
+ "chapter": "1. Purpose, audience and sources",
+ "guide_home": "All guides",
+ "back_build": "Choose how to build",
+ "footer": "Preview for discussion. The planning chapter is a draft; Sheets, local-authoring and reference links open the current documentation.",
+ "purpose": "Purpose",
+ "audience": "Audience",
+ "source": "Sources",
+ "exercise": "Try it",
+ "next": "What comes next",
+ "nav_prefix": "Guide contents",
+ "book_link": "Compositor manual preview",
+ "preview_note": "Proposed structure · English and Spanish",
+ "site_home": "/"
+ },
+ "es": {
+ "guides": "Guías",
+ "explore": "Explorar",
+ "teaching": "Enseñar",
+ "about": "Acerca de",
+ "compositor": "Compositor",
+ "language": "Idioma",
+ "skip": "Saltar al contenido",
+ "design": "Boceto de diseño",
+ "brand_sub": "Narrativas visuales",
+ "hero_tag": "Crea una exhibición con Telar",
+ "hero_title": "De tus fuentes a una narrativa visual.",
+ "hero_intro": "Planea lo que quieres contar, elige cómo construirlo y crea una exhibición que tus visitantes puedan explorar.",
+ "plan_tag": "Empieza por la historia",
+ "plan_title": "Planea tu exhibición",
+ "plan_text": "Observa tus fuentes con cuidado. Esboza un inicio y un cierre. Conecta tus preguntas con detalles y decide dónde se puede profundizar.",
+ "plan_link": "Empieza a planear",
+ "beginning": "Inicio",
+ "question": "Preguntas y fuentes",
+ "layers": "Capas adicionales",
+ "ending": "Cierre",
+ "build_tag": "Elige cómo trabajar",
+ "build_title": "Construye tu exhibición",
+ "build_intro": "Tres manuales, cada uno con un recorrido para crear tu primera historia y guías para las tareas que siguen.",
+ "reference_title": "Encuentra una respuesta concreta",
+ "reference_text": "Formatos de contenido, configuración, medios, accesibilidad y solución de problemas. Una referencia común para las tres formas de construir.",
+ "reference_link": "Consulta la referencia actual",
+ "teach_title": "Enseña y aprende con Telar",
+ "teach_text": "Usa el taller y el planeador narrativo para desarrollar una historia en grupo. La futura sección de enseñanza puede reunir actividades y guías para el aula.",
+ "workshop": "Diapositivas del taller",
+ "worksheet": "Descarga el planeador",
+ "examples_title": "Descubre las decisiones detrás de una exhibición",
+ "examples_text": "Explora proyectos terminados. Los casos comentados que proponemos explicarían sus fuentes, esquemas narrativos y capas, con enlaces a las guías correspondientes.",
+ "examples_link": "Explora los proyectos",
+ "outline": "En este capítulo",
+ "planning": "Planear una exhibición",
+ "chapter": "1. Propósito, público y fuentes",
+ "guide_home": "Todas las guías",
+ "back_build": "Elige cómo construir",
+ "footer": "Vista previa para conversar. El capítulo de planeación es un borrador; los enlaces de Sheets, autoría local y referencia abren la documentación actual.",
+ "purpose": "Propósito",
+ "audience": "Público",
+ "source": "Fuentes",
+ "exercise": "Pruébalo",
+ "next": "Qué sigue",
+ "nav_prefix": "Contenido de la guía",
+ "book_link": "Borrador del manual del Compositor",
+ "preview_note": "Estructura propuesta · Inglés y español",
+ "site_home": "/?lang=es"
+ }
+ },
+ "manuals": [
+ {
+ "id": "compositor",
+ "en": {
+ "title": "Compositor",
+ "tag": "Visual authoring",
+ "text": "Work in your browser. Add objects, write stories, capture views, collaborate and publish.",
+ "link": "Open the manual preview",
+ "href": "/manual/en/"
+ },
+ "es": {
+ "title": "Compositor",
+ "tag": "Autoría visual",
+ "text": "Trabaja en el navegador. Agrega objetos, escribe historias, captura encuadres, colabora y publica.",
+ "link": "Abre el borrador del manual",
+ "href": "/manual/es/"
+ }
+ },
+ {
+ "id": "sheets",
+ "en": {
+ "title": "Google Sheets",
+ "tag": "Spreadsheet authoring",
+ "text": "Organise objects, steps and text in a spreadsheet, connect it to your site and preview the result.",
+ "link": "Read the current guide",
+ "href": "/docs/getting-started/google-sheets/"
+ },
+ "es": {
+ "title": "Google Sheets",
+ "tag": "Autoría en hojas de cálculo",
+ "text": "Organiza objetos, pasos y textos en una hoja de cálculo, conéctala con tu sitio y revisa el resultado.",
+ "link": "Lee la guía actual",
+ "href": "/guia/primeros-pasos/google-sheets/"
+ }
+ },
+ {
+ "id": "local",
+ "en": {
+ "title": "Local authoring & builds",
+ "tag": "Files and a local preview",
+ "text": "Write in CSV and Markdown, build on your own computer, customise the site and choose your hosting.",
+ "link": "Read the current guide",
+ "href": "/docs/getting-started/local-dev/"
+ },
+ "es": {
+ "title": "Autoría local",
+ "tag": "Archivos y vista previa local",
+ "text": "Escribe en CSV y Markdown, genera el sitio en tu computador, personalízalo y elige dónde alojarlo.",
+ "link": "Lee la guía actual",
+ "href": "/guia/primeros-pasos/desarrollo-local/"
+ }
+ }
+ ],
+ "quick": {
+ "en": {
+ "title": "Workshop quick guide",
+ "intro": "A short route from a source and a question to your first published story, using the Compositor.",
+ "tag": "Keep this open during the workshop",
+ "hub_title": "Here for a workshop?",
+ "hub_text": "Keep the short guide open while you work. Six steps, the essential controls and links when you need more help.",
+ "hub_link": "Open the quick guide",
+ "contents": "The six steps",
+ "saved": "Drafts and publication",
+ "saved_text": "Your edits are saved as you work. Use Publish to send them to the repository and rebuild the public site.",
+ "help": "If you get stuck",
+ "after": "After the workshop",
+ "after_text": "Return to the planning guide, explore the full Compositor manual, or choose Google Sheets or local authoring.",
+ "print": "Print this guide",
+ "shortlink": "Proposed workshop link: telar.org/start",
+ "shortlink_note": "The existing /start shortcut can point here once the guide is reviewed and published.",
+ "labels": [
+ "Plan",
+ "Connect",
+ "Add an object",
+ "Write the story",
+ "Frame and add context",
+ "Publish and check"
+ ]
+ },
+ "es": {
+ "title": "Guía rápida para talleres",
+ "intro": "Un recorrido breve, con el Compositor, desde una fuente y una pregunta hasta tu primera historia publicada.",
+ "tag": "Ten esta guía abierta durante el taller",
+ "hub_title": "¿Vienes a un taller?",
+ "hub_text": "Ten la guía breve abierta mientras trabajas. Seis pasos, los controles esenciales y enlaces para cuando necesites más ayuda.",
+ "hub_link": "Abre la guía rápida",
+ "contents": "Los seis pasos",
+ "saved": "Borradores y publicación",
+ "saved_text": "Tus cambios se guardan mientras trabajas. Usa Publicar para enviarlos al repositorio y regenerar el sitio público.",
+ "help": "Si te atascas",
+ "after": "Después del taller",
+ "after_text": "Retoma la guía de planeación, explora el manual completo del Compositor o elige Google Sheets o autoría local.",
+ "print": "Imprime esta guía",
+ "shortlink": "Enlace propuesto para talleres: telar.org/start",
+ "shortlink_note": "El acceso corto /start puede dirigir aquí cuando revisemos y publiquemos la guía.",
+ "labels": [
+ "Planear",
+ "Conectar",
+ "Agregar un objeto",
+ "Escribir la historia",
+ "Encuadrar y agregar contexto",
+ "Publicar y revisar"
+ ]
+ }
+ },
+ "quick_steps": [
+ {
+ "id": "plan",
+ "en": {
+ "title": "Start with a source and a question",
+ "text": "Choose one source you can share. Write an opening question, a possible ending and two or three questions to connect them.",
+ "link": "Use the narrative planner",
+ "href": "/assets/templates/telar-worksheet.pdf"
+ },
+ "es": {
+ "title": "Empieza con una fuente y una pregunta",
+ "text": "Elige una fuente que puedas compartir. Escribe una pregunta inicial, un posible cierre y dos o tres preguntas para conectarlos.",
+ "link": "Usa el planeador narrativo",
+ "href": "/assets/templates/telar-worksheet.pdf"
+ }
+ },
+ {
+ "id": "connect",
+ "en": {
+ "title": "Open the Compositor and create your site",
+ "text": "<a href=\"https://compositor.telar.org\">Open the Compositor</a> and sign in with GitHub. Follow the setup instructions, choose <strong>Create a new Telar site</strong> and give it a name with lowercase letters and hyphens. If you already have a site, open or connect that one.",
+ "link": "Setup help",
+ "href": "/docs/the-compositor/getting-started/"
+ },
+ "es": {
+ "title": "Abre el Compositor y crea tu sitio",
+ "text": "<a href=\"https://compositor.telar.org\">Abre el Compositor</a> e inicia sesión con GitHub. Sigue las instrucciones, elige <strong>Crear un nuevo sitio Telar</strong> y usa un nombre con letras minúsculas y guiones. Si ya tienes un sitio, ábrelo o conéctalo.",
+ "link": "Ayuda para empezar",
+ "href": "/guia/el-compositor/primeros-pasos/"
+ }
+ },
+ {
+ "id": "object",
+ "en": {
+ "title": "Add your source to Objects",
+ "text": "In <strong>Objects</strong>, choose <strong>+ Add object</strong>. Upload an image with <strong>Upload file</strong>, or use <strong>IIIF manifest</strong> and <strong>Fetch manifest</strong> for an external collection. Review the title, source and credit.",
+ "link": "Try the khipu IIIF example",
+ "href": "/manual/en/iiif-to-story/"
+ },
+ "es": {
+ "title": "Agrega tu fuente a Objetos",
+ "text": "En <strong>Objetos</strong>, pulsa <strong>+ Agregar objeto</strong>. Sube una imagen con <strong>Subir archivo</strong>, o usa <strong>Manifiesto IIIF</strong> y <strong>Obtener manifiesto</strong> para una colección externa. Revisa el título, la fuente y el crédito.",
+ "link": "Prueba el ejemplo IIIF del khipu",
+ "href": "/manual/es/iiif-a-historia/"
+ }
+ },
+ {
+ "id": "story",
+ "en": {
+ "title": "Create a short story",
+ "text": "Open <strong>Stories</strong> and choose <strong>+ New Story</strong>. Give it a title, then use <strong>+ Add step</strong> and <strong>Change object</strong> to select your source. Write a question and a brief answer. Repeat for your next questions.",
+ "link": "Read the story walkthrough",
+ "href": "/manual/en/iiif-to-story/#choose"
+ },
+ "es": {
+ "title": "Crea una historia breve",
+ "text": "Abre <strong>Historias</strong> y elige <strong>+ Nueva historia</strong>. Ponle un título; después, usa <strong>+ Agregar paso</strong> y <strong>Cambiar objeto</strong> para seleccionar la fuente. Escribe una pregunta y una respuesta breve. Repite con las siguientes preguntas.",
+ "link": "Consulta el recorrido de historias",
+ "href": "/manual/es/iiif-a-historia/#elegir"
+ }
+ },
+ {
+ "id": "frame",
+ "en": {
+ "title": "Frame the detail and offer context",
+ "text": "On each image step, pan and zoom to the detail you want to discuss, then choose <strong>Capture position</strong>. Use <strong>+ Add panel</strong> when a step needs a longer explanation. Keep the main answer short.",
+ "link": "See the framing controls",
+ "href": "/manual/en/iiif-to-story/#frame"
+ },
+ "es": {
+ "title": "Encuadra el detalle y ofrece contexto",
+ "text": "En cada paso con imagen, desplázala y ajusta el zoom hasta el detalle que quieras comentar; después, pulsa <strong>Capturar posición</strong>. Usa <strong>+ Agregar panel</strong> cuando necesites una explicación más larga. Mantén breve la respuesta principal.",
+ "link": "Mira los controles de encuadre",
+ "href": "/manual/es/iiif-a-historia/#encuadrar"
+ }
+ },
+ {
+ "id": "publish",
+ "en": {
+ "title": "Publish, then visit the result",
+ "text": "Open <strong>Publish</strong>, review your changes and resolve any blocking errors. Publish and wait for the build to finish. Visit the public story and check its images, framing, text and credits. If the story is marked Draft, it will not appear in the public exhibition.",
+ "link": "Publishing help",
+ "href": "/docs/the-compositor/publishing/"
+ },
+ "es": {
+ "title": "Publica y visita el resultado",
+ "text": "Abre <strong>Publicar</strong>, revisa los cambios y resuelve los errores que impidan publicar. Publica y espera a que termine de generarse el sitio. Visita la historia pública y revisa imágenes, encuadres, textos y créditos. Si la historia está marcada como borrador, no aparecerá en la exhibición pública.",
+ "link": "Ayuda para publicar",
+ "href": "/guia/el-compositor/publicacion/"
+ }
+ }
+ ],
+ "diagram_end_direction": "up"
+}
diff --git a/data/homepage_demo.json b/data/homepage_demo.json
new file mode 100644
index 0000000..2dd2142
--- /dev/null
+++ b/data/homepage_demo.json
@@ -0,0 +1,44 @@
+{
+ "es": {
+ "vimeo": "https://player.vimeo.com/video/1241745045?h=9f98bd213d&badge=0&autopause=0&player_id=0&app_id=58479&autoplay=1&muted=1&loop=1",
+ "poster": "/assets/homepage-demo/posters/es.jpg",
+ "title": "Demostración de Telar",
+ "error": "No se pudo cargar el video.",
+ "watch": "Ver en Vimeo",
+ "summary": [
+ "Objetos: Fuentes para explorar",
+ "Pasos: Preguntas, respuestas e invitaciones",
+ "Paneles: Fuentes e interpretación",
+ "Glosario: Definiciones compartidas entre historias",
+ "Construye tu exhibición con el Compositor de Telar.",
+ "Elige las fuentes y organiza los pasos de la historia.",
+ "Agrega imágenes IIIF externas y sus metadatos.",
+ "Edita los metadatos, organiza los pasos y escribe los paneles.",
+ "Encuadra la imagen y captura la posición de cada paso.",
+ "Colabora en tiempo real.",
+ "Publica tu propio sitio.",
+ "Código abierto. Computación mínima. Tu contenido, en tu propio repositorio."
+ ]
+ },
+ "en": {
+ "vimeo": "https://player.vimeo.com/video/1241792049?h=68f09533de&badge=0&autopause=0&player_id=0&app_id=58479&autoplay=1&muted=1&loop=1",
+ "poster": "/assets/homepage-demo/posters/en.jpg",
+ "title": "Telar demonstration",
+ "error": "The video could not be loaded.",
+ "watch": "Watch on Vimeo",
+ "summary": [
+ "Objects: Sources to explore",
+ "Steps: Questions, answers and invitations",
+ "Panels: Sources and interpretation",
+ "Glossary: Definitions shared across stories",
+ "Build your exhibition with Telar Compositor.",
+ "Choose your sources and arrange your story’s steps.",
+ "Add external IIIF images and their metadata.",
+ "Edit metadata, arrange steps and write panels.",
+ "Frame the image and save the view for each step.",
+ "Collaborate in real time.",
+ "Publish your own site.",
+ "Open source. Minimal computing. Your content, in your own repository."
+ ]
+ }
+}
diff --git a/data/site_copy.json b/data/site_copy.json
new file mode 100644
index 0000000..b746a93
--- /dev/null
+++ b/data/site_copy.json
@@ -0,0 +1,8 @@
+{
+ "en": {
+ "description": "A minimal-computing framework that weaves together IIIF images, audio, video, and texts to create layered visual narratives for digital scholarship, public exhibitions, community storytelling, and classroom projects."
+ },
+ "es": {
+ "description": "Un marco de computación mínima que entreteje imágenes IIIF, audio, video y textos en narrativas visuales por capas para humanidades digitales, exposiciones públicas, narrativa comunitaria y proyectos en el salón de clase."
+ }
+}
diff --git a/data/teaching_contact.json b/data/teaching_contact.json
new file mode 100644
index 0000000..6f27103
--- /dev/null
+++ b/data/teaching_contact.json
@@ -0,0 +1,58 @@
+{
+ "en": {
+ "title": "Request teaching-mode access",
+ "name": "Your name",
+ "email": "Reply email",
+ "github": "GitHub username (optional)",
+ "github_help": "The account you use in the Compositor, if you already have one.",
+ "institution": "Institution or organisation (optional)",
+ "course": "How would you like to use Telar?",
+ "course_help": "A few sentences about your course, workshop or student project are enough.",
+ "privacy": "Your request is shared privately with the Telar team so we can reply.",
+ "send": "Send request",
+ "sending": "Sending…",
+ "success_title": "Your request has been received",
+ "success": "We’ll reply using the email you provided. Teaching access is enabled after the team reviews your request.",
+ "failure": "We couldn’t send your request. Your answers are still in the form; please try again.",
+ "validation": "Please check the highlighted fields.",
+ "verification": "Please complete the verification and try again.",
+ "field_error": "Check this field.",
+ "noscript": "Enable JavaScript to send this form.",
+ "back": "Back to Teaching with Telar",
+ "honeypot": "Leave this field empty",
+ "intro_paragraphs": [
+ "Drawing on our own experience teaching with Telar, we have built a new teaching mode in the Compositor, which we are now testing. It is designed to help educators organise class projects and support students as they create their own visual narratives.",
+ "A Telar project asks students to look closely at sources and turn their research into a narrative for an audience. They select evidence, decide what to show, connect observations and provide the context a reader needs. A project might explore a work of art, trace changes in a landscape through maps and photographs, or bring archival materials and oral histories together in a community exhibition. These assignments offer opportunities to practise interpretation, writing, collaboration and digital publishing, and to produce something students can share and develop beyond the course.",
+ "Use the Compositor with your class: share a collection of objects, let student groups build their own exhibitions and review their sites from one course workspace.",
+ "We would love to share this tool with educators working in different disciplines, institutions and learning environments, and to learn from how you use it. If you would like access, please use the form below to tell us about your course, workshop or student project. We will do our best to reply as quickly as possible."
+ ]
+ },
+ "es": {
+ "title": "Solicita acceso al modo docente",
+ "name": "Tu nombre",
+ "email": "Correo para responderte",
+ "github": "Usuario de GitHub (opcional)",
+ "github_help": "La cuenta con la que entras al Compositor, si ya tienes una.",
+ "institution": "Institución u organización (opcional)",
+ "course": "¿Cómo te gustaría usar Telar?",
+ "course_help": "Bastan unas frases sobre el curso, taller o proyecto estudiantil.",
+ "privacy": "Tu solicitud llega de forma privada al equipo de Telar, para que podamos responderte.",
+ "send": "Enviar solicitud",
+ "sending": "Enviando…",
+ "success_title": "Recibimos tu solicitud",
+ "success": "Te responderemos al correo que indicaste. Habilitamos el acceso al modo docente después de revisar tu solicitud.",
+ "failure": "No pudimos enviar tu solicitud. Lo que escribiste sigue en el formulario: intenta de nuevo.",
+ "validation": "Revisa los campos señalados.",
+ "verification": "Completa la verificación e intenta de nuevo.",
+ "field_error": "Revisa este campo.",
+ "noscript": "Activa JavaScript para enviar este formulario.",
+ "back": "Volver a Enseñar con Telar",
+ "honeypot": "Deja este campo vacío",
+ "intro_paragraphs": [
+ "A partir de lo que hemos aprendido al enseñar con Telar, desarrollamos en el Compositor un nuevo modo docente, que todavía estamos probando. Está pensado para que docentes organicen proyectos de clase y acompañen a los estudiantes mientras crean sus propias narrativas visuales.",
+ "Un proyecto en Telar invita a los estudiantes a observar las fuentes con atención y a convertir su investigación en una narrativa para un público. Eligen la evidencia, deciden qué mostrar, relacionan sus observaciones y dan a quien lee el contexto que necesita. Un proyecto puede explorar una obra de arte, seguir en mapas y fotografías cómo cambia un paisaje o reunir materiales de archivo e historias orales en una exhibición comunitaria. En estas actividades, los estudiantes pueden practicar la interpretación, la escritura, el trabajo colaborativo y la publicación digital, y crear algo para compartir y seguir desarrollando después del curso.",
+ "Con el modo docente puedes usar el Compositor con tu clase: compartir una colección de objetos, dejar que cada grupo de estudiantes cree su propia exhibición y revisar los sitios de todos los grupos desde un mismo espacio de curso.",
+ "Nos encantaría compartir esta herramienta con docentes de distintas disciplinas, instituciones y contextos educativos, y aprender de los usos que le den. Si te interesa obtener acceso, cuéntanos en el formulario de abajo sobre tu curso, taller o proyecto estudiantil. Haremos lo posible por responderte cuanto antes."
+ ]
+ }
+}
diff --git a/docs/1-0-getting-started.es.md b/docs/1-0-getting-started.es.md
deleted file mode 100644
index 2cb60c1..0000000
--- a/docs/1-0-getting-started.es.md
+++ /dev/null
@@ -1,39 +0,0 @@
----
-layout: docs
-title: 1. Primeros pasos
-parent: Documentación
-nav_order: 1
-has_children: true
-lang: es
-permalink: /guia/primeros-pasos/
----
-
-# Primeros pasos
-
-Bienvenido a Telar. Elige el método de configuración que mejor funcione para ti.
-
-<div class="getting-started-cards">
- <a href="/guia/primeros-pasos/compositor/" class="gs-card">
- <h3>Opción A: Usa el Compositor</h3>
- <p>Construye tu exhibición de forma visual — sube imágenes, agrega video y audio, y publica con un clic. Sin necesidad de código ni archivos de configuración.</p>
- <span class="gs-card__cta">Guía del Compositor</span>
- </a>
- <a href="/guia/primeros-pasos/google-sheets/" class="gs-card">
- <h3>Opción B: Configura con Google Sheets</h3>
- <p>Una configuración guiada que usa Google Sheets para gestionar tu contenido. Las herramientas interactivas generan tu configuración automáticamente.</p>
- <span class="gs-card__cta">Guía de Google Sheets</span>
- </a>
- <a href="/guia/primeros-pasos/desarrollo-local/" class="gs-card">
- <h3>Opción C: Desarrollo local</h3>
- <p>Trabaja localmente con archivos CSV y Jekyll. Control total sobre tu contenido y el <em>build</em> del sitio.</p>
- <span class="gs-card__cta">Guía de desarrollo local</span>
- </a>
-</div>
-
-### Después de la configuración
-
-Una vez que tu sitio esté funcionando, continúa con el tutorial:
-
-1. **[Planea tu narrativa](/guia/primeros-pasos/estructura-narrativa/)** — Conoce cómo se articulan historias, pasos y paneles
-2. **[Agrega tu contenido](/guia/primeros-pasos/agrega-contenido/)** — Sube imágenes, video y audio, registra objetos y crea tu primera historia
-3. **[Revisa y perfecciona](/guia/primeros-pasos/revisa-y-perfecciona/)** — Ajusta coordenadas de imagen, revisa tu sitio y dale los toques finales
diff --git a/docs/1-0-getting-started.md b/docs/1-0-getting-started.md
deleted file mode 100644
index 4add706..0000000
--- a/docs/1-0-getting-started.md
+++ /dev/null
@@ -1,39 +0,0 @@
----
-layout: docs
-title: 1. Getting Started
-parent: Documentation
-nav_order: 1
-has_children: true
-lang: en
-permalink: /docs/getting-started/
----
-
-# Getting Started
-
-Welcome to Telar! Choose the setup method that works best for you.
-
-<div class="getting-started-cards">
- <a href="/docs/getting-started/compositor/" class="gs-card">
- <h3>Option A: Use the Compositor</h3>
- <p>Build your exhibition visually — upload images, add video and audio, and publish with one click. No coding or configuration files required.</p>
- <span class="gs-card__cta">Open Compositor Guide</span>
- </a>
- <a href="/docs/getting-started/google-sheets/" class="gs-card">
- <h3>Option B: Set Up with Google Sheets</h3>
- <p>A guided setup that uses Google Sheets to manage your content. Interactive tools generate your configuration automatically.</p>
- <span class="gs-card__cta">Google Sheets Guide</span>
- </a>
- <a href="/docs/getting-started/local-dev/" class="gs-card">
- <h3>Option C: Local Development</h3>
- <p>Work locally with CSV files and Jekyll. Full control over your content and build process.</p>
- <span class="gs-card__cta">Local Dev Guide</span>
- </a>
-</div>
-
-### After setup
-
-Once your site is running, continue with the tutorial:
-
-1. **[Plan Your Narrative](/docs/getting-started/narrative-structure/)** — Understand how stories, steps, and panels fit together
-2. **[Add Your Content](/docs/getting-started/add-content/)** — Upload images, video, and audio, register objects, and create your first story
-3. **[Review and Refine](/docs/getting-started/review-refine/)** — Set image coordinates, review your site, and polish
diff --git a/docs/1-3-local-dev.es.md b/docs/1-3-local-dev.es.md
deleted file mode 100644
index 95287a9..0000000
--- a/docs/1-3-local-dev.es.md
+++ /dev/null
@@ -1,306 +0,0 @@
----
-layout: docs
-title: "1.3. Opción C: Desarrollo local"
-parent: 1. Primeros pasos
-grand_parent: Documentación
-nav_order: 3
-lang: es
-permalink: /guia/primeros-pasos/desarrollo-local/
----
-
-# Desarrollo local
-
-Trabaja completamente en tu computadora con archivos CSV y un servidor Jekyll local. Sin Google Sheets ni GitHub.
-
-## Descripción general
-
-Este flujo de trabajo te da control total sobre el *build*. Editas archivos CSV y Markdown directamente, previsualizas los cambios al instante y publicas cuando estés listo. Es ideal para:
-
-- **Cursos de humanidades digitales** — enseñar control de versiones, sitios estáticos y datos estructurados junto con la creación de contenido
-- **Personas con experiencia técnica** — cualquiera que prefiera editores de texto y la línea de comandos a hojas de cálculo
-- **Trabajo sin conexión** — construye el sitio y previsualízalo sin necesidad de internet
-
-## Requisitos previos
-
-- Ruby 3.2+ (para Jekyll)
-- Bundler
-- Python 3.9+ (para generación IIIF)
-- Node.js 18+ (para empaquetado de JavaScript)
-
-## Instalación
-
-### Instala Ruby y Bundler
-
-**macOS (usando Homebrew):**
-```bash
-brew install ruby
-gem install bundler
-```
-
-**Ubuntu/Debian:**
-```bash
-sudo apt-get install ruby-full build-essential
-gem install bundler
-```
-
-Si el paquete de tu distribución instala una versión anterior, verifícalo con
-`ruby -v` e instala Ruby 3.2 o superior con un gestor de versiones.
-
-### Clona y configura
-
-```bash
-# Clona el repositorio
-git clone https://github.com/UCSB-AMPLab/telar.git
-cd telar
-
-# Instala dependencias de Ruby
-bundle install
-
-# Instala dependencias de Python (para generación IIIF)
-pip install -r requirements.txt
-
-# Instala dependencias de Node.js (para empaquetado de JavaScript)
-npm install
-```
-
-### Configura ajustes del sitio
-
-Edita `_config.yml`:
-```yaml
-title: Título de tu Narrativa
-description: Una breve descripción
-baseurl: "/nombre-de-tu-repositorio" # Para GitHub Pages, o "" para dominio raíz
-url: "https://tu-usuario.github.io"
-author: Tu Nombre
-email: tu-email@ejemplo.com
-```
-
-## Comandos principales
-
-A lo largo de tu flujo de trabajo, usarás estos comandos:
-
-```bash
-# Convierte CSVs a JSON (ejecuta después de editar CSVs)
-python3 scripts/csv_to_json.py
-
-# Genera teselas IIIF (ejecuta después de agregar/actualizar imágenes)
-python3 scripts/generate_iiif.py --base-url http://localhost:4001
-
-# Sirve con recarga automática
-bundle exec jekyll serve --livereload --port 4001
-
-# Ver en http://localhost:4001
-```
-
-{: .note }
-> **Aquí las historias privadas se previsualizan en texto plano.** Ni `bundle exec jekyll serve` ni el modo de servir por defecto de `build_local_site.py` ejecutan el paso de encriptación — Jekyll regenera `_site` continuamente mientras sirve el sitio, y la encriptación corre una sola vez, cuando un *build* termina. Si tu sitio tiene una historia marcada `private: yes`, verás su contenido a la vista al previsualizar así; es el comportamiento esperado. Para previsualizar el comportamiento bloqueado que vería una persona visitante, ejecuta `python3 scripts/build_local_site.py --build-only` y sirve el `_site/` resultante con un servidor de archivos estáticos. Consulta [Historias privadas](/guia/funciones/historias-privadas/) para más detalles.
-
-## Flujo de trabajo paso a paso
-
-### Paso 1: reúne tus imágenes
-
-Elige una de dos opciones:
-
-**Opción A: sube tus propias imágenes**
-
-1. Agrega imágenes de alta resolución al directorio `telar-content/objects/`
-2. Nombra archivos para que coincidan con IDs de objeto (ej., `textile-001.jpg`)
-3. Genera teselas IIIF:
- ```bash
- python3 scripts/generate_iiif.py --base-url http://localhost:4001
- ```
-
-**Opción B: usa manifiestos IIIF externos**
-
-1. Encuentra recursos IIIF ([Guía IIIF](https://iiif.io/guides/finding_resources/))
-2. Copia la URL info.json
-3. Crea un object_id (ej., `museum-textile-001`)
-4. Guarda para el siguiente paso
-
-### Paso 2: escribe tu texto narrativo
-
-Crea archivos Markdown para las capas de tu historia:
-
-1. Crea directorio para tu historia:
- ```bash
- mkdir -p telar-content/texts/stories/story1
- ```
-
-2. Crea archivos Markdown (ej., `paso1-capa1.md`, `paso1-capa2.md`)
-
-3. Agrega frontmatter y contenido:
- ```markdown
- ---
- title: "Técnicas de Tejido"
- ---
-
- El patrón de urdimbre entrelazada visible aquí indica...
- ```
-
-### Paso 3: cataloga tus objetos
-
-Agrega metadatos al catálogo de objetos:
-
-1. Edita `telar-content/spreadsheets/objects.csv`
-2. Agrega una fila para cada objeto:
-
-**Para imágenes subidas:**
-```csv
-textile-001,Fragmento de Textil Colonial,"Un textil tejido de...",Artista Desconocido,circa 1650-1700,Lana,45 x 60 cm,,,
-```
-
-**Para IIIF externo:**
-```csv
-museum-textile-001,Fragmento de Textil Colonial,"Un textil tejido de...",Artista Desconocido,circa 1650-1700,Lana,45 x 60 cm,,https://example.org/iiif/image/abc123/info.json,
-```
-
-3. Convierte a JSON:
- ```bash
- python3 scripts/csv_to_json.py
- ```
-
-### Paso 4: previsualiza tus objetos
-
-Construye y ve tu sitio:
-
-```bash
-bundle exec jekyll serve --livereload
-```
-
-Luego:
-1. Visita `http://localhost:4001`
-2. Haz clic en "Objects" en la navegación
-3. Verifica que todas las imágenes aparezcan con sus metadatos
-
-### Paso 5: encuentra coordenadas para momentos de historia
-
-Usa la herramienta de identificación de coordenadas:
-
-1. Navega a una página de objeto: `http://localhost:4001/objects/{object_id}`
-2. Haz clic en el botón **Identify coordinates**
-3. Desplaza y amplía al área que quieres destacar
-4. Haz clic en **Copy entire row** para plantilla CSV con coordenadas
-
-### Paso 6: construye tu historia
-
-Conecta tu narrativa a tus objetos:
-
-1. Crea archivo CSV en `telar-content/spreadsheets/` (ej., `story-1.csv`)
-
-2. Agrega fila de encabezado:
- ```csv
- step,question,answer,object,x,y,zoom,layer1_button,layer1_file,layer2_button,layer2_file
- ```
-
-3. Agrega pasos de historia:
- ```csv
- 1,"¿Qué es este textil?","Este fragmento muestra...","textile-001",0.5,0.5,1.0,"","story1/paso1-capa1.md","",""
- 2,"Nota el patrón","Los motivos geométricos...","textile-001",0.3,0.4,2.5,"","story1/paso2-capa1.md","",""
- ```
-
-4. Agrega a configuración del proyecto:
- - Edita `telar-content/spreadsheets/project.csv`
- - Desplázate a la sección `STORIES`
- - Agrega fila: `1,Título de tu Historia`
-
-5. Convierte a JSON:
- ```bash
- python3 scripts/csv_to_json.py
- ```
-
-6. Reconstruye y prueba:
- ```bash
- bundle exec jekyll serve
- ```
-
-### Paso 7: agrega términos del glosario (opcional)
-
-Mejora tu narrativa con definiciones de términos:
-
-1. Crea archivo Markdown en `telar-content/texts/glossary/` (ej., `periodo-colonial.md`)
-
-2. Agrega frontmatter y definición:
- ```markdown
- ---
- term_id: periodo-colonial
- title: "Período Colonial"
- related_terms: encomienda,virreinato
- ---
-
- El Período Colonial en las Américas comenzó con...
- ```
-
-3. Genera colección:
- ```bash
- python3 scripts/generate_collections.py
- ```
-
-4. Construye y prueba:
- ```bash
- bundle exec jekyll serve
- ```
-
-## Flujo de trabajo de desarrollo diario
-
-Cuando trabajes en tu sitio, puedes usar el script todo-en-uno que construye el sitio o ejecutar los comandos uno por uno.
-
-**Usando el script todo-en-uno (recomendado):**
-
-```bash
-# Volver a construir todo el sitio y servirlo localmente
-python3 scripts/build_local_site.py
-
-# Volver a construir más rápido, sin generar las teselas IIIF ni descargar los datos de Google Sheets (cuando las imágenes y las hojas no han cambiado)
-python3 scripts/build_local_site.py --skip-iiif --skip-fetch
-```
-
-**Flujo de trabajo manual:**
-
-```bash
-# 1. Edita contenido
-# - CSVs en telar-content/spreadsheets/
-# - Markdown en telar-content/texts/
-# - Imágenes en telar-content/objects/
-
-# 2. Convierte CSVs a JSON (después de editar CSVs)
-python3 scripts/csv_to_json.py
-
-# 3. Genera colecciones de Jekyll
-python3 scripts/generate_collections.py
-
-# 4. Genera teselas IIIF (después de agregar/actualizar imágenes)
-python3 scripts/generate_iiif.py --base-url http://localhost:4001
-
-# 5. Sirve con recarga automática
-bundle exec jekyll serve --livereload
-
-# Comandos adicionales:
-# Construir solamente (salida a _site/)
-bundle exec jekyll build
-
-# Borrar los archivos generados al construir el sitio
-bundle exec jekyll clean
-```
-
-## Publicación en GitHub Pages
-
-Una vez que estés satisfecho con tu sitio local:
-
-1. Confirma y empuja cambios a GitHub:
- ```bash
- git add .
- git commit -m "Actualizar contenido"
- git push origin main
- ```
-
-2. GitHub Actions construirá y publicará automáticamente
-
-3. Ve tu sitio en vivo en `https://[usuario].github.io/[repositorio]/`
-
-## Próximos pasos
-
-- [Conoce tu contenido](/guia/tu-contenido/) — Cómo Telar organiza los archivos
-- [Imágenes autoalojadas](/guia/tu-contenido/imagenes-autoalojadas/) — Sube y procesa tus propias imágenes
-- [Imágenes IIIF externas](/guia/tu-contenido/iiif-externo/) — Usa imágenes de museos y bibliotecas
-- [Configuración](/guia/configurar/configuracion/) — Todas las opciones de `_config.yml`
-- [Personaliza tu tema](/guia/personalizacion/temas/)
diff --git a/docs/1-3-local-dev.md b/docs/1-3-local-dev.md
deleted file mode 100644
index f20c3fe..0000000
--- a/docs/1-3-local-dev.md
+++ /dev/null
@@ -1,327 +0,0 @@
----
-layout: docs
-title: "1.3. Option C: Local Development"
-parent: 1. Getting Started
-grand_parent: Documentation
-nav_order: 3
-lang: en
-permalink: /docs/getting-started/local-dev/
----
-
-# Local Development
-
-Work entirely on your computer with CSV files and a local Jekyll server. No Google Sheets or GitHub required.
-
-## Overview
-
-This workflow gives you full control over the build process. You edit CSV and markdown files directly, preview changes instantly, and publish when ready. It is ideal for:
-
-- **Digital humanities courses** — teaching version control, static sites, and structured data alongside content creation
-- **Power users** — anyone who prefers text editors and the command line over spreadsheets
-- **Offline work** — build and preview without an internet connection
-
-## Prerequisites
-
-- Ruby 3.2+ (for Jekyll)
-- Bundler
-- Python 3.9+ (for IIIF generation)
-- Node.js 18+ (for JavaScript bundling)
-
-## Installation
-
-### Install Ruby and Bundler
-
-**macOS (using Homebrew):**
-```bash
-brew install ruby
-gem install bundler
-```
-
-**Ubuntu/Debian:**
-```bash
-sudo apt-get install ruby-full build-essential
-gem install bundler
-```
-
-If your distribution's package installs an older Ruby, check with `ruby -v` and
-install 3.2 or newer with a version manager instead.
-
-### Clone and Setup
-
-```bash
-# Clone the repository
-git clone https://github.com/UCSB-AMPLab/telar.git
-cd telar
-
-# Install Ruby dependencies
-bundle install
-
-# Install Python dependencies (for IIIF generation)
-pip install -r requirements.txt
-
-# Install Node.js dependencies (for JavaScript bundling)
-npm install
-```
-
-### Configure Site Settings
-
-Edit `_config.yml`:
-```yaml
-title: Your Narrative Title
-description: A brief description
-baseurl: "/your-repository-name" # For GitHub Pages, or "" for root
-url: "https://your-username.github.io"
-author: Your Name
-email: your-email@example.com
-```
-
-## Core Commands
-
-**Quick start (recommended):**
-
-```bash
-# Build and serve everything with one command
-python3 scripts/build_local_site.py
-
-# View at http://localhost:4001
-```
-
-The build script handles all steps automatically. Use `--skip-iiif` for faster rebuilds when images haven't changed.
-
-**Manual commands** (if you prefer granular control):
-
-```bash
-# Convert CSVs to JSON (run after editing CSVs)
-python3 scripts/csv_to_json.py
-
-# Generate Jekyll collections
-python3 scripts/generate_collections.py
-
-# Generate IIIF tiles (run after adding/updating images)
-python3 scripts/generate_iiif.py --base-url http://localhost:4001
-
-# Serve with live reload
-bundle exec jekyll serve --livereload --port 4001
-
-# View at http://localhost:4001
-```
-
-{: .note }
-> **Private stories preview as plaintext here.** `bundle exec jekyll serve` and
-> `build_local_site.py`'s default serve mode never run the encryption step — Jekyll keeps
-> regenerating `_site` while serving, and encryption only runs once, after a build finishes. If
-> your site has a story marked `private: yes`, you will see its content in plain view while
-> previewing locally this way; this is expected. To preview the locked behavior a visitor would
-> see, run `python3 scripts/build_local_site.py --build-only`, then serve the resulting `_site/`
-> directory with a static file server. See [Private Stories](/docs/site-features/private-stories/)
-> for details.
-
-## Step-by-Step Workflow
-
-### Step 1: Gather Your Images
-
-Choose one of two options:
-
-**Option A: Upload Your Own Images**
-
-1. Add high-res images to `telar-content/objects/` directory
-2. Name files to match object IDs (e.g., `textile-001.jpg`)
-3. Generate IIIF tiles:
- ```bash
- python3 scripts/generate_iiif.py --base-url http://localhost:4001
- ```
-
-**Option B: Use External IIIF Manifests**
-
-1. Find IIIF resources ([IIIF Guide](https://iiif.io/guides/finding_resources/))
-2. Copy the info.json URL
-3. Create an object_id (e.g., `museum-textile-001`)
-4. Save for next step
-
-### Step 2: Write Your Narrative Text
-
-Create markdown files for your story layers:
-
-1. Create directory for your story:
- ```bash
- mkdir -p telar-content/texts/stories/story1
- ```
-
-2. Create markdown files (e.g., `step1-layer1.md`, `step1-layer2.md`)
-
-3. Add frontmatter and content:
- ```markdown
- ---
- title: "Weaving Techniques"
- ---
-
- The interlocking warp pattern visible here indicates...
- ```
-
-### Step 3: Catalog Your Objects
-
-Add metadata to the objects catalog:
-
-1. Edit `telar-content/spreadsheets/objects.csv`
-2. Add a row for each object:
-
-**For uploaded images:**
-```csv
-textile-001,Colonial Textile Fragment,"A woven textile from...",Unknown Artist,circa 1650-1700,Wool,45 x 60 cm,,,
-```
-
-**For external IIIF:**
-```csv
-museum-textile-001,Colonial Textile Fragment,"A woven textile from...",Unknown Artist,circa 1650-1700,Wool,45 x 60 cm,,https://example.org/iiif/image/abc123/info.json,
-```
-
-3. Convert to JSON:
- ```bash
- python3 scripts/csv_to_json.py
- ```
-
-### Step 4: Preview Your Objects
-
-Build and view your site:
-
-```bash
-bundle exec jekyll serve --livereload
-```
-
-Then:
-1. Visit `http://localhost:4001`
-2. Click "Objects" in the navigation
-3. Verify all images appear with their metadata
-
-### Step 5: Find Coordinates for Story Moments
-
-Use the coordinate identification tool:
-
-1. Navigate to an object page: `http://localhost:4001/objects/{object_id}`
-2. Click **Identify coordinates** button
-3. Pan and zoom to the area you want to feature
-4. Click **Copy entire row** for CSV template with coordinates
-
-### Step 6: Build Your Story
-
-Connect your narrative to your objects:
-
-1. Create CSV file in `telar-content/spreadsheets/` (e.g., `story-1.csv`)
-
-2. Add header row:
- ```csv
- step,question,answer,object,x,y,zoom,layer1_button,layer1_file,layer2_button,layer2_file
- ```
-
-3. Add story steps:
- ```csv
- 1,"What is this textile?","This fragment shows...","textile-001",0.5,0.5,1.0,"","story1/step1-layer1.md","",""
- 2,"Notice the pattern","The geometric motifs...","textile-001",0.3,0.4,2.5,"","story1/step2-layer1.md","",""
- ```
-
-4. Add to project setup:
- - Edit `telar-content/spreadsheets/project.csv`
- - Scroll to `STORIES` section
- - Add row: `1,Your Story Title`
-
-5. Convert to JSON:
- ```bash
- python3 scripts/csv_to_json.py
- ```
-
-6. Rebuild and test:
- ```bash
- bundle exec jekyll serve
- ```
-
-### Step 7: Add Glossary Terms (Optional)
-
-Enhance your narrative with term definitions:
-
-1. Create markdown file in `telar-content/texts/glossary/` (e.g., `colonial-period.md`)
-
-2. Add frontmatter and definition:
- ```markdown
- ---
- term_id: colonial-period
- title: "Colonial Period"
- related_terms: encomienda,viceroyalty
- ---
-
- The Colonial Period in the Americas began with...
- ```
-
-3. Generate collection:
- ```bash
- python3 scripts/generate_collections.py
- ```
-
-4. Build and test:
- ```bash
- bundle exec jekyll serve
- ```
-
-## Daily Development Workflow
-
-When working on your site:
-
-**Using the build script (recommended):**
-
-```bash
-# Full rebuild and serve
-python3 scripts/build_local_site.py
-
-# Quick rebuild (skip IIIF tiles and the Google Sheets fetch when nothing there has changed)
-python3 scripts/build_local_site.py --skip-iiif --skip-fetch
-```
-
-**Manual workflow:**
-
-```bash
-# 1. Edit content
-# - CSVs in telar-content/spreadsheets/
-# - Markdown in telar-content/texts/
-# - Images in telar-content/objects/
-
-# 2. Convert CSVs to JSON (after editing CSVs)
-python3 scripts/csv_to_json.py
-
-# 3. Generate Jekyll collections
-python3 scripts/generate_collections.py
-
-# 4. Generate IIIF tiles (after adding/updating images)
-python3 scripts/generate_iiif.py --base-url http://localhost:4001
-
-# 5. Serve with live reload
-bundle exec jekyll serve --livereload
-
-# Additional commands:
-# Build only (output to _site/)
-bundle exec jekyll build
-
-# Clean build artifacts
-bundle exec jekyll clean
-```
-
-## Deploying to GitHub Pages
-
-Once you're happy with your local site:
-
-1. Commit and push changes to GitHub:
- ```bash
- git add .
- git commit -m "Update content"
- git push origin main
- ```
-
-2. GitHub Actions will automatically build and deploy
-
-3. View your live site at `https://[username].github.io/[repository]/`
-
-## Next Steps
-
-- [Your Content](/docs/your-content/) — How Telar organizes files
-- [Self-Hosted Images](/docs/your-content/self-hosted-images/) — Upload and process your own images
-- [External IIIF Images](/docs/your-content/external-iiif/) — Use images from museums and libraries
-- [Configuration](/docs/configure/configuration/) — All `_config.yml` options
-- [Customize Your Theme](/docs/customization/themes/)
diff --git a/docs/1-4-narrative-structure.es.md b/docs/1-4-narrative-structure.es.md
deleted file mode 100644
index 4afa402..0000000
--- a/docs/1-4-narrative-structure.es.md
+++ /dev/null
@@ -1,55 +0,0 @@
----
-layout: docs
-title: 1.4. Planea tu narrativa
-parent: 1. Primeros pasos
-grand_parent: Documentación
-nav_order: 4
-lang: es
-permalink: /guia/primeros-pasos/estructura-narrativa/
-tutorial_prev:
- title: "Primeros pasos"
- url: /guia/primeros-pasos/
-tutorial_next:
- title: "Agrega tu contenido"
- url: /guia/primeros-pasos/agrega-contenido/
----
-
-# Paso 2: Planea tu narrativa
-
-Entender el modelo narrativo de Telar te ayudará a planificar tu contenido de manera efectiva.
-
-Cada página en tu sitio Telar contiene una o más historias, que pueden ser narrativas independientes o capítulos de una pieza más larga. Las historias se desarrollan a través de pasos sucesivos que muestran una imagen (o un detalle de una imagen) junto con un texto breve.
-
-## El patrón pregunta/respuesta/invitación
-
-Cada paso sigue este patrón:
-
-- **Pregunta**: Atrae a los espectadores con un encabezado convincente
-- **Respuesta**: Una breve respuesta de 1-2 oraciones
-- **Invitación**: "Conoce más" abre un panel de contenido con información extendida
-
-Puedes proporcionar hasta dos paneles adicionales de contenido en cada paso, permitiendo a los espectadores que quieran obtener más detalle.
-
-## Paneles en capas
-
-Los paneles en capas son donde realmente puedes expandir tu narrativa. Están escritos en [formato Markdown](https://www.markdownguide.org/getting-started/), permitiéndote incluir:
-
-- Encabezados, texto en negrita e itálica
-- Enlaces y listas
-- Imágenes adicionales
-- Videos incrustados o modelos 3D
-
-## Planea tu historia
-
-Antes de comenzar a reunir materiales o construir tu sitio, toma tiempo para esbozar la estructura de tu historia:
-
-1. ¿Qué historias quieres contar?
-2. ¿Cuáles son los momentos clave en cada historia?
-3. ¿Qué imagen o imágenes anclarán cada paso?
-4. ¿Qué información pertenece a la respuesta breve y qué a las capas más profundas?
-
-Planificar esto en papel o en una herramienta digital facilitará mucho la implementación.
-
-{: .tip }
-> **Consejo: Inspírate**
-> Navega el [sitio de ejemplo](https://ampl.clair.ucsb.edu/telar) para ver esta estructura en acción.
diff --git a/docs/1-4-narrative-structure.md b/docs/1-4-narrative-structure.md
deleted file mode 100644
index 95905ba..0000000
--- a/docs/1-4-narrative-structure.md
+++ /dev/null
@@ -1,56 +0,0 @@
----
-layout: docs
-title: 1.4. Plan Your Narrative
-parent: 1. Getting Started
-grand_parent: Documentation
-nav_order: 4
-lang: en
-permalink: /docs/getting-started/narrative-structure/
-tutorial_prev:
- title: "Getting Started"
- url: /docs/getting-started/
-tutorial_next:
- title: "Add Your Content"
- url: /docs/getting-started/add-content/
----
-
-# Plan Your Narrative
-
-Understanding Telar's narrative model will help you plan your content effectively.
-
-Each page in your Telar site contains one or more stories, which can be independent or related narratives. Stories unfold through successive steps that show an image (or a detail of an image) alongside a brief text.
-
-## The Question/Answer/Invitation Pattern
-
-Each step follows this pattern:
-
-- **Question**: Draws viewers in with a compelling heading
-- **Answer**: A brief 1-2 sentence response
-- **Invitation**: "Learn more" opens a layer panel with extended information
-
-You can provide up to two layer panels in each step to give viewers further information.
-
-## Layered Panels
-
-Layer panels are where you can expand on your narrative. They are written in [markdown format](https://www.markdownguide.org/getting-started/), allowing you to include:
-
-- Headings, bold and italic text
-- Links and lists
-- Additional images
-- Embedded videos or 3D renderings
-
-## Planning Your Story
-
-Before you start gathering materials or building your site, take time to sketch out your story's structure:
-
-1. What stories do you want to tell?
-2. What are the key moments in each story?
-3. What images or details will anchor each step in the story?
-4. What information belongs in the brief answer and what in the panel layers?
-
-Drafting these answers and panels will make the implementation much easier.
-
-{: .tip }
-
-> **Tip: Get Inspired**
-> Browse the [example site](https://ampl.clair.ucsb.edu/telar) to see this structure in action.
diff --git a/docs/1-5-add-content.es.md b/docs/1-5-add-content.es.md
deleted file mode 100644
index 1b28de6..0000000
--- a/docs/1-5-add-content.es.md
+++ /dev/null
@@ -1,115 +0,0 @@
----
-layout: docs
-title: 1.5. Agrega tu contenido
-parent: 1. Primeros pasos
-grand_parent: Documentación
-nav_order: 5
-lang: es
-permalink: /guia/primeros-pasos/agrega-contenido/
-tutorial_prev:
- title: "Planea tu narrativa"
- url: /guia/primeros-pasos/estructura-narrativa/
-tutorial_next:
- title: "Revisa y perfecciona"
- url: /guia/primeros-pasos/revisa-y-perfecciona/
----
-
-# Agrega tu contenido
-
-Tu sitio está configurado. Ahora es momento de agregar tus imágenes, videos y archivos de audio, y construir tus historias. La forma de ingresar tu contenido depende del método de configuración que elegiste, pero la estructura es la misma en todos los casos.
-
-## Agrega tus archivos multimedia
-
-Los objetos en Telar pueden ser imágenes, videos o archivos de audio. Telar admite dos formas de incluirlos:
-
-**Opción A: Sube tus propias imágenes**
-
-1. En tu repositorio de GitHub, navega a `telar-content/objects/`
-2. Haz clic en **Add file** → **Upload files**
-3. Arrastra tus imágenes al área de carga
-4. Nombra cada archivo de forma sencilla, sin espacios (ej., `textile-001.jpg`, `map-lima.jpg`)
-5. Haz clic en **Commit changes** para guardar
-
-El nombre del archivo (sin la extensión) se convierte en el `object_id` del objeto — lo usarás en tu hoja de cálculo.
-
-
-
-
-{: .warning }
-> **Límites de tamaño**
-> Imágenes individuales: hasta 100 MB. Repositorio total: procura mantenerlo por debajo de 1 GB.
-
-**Opción B: Usa imágenes IIIF de museos y bibliotecas**
-
-Muchas instituciones ofrecen imágenes de alta resolución a través del estándar IIIF. Puedes usarlas directamente sin descargar nada.
-
-1. Encuentra recursos IIIF de instituciones como la Biblioteca del Congreso, la British Library o el Smithsonian ([Guía IIIF para encontrar recursos](https://iiif.io/guides/finding_resources/))
-2. Copia la URL del manifiesto (ej., `https://example.org/iiif/manifest.json`)
-3. En la pestaña de objetos de tu hoja de cálculo, agrega una fila y pega la URL en la columna `source_url`
-
-
-
-## Registra tus objetos
-
-Una vez que tus archivos estén en el repositorio, regístralos como objetos para que Telar los reconozca. Cada objeto necesita:
-
-- **`object_id`** — un identificador sencillo (coincide con el nombre del archivo para imágenes subidas, o cualquier nombre para imágenes IIIF)
-- **`title`** — el nombre visible
-- **`description`** — una descripción breve (opcional, pero ayuda con la búsqueda)
-- **`source_url`** — la URL del manifiesto IIIF (deja en blanco para imágenes subidas)
-- **`creator`**, **`year`**, **`object_type`**, **`subjects`** — metadatos para el filtrado de la galería (todos opcionales)
-
-Dónde ingresas estos datos depende de tu método de configuración:
-- **Compositor** — agrega objetos en la pestaña de Objetos
-- **Google Sheets** — agrega filas en la pestaña **objects** de tu hoja de cálculo
-- **CSV** — agrega filas a `objects.csv`
-
-{: .tip }
-> **Omitir filas y columnas**
-> Agrega un `#` al inicio de cualquier fila o encabezado de columna para que Telar lo ignore. Útil para notas y pendientes.
-
-## Estructura tu historia
-
-Cada historia es una secuencia de pasos. Ya sea que estés agregando filas en una hoja de cálculo, editando un CSV, o usando el editor visual del Compositor, cada paso necesita:
-
-| Columna | Qué hace |
-|---------|----------|
-| `step` | Número del paso (1, 2, 3...) |
-| `object` | Qué objeto mostrar (el `object_id` de la pestaña de objetos) |
-| `x`, `y`, `zoom` | Dónde enfocar en la imagen — usa `0.5, 0.5, 1.0` como punto de partida |
-| `clip` | Tiempos de inicio y fin para clips de video/audio (ej., `00:30-01:15`) |
-| `question` | El encabezado de este paso (ej., "¿Qué es este textil?") |
-| `answer` | Una respuesta breve de 1-2 oraciones |
-
-Esto es suficiente para crear una historia funcional. Cada paso muestra una imagen (o reproduce un clip de video/audio) con una pregunta y respuesta que guían a quien la ve a través de tu narrativa.
-
-## Agrega paneles de detalle
-
-Para los pasos donde quieras compartir más que una respuesta breve, agrega contenido en las columnas de paneles:
-
-| Columna | Qué hace |
-|---------|----------|
-| `layer1_content` | Panel "Saber más" — más detalle sobre este paso |
-| `layer2_content` | Panel "Profundizar más" — aún más profundidad |
-| `layer1_button` | Texto personalizado del botón (deja en blanco para "Saber más") |
-| `layer2_button` | Texto personalizado del botón (deja en blanco para "Profundizar más") |
-
-Escribe tu texto directamente en la celda. Puedes usar formato básico de Markdown: `**negrita**`, `*cursiva*` y encabezados con `##`.
-
-{: .tip }
-> **Mantenlo sencillo**
-> Para la mayoría de las historias, las columnas de pregunta y respuesta más una capa de paneles de detalle es suficiente. Siempre puedes agregar más profundidad después.
-
-## Registra tus historias
-
-En los datos de tu proyecto, lista cada historia con su título y subtítulo.
-
-## Construye tu sitio
-
-Después de hacer cambios en tu contenido:
-
-- **Compositor** — exporta y sube tu sitio actualizado a GitHub
-- **Google Sheets** — ve a la pestaña **Actions** de tu repositorio, haz clic en **Build and Deploy** y luego en **Run workflow**
-- **Desarrollo local** — construye localmente con Jekyll y luego sube a GitHub
-
-Espera de 2 a 5 minutos para que GitHub Pages publique la nueva versión.
diff --git a/docs/1-5-add-content.md b/docs/1-5-add-content.md
deleted file mode 100644
index f6ed5a5..0000000
--- a/docs/1-5-add-content.md
+++ /dev/null
@@ -1,115 +0,0 @@
----
-layout: docs
-title: 1.5. Add Your Content
-parent: 1. Getting Started
-grand_parent: Documentation
-nav_order: 5
-lang: en
-permalink: /docs/getting-started/add-content/
-tutorial_prev:
- title: "Plan Your Narrative"
- url: /docs/getting-started/narrative-structure/
-tutorial_next:
- title: "Review and Refine"
- url: /docs/getting-started/review-refine/
----
-
-# Add Your Content
-
-Your site is set up. Now it's time to add your images, videos, and audio files and build your stories. How you enter your content depends on which setup method you chose — but the structure is the same regardless.
-
-## Add Your Media
-
-Objects in Telar can be images, videos, or audio files. Telar supports two ways to include them:
-
-**Option A: Upload your own images**
-
-1. In your GitHub repository, navigate to `telar-content/objects/`
-2. Click **Add file** → **Upload files**
-3. Drag your images into the upload area
-4. Give each file a simple name without spaces (e.g., `textile-001.jpg`, `map-lima.jpg`)
-5. Click **Commit changes** to save
-
-The filename (without the extension) becomes the object's `object_id` — you will use this in your spreadsheet.
-
-
-
-
-{: .warning }
-> **File Size Limits**
-> Individual images: up to 100 MB. Total repository: keep under 1 GB.
-
-**Option B: Use IIIF images from museums and libraries**
-
-Many institutions provide high-resolution images through the IIIF standard. You can use these directly without downloading anything.
-
-1. Find IIIF resources from institutions like the Library of Congress, the British Library, or the Smithsonian ([IIIF Guide to Finding Resources](https://iiif.io/guides/finding_resources/))
-2. Copy the manifest URL (e.g., `https://example.org/iiif/manifest.json`)
-3. In your spreadsheet's objects tab, add a row and paste the URL into the `source_url` column
-
-
-
-## Register Your Objects
-
-Once your files are in the repository, register them as objects so Telar knows about them. Each object needs:
-
-- **`object_id`** — a simple identifier (matches the filename for uploaded images, or any name for IIIF images)
-- **`title`** — the display name
-- **`description`** — a brief description (optional, but helps with search)
-- **`source_url`** — the IIIF manifest URL (leave blank for uploaded images)
-- **`creator`**, **`year`**, **`object_type`**, **`subjects`** — metadata for gallery filtering (all optional)
-
-Where you enter this depends on your setup method:
-- **Compositor** — add objects in the Objects tab
-- **Google Sheets** — add rows in the **objects** tab of your spreadsheet
-- **CSV** — add rows to `objects.csv`
-
-{: .tip }
-> **Ignoring Rows and Columns**
-> Prefix any row or column header with `#` to have Telar skip it. Useful for notes and TODOs.
-
-## Structure Your Story
-
-Each story is a sequence of steps. Whether you're adding rows in a spreadsheet, editing a CSV, or using the Compositor's visual editor, each step needs:
-
-| Column | What it does |
-|--------|-------------|
-| `step` | Step number (1, 2, 3...) |
-| `object` | Which object to show (the `object_id` from the objects tab) |
-| `x`, `y`, `zoom` | Where to look in the image — use `0.5, 0.5, 1.0` as a starting point |
-| `clip` | Start and end times for video/audio clips (e.g., `00:30-01:15`) |
-| `question` | The heading for this step (e.g., "What is this textile?") |
-| `answer` | A brief 1-2 sentence response |
-
-This is enough to create a working story. Each step shows an image (or plays a video/audio clip) with a question and answer that guide the viewer through your narrative.
-
-## Add Detail Panels
-
-For steps where you want to share more than a brief answer, add content to the panel columns:
-
-| Column | What it does |
-|--------|-------------|
-| `layer1_content` | "Learn more" panel — extra detail about this step |
-| `layer2_content` | "Go deeper" panel — even more depth |
-| `layer1_button` | Custom button text (leave blank for "Learn more") |
-| `layer2_button` | Custom button text (leave blank for "Go deeper") |
-
-Write your panel text directly in the cell. You can use basic markdown formatting: `**bold**`, `*italic*`, and headings with `##`.
-
-{: .tip }
-> **Keep It Simple**
-> For most stories, the question-and-answer columns plus one layer of detail panels is plenty. You can always add more depth later.
-
-## Register Your Stories
-
-In your project data, list each story with its title and subtitle.
-
-## Build Your Site
-
-After making changes to your content:
-
-- **Compositor** — export and push your updated site to GitHub
-- **Google Sheets** — go to your repository's **Actions** tab, click **Build and Deploy**, then **Run workflow**
-- **Local development** — build locally with Jekyll, then push to GitHub
-
-Wait 2–5 minutes for GitHub Pages to publish the new version.
diff --git a/docs/1-6-review-refine.es.md b/docs/1-6-review-refine.es.md
deleted file mode 100644
index 38cf200..0000000
--- a/docs/1-6-review-refine.es.md
+++ /dev/null
@@ -1,67 +0,0 @@
----
-layout: docs
-title: 1.6. Revisa y perfecciona
-parent: 1. Primeros pasos
-grand_parent: Documentación
-nav_order: 6
-lang: es
-permalink: /guia/primeros-pasos/revisa-y-perfecciona/
-tutorial_prev:
- title: "Agrega tu contenido"
- url: /guia/primeros-pasos/agrega-contenido/
----
-
-# Revisa y perfecciona
-
-Navega tu exposición y verifica:
-
-- Mensajes de advertencia en la página de inicio (señalan problemas de configuración)
-- Que las imágenes correctas aparezcan en cada paso de la historia
-- Que el texto se muestre como esperas
-
-## Ajusta las coordenadas de imagen
-
-Las coordenadas iniciales (`0.5, 0.5, 1.0`) muestran el centro de cada imagen. Para enfocar detalles específicos:
-
-1. Navega a cualquier página de objeto en tu sitio
-2. Haz clic en **Identify coordinates** debajo del visor de imágenes
-3. Desplaza y amplía para encontrar la vista perfecta de cada paso
-4. Copia los valores de X, Y y Zoom
-5. Pégalos en tu hoja de cálculo
-6. Vuelve a construir el sitio para ver los cambios
-
-
-
-## Haz historias privadas (opcional)
-
-Si quieres restringir el acceso a una historia — para uso en el aula, borradores o trabajos en progreso:
-
-1. En la pestaña **project**, establece la columna `private` en `yes` para esa historia
-2. En el archivo `_config.yml` de tu repositorio, agrega un `story_key`:
-
- ```yaml
- story_key: "tu-clave-secreta"
- ```
-
-3. Comparte la clave con tus lectores, o envíales un enlace con `?key=tu-clave-secreta` al final
-
-Una historia privada se genera como cualquier otra durante el *build* — el Markdown, los enlaces de glosario y las imágenes funcionan una vez que la persona la desbloquea. Consulta [Historias privadas](/guia/funciones/historias-privadas/) para más detalles, incluido cómo previsualizarla localmente.
-
-## Sigue construyendo
-
-Una vez que tengas lo básico, puedes:
-
-- Agregar más historias
-- Agregar un glosario de términos
-- Personalizar tu página de inicio (edita `index.md` en tu repositorio)
-- Explorar y buscar en tu colección de objetos (habilitado por defecto)
-
-Cuando tus paneles necesiten más que unos pocos párrafos — widgets, formato enriquecido o contenido reutilizable — consulta [Contenido enriquecido](/guia/tu-contenido/contenido-enriquecido/) para aprender a agregar archivos Markdown.
-
-## Próximos pasos
-
-- [Contenido enriquecido](/guia/tu-contenido/contenido-enriquecido/) — Enriquece paneles con archivos Markdown y widgets
-- [Tu Contenido](/guia/tu-contenido/) — Cómo Telar organiza tus materiales
-- [Temas](/guia/personalizacion/temas/) — Personaliza la apariencia de tu sitio
-- [Imágenes autoalojadas](/guia/tu-contenido/imagenes-autoalojadas/) — Sube y procesa tus propias imágenes
-- [Imágenes IIIF externas](/guia/tu-contenido/iiif-externo/) — Usa imágenes de museos y bibliotecas
diff --git a/docs/1-6-review-refine.md b/docs/1-6-review-refine.md
deleted file mode 100644
index f912321..0000000
--- a/docs/1-6-review-refine.md
+++ /dev/null
@@ -1,69 +0,0 @@
----
-layout: docs
-title: 1.6. Review and Refine
-parent: 1. Getting Started
-grand_parent: Documentation
-nav_order: 6
-lang: en
-permalink: /docs/getting-started/review-refine/
-tutorial_prev:
- title: "Add Your Content"
- url: /docs/getting-started/add-content/
----
-
-# Review and Refine
-
-Browse through your exhibition and check for:
-
-- Warning messages on the homepage (these point to configuration issues)
-- Correct images appearing for each story step
-- Text displaying as expected
-
-## Set Your Image Coordinates
-
-The placeholder coordinates (`0.5, 0.5, 1.0`) show the center of each image. To focus on specific details:
-
-1. Navigate to any object page on your site
-2. Click **Identify coordinates** below the image viewer
-3. Pan and zoom to find the perfect view for each story step
-4. Copy the X, Y, and Zoom values
-5. Paste them into your spreadsheet
-6. Trigger a rebuild to see the changes
-
-
-
-## Make Stories Private (Optional)
-
-If you want to restrict access to a story — for classroom use, drafts, or work in progress:
-
-1. In the **project** tab, set the `private` column to `yes` for that story
-2. In your repository's `_config.yml`, add a `story_key`:
-
- ```yaml
- story_key: "your-secret-key"
- ```
-
-3. Share the key with your viewers, or send them a link with `?key=your-secret-key` appended
-
-A private story renders like any other story during the build — markdown, glossary links, and
-images all work once a viewer unlocks it. See [Private
-Stories](/docs/site-features/private-stories/) for details, including how to preview one locally.
-
-## Keep Building
-
-Once the basics are in place, you can:
-
-- Add more stories
-- Add a glossary of terms
-- Customize your homepage (edit `index.md` in your repository)
-- Browse and search your objects collection (enabled by default)
-
-When your panels need more than a few paragraphs — widgets, rich formatting, or reusable content — see [Rich Content](/docs/your-content/rich-content/) for how to add markdown files.
-
-## Next Steps
-
-- [Rich Content](/docs/your-content/rich-content/) — Enhance panels with markdown files and widgets
-- [Your Content](/docs/your-content/) — How Telar organizes your materials
-- [Themes](/docs/customization/themes/) — Customizing your site's look and feel
-- [Self-Hosted Images](/docs/your-content/self-hosted-images/) — Upload and process your own images
-- [External IIIF Images](/docs/your-content/external-iiif/) — Use images from museums and libraries
diff --git a/docs/5-1-google-sheets.es.md b/docs/5-1-google-sheets.es.md
deleted file mode 100644
index 72fc52c..0000000
--- a/docs/5-1-google-sheets.es.md
+++ /dev/null
@@ -1,123 +0,0 @@
----
-layout: docs
-title: "5.1. Google Sheets"
-parent: "5. Tus datos"
-grand_parent: Documentación
-nav_order: 1
-lang: es
-permalink: /guia/tus-datos/google-sheets/
----
-
-## Integración con Google Sheets
-
-Usa Google Sheets para gestionar el contenido de tu exhibición con una interfaz familiar y colaborativa. Funciona tanto con el flujo de trabajo de Interfaz Web de GitHub como con Desarrollo Local.
-
-## Inicio rápido
-
-1. Duplica la plantilla: <https://bit.ly/telar-template> (Archivo → Hacer una copia · File → Make a copy)
-2. Publica: Archivo → Compartir → Publicar en la Web · File → Share → Publish to the web
-3. Configura `_config.yml` → bloque `google_sheets` (published_url)
-4. Construye tu sitio (GitHub Actions o build local)
-
-{: .tip }
-> **Integración con el Compositor.** El Compositor puede importar directamente desde tu Google Sheet durante la configuración inicial. Después de la primera publicación con el Compositor, puedes desactivar la integración con Google Sheets si prefieres gestionar el contenido solo desde el Compositor.
-
-Opcional: Importar desde Excel en lugar de duplicar la plantilla de Google
-
-- Descarga la plantilla de Excel (archivo):
- {{ site.baseurl }}/assets/templates/telar-template.xlsx
-- En Google Sheets: Archivo → Importar → Subir → Reemplazar hoja de cálculo · File → Import → Upload → Replace spreadsheet
-
-## Estructura de la hoja
-
-Tu hoja de cálculo incluye estas pestañas por defecto:
-
-- `project` — Configuración del sitio y lista de historias
-- `objects` — Objetos IIIF usados en las historias
-- `story-1`, `story-2`, … — Pasos y contenido de cada historia
-
-Consejos
-
-- Usa filas que comiencen con `#` como separadores o TODOs (se ignoran en el procesamiento)
-- Cualquier columna que empiece con `#` también se ignora (para notas y guía en línea)
-- Coordenadas: empieza con `0.500, 0.500, 1.000` y luego afina usando la herramienta Identificar Coordenadas
-
-## Configurar `_config.yml`
-
-En tu repositorio, define:
-
-```yaml
-google_sheets:
- enabled: true
- published_url: "https://docs.google.com/..." # Archivo → Compartir → Publicar en la Web · File → Share → Publish to the web
-```
-
-- `published_url` provee URLs CSV estables por pestaña
-
-{: .note }
-> **Simplificado en v0.9.0.** Ya no necesitas compartir tu hoja por separado. Solo se requiere la URL publicada. Si tu configuración todavía tiene una línea `shared_url`, se ignora sin problemas.
-
-
-
-## Obtener datos (solo desarrollo local)
-
-Cuando desarrolles localmente, la forma más sencilla es usar el script **todo-en-uno**, que construye el sitio y descarga y procesa los datos automáticamente:
-
-```bash
-python3 scripts/build_local_site.py
-```
-
-O ejecuta el paso de descarga de manera independiente:
-
-```bash
-python3 scripts/fetch_google_sheets.py
-```
-
-Qué hace el script de descarga:
-
-- Detecta automáticamente los GID de las pestañas
-- Descarga CSV a `telar-content/spreadsheets/`
-- Omite pestañas solo de instrucciones
-
-Luego ejecuta tu flujo de build habitual:
-
-```bash
-python3 scripts/csv_to_json.py
-python3 scripts/generate_collections.py
-bundle exec jekyll build
-```
-
-## Referencia de columnas (resumen)
-
-Pestaña `project`
-
-- Después de la fila `STORIES`, lista cada historia (número y título)
-
-Pestaña `objects` (campos comunes)
-
-- object_id, title, description, source_url, creator, period, medium, dimensions, location, credit, thumbnail
-
-Pestañas `story-X`
-
-- step, object, x, y, zoom, clip, question, answer, alt_text
-- layer1_button, **layer1_content**, layer2_button, **layer2_content**
-
-El contenido del panel puede ser:
-- Texto en línea (escrito directamente en la celda)
-- Indicar un archivo de texto (ruta terminando en `.md`)
-
-{: .tip }
-> **Texto en línea vs archivos de texto**
-> Para paneles cortos (1–2 párrafos), escribe el contenido directamente en la celda de la hoja de cálculo. Usa archivos de texto para contenido complejo con widgets o narrativas muy largas. Consulta la [Referencia CSV: Historias](/guia/tus-datos/csv-historias/#contenido-de-capa) para más detalles.
-
-## Solución de problemas
-
-- Referencias de objetos inválidas → asegúrate de que los IDs coincidan exactamente entre `objects` y las pestañas de historia
-- Falla al traer datos → verifica la configuración de compartir/publicar y las URLs en `_config.yml`
-- Coordenadas imprecisas → usa rangos válidos (x/y: 0.000–1.000; zoom: número positivo)
-
-## Véase también
-
-- [Configuración manual](/guia/configuracion/configuracion-manual/)
-- [Desarrollo local](/guia/primeros-pasos/desarrollo-local/)
-- [Actualizar Telar](/guia/configuracion/actualizacion/)
diff --git a/docs/5-1-google-sheets.md b/docs/5-1-google-sheets.md
deleted file mode 100644
index f424079..0000000
--- a/docs/5-1-google-sheets.md
+++ /dev/null
@@ -1,125 +0,0 @@
----
-layout: docs
-title: "5.1. Google Sheets"
-parent: "5. Your Data"
-grand_parent: Documentation
-nav_order: 1
-lang: en
-permalink: /docs/your-data/google-sheets/
----
-
-## Google Sheets Integration
-
-Use Google Sheets to manage your Telar content through a familiar, collaborative interface. This works with both the GitHub Web workflow and Local Development.
-
-## Quick start
-
-1. Duplicate the template: <https://bit.ly/telar-template> (File → Make a copy)
-2. Publish: File → Share → Publish to web
-3. Configure `_config.yml` → `google_sheets` block (published_url)
-4. Build your site (GitHub Actions or local build)
-
-{: .tip }
-> **Compositor onboarding.** The Compositor can import directly from your Google Sheet during onboarding. After your first publish via the Compositor, you can disable Google Sheets integration if you prefer to manage content entirely through the Compositor.
-
-Optional: Import from Excel instead of duplicating the Google template
-
-- Download the Excel template (raw file):
- {{ site.baseurl }}/assets/templates/telar-template.xlsx
-- In Google Sheets: File → Import → Upload → Replace spreadsheet
-
-## Sheet structure
-
-Your spreadsheet contains these tabs by default:
-
-- `project` — Site-wide settings and story list
-- `objects` — IIIF objects used across stories
-- `story-1`, `story-2`, ... — Steps and content for each story
-
-Tips
-
-- Use `#`-prefixed rows as section breaks or TODOs (ignored during processing)
-- Any column starting with `#` is also ignored (for inline notes/guidance)
-- Coordinates: start with `0.500, 0.500, 1.000` and refine later using the Identify Coordinates tool
-
-## Configuring `_config.yml`
-
-In your repository, set:
-
-```yaml
-google_sheets:
- enabled: true
- published_url: "https://docs.google.com/..." # File → Share → Publish to web
-```
-
-- The `published_url` provides stable CSV endpoints for each sheet
-
-{: .note }
-> **Simplified in v0.9.0.** You no longer need to share your sheet separately. Only the published URL is required. If your config still has a `shared_url` line, it is safely ignored.
-
-
-
-## Fetching data (local dev only)
-
-When developing locally, use the build script which handles fetching automatically:
-
-```bash
-python3 scripts/build_local_site.py
-```
-
-Or run the fetch step manually:
-
-```bash
-python3 scripts/fetch_google_sheets.py
-```
-
-What the fetch script does:
-
-- Discovers tab GIDs automatically
-- Downloads CSVs to `telar-content/spreadsheets/`
-- Skips instruction-only tabs
-
-Then run your normal build steps:
-
-```bash
-python3 scripts/csv_to_json.py
-python3 scripts/generate_collections.py
-bundle exec jekyll build
-```
-
-## Column reference (summary)
-
-`project` tab
-
-- After the `STORIES` row, list each story (number and title)
-
-`objects` tab (common fields)
-
-- object_id, title, description, source_url, creator, period, medium, dimensions, location, credit, thumbnail
-
-
-
-`story-X` tabs
-
-- step, object, x, y, zoom, clip, question, answer, alt_text
-- layer1_button, **layer1_content**, layer2_button, **layer2_content**
-
-Panel content can be:
-- Inline text (write directly in the cell)
-- File reference (path ending in `.md`)
-
-{: .tip }
-> **Inline vs File References**
-> For short panels (1–2 paragraphs), write content directly in the spreadsheet cell. Use file references for complex content with widgets or very long narratives. See the [CSV Reference: Stories](/docs/your-data/csv-stories/#layer-content) for details.
-
-## Troubleshooting
-
-- Invalid object references → ensure IDs match exactly between `objects` and story tabs
-- Fetch fails → verify share/publish settings and URLs in `_config.yml`
-- Coordinates off → keep values in range (x/y: 0.000–1.000; zoom: positive number)
-
-## See also
-
-- [Manual Setup](/docs/setup/manual/)
-- [Local Development](/docs/getting-started/local-dev/)
-- [Upgrading](/docs/setup/upgrading/)
diff --git a/docs/9-0-compositor.es.md b/docs/9-0-compositor.es.md
deleted file mode 100644
index f14389c..0000000
--- a/docs/9-0-compositor.es.md
+++ /dev/null
@@ -1,54 +0,0 @@
----
-layout: docs
-title: "9. El Compositor"
-parent: Documentación
-nav_order: 9
-has_children: true
-lang: es
-permalink: /guia/el-compositor/
----
-
-# El Compositor
-
-El Compositor de Telar es un editor visual para construir y administrar tu exhibición — sin hojas de cálculo, sin línea de comandos, sin código. Funciona en tu navegador en [compositor.telar.org](https://compositor.telar.org) y se conecta directamente a tu repositorio de GitHub.
-
-## ¿Qué es el Compositor?
-
-Si ya has usado Telar, sabes que el contenido se define a través de archivos de hoja de cálculo — archivos CSV o Google Sheets — y se publica a través de GitHub. El Compositor reemplaza ese flujo de trabajo con un editor visual. Puedes:
-
-- Importar contenido existente desde un repositorio de Telar o Google Sheets
-- Agregar y editar objetos con metadatos, manifiestos IIIF o imágenes subidas
-- Construir historias visualmente — escribir paneles, definir coordenadas del visor, fijar los tiempos del clip
-- Publicar cambios en GitHub con un solo clic
-- Monitorear el estado del *build* de tu sitio en tiempo real
-
-El Compositor está diseñado para estudiantes, docentes y cualquier persona que quiera enfocarse en la narrativa en lugar de los archivos de datos.
-
-## Cómo funciona
-
-El flujo de trabajo tiene cuatro etapas:
-
-1. **Iniciar sesión** — Autentícate con tu cuenta de GitHub en [compositor.telar.org](https://compositor.telar.org)
-2. **Conectar un repositorio** — Selecciona un repositorio de Telar existente e importa su contenido
-3. **Editar** — Usa el editor visual para administrar objetos, escribir historias y organizar los pasos
-4. **Publicar** — Revisa tus cambios, confirma el *commit* en GitHub y observa cómo se completa el *build*
-
-Todos los cambios que hagas en el Compositor se guardan automáticamente en el servidor hasta que publiques. Al publicar se crea un solo *commit* en tu repositorio — atribuido a ti — y se activa automáticamente un *build* de GitHub Pages.
-
-## Requisitos
-
-Para usar el Compositor necesitas:
-
-- Una **cuenta de GitHub** ([regístrate gratis](https://github.com/join))
-- Un **repositorio de Telar** creado a partir de la [plantilla de Telar](https://github.com/UCSB-AMPLab/telar) (consulta [Primeros pasos](/guia/primeros-pasos/compositor/) para instrucciones de configuración)
-- **GitHub Pages habilitado** con la fuente configurada como **GitHub Actions** (consulta [Primeros pasos](/guia/primeros-pasos/compositor/) para más detalles)
-
-## En esta sección
-
-- [Primeros pasos](/guia/el-compositor/primeros-pasos/) — Inicia sesión, conecta un repositorio e importa tu contenido
-- [Panel de control](/guia/el-compositor/panel-de-control/) — Navega tu proyecto, administra historias y monitorea tu sitio
-- [Objetos](/guia/el-compositor/objetos/) — Explora, edita, sube y agrega objetos a tu exhibición
-- [Editor de historias](/guia/el-compositor/editor-historias/) — Construye historias con un editor visual, captura coordenadas y escribe contenido de capas
-- [Video y audio](/guia/el-compositor/video-y-audio/) — Fija los tiempos del clip y los puntos de bucle, y trabaja con pasos multimedia
-- [Publicación](/guia/el-compositor/publicacion/) — Revisa los cambios, confirma el *commit* en GitHub y sigue el *build*
-- [Sincronización y actualizaciones](/guia/el-compositor/sincronizacion-y-actualizaciones/) — Resincroniza con tu repositorio y actualiza Telar
diff --git a/docs/9-0-compositor.md b/docs/9-0-compositor.md
deleted file mode 100644
index f24b517..0000000
--- a/docs/9-0-compositor.md
+++ /dev/null
@@ -1,54 +0,0 @@
----
-layout: docs
-title: "9. The Compositor"
-parent: Documentation
-nav_order: 9
-has_children: true
-lang: en
-permalink: /docs/the-compositor/
----
-
-# The Compositor
-
-The Telar Compositor is a visual editor for building and managing your exhibition — no spreadsheets, no command line, no code. It runs in your browser at [compositor.telar.org](https://compositor.telar.org) and connects directly to your GitHub repository.
-
-## What is the Compositor?
-
-If you have used Telar before, you know that content is defined through spreadsheet files — CSV files or Google Sheets — and published through GitHub. The Compositor replaces that workflow with a point-and-click editor. You can:
-
-- Import existing content from a Telar repository or Google Sheets
-- Add and edit objects with metadata, IIIF manifests, or uploaded images
-- Build stories visually — write panels, set viewer coordinates, set clip times
-- Publish changes to GitHub with a single click
-- Track your site's build status in real time
-
-The Compositor is designed for students, educators, and anyone who wants to focus on storytelling rather than data files.
-
-## How it works
-
-The typical workflow has four stages:
-
-1. **Sign in** — Authenticate with your GitHub account at [compositor.telar.org](https://compositor.telar.org)
-2. **Connect a repository** — Select an existing Telar repository and import its content
-3. **Edit** — Use the visual editor to manage objects, write stories, and arrange steps
-4. **Publish** — Review your changes, commit to GitHub, and watch the build complete
-
-Every change you make in the Compositor is saved automatically on the server until you publish. Publishing creates a single commit in your repository — attributed to you — and triggers a GitHub Pages build automatically.
-
-## Requirements
-
-To use the Compositor, you need:
-
-- A **GitHub account** ([sign up for free](https://github.com/join))
-- A **Telar repository** created from the [Telar template](https://github.com/UCSB-AMPLab/telar) (see [Getting Started](/docs/getting-started/compositor/) for setup instructions)
-- **GitHub Pages enabled** with the source set to **GitHub Actions** (see [Getting Started](/docs/getting-started/compositor/) for details)
-
-## In this section
-
-- [Getting Started](/docs/the-compositor/getting-started/) — Sign in, connect a repository, and import your content
-- [Dashboard](/docs/the-compositor/dashboard/) — Navigate your project, manage stories, and monitor your site
-- [Objects](/docs/the-compositor/objects/) — Browse, edit, upload, and add objects to your exhibition
-- [Story Editor](/docs/the-compositor/story-editor/) — Build stories with a visual editor, capture coordinates, and write layer content
-- [Video and Audio](/docs/the-compositor/video-audio/) — Set clip times, loop points, and work with multimedia steps
-- [Publishing](/docs/the-compositor/publishing/) — Review changes, commit to GitHub, and track your build
-- [Sync and Updates](/docs/the-compositor/sync-updates/) — Re-sync with your repository and upgrade Telar
diff --git a/docs/9-2-dashboard.es.md b/docs/9-2-dashboard.es.md
deleted file mode 100644
index ff756b1..0000000
--- a/docs/9-2-dashboard.es.md
+++ /dev/null
@@ -1,91 +0,0 @@
----
-layout: docs
-title: "9.2. Panel de control"
-parent: "9. El Compositor"
-grand_parent: Documentación
-nav_order: 2
-lang: es
-permalink: /guia/el-compositor/panel-de-control/
----
-
-# Panel de control
-
-El panel de control es lo primero que ves después de importar tu contenido en el Compositor. Te ofrece una vista general de tu proyecto y acceso rápido a tus historias, objetos y el estado del sitio.
-
-## Vista previa del sitio
-
-La parte superior del panel de control muestra una vista previa de la página de inicio de tu sitio — incluyendo el mensaje de bienvenida y cualquier objeto destacado. Esta vista previa se actualiza a medida que haces cambios, para que puedas ver cómo se verán las ediciones antes de publicar.
-
-## Mensaje de bienvenida
-
-El mensaje de bienvenida de tu sitio aparece en la página de inicio y presenta tu exhibición a quienes visitan. Puedes editarlo directamente desde el panel de control.
-
-1. Haz clic en el área del mensaje de bienvenida para abrir el editor
-2. Escribe o actualiza tu mensaje usando la barra de herramientas de texto enriquecido
-3. Los cambios se guardan automáticamente mientras escribes
-
-El mensaje de bienvenida admite formato básico — negrita, cursiva, enlaces y saltos de línea.
-
-## Historias
-
-La pestaña **Historias** lista todas las historias de tu exhibición. Desde aquí puedes administrar toda tu colección de narrativas.
-
-### Ver y abrir historias
-
-Cada historia en la lista muestra su título, número de pasos y estado actual. Haz clic en una historia para abrirla en el [Editor de historias](/guia/el-compositor/editor-historias/).
-
-### Crear una historia nueva
-
-Para agregar una historia nueva a tu exhibición:
-
-1. Haz clic en el botón **+** o **Nueva historia** en la pestaña de historias
-2. Escribe un título para la historia
-3. El Compositor crea la historia y la abre en el editor
-
-### Reordenar historias
-
-Las historias aparecen en tu sitio en el orden en que están listadas. Para cambiar el orden:
-
-1. Haz clic y mantén presionado el control de arrastre junto a una historia
-2. Arrástrala a la posición deseada
-3. Suéltala en su lugar
-
-### Eliminar una historia
-
-Para eliminar una historia de tu exhibición:
-
-1. Haz clic en la opción de eliminar de la historia que deseas remover
-2. Confirma la eliminación cuando se te solicite
-
-{: .warning }
-> Eliminar una historia la remueve del Compositor. La eliminación no es definitiva hasta que publiques — si eliminas una historia por error, puedes reimportar desde tu repositorio antes de publicar.
-
-### Controles de borrador y privacidad
-
-Cada historia tiene dos controles de visibilidad:
-
-- **Borrador** — Las historias en borrador quedan por completo fuera del sitio publicado. Usa esta opción mientras todavía estás trabajando en una historia.
-- **Privada** — Las historias privadas siguen apareciendo en la lista de historias del sitio, con su título y subtítulo visibles, pero su contenido queda bloqueado. Para leerlas se necesita la clave de historia, que se ingresa en la página misma o va incluida en un enlace compartido. Consulta [Historias privadas](/guia/funciones/historias-privadas/) para más detalles.
-
-## Cambiar de proyecto
-
-Si trabajas con varios repositorios de Telar, puedes cambiar entre ellos sin cerrar sesión.
-
-1. Haz clic en el nombre del proyecto o el selector en la navegación superior
-2. Selecciona un repositorio diferente de la lista
-3. El Compositor carga el contenido de ese proyecto
-
-Los cambios de cada proyecto se almacenan por separado en tu navegador.
-
-## Barra de estado
-
-La parte inferior del panel de control muestra el estado actual de tu proyecto:
-
-- **Última publicación** — Cuándo se confirmó el último *commit* en GitHub
-- **Última sincronización** — Cuándo se importó contenido por última vez desde el repositorio
-- **Sitio en línea** — Un enlace directo a tu sitio publicado en GitHub Pages
-
-## Véase también
-
-- [Primeros pasos](/guia/el-compositor/primeros-pasos/) — Inicia sesión e importa tu contenido
-- [Objetos](/guia/el-compositor/objetos/) — Administra los objetos de tu exhibición
diff --git a/docs/9-2-dashboard.md b/docs/9-2-dashboard.md
deleted file mode 100644
index a8cd9a8..0000000
--- a/docs/9-2-dashboard.md
+++ /dev/null
@@ -1,91 +0,0 @@
----
-layout: docs
-title: "9.2. Dashboard"
-parent: "9. The Compositor"
-grand_parent: Documentation
-nav_order: 2
-lang: en
-permalink: /docs/the-compositor/dashboard/
----
-
-# Dashboard
-
-The dashboard is the first thing you see after importing your content into the Compositor. It gives you an overview of your project and quick access to your stories, objects, and site status.
-
-## Site preview
-
-The top of the dashboard shows a preview of your site's home page — including the welcome message and any featured objects. This preview updates as you make changes, so you can see how edits will look before you publish.
-
-## Welcome message
-
-Your site's welcome message appears on the home page and introduces your exhibition to visitors. You can edit it directly from the dashboard.
-
-1. Click the welcome message area to open the editor
-2. Write or update your message using the rich text toolbar
-3. Changes save automatically as you type
-
-The welcome message supports basic formatting — bold, italic, links, and line breaks.
-
-## Stories
-
-The **Stories** tab lists all the stories in your exhibition. From here you can manage your entire collection of narratives.
-
-### View and open stories
-
-Each story in the list shows its title, number of steps, and current status. Click a story to open it in the [Story Editor](/docs/the-compositor/story-editor/).
-
-### Create a new story
-
-To add a new story to your exhibition:
-
-1. Click the **+** button or **New Story** in the stories tab
-2. Enter a title for the story
-3. The Compositor creates the story and opens it in the editor
-
-### Reorder stories
-
-Stories appear on your site in the order they are listed. To change the order:
-
-1. Click and hold the drag handle next to a story
-2. Drag it to the desired position
-3. Release to drop it in place
-
-### Delete a story
-
-To remove a story from your exhibition:
-
-1. Click the delete option on the story you want to remove
-2. Confirm the deletion when prompted
-
-{: .warning }
-> Deleting a story removes it from the Compositor. The deletion is not final until you publish — if you delete a story by mistake, you can re-import from your repository before publishing.
-
-### Draft and private toggles
-
-Each story has two visibility toggles:
-
-- **Draft** — Draft stories are excluded from your published site entirely. Use this for stories you are still working on.
-- **Private** — Private stories remain listed on your site, with their title and subtitle visible, but their content is locked. Visitors need the story key to read them, entered on the story page or included in a shared link. See [Private Stories](/docs/site-features/private-stories/) for details.
-
-## Project switching
-
-If you work with multiple Telar repositories, you can switch between them without signing out.
-
-1. Click the project name or switcher in the top navigation
-2. Select a different repository from the list
-3. The Compositor loads that project's content
-
-Each project's changes are stored separately in your browser.
-
-## Status bar
-
-The bottom of the dashboard shows the current status of your project:
-
-- **Last published** — When changes were last committed to GitHub
-- **Last synced** — When content was last imported from the repository
-- **Live site** — A direct link to your published site on GitHub Pages
-
-## See also
-
-- [Getting Started](/docs/the-compositor/getting-started/) — Sign in and import your content
-- [Objects](/docs/the-compositor/objects/) — Manage the objects in your exhibition
diff --git a/docs/9-3-objects.es.md b/docs/9-3-objects.es.md
deleted file mode 100644
index 789f8f7..0000000
--- a/docs/9-3-objects.es.md
+++ /dev/null
@@ -1,104 +0,0 @@
----
-layout: docs
-title: "9.3. Objetos"
-parent: "9. El Compositor"
-grand_parent: Documentación
-nav_order: 3
-lang: es
-permalink: /guia/el-compositor/objetos/
----
-
-# Objetos
-
-La página de objetos en el Compositor te permite explorar, editar y agregar los elementos visuales que componen tu exhibición. Cada objeto que administras aquí — imágenes, manifiestos IIIF, videos, archivos de audio — se registra en el archivo `objects.csv` de tu repositorio. El Compositor se encarga de ese archivo por ti, así que nunca necesitas editarlo directamente.
-
-## Lista de objetos
-
-La lista de objetos muestra todos los objetos de tu exhibición como una cuadrícula de miniaturas. Cada objeto muestra:
-
-- Una **miniatura** de vista previa de la imagen o el medio
-- El **título** del objeto
-- Un **indicador de estado** que muestra su condición actual
-
-### Indicadores de estado
-
-Los objetos pueden tener uno de tres estados:
-
-- **Listo** — El objeto tiene metadatos y sus teselas (*tiles*) ya están generadas. Ya puedes usarlo en las historias.
-- **Sin metadatos** — El objeto existe pero le falta información clave como el título, el creador o la descripción. Aún puedes usarlo en las historias, pero agregar metadatos mejora la exhibición.
-- **Sin teselas** — Las teselas IIIF del objeto aún no se han generado. Esto puede ocurrir con imágenes recién subidas que no se han publicado ni procesado en el *build*.
-
-### Control de destacados
-
-Puedes marcar cualquier objeto como destacado. Los objetos destacados aparecen de manera prominente en la página de inicio de tu sitio y en la galería de objetos.
-
-Para cambiar el estado de destacado de un objeto, haz clic en el indicador de destacado en la tarjeta del objeto.
-
-## Editar metadatos
-
-Selecciona un objeto para abrir su editor de metadatos. Aquí puedes completar o actualizar la información que describe al objeto en tu exhibición.
-
-Los campos de metadatos son:
-
-| Campo | Descripción |
-|---|---|
-| **Título** | El nombre del objeto como aparece en tu sitio |
-| **Creador** | La persona u organización que creó el objeto |
-| **Fecha** | Cuándo se creó o publicó el objeto |
-| **Descripción** | Un resumen breve de lo que el objeto muestra o contiene |
-| **Fuente** | De dónde proviene el objeto — una colección, archivo o URL |
-| **Texto alternativo** | Una descripción para lectores de pantalla y accesibilidad |
-| **Género / Medio** | El tipo de objeto — fotografía, pintura, mapa, manuscrito, etc. |
-
-{: .tip }
-> El texto alternativo es importante para la accesibilidad. Escribe una oración breve y descriptiva que transmita lo que muestra la imagen a quien no puede verla.
-
-## Agregar IIIF externo
-
-Puedes agregar objetos de museos, bibliotecas y otras instituciones que publican manifiestos IIIF. El Compositor obtiene la imagen y los metadatos automáticamente.
-
-1. Haz clic en **Agregar objeto** y selecciona la opción IIIF
-2. Pega la URL del manifiesto en el campo
-3. El Compositor recupera la imagen y completa los metadatos disponibles (título, creador, descripción)
-4. Revisa y ajusta los metadatos según sea necesario
-5. Guarda el objeto
-
-{: .note }
-> Para encontrar manifiestos IIIF, busca el logo de IIIF en los sitios web de museos y bibliotecas, o consulta la [guía de IIIF para encontrar recursos](https://iiif.io/guides/finding_resources/). Para más información sobre IIIF en Telar, consulta [Imágenes IIIF externas](/guia/tu-contenido/iiif-externo/).
-
-## Subir imágenes
-
-Puedes subir tus propias imágenes directamente a través del Compositor. Las imágenes subidas se confirman en tu repositorio y las teselas IIIF se generan automáticamente durante el siguiente *build*.
-
-1. Haz clic en **Agregar objeto** y selecciona la opción de subida
-2. Arrastra archivos al área de subida, o haz clic para seleccionar archivos desde tu computador
-3. Completa los metadatos mientras se procesa la subida
-4. Guarda el objeto en tu proyecto
-
-Los formatos admitidos son JPG, PNG y TIFF, con un tamaño máximo de 25 MB por imagen.
-
-{: .note }
-> Después de subir, el estado del objeto puede mostrar **Sin teselas** hasta que publiques y el *build* de GitHub Actions genere las teselas IIIF. El objeto sigue siendo utilizable en el Compositor — las teselas estarán disponibles en tu sitio en línea después de que se complete el *build*.
-
-## Guardar en el repositorio
-
-Cuando guardas cambios en los objetos — ya sea editando metadatos, agregando IIIF o subiendo imágenes — esos cambios se almacenan localmente en el Compositor. Para enviarlos a GitHub, necesitas publicar.
-
-Al publicar se confirma un archivo `objects.csv` actualizado en tu repositorio junto con cualquier imagen subida. Consulta [Publicación](/guia/el-compositor/publicacion/) para el flujo de trabajo completo.
-
-## Sincronización
-
-Si se agregaron o cambiaron objetos fuera del Compositor — por ejemplo, al editar `objects.csv` directamente o subir imágenes a través de GitHub — puedes reescanear tu repositorio para detectar esos cambios.
-
-1. Haz clic en el botón **Sincronizar desde GitHub**
-2. El Compositor relee tu repositorio y actualiza la lista de objetos
-
-{: .warning }
-> Si tienes cambios sin publicar en el Compositor, la sincronización puede sobrescribirlos con el estado actual del repositorio. Publica tus cambios primero, o revisa con cuidado antes de sincronizar.
-
-## Véase también
-
-- [Panel de control](/guia/el-compositor/panel-de-control/) — Regresa a la vista general del proyecto
-- [Objetos](/guia/tu-contenido/objetos/) — Cómo funcionan los objetos en Telar
-- [Imágenes IIIF externas](/guia/tu-contenido/iiif-externo/) — Información sobre manifiestos IIIF y fuentes
-- [Imágenes autoalojadas](/guia/tu-contenido/imagenes-autoalojadas/) — Cómo las imágenes subidas se convierten en teselas IIIF
diff --git a/docs/9-3-objects.md b/docs/9-3-objects.md
deleted file mode 100644
index c6e9c29..0000000
--- a/docs/9-3-objects.md
+++ /dev/null
@@ -1,104 +0,0 @@
----
-layout: docs
-title: "9.3. Objects"
-parent: "9. The Compositor"
-grand_parent: Documentation
-nav_order: 3
-lang: en
-permalink: /docs/the-compositor/objects/
----
-
-# Objects
-
-The Objects page in the Compositor lets you browse, edit, and add the visual items that make up your exhibition. Every object you manage here — images, IIIF manifests, videos, audio files — is tracked in your repository's `objects.csv` file. The Compositor handles that file for you, so you never need to edit it directly.
-
-## Object list
-
-The object list shows all objects in your exhibition as a grid of thumbnails. Each object displays:
-
-- A **thumbnail** preview of the image or media
-- The object's **title**
-- A **status indicator** showing its current state
-
-### Status indicators
-
-Objects can have one of three statuses:
-
-- **Ready** — The object has metadata and its image tiles are available. It is ready to use in stories.
-- **No metadata** — The object exists but is missing key information like title, creator, or description. You can still use it in stories, but adding metadata improves your exhibition.
-- **Needs tiles** — The object's IIIF tiles have not been generated yet. This can happen with newly uploaded images that have not been published and built.
-
-### Featured toggle
-
-You can mark any object as featured. Featured objects appear prominently on your site's home page and in the objects gallery.
-
-To toggle an object's featured status, click the featured indicator on the object card.
-
-## Edit metadata
-
-Select an object to open its metadata editor. Here you can fill in or update the information that describes the object in your exhibition.
-
-The metadata fields are:
-
-| Field | Description |
-|---|---|
-| **Title** | The name of the object as it appears on your site |
-| **Creator** | The person or organization that created the object |
-| **Date** | When the object was created or published |
-| **Description** | A short summary of what the object depicts or contains |
-| **Source** | Where the object comes from — a collection, archive, or URL |
-| **Alt text** | A description for screen readers and accessibility |
-| **Genre / Medium** | The type of object — photograph, painting, map, manuscript, etc. |
-
-{: .tip }
-> Alt text is important for accessibility. Write a brief, descriptive sentence that conveys what the image shows to someone who cannot see it.
-
-## Add external IIIF
-
-You can add objects from museums, libraries, and other institutions that publish IIIF manifests. The Compositor fetches the image and metadata automatically.
-
-1. Click **Add object** and select the IIIF option
-2. Paste the manifest URL into the field
-3. The Compositor retrieves the image and fills in available metadata (title, creator, description)
-4. Review and adjust the metadata as needed
-5. Save the object
-
-{: .note }
-> To find IIIF manifests, look for the IIIF logo on museum and library websites, or check the [IIIF Guide to Finding Resources](https://iiif.io/guides/finding_resources/). For more background on IIIF in Telar, see [External IIIF Images](/docs/your-content/external-iiif/).
-
-## Upload images
-
-You can upload your own images directly through the Compositor. Uploaded images are committed to your repository and IIIF tiles are generated automatically during the next build.
-
-1. Click **Add object** and select the upload option
-2. Drag files into the upload area, or click to select files from your computer
-3. Fill in metadata while the upload processes
-4. Save the object to your project
-
-Supported formats are JPG, PNG, and TIFF, with a maximum file size of 25 MB per image.
-
-{: .note }
-> After uploading, the object's status may show **Needs tiles** until you publish and the GitHub Actions build generates the IIIF tiles. The object is still usable in the Compositor — tiles will be available on your live site after the build completes.
-
-## Save to repository
-
-When you save changes to objects — whether editing metadata, adding IIIF, or uploading images — those changes are stored locally in the Compositor. To send them to GitHub, you need to publish.
-
-Publishing commits an updated `objects.csv` to your repository along with any uploaded image files. See [Publishing](/docs/the-compositor/publishing/) for the full workflow.
-
-## Sync
-
-If objects were added or changed outside the Compositor — for example, by editing `objects.csv` directly or uploading images through GitHub — you can re-scan your repository to pick up those changes.
-
-1. Click the **Sync from GitHub** button
-2. The Compositor re-reads your repository and updates the object list
-
-{: .warning }
-> If you have unpublished changes in the Compositor, syncing may overwrite them with the repository's current state. Publish your changes first, or review carefully before syncing.
-
-## See also
-
-- [Dashboard](/docs/the-compositor/dashboard/) — Return to the project overview
-- [Objects](/docs/your-content/objects/) — How objects work in Telar
-- [External IIIF Images](/docs/your-content/external-iiif/) — Background on IIIF manifests and sources
-- [Self-Hosted Images](/docs/your-content/self-hosted-images/) — How uploaded images become IIIF tiles
diff --git a/docs/9-4-story-editor.es.md b/docs/9-4-story-editor.es.md
deleted file mode 100644
index f17789a..0000000
--- a/docs/9-4-story-editor.es.md
+++ /dev/null
@@ -1,98 +0,0 @@
----
-layout: docs
-title: "9.4. Editor de historias"
-parent: "9. El Compositor"
-grand_parent: Documentación
-nav_order: 4
-lang: es
-permalink: /guia/el-compositor/editor-historias/
----
-
-# Editor de historias
-
-El editor de historias es donde construyes y refinas tus narrativas. Combina un editor de texto, un visor interactivo y herramientas de gestión de pasos en un solo espacio de trabajo — todo lo que necesitas para componer una historia sin editar hojas de cálculo.
-
-Cuando abres una historia desde el [Panel de control](/guia/el-compositor/panel-de-control/), el editor se carga con la tarjeta de título a la izquierda y el visor a la derecha. Cada paso de la historia aparece como una tarjeta en la barra lateral, y al seleccionar un paso se actualizan tanto el editor de texto como el visor para mostrar el contenido de ese paso.
-
-## Tarjeta de título
-
-La tarjeta de título es lo primero que ve el público. Muestra el título, subtítulo y línea de autoría de tu historia.
-
-Para editar la tarjeta de título, haz clic directamente en cualquiera de sus campos. Los cambios se guardan automáticamente a medida que escribes — no hay un botón de guardar aparte. La tarjeta de título es siempre el primer elemento en la barra lateral de pasos.
-
-## Visor IIIF
-
-El lado derecho del editor muestra un visor IIIF interactivo. Cuando un paso hace referencia a un objeto de imagen, puedes desplazar y ampliar para encuadrar la vista exacta que deseas que vea el público.
-
-Para capturar la vista actual de un paso:
-
-1. Navega al paso que deseas configurar
-2. Desplaza y amplía el visor hasta que la imagen muestre el encuadre que deseas
-3. El Compositor captura las coordenadas actuales de x, y y zoom y las guarda en el paso
-
-Estas coordenadas controlan lo que ve el público cuando llega a ese paso en la historia publicada. Para más información sobre cómo funcionan las coordenadas del visor en Telar, consulta [Historias y paneles](/guia/tu-contenido/historias-y-paneles/).
-
-## Gestión de pasos
-
-La barra lateral lista todos los pasos de tu historia. Aquí puedes reorganizar y modificar la estructura de la historia.
-
-- **Agregar un paso** — Haz clic en el botón de agregar en la parte inferior de la barra lateral para añadir un nuevo paso al final
-- **Insertar un paso** — Haz clic en el botón de insertar entre dos pasos existentes para colocar un nuevo paso en esa posición
-- **Eliminar un paso** — Elimina un paso y su contenido de la historia
-- **Reordenar pasos** — Arrastra un paso por su asa para moverlo a una nueva posición en la secuencia
-
-### Selector de objetos
-
-Cada paso puede mostrar un objeto diferente en el visor. Para cambiar qué objeto muestra un paso, usa el selector de objetos — te permite explorar todos los objetos de tu exhibición y seleccionar uno para el paso actual.
-
-Cuando un paso hace referencia a un objeto de video o audio, la columna del visor muestra el reproductor de medios correspondiente en lugar del visor IIIF. Consulta [Video y audio](/guia/el-compositor/video-y-audio/) para más detalles sobre los pasos multimedia.
-
-## Edición de capas
-
-El panel de texto de cada paso utiliza un editor con vista previa en vivo basado en CodeMirror. Escribes en *Markdown* y ves el resultado formateado de inmediato — no necesitas alternar entre modos de edición y vista previa.
-
-### Barra de formato
-
-La barra de herramientas sobre el editor ofrece acceso rápido a las opciones de formato más comunes:
-
-- **Negrita** y **cursiva** — Énfasis y énfasis fuerte
-- **Enlace** — Insertar o editar un hipervínculo
-- **Imagen** — Insertar una imagen en el texto del panel
-- **Encabezados** — Aplicar niveles de encabezado (H2, H3)
-- **Listas** — Listas con viñetas y listas numeradas
-- **Cita** — Bloques de cita indentados
-- **Deshacer** y **Rehacer** — Retroceder o avanzar en las ediciones
-
-### Atajos de teclado
-
-Para editar más rápido, el editor admite atajos de teclado estándar:
-
-| Atajo | Acción |
-|---|---|
-| Cmd+B (Ctrl+B en Windows/Linux) | Negrita |
-| Cmd+I (Ctrl+I en Windows/Linux) | Cursiva |
-| Cmd+K (Ctrl+K en Windows/Linux) | Insertar enlace |
-| Cmd+Z (Ctrl+Z en Windows/Linux) | Deshacer |
-
-### Inserción de imágenes
-
-Puedes agregar imágenes al texto de tu panel de dos maneras:
-
-- **Desde una URL** — Pega cualquier URL de imagen y el editor la inserta como imagen en *Markdown*
-- **Desde tus objetos IIIF** — Explora los objetos de tu repositorio y selecciona uno. El Compositor genera la URL correcta automáticamente.
-
-### Pegado enriquecido
-
-Cuando pegas contenido desde otras aplicaciones — como un procesador de texto o una página web — el editor convierte automáticamente el formato HTML a *Markdown*. El texto en negrita se mantiene en negrita, los enlaces siguen siendo funcionales y los encabezados conservan sus niveles. Esto facilita trasladar texto existente a los paneles de tu historia.
-
-### Preservación de inserciones
-
-Si pegas un código de inserción de YouTube o Vimeo (una etiqueta `<iframe>`), el editor lo preserva como HTML sin procesar en lugar de convertirlo. Esto te permite insertar reproductores de video directamente en el texto del panel, independientemente de la columna del visor.
-
-## Véase también
-
-- [Panel de control](/guia/el-compositor/panel-de-control/) — Regresa a la vista general del proyecto
-- [Video y audio](/guia/el-compositor/video-y-audio/) — Trabajar con pasos de video y audio
-- [Publicación](/guia/el-compositor/publicacion/) — Revisar y publicar cambios
-- [Historias y paneles](/guia/tu-contenido/historias-y-paneles/) — Cómo funcionan las historias en Telar
-- [Contenido enriquecido](/guia/tu-contenido/contenido-enriquecido/) — Referencia de formato *Markdown* para texto de paneles
diff --git a/docs/9-4-story-editor.md b/docs/9-4-story-editor.md
deleted file mode 100644
index 5757a85..0000000
--- a/docs/9-4-story-editor.md
+++ /dev/null
@@ -1,98 +0,0 @@
----
-layout: docs
-title: "9.4. Story Editor"
-parent: "9. The Compositor"
-grand_parent: Documentation
-nav_order: 4
-lang: en
-permalink: /docs/the-compositor/story-editor/
----
-
-# Story Editor
-
-The story editor is where you build and refine your narratives. It combines a text editor, an interactive viewer, and step management tools into a single workspace — everything you need to compose a story without editing spreadsheet files.
-
-When you open a story from the [Dashboard](/docs/the-compositor/dashboard/), the editor loads with the title card on the left and the viewer on the right. Each step in your story appears as a card in the sidebar, and selecting a step updates both the text editor and the viewer to show that step's content.
-
-## Title card
-
-The title card is the first thing your audience sees. It displays your story's title, subtitle, and byline.
-
-To edit the title card, click directly on any of its fields. Changes save automatically as you type — there is no separate save button. The title card is always the first item in the step sidebar.
-
-## IIIF viewer
-
-The right side of the editor shows an interactive IIIF viewer. When a step references an image object, you can pan and zoom to frame the exact view you want your audience to see.
-
-To capture the current view for a step:
-
-1. Navigate to the step you want to configure
-2. Pan and zoom the viewer until the image shows the framing you want
-3. The Compositor captures the current x, y, and zoom coordinates and saves them to the step
-
-These coordinates control what your audience sees when they reach that step in the published story. For background on how viewer coordinates work in Telar, see [Stories & Panels](/docs/your-content/stories-panels/).
-
-## Step management
-
-The sidebar lists all steps in your story. You can reorganize and modify your story structure here.
-
-- **Add a step** — Click the add button at the bottom of the sidebar to append a new step
-- **Insert a step** — Click the insert button between two existing steps to place a new step at that position
-- **Delete a step** — Remove a step and its content from the story
-- **Reorder steps** — Drag a step by its handle to move it to a new position in the sequence
-
-### Object picker
-
-Each step can display a different object in the viewer. To change which object a step shows, use the object picker — it lets you browse all objects in your exhibition and select one for the current step.
-
-When a step references a video or audio object, the viewer column shows the appropriate media player instead of the IIIF viewer. See [Video and Audio](/docs/the-compositor/video-audio/) for details on working with multimedia steps.
-
-## Layer editing
-
-The text panel for each step uses a live preview editor powered by CodeMirror. You write in markdown and see the formatted result immediately — no need to switch between editing and preview modes.
-
-### Formatting toolbar
-
-The toolbar above the editor provides quick access to common formatting options:
-
-- **Bold** and **Italic** — Emphasis and strong emphasis
-- **Link** — Insert or edit a hyperlink
-- **Image** — Insert an image into the panel text
-- **Headings** — Apply heading levels (H2, H3)
-- **Lists** — Bulleted and numbered lists
-- **Blockquote** — Indented quotation blocks
-- **Undo** and **Redo** — Step backward or forward through your edits
-
-### Keyboard shortcuts
-
-For faster editing, the editor supports standard keyboard shortcuts:
-
-| Shortcut | Action |
-|---|---|
-| Cmd+B (Ctrl+B on Windows/Linux) | Bold |
-| Cmd+I (Ctrl+I on Windows/Linux) | Italic |
-| Cmd+K (Ctrl+K on Windows/Linux) | Insert link |
-| Cmd+Z (Ctrl+Z on Windows/Linux) | Undo |
-
-### Image insertion
-
-You can add images to your panel text in two ways:
-
-- **From a URL** — Paste any image URL and the editor inserts it as a markdown image
-- **From your IIIF objects** — Browse the objects in your repository and select one. The Compositor generates the correct URL automatically.
-
-### Rich paste
-
-When you paste content from other applications — such as a word processor or a web page — the editor automatically converts the HTML formatting to markdown. Bold text stays bold, links remain clickable, and headings keep their levels. This makes it easy to move existing text into your story panels.
-
-### Embed preservation
-
-If you paste a YouTube or Vimeo embed code (an `<iframe>` tag), the editor preserves it as raw HTML rather than converting it. This lets you embed video players directly in your panel text, separate from the viewer column.
-
-## See also
-
-- [Dashboard](/docs/the-compositor/dashboard/) — Return to the project overview
-- [Video and Audio](/docs/the-compositor/video-audio/) — Working with video and audio steps
-- [Publishing](/docs/the-compositor/publishing/) — Review and publish your changes
-- [Stories & Panels](/docs/your-content/stories-panels/) — How stories work in Telar
-- [Rich Content](/docs/your-content/rich-content/) — Markdown formatting reference for panel text
diff --git a/docs/9-7-sync-updates.es.md b/docs/9-7-sync-updates.es.md
deleted file mode 100644
index f0e8b69..0000000
--- a/docs/9-7-sync-updates.es.md
+++ /dev/null
@@ -1,64 +0,0 @@
----
-layout: docs
-title: "9.7. Sincronización y actualizaciones"
-parent: "9. El Compositor"
-grand_parent: Documentación
-nav_order: 7
-lang: es
-permalink: /guia/el-compositor/sincronizacion-y-actualizaciones/
----
-
-# Sincronización y actualizaciones
-
-El Compositor hace seguimiento de los cambios en tu repositorio y las actualizaciones de Telar. Cuando regresas a un proyecto, verifica si algo cambió remotamente y si hay una versión más reciente de Telar disponible. Esta página explica cómo funcionan la sincronización y las actualizaciones.
-
-## Detección al regresar
-
-Cada vez que abres el Compositor, verifica si tu repositorio de GitHub ha cambiado desde tu última sesión. Los cambios pueden provenir de otra persona colaboradora, de ediciones directas en GitHub o de una sesión anterior en un dispositivo diferente.
-
-Si el repositorio no ha cambiado, continúas donde lo dejaste. Si se detectan cambios, el Compositor te invita a resincronizar antes de editar.
-
-## Resincronización
-
-La resincronización importa el contenido más reciente de tu repositorio al Compositor. Esto asegura que trabajas con la versión más actual de tus objetos, historias y configuración.
-
-Durante la resincronización, el Compositor:
-
-1. Lee el estado actual de tu repositorio
-2. Actualiza tu proyecto local para reflejar cualquier cambio remoto
-3. Te advierte si los cambios remotos entran en conflicto con ediciones locales sin publicar
-
-{: .warning }
-> Si tienes cambios sin publicar en el Compositor y el repositorio también ha cambiado, el Compositor te advierte sobre posibles conflictos. Revisa la advertencia con cuidado — puede que necesites publicar tus cambios locales primero o aceptar que la versión remota reemplazará tus ediciones sin publicar.
-
-## Detección de versión
-
-El Compositor verifica qué versión de Telar ejecuta tu sitio. Si hay una versión más reciente disponible, te lo informa y ofrece actualizar.
-
-La detección de versión ocurre automáticamente al abrir tu proyecto. Si tu sitio ya ejecuta la versión más reciente, no se requiere ninguna acción.
-
-## Página de actualización
-
-Cuando hay una actualización disponible, el Compositor muestra una página de actualización con los detalles necesarios para tomar una decisión informada:
-
-- **Versión actual** — La versión de Telar que tu sitio ejecuta actualmente
-- **Versión destino** — La versión más reciente disponible
-- **Notas de la versión** — Un resumen de lo que cambió en la nueva versión — funciones nuevas, mejoras y correcciones
-- **Cambios de archivos agrupados** — Una lista de los archivos de Telar que se agregarán, modificarán o eliminarán, organizados por tipo
-
-Revisa esta información antes de continuar. Las actualizaciones modifican el código de Telar en tu repositorio pero no alteran tu contenido — tus objetos, historias y configuración se mantienen sin cambios.
-
-## Actualización con un clic
-
-Cuando estés listo para actualizar, haz clic en el botón de actualización. El Compositor confirma los archivos actualizados de Telar como un solo *commit* atómico en tu repositorio y hace seguimiento del *build* resultante, igual que en una publicación normal.
-
-Después de que la actualización se completa y el *build* finaliza correctamente, el Compositor continúa con la operación que estaba bloqueada originalmente por la verificación de versión. Por ejemplo, si estabas a punto de publicar y el Compositor detectó una versión desactualizada, la actualización se ejecuta primero y luego la publicación procede.
-
-{: .note }
-> La actualización modifica únicamente los archivos de código de Telar en tu repositorio. Tu contenido — objetos, historias, imágenes y configuración — nunca se modifica durante una actualización.
-
-## Véase también
-
-- [Publicación](/guia/el-compositor/publicacion/) — Cómo funcionan la publicación y el seguimiento de *builds*
-- [Panel de control](/guia/el-compositor/panel-de-control/) — Regresa a la vista general del proyecto
-- [Primeros pasos](/guia/el-compositor/primeros-pasos/) — Configuración inicial y conexión de un repositorio
diff --git a/docs/9-7-sync-updates.md b/docs/9-7-sync-updates.md
deleted file mode 100644
index ea2178d..0000000
--- a/docs/9-7-sync-updates.md
+++ /dev/null
@@ -1,64 +0,0 @@
----
-layout: docs
-title: "9.7. Sync and Updates"
-parent: "9. The Compositor"
-grand_parent: Documentation
-nav_order: 7
-lang: en
-permalink: /docs/the-compositor/sync-updates/
----
-
-# Sync and Updates
-
-The Compositor keeps track of changes in your repository and Telar updates. When you return to a project, it checks whether anything has changed remotely and whether a newer version of Telar is available. This page explains how synchronization and upgrades work.
-
-## On return detection
-
-Each time you open the Compositor, it checks whether your GitHub repository has changed since your last session. Changes might come from another collaborator, from direct edits on GitHub, or from a previous session on a different device.
-
-If the repository has not changed, you continue where you left off. If changes are detected, the Compositor prompts you to re-sync before editing.
-
-## Re-sync
-
-Re-syncing imports the latest content from your repository into the Compositor. This ensures you are working with the most current version of your objects, stories, and configuration.
-
-During re-sync, the Compositor:
-
-1. Reads the current state of your repository
-2. Updates your local project to reflect any remote changes
-3. Warns you if the remote changes conflict with unpublished local edits
-
-{: .warning }
-> If you have unpublished changes in the Compositor and the repository has also changed, the Compositor warns you about potential conflicts. Review the warning carefully — you may need to publish your local changes first or accept that the remote version will replace your unpublished edits.
-
-## Version detection
-
-The Compositor checks which version of Telar your site is running. If a newer version is available, it lets you know and offers to upgrade.
-
-Version detection happens automatically when you open your project. If your site is already running the latest version, no action is needed.
-
-## Upgrade page
-
-When an upgrade is available, the Compositor shows an upgrade page with the details you need to make an informed decision:
-
-- **Current version** — The version of Telar your site is currently running
-- **Target version** — The latest available version
-- **Release notes** — A summary of what changed in the new version — new features, improvements, and fixes
-- **Grouped file changes** — A list of the Telar files that will be added, modified, or removed, organized by type
-
-Review this information before proceeding. Upgrades update Telar's code in your repository but do not alter your content — your objects, stories, and configuration remain unchanged.
-
-## One-click upgrade
-
-When you are ready to upgrade, click the upgrade button. The Compositor commits the updated Telar files as a single atomic commit to your repository and tracks the resulting build, just like a regular publish.
-
-After the upgrade completes and the build succeeds, the Compositor continues to the operation that was originally blocked by the version check. For example, if you were about to publish and the Compositor detected an outdated version, the upgrade runs first and then the publish proceeds.
-
-{: .note }
-> Upgrading updates only Telar's code files in your repository. Your content — objects, stories, images, and configuration — is never modified by an upgrade.
-
-## See also
-
-- [Publishing](/docs/the-compositor/publishing/) — How publishing and build tracking work
-- [Dashboard](/docs/the-compositor/dashboard/) — Return to the project overview
-- [Getting Started](/docs/the-compositor/getting-started/) — Initial setup and connecting a repository
diff --git a/docs/index.es.md b/docs/index.es.md
deleted file mode 100644
index 4a14d8d..0000000
--- a/docs/index.es.md
+++ /dev/null
@@ -1,81 +0,0 @@
----
-layout: docs
-title: Documentación
-nav_order: 3
-has_children: true
-lang: es
-permalink: /guia/
----
-
-# Documentación
-
-{% assign _m = site.telar_release_date | date: "%m" | minus: 1 %}{% assign _months_es = "enero,febrero,marzo,abril,mayo,junio,julio,agosto,septiembre,octubre,noviembre,diciembre" | split: "," %}{% assign _month_es = _months_es[_m] %}
-> **Versión actual: v{{ site.telar_version }}** ({{ _month_es }} {{ site.telar_release_date | date: "%Y" }})
-> Esta documentación corresponde a Telar v{{ site.telar_version }}. Consulta el [CHANGELOG de Telar](https://github.com/UCSB-AMPLab/telar/blob/main/CHANGELOG.md) para notas de la versión.
-
-Bienvenido a la documentación de Telar. Esta guía te ayudará a crear narrativas visuales usando imágenes IIIF y scrollytelling.
-
-## Primeros pasos
-
-¿Nuevo en Telar? Comienza aquí:
-
-- [Primeros pasos](/guia/primeros-pasos/) - Elige tu método de configuración
-- [Usa el Compositor](/guia/primeros-pasos/compositor/) - Configuración visual, sin necesidad de programar
-- [Configura con Google Sheets](/guia/primeros-pasos/google-sheets/) - Configuración guiada con herramientas interactivas
-- [Desarrollo local](/guia/primeros-pasos/desarrollo-local/) - CSV + Jekyll para control total
-- [Planea tu narrativa](/guia/primeros-pasos/estructura-narrativa/) - Conoce el modelo narrativo
-- [Agrega tu contenido](/guia/primeros-pasos/agrega-contenido/) - Sube imágenes, crea historias
-- [Revisa y perfecciona](/guia/primeros-pasos/revisa-y-perfecciona/) - Dale los toques finales
-
-## Configura tu sitio
-
-- [Configuración manual](/guia/configuracion/configuracion-manual/) - Google Sheets + GitHub, no necesitas instalar nada
-- [Actualización](/guia/configuracion/actualizacion/) - Mantén tu sitio al día
-
-## Configura tu proyecto
-
-- [Generador y editor de configuración](/guia/configurar/generador-de-configuracion/) - Crea o edita tu _config.yml
-- [Referencia de configuración](/guia/configurar/configuracion/) - Lista completa de ajustes
-- [Validador de configuración](/guia/configurar/validador-de-configuracion/) - Verifica errores antes de hacer commit
-
-## Tu contenido
-
-- [Objetos](/guia/tu-contenido/objetos/) - Define objetos en tu hoja de cálculo con metadatos como título, creador y periodo
-- [Imágenes autoalojadas](/guia/tu-contenido/imagenes-autoalojadas/) - Sube imágenes y Telar genera teselas IIIF ampliables automáticamente
-- [Imágenes IIIF externas](/guia/tu-contenido/iiif-externo/) - Usa imágenes de museos, bibliotecas y otros proveedores IIIF
-- [Historias y paneles](/guia/tu-contenido/historias-paneles/) - Narrativas paso a paso con paneles de detalle
-- [Contenido enriquecido](/guia/tu-contenido/contenido-enriquecido/) - Archivos Markdown para paneles más ricos
-- [Sintaxis de Markdown](/guia/tu-contenido/sintaxis-markdown/) - Referencia de formato
-- [Widgets](/guia/tu-contenido/widgets/) - Carruseles, pestañas, acordeones
-
-## Tus datos
-
-- [Google Sheets](/guia/tus-datos/google-sheets/) - Configuración y flujo de trabajo
-- [Columnas del proyecto](/guia/tus-datos/csv-proyecto/) - Referencia de project.csv
-- [Columnas de objetos](/guia/tus-datos/csv-objetos/) - Referencia de objects.csv
-- [Columnas de historias](/guia/tus-datos/csv-historias/) - Referencia de CSV de historias
-- [Columnas del glosario](/guia/tus-datos/csv-glosario/) - Referencia de glossary.csv
-
-## Funciones del sitio
-
-- [Galería de objetos](/guia/funciones/galeria-objetos/) - Navega, busca y filtra tu colección
-- [Glosario](/guia/funciones/glosario/) - Términos consultables en línea
-- [Historias privadas](/guia/funciones/historias-privadas/) - Encripta historias con una clave
-- [Páginas personalizadas](/guia/funciones/paginas-personalizadas/) - Páginas independientes fuera de las historias
-- [Insertar en Canvas](/guia/funciones/insercion/) - Inserta en plataformas LMS
-
-## Personalización
-
-- [Temas](/guia/personalizacion/temas/) - Elige o crea temas visuales
-- [Página de inicio](/guia/personalizacion/pagina-inicio/) - Personaliza la página principal
-- [Menú de navegación](/guia/personalizacion/menu-navegacion/) - Configura el menú de navegación
-- [Contenido de demostración](/guia/personalizacion/contenido-demostracion/) - Historias de demostración integradas
-
-## Para desarrolladores
-
-- [Configuración local](/guia/desarrolladores/desarrollo-local/) - Configuración de Ruby, Jekyll y Python
-- [GitHub Actions](/guia/desarrolladores/github-actions/) - Referencia del flujo CI/CD
-- [Sistema de demostración](/guia/desarrolladores/sistema-demo/) - Cómo funciona el sistema de contenido demo
-- [Sistema de inserción](/guia/desarrolladores/sistema-de-insercion/) - Arquitectura de inserción en LMS
-- [Estilos avanzados](/guia/desarrolladores/estilos/) - CSS personalizado y diseños
-- [Optimización móvil](/guia/desarrolladores/movil/) - Guía de diseño responsive
diff --git a/docs/index.md b/docs/index.md
deleted file mode 100644
index 88fdb23..0000000
--- a/docs/index.md
+++ /dev/null
@@ -1,80 +0,0 @@
----
-layout: docs
-title: Documentation
-nav_order: 3
-has_children: true
-lang: en
-permalink: /docs/
----
-
-# Documentation
-
-> **Current Version: v{{ site.telar_version }}** ({{ site.telar_release_date | date: "%B %Y" }})
-> This documentation covers Telar v{{ site.telar_version }}. See the [Telar CHANGELOG](https://github.com/UCSB-AMPLab/telar/blob/main/CHANGELOG.md) for release notes.
-
-Welcome to the Telar documentation. This guide will help you create visual narrative exhibitions using IIIF images and scrollytelling.
-
-## Getting Started
-
-New to Telar? Start here:
-
-- [Getting Started](/docs/getting-started/) - Choose your setup method
-- [Use the Compositor](/docs/getting-started/compositor/) - Visual setup, no coding required
-- [Set Up with Google Sheets](/docs/getting-started/google-sheets/) - Guided setup with interactive tools
-- [Local Development](/docs/getting-started/local-dev/) - CSV + Jekyll for full control
-- [Plan Your Narrative](/docs/getting-started/narrative-structure/) - Understand the narrative model
-- [Add Your Content](/docs/getting-started/add-content/) - Upload images, create stories
-- [Review and Refine](/docs/getting-started/review-refine/) - Polish your exhibition
-
-## Set Up Your Site
-
-- [Manual Setup](/docs/setup/manual/) - Google Sheets + GitHub, no installation required
-- [Upgrading](/docs/setup/upgrading/) - Keep your site up to date
-
-## Configure Your Site
-
-- [Config Generator and Editor](/docs/configure/config-generator/) - Create or edit your _config.yml
-- [Configuration Reference](/docs/configure/configuration/) - Complete list of settings
-- [Config Validator](/docs/configure/config-validator/) - Check for errors before committing
-
-## Your Content
-
-- [Objects](/docs/your-content/objects/) - Define objects in your spreadsheet with metadata like title, creator, and period
-- [Self-Hosted Images](/docs/your-content/self-hosted-images/) - Upload images and Telar generates zoomable IIIF tiles automatically
-- [External IIIF Images](/docs/your-content/external-iiif/) - Use images from museums, libraries, and other IIIF providers
-- [Stories & Panels](/docs/your-content/stories-panels/) - Step-by-step narratives with detail panels
-- [Rich Content](/docs/your-content/rich-content/) - Markdown files for richer panels
-- [Markdown Syntax](/docs/your-content/markdown-syntax/) - Formatting reference
-- [Widgets](/docs/your-content/widgets/) - Carousels, tabs, accordions
-
-## Your Data
-
-- [Google Sheets](/docs/your-data/google-sheets/) - Spreadsheet setup and workflow
-- [Project Columns](/docs/your-data/csv-project/) - project.csv reference
-- [Object Columns](/docs/your-data/csv-objects/) - objects.csv reference
-- [Story Columns](/docs/your-data/csv-stories/) - Story CSV reference
-- [Glossary Columns](/docs/your-data/csv-glossary/) - glossary.csv reference
-
-## Site Features
-
-- [Objects Gallery](/docs/site-features/objects-gallery/) - Browse, search, and filter your collection
-- [Glossary](/docs/site-features/glossary/) - Terms viewers can look up inline
-- [Private Stories](/docs/site-features/private-stories/) - Encrypt stories with a key
-- [Custom Pages](/docs/site-features/custom-pages/) - Standalone pages outside stories
-- [Embedding in Canvas](/docs/site-features/embedding/) - Embed in LMS platforms
-
-## Customization
-
-- [Themes](/docs/customization/themes/) - Choose or create visual themes
-- [Home Page](/docs/customization/home-page/) - Customize the landing page
-- [Navigation Menu](/docs/customization/navigation-menu/) - Configure the nav menu
-- [Demo Content](/docs/customization/demo-content/) - Built-in demo stories
-
-## For Developers
-
-- [Local Dev Setup](/docs/developers/local-development/) - Ruby, Jekyll, and Python setup
-- [GitHub Actions](/docs/developers/github-actions/) - CI/CD workflow reference
-- [Demo System](/docs/developers/demo-system/) - How the demo content system works
-- [Embedding System](/docs/developers/embedding-system/) - LMS embedding architecture
-- [Advanced Styling](/docs/developers/styling/) - Custom CSS and layouts
-- [Mobile Optimization](/docs/developers/mobile/) - Responsive design guidelines
diff --git a/empezar.html b/empezar.html
deleted file mode 100644
index cef735d..0000000
--- a/empezar.html
+++ /dev/null
@@ -1,15 +0,0 @@
----
-permalink: /empezar/
----
-<!DOCTYPE html>
-<html lang="es">
-<head>
- <meta charset="utf-8">
- <meta http-equiv="refresh" content="0; url={{ '/guia/primeros-pasos/' | relative_url }}">
- <title>Redirigiendo…
-
-
-