@@ -4737,7 +4737,7 @@ <h2>Internationalization Considerations</h2>
4737
4737
This section outlines general internationalization considerations to take into
4738
4738
account when utilizing this data model and is intended to highlight specific
4739
4739
parts of the < em > Strings on the Web: Language and Direction Metadata</ em >
4740
- document [[STRING-META]] that implementers might be interested in perusing .
4740
+ document [[STRING-META]] that implementers might be interested in reading .
4741
4741
</ p >
4742
4742
4743
4743
< section class ="informative ">
@@ -4767,29 +4767,35 @@ <h3>Language and Base Direction</h3>
4767
4767
4768
4768
< p >
4769
4769
An example utilizing the design pattern above is shown below to express the
4770
- human-readable text "revoked" in the English language without specifying a
4771
- text direction:
4770
+ title of a book in the English language without specifying a text direction:
4772
4771
</ p >
4773
4772
4774
4773
< pre class ="example nohighlight " title ="Expressing natural language text as English ">
4775
- "statusReason ": {
4776
- "value": "< span class ="highlight "> Revoked </ span > ",
4774
+ "title ": {
4775
+ "value": "< span class ="highlight "> HTML and CSS: Designing and Creating Websites </ span > ",
4777
4776
"lang": "< code > en</ code > "
4778
4777
}
4779
4778
</ pre >
4780
4779
4781
4780
< p >
4782
- The next example uses a term in Arabic with a base direction of right-to-left:
4781
+ The next example uses a similar title expressed in the Arabic language with a
4782
+ base direction of right-to-left:
4783
4783
</ p >
4784
4784
4785
4785
< pre class ="example nohighlight " title ="Arabic text with a base direction of right-to-left ">
4786
- "statusReason ": {
4787
- "value": "< span class ="highlight "> إلغاء </ span > ",
4786
+ "title ": {
4787
+ "value": "< span class ="highlight "> HTML و CSS: تصميم و إنشاء مواقع الويب </ span > ",
4788
4788
"lang": "< code > ar</ code > "
4789
4789
"dir": "< code > rtl</ code > "
4790
4790
}
4791
4791
</ pre >
4792
4792
4793
+ < p class ="note ">
4794
+ The text above would most likley be rendered incorrectly as left to right
4795
+ without the explicit expression of language and direction as many systems will
4796
+ use the first character of a text string to determine text direction.
4797
+ < p >
4798
+
4793
4799
< p >
4794
4800
Utilization of the design pattern above assumes that the JSON-LD
4795
4801
< a href ="#extensibility "> extension</ a > associated with the
@@ -4801,9 +4807,9 @@ <h3>Language and Base Direction</h3>
4801
4807
</ p >
4802
4808
4803
4809
< pre class ="example nohighlight " title ="Specifying scoped aliasing for language information ">
4804
- "statusReason ": {
4810
+ "title ": {
4805
4811
< span class ="highlight "> "@context": {"value": "@value", "lang": "@language", "dir": "@direction"}</ span > ,
4806
- "@id": "https://www.w3.org/2018/credentials/examples#statusReason "
4812
+ "@id": "https://www.w3.org/2018/credentials/examples#title "
4807
4813
}
4808
4814
</ pre >
4809
4815
0 commit comments