docs: document msgctxt handling in PO format page#1111
Open
Anty0 wants to merge 2 commits into
Open
Conversation
Adds a 'msgctxt and key names' section explaining how Tolgee encodes the optional gettext msgctxt field into key names using the U+0004 separator, with an example and a link to the GNU Gettext documentation on contexts.
✅ Deploy Preview for tolgee-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
This was referenced May 26, 2026
Anty0
added a commit
to tolgee/tolgee-js
that referenced
this pull request
May 27, 2026
## Summary - The in-context **KeyDialog** and the **ScreenshotWithLabels** tooltip now use a new `<KeyName>` component that splits the key name on the U+0004 separator (set by tolgee-platform when importing gettext `.po` files with a `msgctxt`) and renders the `msgctxt` portion as a styled chip in front of the `msgid`. - Standalone implementation — no runtime dependency on `@tginternal/editor` to keep this package's bundle independent of release coordination. - The platform-side change introducing the separator and the matching chip visual lives in the companion tolgee-platform PR. ## Companion PRs - tolgee-platform: tolgee/tolgee-platform#3694 - editor: tolgee/editor#8 - documentation: tolgee/documentation#1111 <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **New Features** * Added improved key name rendering with enhanced formatting that visually distinguishes embedded metadata using dedicated styling * Updated the UI across dialogs and tooltips to consistently leverage the new key name display, improving visual clarity and presentation when viewing keys with associated metadata <!-- review_stack_entry_start --> [](https://app.coderabbit.ai/change-stack/tolgee/tolgee-js/pull/3523?utm_source=github_walkthrough&utm_medium=github&utm_campaign=change_stack) <!-- review_stack_entry_end --> <!-- end of auto-generated comment: release notes by coderabbit.ai -->
](https://app.coderabbit.ai/change-stack/tolgee/tolgee-js/pull/3523?utm_source=github_walkthrough&utm_medium=github&utm_campaign=change_stack){kind=link}
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
platform/formats/po.mdxexplaining how Tolgee encodes the gettextmsgctxtfield into key names using the U+0004 separator.msgctxtin the existing Feature support paragraph.Companion PRs