summaryrefslogtreecommitdiff
path: root/maintenance/cssjanus/README
blob: 1b96d1a20f701313c69371061454acdba6caa7d0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
=CSSJanus=

_Flips CSS from LTR to an RTL orienation and vice-versa_

Author: `Lindsey Simon <elsigh@google.com>`

==Introduction==

CSSJanus is CSS parser utility designed to aid the conversion of a website's
layout from left-to-right(LTR) to right-to-left(RTL). The script was born out of
a need to convert CSS for RTL languages when tables are not being used for layout (since tables will automatically reorder TD's in RTL).
CSSJanus will change most of the obvious CSS property names and their values as
well as some not-so-obvious ones (cursor, background-position %, etc...).
The script is designed to offer flexibility to account for cases when you do
not want to change certain rules which exist to account for bidirectional text
display bugs, as well as situations where you may or may not want to flip annotations inside of the background url string.
Note that you can disable CSSJanus from running on an entire class or any
rule within a class by prepending a /* @noflip */ comment before the rule(s)
you want CSSJanus to ignore.

CSSJanus itself is not always enough to make a website that works in a LTR
language context work in a RTL language all the way, but it is a start.

==Getting the code==

View the trunk at:

  http://cssjanus.googlecode.com/svn/trunk/

Check out the latest development version anonymously with:

{{{
  $ svn checkout http://cssjanus.googlecode.com/svn/trunk/ cssjanus
}}}

==Using==

Usage:
  ./cssjanus.py < file.css > file-rtl.css
Flags:
  --swap_left_right_in_url: Fixes "left"/"right" string within urls.
  Ex: ./cssjanus.py --swap_left_right_in_url < file.css > file_rtl.css
  --swap_ltr_rtl_in_url: Fixes "ltr"/"rtl" string within urls.
  Ex: ./cssjanus.py --swap_ltr_rtl_in_url < file.css > file_rtl.css

If you'd like to make use of the webapp version of cssjanus, you'll need to
download the Google App Engine SDK
  http://code.google.com/appengine/downloads.html
and also drop a "django" directory into this directory, with the latest svn
from django. You should be good to go with that setup. Please let me know
otherwise.

==Bugs, Patches==

Patches and bug reports are welcome, just please keep the style
consistent with the original source. If you find a bug, please include a diff
of cssjanus_test.py with the bug included as a new unit test which fails. It
will make understanding and fixing the bug easier.

==Todo==

* Include some helpers for some typical bidi text solutions?
* Aural CSS (azimuth) swapping?

==Contributors==

Additional thanks to Mike Samuel for his work on csslex.py, Andy Perelson for
his help coding and reviewing, Stephen Zabel for his help with i18n and my sanity,
and to Eric Meyer for his thoughtful input.
Thanks to Junyu Wang for the Chinese translation.
Thanks to Masashi Kawashima for the Japanese translation.
Thanks to Taaryk Taar and Tariq Al-Omaireeni for an updated Arabic translation.
Thanks to Jens Meiert for the German translation.

==License==

{{{
  Copyright 2008 Google Inc. All Rights Reserved.

  Licensed under the Apache License, Version 2.0 (the 'License');
  you may not use this file except in compliance with the License.
  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an 'AS IS' BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
}}}