diff --git a/src/assets/screenshots/crowdin/localization-resources/glossary_add_concept.png b/src/assets/screenshots/crowdin/localization-resources/glossary_add_concept.png deleted file mode 100644 index 3a0de7ffc..000000000 Binary files a/src/assets/screenshots/crowdin/localization-resources/glossary_add_concept.png and /dev/null differ diff --git a/src/assets/screenshots/crowdin/localization-resources/glossary_add_concept_dialog.png b/src/assets/screenshots/crowdin/localization-resources/glossary_add_concept_dialog.png index 95911d55f..0cba218e2 100644 Binary files a/src/assets/screenshots/crowdin/localization-resources/glossary_add_concept_dialog.png and b/src/assets/screenshots/crowdin/localization-resources/glossary_add_concept_dialog.png differ diff --git a/src/assets/screenshots/crowdin/localization-resources/glossary_add_concept_editor.png b/src/assets/screenshots/crowdin/localization-resources/glossary_add_concept_editor.png index 28fe4197c..8115f8db6 100644 Binary files a/src/assets/screenshots/crowdin/localization-resources/glossary_add_concept_editor.png and b/src/assets/screenshots/crowdin/localization-resources/glossary_add_concept_editor.png differ diff --git a/src/assets/screenshots/crowdin/localization-resources/glossary_concepts_view.png b/src/assets/screenshots/crowdin/localization-resources/glossary_concepts_view.png deleted file mode 100644 index 504a2c3b7..000000000 Binary files a/src/assets/screenshots/crowdin/localization-resources/glossary_concepts_view.png and /dev/null differ diff --git a/src/assets/screenshots/crowdin/localization-resources/glossary_create_glossary.png b/src/assets/screenshots/crowdin/localization-resources/glossary_create_glossary.png deleted file mode 100644 index 6b58c6e69..000000000 Binary files a/src/assets/screenshots/crowdin/localization-resources/glossary_create_glossary.png and /dev/null differ diff --git a/src/assets/screenshots/crowdin/localization-resources/glossary_create_glossary_dialog.png b/src/assets/screenshots/crowdin/localization-resources/glossary_create_glossary_dialog.png deleted file mode 100644 index 7ec1a44e8..000000000 Binary files a/src/assets/screenshots/crowdin/localization-resources/glossary_create_glossary_dialog.png and /dev/null differ diff --git a/src/assets/screenshots/crowdin/localization-resources/glossary_delete_all_concepts.png b/src/assets/screenshots/crowdin/localization-resources/glossary_delete_all_concepts.png deleted file mode 100644 index ea4654b41..000000000 Binary files a/src/assets/screenshots/crowdin/localization-resources/glossary_delete_all_concepts.png and /dev/null differ diff --git a/src/assets/screenshots/crowdin/localization-resources/glossary_edit_concept.png b/src/assets/screenshots/crowdin/localization-resources/glossary_edit_concept.png deleted file mode 100644 index aed593744..000000000 Binary files a/src/assets/screenshots/crowdin/localization-resources/glossary_edit_concept.png and /dev/null differ diff --git a/src/assets/screenshots/crowdin/localization-resources/glossary_share_glossaries.png b/src/assets/screenshots/crowdin/localization-resources/glossary_share_glossaries.png deleted file mode 100644 index d158e4a3d..000000000 Binary files a/src/assets/screenshots/crowdin/localization-resources/glossary_share_glossaries.png and /dev/null differ diff --git a/src/assets/screenshots/crowdin/localization-resources/glossary_term_hover.png b/src/assets/screenshots/crowdin/localization-resources/glossary_term_hover.png index 7000cb942..429825bed 100644 Binary files a/src/assets/screenshots/crowdin/localization-resources/glossary_term_hover.png and b/src/assets/screenshots/crowdin/localization-resources/glossary_term_hover.png differ diff --git a/src/assets/screenshots/crowdin/localization-resources/glossary_terms_view.png b/src/assets/screenshots/crowdin/localization-resources/glossary_terms_view.png deleted file mode 100644 index 776399698..000000000 Binary files a/src/assets/screenshots/crowdin/localization-resources/glossary_terms_view.png and /dev/null differ diff --git a/src/assets/screenshots/crowdin/localization-resources/glossary_upload_download.png b/src/assets/screenshots/crowdin/localization-resources/glossary_upload_download.png deleted file mode 100644 index 6a5778108..000000000 Binary files a/src/assets/screenshots/crowdin/localization-resources/glossary_upload_download.png and /dev/null differ diff --git a/src/assets/screenshots/enterprise/localization-resources/glossary_add_concept.png b/src/assets/screenshots/enterprise/localization-resources/glossary_add_concept.png deleted file mode 100644 index acde025d4..000000000 Binary files a/src/assets/screenshots/enterprise/localization-resources/glossary_add_concept.png and /dev/null differ diff --git a/src/assets/screenshots/enterprise/localization-resources/glossary_add_concept_dialog.png b/src/assets/screenshots/enterprise/localization-resources/glossary_add_concept_dialog.png index 33d2db417..1696d3e4a 100644 Binary files a/src/assets/screenshots/enterprise/localization-resources/glossary_add_concept_dialog.png and b/src/assets/screenshots/enterprise/localization-resources/glossary_add_concept_dialog.png differ diff --git a/src/assets/screenshots/enterprise/localization-resources/glossary_concepts_view.png b/src/assets/screenshots/enterprise/localization-resources/glossary_concepts_view.png deleted file mode 100644 index e0fb6d7c9..000000000 Binary files a/src/assets/screenshots/enterprise/localization-resources/glossary_concepts_view.png and /dev/null differ diff --git a/src/assets/screenshots/enterprise/localization-resources/glossary_create_glossary.png b/src/assets/screenshots/enterprise/localization-resources/glossary_create_glossary.png deleted file mode 100644 index 7c74c11b9..000000000 Binary files a/src/assets/screenshots/enterprise/localization-resources/glossary_create_glossary.png and /dev/null differ diff --git a/src/assets/screenshots/enterprise/localization-resources/glossary_create_glossary_dialog.png b/src/assets/screenshots/enterprise/localization-resources/glossary_create_glossary_dialog.png deleted file mode 100644 index 87ffe8324..000000000 Binary files a/src/assets/screenshots/enterprise/localization-resources/glossary_create_glossary_dialog.png and /dev/null differ diff --git a/src/assets/screenshots/enterprise/localization-resources/glossary_delete_all_concepts.png b/src/assets/screenshots/enterprise/localization-resources/glossary_delete_all_concepts.png deleted file mode 100644 index 56a8069f7..000000000 Binary files a/src/assets/screenshots/enterprise/localization-resources/glossary_delete_all_concepts.png and /dev/null differ diff --git a/src/assets/screenshots/enterprise/localization-resources/glossary_edit_concept.png b/src/assets/screenshots/enterprise/localization-resources/glossary_edit_concept.png deleted file mode 100644 index bf23c238e..000000000 Binary files a/src/assets/screenshots/enterprise/localization-resources/glossary_edit_concept.png and /dev/null differ diff --git a/src/assets/screenshots/enterprise/localization-resources/glossary_share_glossaries.png b/src/assets/screenshots/enterprise/localization-resources/glossary_share_glossaries.png deleted file mode 100644 index 10f0e84b4..000000000 Binary files a/src/assets/screenshots/enterprise/localization-resources/glossary_share_glossaries.png and /dev/null differ diff --git a/src/assets/screenshots/enterprise/localization-resources/glossary_terms_view.png b/src/assets/screenshots/enterprise/localization-resources/glossary_terms_view.png deleted file mode 100644 index e78c4a347..000000000 Binary files a/src/assets/screenshots/enterprise/localization-resources/glossary_terms_view.png and /dev/null differ diff --git a/src/assets/screenshots/enterprise/localization-resources/glossary_upload_download.png b/src/assets/screenshots/enterprise/localization-resources/glossary_upload_download.png deleted file mode 100644 index 3a954cf2b..000000000 Binary files a/src/assets/screenshots/enterprise/localization-resources/glossary_upload_download.png and /dev/null differ diff --git a/src/content/docs/crowdin/localization-resources/glossary.mdx b/src/content/docs/crowdin/localization-resources/glossary.mdx index 8b7dafa8a..d30e37072 100644 --- a/src/content/docs/crowdin/localization-resources/glossary.mdx +++ b/src/content/docs/crowdin/localization-resources/glossary.mdx @@ -4,23 +4,14 @@ description: Learn how to create, manage, and share glossaries in Crowdin slug: glossary --- -import { Steps, Aside, LinkCard, CardGrid } from '@astrojs/starlight/components'; +import { Steps, Aside, LinkCard, CardGrid, Badge } from '@astrojs/starlight/components'; import { Icon } from 'astro-icon/components'; import KBD from '~/components/KBD.astro'; import { Image } from 'astro:assets'; import termHover from '!/crowdin/localization-resources/glossary_term_hover.png'; -import createGlossary from '!/crowdin/localization-resources/glossary_create_glossary.png'; -import createGlossaryDialog from '!/crowdin/localization-resources/glossary_create_glossary_dialog.png'; -import addConcept from '!/crowdin/localization-resources/glossary_add_concept.png'; import addConceptDialog from '!/crowdin/localization-resources/glossary_add_concept_dialog.png'; import addConceptEditor from '!/crowdin/localization-resources/glossary_add_concept_editor.png'; -import conceptsView from '!/crowdin/localization-resources/glossary_concepts_view.png'; -import termsView from '!/crowdin/localization-resources/glossary_terms_view.png'; -import editConcept from '!/crowdin/localization-resources/glossary_edit_concept.png'; -import deleteAllConcepts from '!/crowdin/localization-resources/glossary_delete_all_concepts.png'; -import downloadUpload from '!/crowdin/localization-resources/glossary_upload_download.png'; import configureImport from '!/crowdin/localization-resources/glossary_configure_import.png'; -import shareGlossaries from '!/crowdin/localization-resources/glossary_share_glossaries.png'; With a glossary, you can create, store, and manage all the project terminology in one place. The main aim of terminology is to explain some specific terms or the ones often used in the project to be translated properly and consistently. @@ -36,10 +27,10 @@ To create a glossary, follow these steps: 1. Open your profile home page and select **Glossaries** on the left sidebar. - 2. Click **Create Glossary**. Create glossary + 2. At the top right, click **Create Glossary**. 3. In the appeared dialog, name your glossary and select a default language that will be displayed first in the table of glossary records. 4. *(Optional)* Assign the glossary to the needed projects. You can skip this step and assign a glossary later. - 5. Click **Create**. Create glossary dialog + 5. Click **Create**. @@ -80,25 +71,42 @@ Term details: * Type – Classifies the term's function (e.g., full form, acronym, abbreviation, phrase, variant). * Status – Defines the term's approval level (e.g., preferred, admitted, not recommended). * Gender – The grammatical gender of the term (e.g., masculine, feminine, neuter). -* Description – A brief explanation or context for the specific term (distinct from the concept's definition). +* Description (context) – A brief explanation or context for the specific term (distinct from the concept's definition). * Note – Short notes about a term that might be helpful to translators. * URL – URL to the web page with relevant information about a term. +The concept dialog opens as a full-screen view with two panes: + +* The left pane contains concept-level details: the **Primary term** (filled in automatically from the source-language term), **Subject**, **Definition**, and the **Translatable** toggle. The expandable **Concept details** section holds the concept **Note**, **URL**, and **Figure**. +* The right pane lists all terms across languages, grouped by language. The source language is pinned at the top and marked with a badge. Each term row shows its **Part of speech**, **Gender**, **Type**, and **Status**, along with the **desc**, **url**, and **note** badges that expand the term's **Description (context)**, **URL**, and **Note** fields. + To add a new glossary concept, follow these steps: 1. Open your profile home page and select **Glossaries** on the left sidebar. Alternatively, open your project and go to **Settings > Glossaries**. 2. Click **View Records** on the needed glossary. - 3. Click **Add concept**. Add Concept - 4. In the appeared dialog, select the language from the drop-down menu, and specify the term and all related details. Click to detect the part of speech automatically. + 3. Click **Add term**. + 4. In the source-language row, enter the term and set its **Part of speech**, **Gender**, **Type**, and **Status**. Hover over the row and click to detect the part of speech automatically. - 5. *(Optional)* Click **Add term** to add a term variation (e.g., acronym, short form, etc.) - 6. Specify the concept details. - 7. Click **Create**. Add Concept Dialog + 5. *(Optional)* Click **Add term** below the language to add a term variation (e.g., acronym, short form, etc.) + 6. *(Optional)* Click **Add language** and search for a language to add its translation. + 7. Specify the concept details in the left pane (**Subject**, **Definition**, and the **Concept details** section). + 8. Click **Create**. Add Term as New Concept dialog + + + + To add glossary concepts via the Editor, follow these steps: @@ -120,13 +128,11 @@ Alternatively, you can grant full access, allowing them to manage all glossary t ### Viewing, Searching, and Filtering Glossary Concepts and Terms -Once you open a glossary, you can view and filter its glossary concepts and terms using either the **Concepts** or **Terms** tabs. +Once you open a glossary, you can switch between two views using the **Group by concept** toggle. -On the **Concepts** tab, you can view glossary content grouped as concepts (one concept per row, each term displayed in a separate language column). +With **Group by concept** enabled, glossary content is grouped as concepts (one concept per row), with each term's translations shown in separate language columns. Under each term, its part of speech, status, gender, and type appear as badges. -Concepts View - -On the **Terms** tab, you can view glossary content as individual terms (one term per row) with the following details: +With **Group by concept** disabled, glossary content is shown as individual terms (one term per row) with the following details: * **Term**: Contains either source or target language text. * **Language**: The term's language (e.g., French, Spanish). @@ -139,15 +145,12 @@ On the **Terms** tab, you can view glossary content as individual terms (one ter * **Concept subject**: The subject field from the parent concept. * **Concept definition**: The definition from the parent concept. -Terms View - -By default, all glossary concepts and terms are displayed. To find a specific concept or term, you can use the **Search** field. +By default, all glossary concepts and terms are displayed. To find a specific concept or term, type in the **Search** field. In both views, the search matches against the following fields: -In the **Concepts** tab, you can search by the following details: - -* **Terms** -* **Concept definitions** -* **Concept subjects** +* **Term text** +* **Term description (context)** +* **Concept definition** +* **Concept subject** To refine the search results, you can use the following options: @@ -155,26 +158,24 @@ To refine the search results, you can use the following options: * **Match whole phrase** * **Exact match** -To filter the list of concepts or terms, click **Filter** and use the available options: +To filter the list of concepts or terms, click **Filters** and use the available options: -* **Languages** (Specific to the **Terms** tab): Filter by **All languages** or a **Specific language**. -* **Modified**: Filter by modification date (**All**, **Custom Range**). +* **Languages** (available when **Group by concept** is disabled): Filter by **All languages** or a **Specific language**. +* **Last modified**: Filter by modification date (**All**, **Custom Range**). * **Part of speech**: Filter by grammatical category (**All**, **Noun**, **Verb**, etc.). * **Type**: Filter by classification (**All**, **Full form**, **Acronym**, etc.). * **Status**: Filter by approval status (**All**, **Preferred**, **Draft**, etc.). * **Gender**: Filter by grammatical gender (**All**, **Masculine**, **Feminine**, etc.). * **Author**: Filter by **All** or a particular user. -To sort concepts or terms, click **Sort by** and select one of the available options: - -* **Text** -* **Last modified** -* **Created** +To sort concepts or terms, click a column header. By default, the list is sorted by the source-language terms. You can also sort by the **Created** or **Last modified** column. Click a column header once to sort in ascending order and click again to sort in descending order. To customize your viewing experience, you can use the following options on the top toolbar: * **Word Wrap**: Click to toggle the word wrap feature. This is useful for viewing long texts (such as definitions, subjects, or notes) without expanding the column width. -* **Column Settings**: Click to configure which columns are displayed in the table. You can show or hide columns like *Definition*, *Subject*, *Translatable*, and *Note*, as well as the language columns. +* **Column Settings**: Click to configure which columns are displayed in the table. Use **All Columns** to show or hide all of them at once. + * **Concepts** view: You can show or hide columns such as *Definition*, *Subject*, *Translatable*, *Note*, *Created*, and *Last modified*, as well as the language columns. All columns and languages are shown by default, except *Translatable* and *Note*. + * **Terms** view: You can show or hide columns like *Language*, *Part of speech*, *Type*, *Status*, *Gender*, *Description (context)*, *Note*, *Concept subject*, and *Concept definition*. ### Editing Glossary Concepts and Terms @@ -185,20 +186,29 @@ To edit a glossary concept, follow these steps: 1. Open your profile home page and select **Glossaries** on the left sidebar. Alternatively, open your project and go to **Settings > Glossaries**. 2. Click **View Records** on the needed glossary. - 3. Open a glossary concept with a double-click or click **Edit**. - 4. In the appeared dialog, make the necessary edits to the concept or terms and click **Save**. Edit Glossary Concept + 3. Open a glossary concept with a double-click, or click on its row and select **Edit**. + 4. In the **Edit concept** dialog, make the necessary edits to the concept or its terms. The dialog uses the same two-pane layout described in [Creating Glossary Concepts and Terms](#creating-glossary-concepts-and-terms), with an added **Metadata** section that lists the concept **ID**, creation date, and last modification details. + 5. Click **Save**. -### Deleting Glossary Concepts + + +### Deleting Glossary Concepts and Terms + +You can delete a single term, an entire concept, or several concepts at once. + +When [editing a concept](#editing-glossary-concepts-and-terms), you can delete individual terms or the entire concept directly in the dialog: -You can delete one, multiple, or all the glossary concepts at once. +* Delete a single term – expand the term's row and click **Delete term**. +* Delete the entire concept – click **Delete concept** in the bottom-left corner of the dialog. -To delete all the concepts from the glossary, follow these steps: +To delete several concepts at once, follow these steps: - 1. Select the top checkbox above the concept list. - 2. Confirm the selection of all concepts. - 3. Click . Deleting Glossary Concepts + 1. Select the checkboxes next to the concepts you want to delete. To delete all concepts, select the top checkbox and confirm the selection of all concepts. + 2. Click . ## Managing Glossaries @@ -224,7 +234,7 @@ To upload or download the glossary, follow these steps: 3. Click and select one of the following options: * **Upload** – uploads new glossary content. * **Download** – downloads the full glossary. - * **Download filtered** – downloads only glossary concepts that match the applied filters or search criteria. Downloading and Uploading Glossary + * **Download filtered** – downloads only glossary concepts that match the applied filters or search criteria. The project owner and managers can upload and download the glossary in the following file formats: TBX (v2), TBX (v3), CSV, XLSX. @@ -295,7 +305,7 @@ To share your glossaries between all of the projects you own, follow these steps 1. Open your profile home page and select **Glossaries** on the left sidebar. - 2. Select **Share Glossaries**. Sharing Glossaries + 2. At the top left of the **Glossaries** page, select the **Share Glossaries** checkbox.