Документация: Функция getConfiguration в intlayer

    Описание:

    Функция getConfiguration извлекает всю конфигурацию для приложения intlayer, получая переменные окружения. Эта функция обеспечивает гибкость использования одной и той же конфигурации как на стороне клиента, так и на стороне сервера, что гарантирует согласованность приложения.


    Параметры:

    Функция не принимает никаких параметров. Вместо этого она использует переменные окружения для конфигурации.

    Возвращает:

    • Тип: IntlayerConfig
    • Описание: Объект, содержащий полную конфигурацию для intlayer. Конфигурация включает в себя следующие разделы:

      • internationalization: Настройки, связанные с локалями и строгим режимом.
      • middleware: Настройки, связанные с управлением URL и куки.
      • content: Настройки, связанные с файловым содержимым, каталогами и шаблонами.
      • editor: Конфигурации, специфичные для редактора.

    Смотрите документацию по конфигурации Intlayer для получения дополнительной информации.


    Пример использования:

    Извлечение полной конфигурации:

    typescript
    import { getConfiguration } from "intlayer";
    
    const config = getConfiguration();
    console.log(config);
    // Вывод:
    // {
    //   internationalization: { ... },
    //   middleware: { ... },
    //   content: { ... },
    //   editor: { ... }
    // }
    

    Извлечение availableLocales и defaultLocale:

    Раздел internationalization конфигурации предоставляет настройки, связанные с локалями, такие как locales (доступные локали) и defaultLocale (язык по умолчанию).

    typescript
    const { internationalization, middleware } = getConfiguration();
    const { locales: availableLocales, defaultLocale } = internationalization;
    const { cookieName } = middleware;
    
    console.log(availableLocales); // Пример вывода: ["en", "fr", "es"]
    console.log(defaultLocale); // Пример вывода: "en"
    console.log(cookieName); // Вывод: "INTLAYER_LOCALE"
    

    Примечания:

    • Убедитесь, что все необходимые переменные окружения правильно установлены перед вызовом этой функции. Отсутствующие переменные вызовут ошибки во время инициализации.
    • Эта функция может использоваться как на стороне клиента, так и на стороне сервера, что делает её универсальным инструментом для управления конфигурациями в едином формате.

    Использование в приложениях:

    Функция getConfiguration является основным инструментом для инициализации и управления конфигурацией приложения intlayer. Предоставляя доступ к таким настройкам, как локали, промежуточное ПО и директории содержимого, она обеспечивает согласованность и масштабируемость в многоязычных и контентно ориентированных приложениях.

    Если у вас есть идея по улучшению этой документации, не стесняйтесь внести свой вклад, подав запрос на вытягивание на GitHub.

    Ссылка на документацию GitHub