# gettext_translator v0.7.0 - Table of Contents

Elixir Gettext add-on for translations with LLMs and LiveDashboard integration. Suport making pull request from livedashboard.

## Pages

- [GettextTranslator](readme.md)
- [Changelog](changelog.md)
- [Contributing to GettextTranslator](contributing.md)
- [Contributors](contributors.md)
- [Custom LLM Endpoint Guide](custom_endpoints.md)
- [LLM Gateway API - Elixir HTTP Wrapper for Local LLM Models](llm_gateway_example.md)

## Modules

- [GettextTranslator.Dashboard.Components.ExtractedStats](GettextTranslator.Dashboard.Components.ExtractedStats.md): Component for displaying newly extracted (pending) translations by language and domain,
with batch translate controls and progress tracking.

- [GettextTranslator.Dashboard.Components.GettextDashboardCSS](GettextTranslator.Dashboard.Components.GettextDashboardCSS.md): Provides CSS styles for the Gettext Translator Dashboard that match
Phoenix LiveDashboard's look and feel.

- [GettextTranslator.Dashboard.Components.Header](GettextTranslator.Dashboard.Components.Header.md): Header component for the Gettext Translator dashboard.

- [GettextTranslator.Dashboard.Components.LLMOverrideForm](GettextTranslator.Dashboard.Components.LLMOverrideForm.md): Component for overriding LLM provider settings per session.

- [GettextTranslator.Dashboard.Components.TabNav](GettextTranslator.Dashboard.Components.TabNav.md): Top-level tab navigation for the dashboard page.
Switches between Translation Stats, New Extracted, and New Translated views.

- [GettextTranslator.Dashboard.Components.TranslatedStats](GettextTranslator.Dashboard.Components.TranslatedStats.md): Component for displaying batch-translated translations from the current session,
grouped by language and domain for review, approval, and editing.

- [GettextTranslator.Dashboard.Components.TranslationDetails](GettextTranslator.Dashboard.Components.TranslationDetails.md): Component for showing and editing translation details.

- [GettextTranslator.Dashboard.Components.TranslationStats](GettextTranslator.Dashboard.Components.TranslationStats.md): Component for displaying translation statistics.

- [GettextTranslator.Dashboard.PromptTemplates](GettextTranslator.Dashboard.PromptTemplates.md): Locale-aware prompt templates for quick LLM translation actions.
- [GettextTranslator.Util.Extractor](GettextTranslator.Util.Extractor.md): Handles extraction and merging of gettext translations.

- Core
  - [GettextTranslator](GettextTranslator.md): A module for translating gettext files.
  - [GettextTranslator.Processor](GettextTranslator.Processor.md): Documentation for `GettextTranslator.Processor`.
Here we process parsing the PO files and extracting the messages.

  - [GettextTranslator.Processor.LLM](GettextTranslator.Processor.LLM.md):  LLM processor for the translator behaviour.

  - [GettextTranslator.Processor.Translator](GettextTranslator.Processor.Translator.md): Translator behavior.

  - [GettextTranslator.Util.GitHub](GettextTranslator.Util.GitHub.md)
  - [GettextTranslator.Util.GitLab](GettextTranslator.Util.GitLab.md)
  - [GettextTranslator.Util.Helper](GettextTranslator.Util.Helper.md): Helper functions

  - [GettextTranslator.Util.MakePullRequest](GettextTranslator.Util.MakePullRequest.md)
  - [GettextTranslator.Util.Parser](GettextTranslator.Util.Parser.md): Parse files in the gettext root folder

  - [GettextTranslator.Util.PathHelper](GettextTranslator.Util.PathHelper.md): Helper functions for working with PO and changelog file paths.

  - [GettextTranslator.Util.PoHelper](GettextTranslator.Util.PoHelper.md)

- Dashboard
  - [GettextTranslator.Dashboard](GettextTranslator.Dashboard.md): Phoenix LiveDashboard integration for GettextTranslator.
  - [GettextTranslator.Dashboard.DashboardPage](GettextTranslator.Dashboard.DashboardPage.md): Phoenix LiveDashboard page for managing Gettext translations.
  - [GettextTranslator.Supervisor](GettextTranslator.Supervisor.md): Supervisor for GettextTranslator processes.

- Operation
  - [GettextTranslator.Store](GettextTranslator.Store.md): In-memory store for translation entries and changelog using ETS.
This module is responsible for the low-level persistence layer.

  - [GettextTranslator.Store.Changelog](GettextTranslator.Store.Changelog.md): Service for managing changelog operations.
Maintains status history of translations with a simple 1:1 mapping.

  - [GettextTranslator.Store.Translation](GettextTranslator.Store.Translation.md): Service for managing translation operations.
Handles processing PO files and translation operations.

## Mix Tasks

- Mix Tasks
  - [mix gettext_translator.run](Mix.Tasks.GettextTranslator.Run.md):  GettextTranslator usage:
 * Base using default gettext folder (priv/gettext)
    ```
    mix gettext_translator.run
    ```