Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: some improvements on glossary BiDi #33421

Merged
merged 6 commits into from
May 21, 2024
Merged
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
10 changes: 9 additions & 1 deletion files/en-us/glossary/bidi/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,16 @@ page-type: glossary-definition

{{GlossarySidebar}}

**BiDi** (BiDirectional) refers to a document containing both right-to-left and left-to-right text. Even when both directionalities occur in the same paragraph, the text in each language must appear in its proper directionality.
**BiDi** (BiDirectional) denotes the characteristic a document has, signifying that both right-to-left (RTL) and left-to-right (LTR) text orientations occurred in one document.
PassionPenguin marked this conversation as resolved.
Show resolved Hide resolved

User Interfaces should design to display BiDi content correctly, but many failed in this. An example is the RTL Hebrew name Sarah: שרה, spelled sin (ש) on the right, resh (ר) in the middle, and heh (ה) on the left, which, many programs would display the Hebrew word in the opposite order.
PassionPenguin marked this conversation as resolved.
Show resolved Hide resolved

It is possible to simply flip the left-to-right display order to a right-to-left display order, but doing this sacrifices the ability to correctly display left-to-right scripts. With bidirectional script support, it is possible to mix characters from different scripts on the same page, regardless of writing direction.
PassionPenguin marked this conversation as resolved.
Show resolved Hide resolved

The Unicode standard provides foundations for complete BiDi support, with detailed rules as to how mixtures of left-to-right and right-to-left scripts are to be encoded and displayed.

## See also

- {{glossary("Unicode")}}
- [Bi-directional text](https://en.wikipedia.org/wiki/Bi-directional_text) on Wikipedia
- [UAX#9: Unicode Bi-directional Algorithm](https://www.unicode.org/reports/tr9/#Resolving_Weak_Types)
PassionPenguin marked this conversation as resolved.
Show resolved Hide resolved