Maxime Lucas

Repositories

13

Projects Packages

4

Public activity Starred repositories

@mlcs/nuxt-tolgee (1.4.1)

Published 2024-01-11 13:23:20 +01:00 by freesker in mlcsthor/nuxt-tolgee

Installation

Setup this registry in your project .npmrc file:

@mlcs:registry=

To install the package using npm, run the following command:

npm install @mlcs/nuxt-tolgee@1.4.1

or add it to the package.json file:

"@mlcs/nuxt-tolgee": "1.4.1"

For more information on the npm registry, see the documentation.

About this package

Nuxt Tolgee

⚠ To use this module, SSR must be disabled (ssr: false in nuxt.config.ts)

Quick Setup

1. Log to NPM registry

npm config set @mlcs:registry https://git.deditoolbox.fr/api/packages/mlcsthor/npm/

npm config set -- '//git.deditoolbox.fr/api/packages/mlcsthor/npm/:_authToken' "[personal_access_token]"

2. Add @mlcs/nuxt-tolgee dependency to your project

yarn add @mlcs/nuxt-tolgee

3. Add @mlcs/nuxt-tolgee to the modules section of nuxt.config.ts

export default defineNuxtConfig({
  modules: ["@mlcs/nuxt-tolgee"],
});

4. Configure module inside nuxt.config.ts

export default defineNuxtConfig({
  tolgee: {
    // options
  },
});

5. Wrap content in app.vue with Provider

<template>
  <TolgeeProvider>
    <template #fallback>
      <div>Loading...</div>
    </template>

    <NuxtLayout>
      <NuxtPage />
    </NuxtLayout>
  </TolgeeProvider>
</template>

<script setup lang="ts">
const { TolgeeProvider } = useTranslate()
</script>

That's it! You can now use @mlcs/nuxt-tolgee in your Nuxt app ✨

Configuration

Name	Type	Default	Description
url	string	/	Your Tolgee instance url
key	string	/	Your Tolgee apiKey
defaultLanguage	string	en	Default language
languages	string[]	[]	List of all available languages
hook	boolean	true	Auto-retrieve translations from your instance on build
defaultNamespace	boolean	''	Default namespace used by useTranslate
namespaces	boolean	[]	Namespaces to download from platform

Usage

<template>
  <p>{{ t('hello') }}</p>
  <p>Current language: {{ language }}</p></template
>

<script setup lang="ts">
  const { t, language } = useTranslate()
  const { t: t2 } = useTranslate('test')

  console.log(t("world"));
</script>

Development

# Install dependencies
yarn install

# Generate type stubs
yarn dev:prepare

# Develop with the playground
yarn dev

# Build the playground
yarn dev:build

# Run ESLint
yarn lint

# Run Vitest
yarn test
yarn test:watch

# Release new version
yarn release

Dependencies

Dependencies

ID	Version
@nuxt/kit	^3.9.1
@tolgee/vue	^5.19.0
defu	^6.1.4
unzipit	^1.4.3

Development dependencies

ID	Version
@nuxt/eslint-config	^0.2.0
@nuxt/module-builder	^0.5.5
@nuxt/schema	^3.9.1
@nuxt/test-utils	^3.9.01
@types/node	^20.10.8
@typescript-eslint/eslint-plugin	^6.18.1
@typescript-eslint/parser	^6.18.1
eslint	^8.56.0
eslint-config-prettier	^9.1.0
eslint-plugin-nuxt	^4.0.0
eslint-plugin-simple-import-sort	^10.0.0
eslint-plugin-sort-keys-fix	^1.1.2
eslint-plugin-typescript-sort-keys	^3.1.0
eslint-plugin-vue	^9.19.2
husky	^8.0.0
lint-staged	^15.2.0
nuxt	^3.9.1
vitest	^1.1.3
vue-eslint-parser	^9.4.0

Details

npm

mlcsthor/nuxt-tolgee

2024-01-11 13:23:20 +01:00

12

MIT

4.4 KiB

Assets (1)

nuxt-tolgee-1.4.1.tgz 4.4 KiB

Versions (5) View all

1.6.2 2024-11-17

1.6.1 2024-10-22

1.5.0 2024-05-18

1.4.2 2024-01-11

1.4.1 2024-01-11

Issues