Tlön is a comprehensive Emacs package designed to streamline translation workflows, manage bibliographic data, and facilitate content creation for Tlön, our organization. It provides tools for working with Markdown files, YAML metadata, counterpart documents, and various import/export operations.
- Translation management: Create and manage translation files with automatic metadata handling
- Counterpart navigation: Seamlessly navigate between original and translated documents
- Bibliography integration: Comprehensive BibTeX and bibliography management
- Markdown extensions: Enhanced Markdown editing with custom MDX components
- Import tools: Import content from various sources including HTML, PDF, and external APIs
- YAML metadata: Robust metadata management and validation
- Git integration: Enhanced Git workflows with automatic commit generation
- Quality assurance: Automated cleanup and validation tools
The package is organized into several modules, each with comprehensive documentation:
- Tlön package - Main package file providing top-level commands and integration
- AI functionality - Integration with AI models for summarization, translation, and content creation
- API interaction - Interface with Tlön Babel APIs for citations and file management
- Cleanup tools - Automated formatting and quality assurance
- Clock management - Time tracking and workflow coordination
- Color palette management - Color palette management for frontend projects
- Contact management - Managing contacts stored in Org mode files
- Core functionality - Essential functions for repository management, lookups, and utilities
- Word counting and statistics - Word counting, statistics, and reporting tools
- Counterpart navigation - Tools for working with original and translated document pairs
- DeepL integration - Translation services and glossary management via DeepL API
- Db integration - Integration with external bibliographic database APIs
- Dictionary functionality - Dictionary and synonym lookup integration
- Dispatch commands - Main entry points and hierarchical menus for Tlön operations
- Dubbing - Audio and video dubbing functionality with ElevenLabs integration
- Email functionality - Email composition using predefined templates
- Fix utilities - Automated error correction and validation
- Forge integration - GitHub issues and Org mode TODO synchronization
- Glossary management - Multilingual glossary management and extraction
- Image processing - Image manipulation and optimization tools
- Import tools - Import content from HTML, PDF, and external sources
- Job management - Workflow management for translation jobs
- Markdown editing - Enhanced Markdown mode with MDX components and specialized editing tools
- Meeting management - Meeting issue creation and recording processing
- Text-to-speech control - TTS playback control and navigation
- Clock reporting and management - Time tracking reports and Git integration
- Repository management - Git repository creation, cloning, and management
- Search functionality - Search commands for commits, files, and translations
- Split window alignment - Window alignment for translation workflows
- BibTeX functionality - Bibliography management and citation handling
- Text-to-speech - Comprehensive TTS functionality with multiple engines
- URL handling - URL validation, archiving, and replacement tools
- YAML metadata - Metadata management and validation for translation files
- YouTube integration - Tools for managing YouTube videos and subtitles
The package requires several external packages. See the Package-Requires header in tlon.el for the complete list.
After installation, you’ll need to configure:
- Repository paths
- User information for Git operations
- Language preferences for translations
- Bibliography file locations
See the individual module documentation for detailed configuration instructions.
The package provides numerous interactive commands. The main point of entry is the main transient menu, tlon-dispatch.
Project-local agent skills for Tlön live under this repository’s .claude/skills/
and .codex/skills/ directories.
Scans, prioritizes, and batch-resolves open GitHub issues for
tlon-team/tlon.el. It keeps triage, verified local fixes, GitHub publication
and closure, and Org archiving separately scoped. It tracks processed issues
across batches, checks the bot identity and publication results, and archives
only an unambiguous matching Org heading. It reads the tlon-ai bot token
from the tlon-ai-github-token item of the personal 1Password Automation
vault.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.