Getting Started

\n This guide will help you learn quickly and efficiently.\n

\n Need help?\n \n\n```\n\nText content gets translated while HTML structure and tags remain intact.\n\n### Attribute Handling\n\n```html\n $\"Welcome$ \n\n\n```\n\nTranslatable attributes like `alt`, `title`, `placeholder`, and `aria-label` get localized.\n\n### Semantic Preservation\n\n```html\n

Article Title

\n January 15, 2024\n

Article content goes here...

\n```\n\nSemantic HTML5 elements and their structure are preserved.\n\n## Advanced Features\n\n### Script and Style Protection\n\n```html\n\n\n\n```\n\nJavaScript and CSS content remains untouched.\n\n### Data Attributes\n\n```html\n

\n Visible content gets translated\n

\n```\n\nData attributes with translatable content are processed intelligently.\n\n## Advanced Configuration\n\n### Multiple HTML Directories\n\n```json\n\"html\": {\n \"include\": [\n \"content/[locale]/*.html\",\n \"pages/[locale]/**/*.html\"\n ]\n}\n```\n\n### Lock Technical Attributes\n\n```json\n\"html\": {\n \"include\": [\"content/[locale]/*.html\"],\n \"lockedKeys\": [\"id\", \"class\", \"data-id\", \"href\"]\n}\n```\n","content","\n**Lingo.dev CLI** translates HTML files while preserving markup structure, attributes, and semantic elements for websites and documentation. The CLI keeps all HTML markup and nesting intact, processes only translatable attributes intelligently, protects JavaScript and CSS from translation, handles HTML5 semantic elements correctly, and guarantees valid HTML output.\n\n## Quick Setup\n\nConfigure for HTML files with locale-based organization:\n\n```json\n{\n \"locale\": {\n \"source\": \"en\",\n \"targets\": [\"es\", \"fr\", \"de\"]\n },\n \"buckets\": {\n \"html\": {\n \"include\": [\"content/[locale]/*.html\"]\n }\n }\n}\n```\n\n**Reminder**: `[locale]` is a placeholder that should remain in the config literally, as it's replaced with the actual locale during CLI run.\n\n## Translate HTML Files\n\n```bash\nnpx lingo.dev@latest i18n\n```\n\nTranslates text content while preserving HTML structure, tags, attributes, and semantic markup.\n\n## Smart HTML Processing\n\n### Content Translation\n\n```html\n\n\n \n Welcome to Our Platform\n \n \n \n