https://github.com/w3c/alreq
Documenting gaps and requirements for support of Arabic Script languages on the Web and in eBooks.
https://github.com/w3c/alreq
arabic persian scripts text-layout typography writing-systems
Last synced: 6 months ago
JSON representation
Documenting gaps and requirements for support of Arabic Script languages on the Web and in eBooks.
- Host: GitHub
- URL: https://github.com/w3c/alreq
- Owner: w3c
- License: other
- Created: 2015-07-28T16:08:08.000Z (about 10 years ago)
- Default Branch: gh-pages
- Last Pushed: 2025-02-26T03:01:42.000Z (7 months ago)
- Last Synced: 2025-03-30T11:10:26.047Z (6 months ago)
- Topics: arabic, persian, scripts, text-layout, typography, writing-systems
- Language: HTML
- Homepage:
- Size: 12.4 MB
- Stars: 64
- Watchers: 33
- Forks: 24
- Open Issues: 92
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Language Enablement for Arabic Script languages (alreq)
This is the place to explore gaps in support for languages that use the Arabic script on the Web and in eBooks, and to document requirements.
We aim to address the problem that local users don't know how to tell the W3C what problems exist for support of their language on the Web, and the W3C doesn't know how to contact people who can help when questions arise.
Topics for discussion are suggested by [the gap-analysis template](https://www.w3.org/International/i18n-activity/templates/gap-analysis/gap-analysis_template.html). This work feeds into the [language matrix](https://www.w3.org/International/typography/gap-analysis/language-matrix.html) which provides a heat-map for language issues on the Web.
---
## Help wanted! ###
**We're looking for information about these writing systems. Follow the links for specific questions.**
**[Arabic](https://github.com/w3c/alreq/issues?q=is%3Aissue+is%3Aopen+label%3Al%3Aarb+label%3Aquestion) • [Kashmiri](https://github.com/w3c/alreq/issues?q=is%3Aissue+is%3Aopen+label%3Al%3Aks+label%3Aquestion) • [Persian](https://github.com/w3c/alreq/issues?q=is%3Aissue+is%3Aopen+label%3Al%3Apes+label%3Aquestion) • [Uighur](https://github.com/w3c/alreq/issues?q=is%3Aissue+is%3Aopen+label%3Al%3Aug+label%3Aquestion) • [Urdu](https://github.com/w3c/alreq/issues?q=is%3Aissue+is%3Aopen+label%3Al%3Aur+label%3Aquestion)**
---
### Key links
[GitHub repo](https://github.com/w3c/alreq) • [Discussion threads](https://github.com/w3c/alreq/issues) • [Charter](https://www.w3.org/International/alreq/charter/)
### Resource & requirement docs
- **Arabic Script Resources** • [DNOTE](https://www.w3.org/TR/arab-lreq) • [*Editor's draft*](https://w3c.github.io/alreq/arab/) • [*Latest commits*](https://github.com/w3c/alreq/commits/gh-pages/index.html)
- **Arabic & Persian Layout Requirements** • [DNOTE](https://www.w3.org/TR/alreq) • [*Editor's draft*](https://www.w3.org/International/alreq/) • [*Latest commits*](https://github.com/w3c/alreq/commits/gh-pages/index.html)
### Gap-analysis docs
- **Arabic Script Gap Analysis** • [DNOTE](https://www.w3.org/TR/alreq-gap) • [*Editor's draft*](https://www.w3.org/International/alreq/gap-analysis/) • [*Latest commits*](https://github.com/w3c/alreq/commits/gh-pages/gap-analysis/index.html)
### Discussions
- **Arabic** • [*Questions*](https://github.com/w3c/alreq/issues?q=is%3Aissue+is%3Aopen+label%3Al%3Aarb+label%3Aquestion)
• [*Gap reports*](https://github.com/w3c/alreq/labels/doc%3Aarfa)
• [*Other*](https://github.com/w3c/alreq/issues?q=is%3Aopen+label%3As%3Aarb+-label%3Aquestion)
• [*Spec issues*](https://github.com/w3c/i18n-activity/issues?q=is%3Aopen+label%3Aalreq+label%3Aspec-type-issue)
- **Kashmiri** • [*Questions*](https://github.com/w3c/alreq/issues?q=is%3Aissue+is%3Aopen+label%3Al%3Aks+label%3Aquestion)
• [*Gap reports*](https://github.com/w3c/alreq/labels/doc%3Aarab_ks)
• [*Other*](https://github.com/w3c/alreq/issues?q=is%3Aopen+label%3As%3Aks+-label%3Aquestion)
• [*Spec issues*](https://github.com/w3c/i18n-activity/issues?q=is%3Aopen+label%3Aalreq+label%3Aspec-type-issue)
- **Persian** • [*Questions*](https://github.com/w3c/alreq/issues?q=is%3Aissue+is%3Aopen+label%3Al%3Apes+label%3Aquestion)
• [*Gap reports*](https://github.com/w3c/alreq/labels/doc%3Aarab_fa)
• [*Other*](https://github.com/w3c/alreq/issues?q=is%3Aopen+label%3As%3Apes+-label%3Aquestion)
• [*Spec issues*](https://github.com/w3c/i18n-activity/issues?q=is%3Aopen+label%3Aalreq+label%3Aspec-type-issue)
- **Uighur** • [*Questions*](https://github.com/w3c/alreq/issues?q=is%3Aissue+is%3Aopen+label%3Al%3Aug+label%3Aquestion)
• [*Gap reports*](https://github.com/w3c/alreq/labels/doc%3Aarab_ug)
• [*Other*](https://github.com/w3c/alreq/issues?q=is%3Aopen+label%3As%3Aug+-label%3Aquestion)
• [*Spec issues*](https://github.com/w3c/i18n-activity/issues?q=is%3Aopen+label%3Aalreq+label%3Aspec-type-issue)
- **Urdu** • [*Questions*](https://github.com/w3c/alreq/issues?q=is%3Aissue+is%3Aopen+label%3Al%3Aur+label%3Aquestion)
• [*Gap reports*](https://github.com/w3c/alreq/labels/doc%3Aarab_ur)
• [*Other*](https://github.com/w3c/alreq/issues?q=is%3Aopen+label%3As%3Aur+-label%3Aquestion)
• [*Spec issues*](https://github.com/w3c/i18n-activity/issues?q=is%3Aopen+label%3Aalreq+label%3Aspec-type-issue)
### Related documents
- [Glossary source](https://docs.google.com/spreadsheets/d/1nSxYKQm_mKroCmxU4fyJ-g70Eo1_mF89yHZg8YNOuzc/edit#gid=0) (temporary Google spreadsheet)
- [Arabic mathematical notation](https://www.w3.org/TR/arabic-math/)
- [Additional Requirements for Bidi in HTML & CSS](https://www.w3.org/TR/html-bidi/)
- [Ready-made Counter Styles](https://www.w3.org/TR/predefined-counter-styles/#arabic-styles)
### Feedback
Please use the [GitHub issue list](https://github.com/w3c/alreq/issues) to report issues for language support, for discussions, and to send feedback about documents. (Learn [how GitHub issues work](https://www.w3.org/International/i18n-activity/guidelines/issues.html).)
Note that the public-i18n-arabic mailing list is used to send notification digests & meeting minutes. It is **not** for technical discussion.
### Participate
You can participate in the work at various levels. In order of increasing commitment, these include List subscriber, Participant, Editor, and Chair. [Explore the options](https://www.w3.org/International/i18n-drafts/pages/languagedev_participation.html).
**To just follow the work:** Rather than 'Watch' this repository, [subscribe](mailto:public-i18n-arabic-request@w3.org?subject=subscribe) to the [public-i18n-arabic](https://lists.w3.org/Archives/Public/public-i18n-arabic/) mailing list. That list is notified (no more than once a day, and in digest form), about changes to issues in this repository, but also about other W3C Working Group issues related to the Arabic writing systems.
**To contribute content:** All contributors should read and agree with [CONTRIBUTING.md](CONTRIBUTING.md).
**To become a participant, editor, or chair:** contact [Richard Ishida](mailto:ishida@w3.org). We welcome participation requests.
To get an idea about what's involved, see [Get involved with Language Enablement!](https://www.w3.org/International/i18n-drafts/pages/languagedev_participation).
### Contacts
- Chairs: Shervin Afshar, Behnam Esfahbod
- W3C staff: [Richard Ishida](mailto:ishida@w3.org)
- [Group participants](https://www.w3.org/groups/tf/i18n-alreq/participants)
### Links
- [Mail archive](https://lists.w3.org/Archives/Public/public-i18n-arabic/)
- [Writing i18n tests](https://github.com/w3c/i18n-tests/wiki/Writing-i18n-tests)
- [Practical tips for task forces](https://www.w3.org/International/i18n-activity/guidelines/process.html) (See also the github and editorial guidelines below)
- [Meeting info](https://www.w3.org/2017/07/alreq-meeting-info.html)
- [Archived, former action tracker](https://www.w3.org/International/groups/arabic-layout/track/)
### Links to background information
The following information describes work going on at the W3C to support languages on the Web.
- [Language support heatmap (matrix)](https://www.w3.org/International/typography/gap-analysis/language-matrix.html)
- [Analysing support for text layout on the Web](https://www.w3.org/International/i18n-drafts/nav/languagedev)
- [Overview of language enablement work in progress](https://www.w3.org/International/i18n-drafts/nav/languagedev)
- [Get involved with Language Enablement](https://www.w3.org/International/i18n-drafts/pages/languagedev_participation)
- [Setting up a Gap Analysis Project](https://github.com/w3c/typography/wiki/Setting-up-a-Gap-Analysis-Project)
- [Internationalization Sponsorship Program](https://www.w3.org/International/sponsorship/)
### Links for editors
If you end up creating a document, you should be familiar with and use the following:
- [Github guidelines for working with i18n documents](https://www.w3.org/International/i18n-activity/guidelines/github)
- [Editorial guidelines for working with i18n documents](https://www.w3.org/International/i18n-activity/guidelines/editing)