]> sipb.mit.edu Git - ikiwiki.git/blob - doc/forum/PO_and_RTL_support/comment_1_5506d5878cfc7ad9a34f85c49d523ec3._comment
Added a comment: next steps
[ikiwiki.git] / doc / forum / PO_and_RTL_support / comment_1_5506d5878cfc7ad9a34f85c49d523ec3._comment
1 [[!comment format=mdwn
2  username="smcv"
3  ip="81.100.115.242"
4  subject="next steps"
5  date="2014-09-17T08:09:50Z"
6  content="""
7 HTML5 says:
8
9 > Authors are strongly encouraged to use the dir attribute to indicate text direction rather than using CSS, since that way their documents will continue to render correctly even in the absence of CSS (e.g. as interpreted by search engines).
10
11 Could you test whether your tip works with `<div dir=\"rtl\">` or something,
12 please? If it does, please change the tip, if not, we'll have to look at
13 whether the [[plugins/htmlscrubber]] is getting in the way.
14
15 After that, I think the next step towards good RTL support would be to
16 put together some test-cases for things that are meant to work, in the
17 form of:
18
19 * self-contained source code and setup file for a very simple wiki
20 * the pages in that wiki making it clear what their intended text
21   direction is (e.g. \"this paragraph should be right to left\")
22
23 As far as I know, none of the IkiWiki committers can read any RTL
24 languages, so if you use Arabic or Hebrew or whatever in those
25 test-cases, we'll need a screenshot/image of what it's meant to look 
26 like. Using Latin text marked as RTL (so it should come out backwards
27 if everything is working correctly) might be easier.
28
29 The obvious cases that I can think of are:
30
31 * the wiki is \"mostly\" in a RTL language
32 * the master language is LTR but the [[plugins/po]] plugin
33   provides a translation into a RTL language
34
35 and possibly
36
37 * the master language is RTL but the [[plugins/po]] plugin
38   provides a translation into a LTR language
39
40 It might be necessary to add support for a per-wiki, per-page or
41 (for po) per-translation-language direction override that would set
42 the `<html dir>` attribute, but we should find test-cases first, then we
43 can work out solutions.
44 """]]