https://github.com/desentio/globalseo
Translate your website with ai
https://github.com/desentio/globalseo
ai i18n i18n-tool i18next i18next-backend localization translation
Last synced: 8 days ago
JSON representation
Translate your website with ai
- Host: GitHub
- URL: https://github.com/desentio/globalseo
- Owner: desentio
- Created: 2023-05-12T07:21:17.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-21T12:37:04.000Z (3 months ago)
- Last Synced: 2025-04-27T18:25:28.340Z (27 days ago)
- Topics: ai, i18n, i18n-tool, i18next, i18next-backend, localization, translation
- Language: JavaScript
- Homepage: https://globalseo.ai
- Size: 1.25 MB
- Stars: 7
- Watchers: 1
- Forks: 1
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Globalseo.ai Integration Guide
## Table of Contents
1. [About the Integration](#about-the-integration)
2. [Script Tag Example](#script-tag-example)
3. [Optional Configuration](#optional-configuration)
4. [Server-Side Rendering Configuration](#server-side-rendering-configuration)
5. [Excluding Text from Translation](#excluding-text-from-translation)
7. [Advanced Configuration](#advanced-configuration)
## About the Integration
To set up Globalseo, follow these steps:
1. **Sign Up**: Go to [Globalseo](https://app.globalseo.ai) and sign up.
2. **Create a Project**: Select the languages you want to translate your website into.
3. **Select Integration Mode**: Choose how you want your website to be translated. Then click "Save" and follow the integration steps on the website.
## Script Tag Example
Below is a script tag example with all possible configurations:
```html
```
## Optional Configuration
- **data-use-browser-language**: Automatically sets the language based on the user's browser language. Set to `false` to disable.
- **data-exclude-classes**: List CSS class names to exclude from translation, separated by commas (e.g., `chatbot, no-translate`).
- **data-exclude-ids**: List IDs to exclude from translation, separated by commas (e.g., `user-comment, code-snippet`).
- **data-exclude-paths**: List URL paths to exclude from translation, separated by commas (e.g., `/admin, /blog`). Note: Each path should start with a `/`.
## Server-Side Rendering Configuration
- **data-translation-mode**: Modifies the translated pages logic. Set to `subdomain` (e.g., `de.domain.com`) or `subdirectory` (e.g., `domain.com/de`). *Do not use* this option unless using SSR (available in higher plans).
## Excluding Text from Translation
To prevent translation of specific content, add the class `globalseo-exclude` to elements, such as chat pop-ups or user-generated text.
**Note:** Input fields and iframes are ignored by default.
## Advanced Configuration
- **data-translate-attributes**: Translates `title` & `alt` attributes of images and links for improved SEO and accessibility. Set to `true` to enable.
- **data-lang-parameter**: Custom URL parameter for setting the language (default: `lang`).
- **data-timeout**: Delay (in milliseconds) before the translation service activates, ensuring full page load.
- **data-replace-links**: Replaces links with translated URLs by appending the language code. Set to `false` to disable.
- **data-custom-language-code**: Custom language code mapping (e.g., `kk=kz` for "KZ" instead of "KK").
- **data-exclude-contents**: Excludes specific text from translation using regular expressions (`{{regex1}} {{regex2}}`).
- **data-translate-form-placeholder**: Translates form placeholders. Set to `true` to enable.
- **data-dynamic-translation**: Allows automatic generation of new translations. Set to `false` to disable. If quota is reached, setting this to `false` prevents error messages from appearing on your site.
- **data-translate-select-options**: Translates options inside `` elements. Set to `true` to enable. The `globalseo-exclude` class is still respected.