# Adding a New Language to Fess

This guide explains how to add internationalization (i18n) support for a new language in Fess.

## Overview

Fess uses a two-tier language support system:

1. **Full UI Translation** (13 languages): Complete user interface translation with label and message files
2. **Search/Analysis Support** (40+ languages): Language-specific text analysis for search indexing

      matrix:
        # Override automatic language detection by changing the below list
        # Supported options are ['csharp', 'cpp', 'go', 'java', 'javascript', 'python']
        language: ['java']
        # Learn more...
        # https://docs.github.com/en/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#overriding-automatic-language-detection

    steps:
    - name: Checkout repository

     */
    void init() throws IOException;

    /**
     * Converts the given text into a list of readings based on the specified field and languages.
     *
     * @param text the text to be converted.
     * @param field the field to be used for conversion.
     * @param langs the languages to be used for conversion.
     * @return a list of readings for the given text.
     * @throws IOException if an I/O error occurs during conversion.

    }

    /**
     * Language-specific analyzer normalizer.
     */
    protected class LangAnalyzerNormalizer implements Normalizer {
        /**
         * The language used for normalization.
         */
        protected final String lang;

        /**
         * Constructs a LangAnalyzerNormalizer with the specified language.
         *

 *
 * <p>
 * The hreflang attribute tells search engines about alternate versions of a page in different languages
 * or for different regions. This helps search engines serve the correct language or regional URL
 * to searchers.
 * </p>
 *

        }
        return converter.convert(text, field);
    }

    /**
     * Language-specific analyzer converter.
     */
    protected class LangAnalyzerConverter implements ReadingConverter {
        /** Language. */
        protected final String lang;

        /**
         * Constructor.
         * @param lang Language
         */
        protected LangAnalyzerConverter(final String lang) {

/**
 * Helper class for language detection.
 */
public class LanguageHelper {
    private static final Logger logger = LogManager.getLogger(LanguageHelper.class);

    /** An array of language fields. */
    protected String[] langFields;

    /** An array of supported languages. */
    protected String[] supportedLanguages;

    /** The language detector. */
    protected LanguageDetector detector;

        }

        return new String[0];
    }

    /**
     * Check if the search word is excluded.
     * @param searchWord Search word
     * @param field Field
     * @param langs Languages
     * @param analyzer Analyzer
     * @return True if the search word is excluded
     */
    protected boolean isExcludeSearchword(final String searchWord, final String field, final String[] langs,

### SuggestItem (Domain Entity)
Location: `src/main/java/org/codelibs/fess/suggest/entity/SuggestItem.java`

Core attributes: `text`, `timestamp`, `queryFreq`, `docFreq`, `userBoost`, `readings`, `tags`, `roles`, `languages`, `kinds`

Kind types: `DOCUMENT`, `QUERY`, `USER`

---

## Development Workflow

### Build Commands

```bash
mvn compile                              # Compile

        return config.searchFieldSet != null && config.searchFieldSet.contains(field);
    }

    /**
     * Gets the query languages from the current request.
     * @return An optional containing the query languages array, or empty if not available.
     */
    protected OptionalThing<String[]> getQueryLanguages() {
        return LaRequestUtil.getOptionalRequest()