| CARVIEW |
Japanese Script Resources
More details about this document
- This version:
- https://www.w3.org/TR/2024/DNOTE-jpan-lreq-20240730/
- Latest published version:
- https://www.w3.org/TR/jpan-lreq/
- Latest editor's draft:
- https://w3c.github.io/jlreq/jpan/
- History:
- https://www.w3.org/standards/history/jpan-lreq/
- Commit history
- Editor:
- Richard Ishida (W3C)
- Feedback:
- GitHub w3c/jlreq (pull requests, new issue, open issues)
Copyright © 2018-2024 World Wide Web Consortium. W3C® liability, trademark and permissive document license rules apply.
Abstract
This document points to resources for the layout and presentation of text in languages that use the Japanese script. The target audience includes developers of Web standards and technologies, such as HTML, CSS, Mobile Web, Digital Publications, and Unicode, as well as implementers of web browsers, ebook readers, and other applications that need to render Japanese text.
Status of This Document
This section describes the status of this document at the time of its publication. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/.
This document points to resources for Japanese script layout and text support on the Web and in eBooks. These requirements provide information for Web technologies such as CSS, HTML and digital publications about how to support languages written using the Japanese script. The information here is developed in conjunction with a document that summarises gaps where the Web fails to adequately support the Japanese script.
The editor's draft of this document is being developed in the GitHub repository Japanese Language Enablement (jlreq), with contributors from the W3C Internationalization Interest Group. It is published by the Internationalization Working Group. The end target for this document is a Working Group Note.
To make it easier to track comments, please raise separate issues or emails for each comment, and point to the section you are commenting on using a URL.
This document was published by the Internationalization Working Group as a Group Draft Note using the Note track.
Group Draft Notes are not endorsed by W3C nor its Members.
This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than work in progress.
The W3C Patent Policy does not carry any licensing requirements or commitments on this document.
This document is governed by the 03 November 2023 W3C Process Document.
Some links on this page point to repositories or pages to which information will be added over time. Initially, the link may produce no results, but as issues, tests, etc. are created they will show up.
Links that have a gray color led to no content the last time this document was updated. They are still live, however, since relevant content could be added at any time. When the document is updated, links that now point to results will have their live colour restored.
This document was created by Richard Ishida.
See also the GitHub contributors list for the Japanese Language Enablement project, and the discussions related to the Japanese script.
This document points to resources for Japanese script layout and text support on the Web and in eBooks. These resources provide information for developers of Web technologies such as CSS, HTML and digital publications, and for application developers, about how to support languages written using the Japanese script. They include requirements, tests, GitHub discussions, type samples, and more,
The document focuses on typographic layout issues. For a deeper understanding of the Japanese script and how it works see Japanese Orthography Notes, which includes topics such as: Phonology, and Characters.
This document should be used alongside a separate document, Japanese Gap Analysis, which describes gaps in language support for users of the Japanese script, and prioritises and describes the impact of those gaps on the user.
Gap reports are brought to the attention of spec and browser implementers, and are tracked via the Gap Analysis Pipeline. (Filter for Japanese script items)
The document Language enablement index points to this document and others, and provides a central location for developers and implementers to find information related to various scripts.
The W3C also has a repository with discussion threads related to the Japanese script, including requests from developers to the user community for information about how scripts/languages work, and a notification system that tracks issues in W3C working groups related to the Japanese script. See a list of unresolved questions for Japanese experts. Each section below points to related discussions. See also the repository home page.
Four scripts are used, mixed together to write Japanese: kanji (han), katakana, hiragana, and latin. Essentially, Japanese writing is a mixture of an ideographic and a syllabic script. Non-latin letters typically represent a spoken syllable. See the table to the right for a brief overview of features for the modern Japanese orthography. The character count reflects a typical set of characters needed for everyday reading and writing: there are thousands more kanji characters that could be added for other purposes.
Text can be written horizontally or vertically. The visual forms of characters don't interact, but rotated and alternative glyph forms are needed to enable the switch between directions.
Words are not separated by spaces or any other character. There is no case distinction. The visual forms of characters don't interact.
Kanji characters are mostly derived from the Chinese Han script. They are used for word roots.
The term kana covers two syllabaries that are used with kanji characters to write Japanese.
One syllabary is hiragana, the other katakana. In both cases, the repertoire includes 5 independent vowel sounds, one nasal sound, and the rest are consonant+vowel combinations. There are a small number of additional characters with particular functions, such a katakana lengthening mark, and a few small characters for representing medial glides.
The Latin (romaji) characters and much of the punctuation corresponding to the ASCII range is available in fullwidth sizes that match the dimensions of the kanji and kana.
- GitHub discussions
- Type samples
- Tests
- Gap analysis
- Requirements
-
- Japanese Layout Requirements: Vertical Writing Mode and Horizontal Writing Mode • Japanese and Western Mixed Text Composition (including Horizontal-in-Vertical Text Composition)
- Orthography Notes: Japanese
- GitHub discussions
- Type samples
- Tests
- Gap analysis
- LE Index
- Requirements
-
- Orthography Notes: Japanese
- List of system fonts
- GitHub discussions
- Type samples
- Tests
- Gap analysis
- LE Index
- Requirements
-
- Orthography Notes: Japanese
- GitHub discussions
- Type samples
- Tests
-
- Exploratory/interactive test results (tbc)
- Exploratory/interactive test repo (tbc)
- Gap analysis
- LE Index
- Requirements
-
- Implementing Japanese Subtitles on Netflix: Slanted Text
- GitHub discussions
- Type samples
- Tests
- Gap analysis
- LE Index
- Requirements
-
- Orthography Notes: Japanese
- GitHub discussions
- Type samples
- Tests
- Gap analysis
- LE Index
- Requirements
-
- Orthography Notes, Characters: Japanese
- GitHub discussions
- Type samples
-
- W3C type samples
- r12a type samples: consonants • vowels
- Tests
-
- Exploratory/interactive test results (tbc)
- Exploratory/interactive test repo (tbc)
- Gap analysis
- LE Index
- Requirements
- GitHub discussions
- Type samples
- Tools
- Tests
- Gap analysis
- LE Index
- Requirements
-
- Japanese Layout Requirements: Characters Used for Japanese Composition • Line Composition Rules for Punctuation Marks • Examples of Items Jutting Out of the Kihon-hanmen • Character Positioning based on Kihon-hanmen • Design Grouping of Characters and Symbols depending on their Positioning
- Orthography Notes: Japanese
- GitHub discussions
- Type samples
-
- W3C type samples
- r12a type samples: phrases • bracketing
- Tests
-
- Exploratory/interactive test results (tbc)
- Exploratory/interactive test repo (tbc)
- Gap analysis
- LE Index
- Requirements
-
- Japanese Layout Requirements: Line Head Indent and Line End Indent • Processing of Spaces between Paragraphs • Adjustment of Processing of Realm in Block Direction • Differences in Vertical and Horizontal Composition in Use of Punctuation Marks
- Orthography Notes: Japanese
- Wikipedia: Quotation mark
- GitHub discussions
- Type samples
- Tests
- Gap analysis
- LE Index
- Requirements
-
- Japanese Layout Requirements: Composition of Emphasis Dots
- Orthography Notes: Japanese
- GitHub discussions
- Type samples
- Tests
- Gap analysis
- LE Index
- Requirements
-
- Orthography Notes: Japanese
- GitHub discussions
- Type samples
- Tests
-
- Exploratory/interactive test results (tbc)
- Exploratory/interactive test repo (tbc)
- Gap analysis
- LE Index
- Requirements
-
- Japanese Layout Requirements: Ruby and Emphasis Dots • Positioning of Jukugo-ruby • Inline Cutting Note (Warichu) • Superscripts and Superscripts • Furiwake Processing
- Implementing Japanese Subtitles on Netflix: Vertical Subtitles • Tate-chu-yoko
- Orthography Notes: Japanese
- r12a blog: What’s so difficult about jukugo ruby?
- Use Cases & Exploratory Approaches for Ruby Markup
- GitHub discussions
- Type samples
- Tests
- Gap analysis
- LE Index
- Requirements
-
- Japanese Layout Requirements: Examples of Items Jutting Out of the Kihon-hanmen • Line Gap Arrangement with Ruby and Other Objects
- Japanese Layout Requirements:
- Orthography Notes: Japanese
- GitHub discussions
- Type samples
- Tests
- Gap analysis
- LE Index
- Requirements
-
- GitHub discussions
- Type samples
- Tests
- Gap analysis
- LE Index
- Requirements
-
- Japanese Layout Requirements: Possibilities for Line-breaking between Characters
- Orthography Notes: Japanese
- Approaches to line-breaking
- GitHub discussions
- Type samples
- Tests
- Gap analysis
- LE Index
- Requirements
-
- Japanese Layout Requirements: Line Adjustment • Opportunities for Inter-character Space Reduction during Line Adjustment • Opportunities for Inter-character Space Expansion during Line Adjustment • Paragraph Adjustment Rules
- Orthography Notes: Japanese
- Approaches to full justification
- GitHub discussions
- Type samples
- Tests
- Gap analysis
- LE Index
- Requirements
-
- Japanese Layout Requirements: Positioning of Consecutive Opening Brackets, Closing Brackets, Commas, Full Stops and Middle Dots • Handling of Western Text in Japanese Text using Proportional Western Fonts
- Orthography Notes: Japanese
- GitHub discussions
- Type samples
- Tests
- Gap analysis
- LE Index
- Requirements
-
- Orthography Notes: Japanese
- GitHub discussions
- Type samples
- Tests
-
- Exploratory/interactive test results (tbc)
- Exploratory/interactive test repo (tbc)
- Gap analysis
- LE Index
- Requirements
- GitHub discussions
- Type samples
- Tests
- Gap analysis
- LE Index
- Requirements
-
- Orthography Notes: Japanese
- GitHub discussions
- Type samples
- Tests
- Gap analysis
- LE Index
- Requirements
-
- Japanese Layout Requirements: Vertical Writing Mode and Horizontal Writing Mode • Page Formats for Japanese Documents • Specifying the Kihon-hanmen • Block Direction Setting Process of Lines, Paragraphs etc.
- Orthography Notes: Japanese
- GitHub discussions
- Type samples
- Tests
-
- Exploratory/interactive test results (tbc)
- Exploratory/interactive test repo (tbc)
- Gap analysis
- LE Index
- Requirements
-
- GitHub discussions
- Type samples
- Tests
-
- Exploratory/interactive test results (tbc)
- Exploratory/interactive test repo (tbc)
- Gap analysis
- LE Index
- Requirements
-
- Japanese Layout Requirements: Processing of Notes
- Orthography Notes: Japanese
- GitHub discussions
- Type samples
- Tests
-
- Exploratory/interactive test results (tbc)
- Exploratory/interactive test repo (tbc)
- Gap analysis
- LE Index
- Requirements
-
- Japanese Layout Requirements: Running Heads and Page Numbers
- GitHub discussions
- Type samples
- Tests
-
- Exploratory/interactive test results (tbc)
- Exploratory/interactive test repo (tbc)
- Gap analysis
- LE Index
- Requirements
-
- Orthography Notes: Japanese
- GitHub discussions
- Type samples
- Tests
-
- Exploratory/interactive test results (tbc)
- Exploratory/interactive test repo (tbc)
- Gap analysis
- LE Index