Mercurial > vim

comparison runtime/doc/farsi.txt @ 237:73354c21f1e4 v7.0066

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
updated for version 7.0066
author vimboss
date Fri, 15 Apr 2005 21:13:42 +0000
parents 4102fb4ea781
children d8f905020502
comparison
equal deleted inserted replaced
236:4707450c2b33 237:73354c21f1e4
1 *farsi.txt* For Vim version 7.0aa. Last change: 2004 Jun 16 1 *farsi.txt* For Vim version 7.0aa. Last change: 2005 Mar 29
2 2
3 3
4 VIM REFERENCE MANUAL by Mortaza Ghassab Shiran 4 VIM REFERENCE MANUAL by Mortaza Ghassab Shiran
5 5
6 6
40 command. 40 command.
41 41
42 o Backing from reverse insert mode to the correct place in the file 42 o Backing from reverse insert mode to the correct place in the file
43 (if possible). 43 (if possible).
44 44
45 o While in Farsi mode, numbers are entered from left to right. Upon entering 45 o While in Farsi mode, numbers are entered from left to right. Upon entering
46 a none number character, that character will be inserted just into the 46 a none number character, that character will be inserted just into the
47 left of the last number. 47 left of the last number.
48 48
49 o No special terminal with right-to-left capabilities is required. The 49 o No special terminal with right-to-left capabilities is required. The
50 right-to-left changes are completely hardware independent. Only 50 right-to-left changes are completely hardware independent. Only
52 52
53 o Farsi keymapping on the command line in reverse insert mode. 53 o Farsi keymapping on the command line in reverse insert mode.
54 54
55 o Toggling between left-to-right and right-to-left via F8 function key. 55 o Toggling between left-to-right and right-to-left via F8 function key.
56 56
57 o Toggling between Farsi ISIR-3342 standard encoding and VIM Farsi via F9 57 o Toggling between Farsi ISIR-3342 standard encoding and Vim Farsi via F9
58 function key. Since this makes sense only for the text written in 58 function key. Since this makes sense only for the text written in
59 right-to-left mode, this function is also supported only in right-to-left 59 right-to-left mode, this function is also supported only in right-to-left
60 mode. 60 mode.
61 61
62 Farsi Fonts *farsi fonts* 62 Farsi Fonts *farsi fonts*
63 ----------- 63 -----------
75 Font Installation 75 Font Installation
76 ----------------- 76 -----------------
77 77
78 o Installation of fonts for MS Window systems (NT/95/98) 78 o Installation of fonts for MS Window systems (NT/95/98)
79 79
80 From 'Control Panel' folder, start the 'Fonts' program. Then from 'file' 80 From 'Control Panel' folder, start the 'Fonts' program. Then from 'file'
81 menu item select 'Install New Fonts ...'. Browse and select the 81 menu item select 'Install New Fonts ...'. Browse and select the
82 'far-a01.fon', then follow the installation guide. 82 'far-a01.fon', then follow the installation guide.
83 NOTE: several people have reported that this does not work. The solution 83 NOTE: several people have reported that this does not work. The solution
84 is unknown. 84 is unknown.
85 85
86 o Installation of fonts for X Window systems (Unix/Linux) 86 o Installation of fonts for X Window systems (Unix/Linux)
102 > xset +fp path_name_of_fonts_directory 102 > xset +fp path_name_of_fonts_directory
103 103
104 o Installation of ASCII screen fonts (Unix/Linux) 104 o Installation of ASCII screen fonts (Unix/Linux)
105 105
106 For Linux system, copy the far-a01.f16 fonts into /usr/lib/kbd/consolefonts 106 For Linux system, copy the far-a01.f16 fonts into /usr/lib/kbd/consolefonts
107 directory and execute the setfont program as "setfont far-a01.f16". For 107 directory and execute the setfont program as "setfont far-a01.f16". For
108 other systems (e.g. SCO Unix), please refer to the fonts installation 108 other systems (e.g. SCO Unix), please refer to the fonts installation
109 section of your system administration manuals. 109 section of your system administration manuals.
110 110
111 o Installation of ASCII screen fonts (DOS) 111 o Installation of ASCII screen fonts (DOS)
112 112
113 After system power on, prior to the first use of VIM, upload the Farsi 113 After system power on, prior to the first use of Vim, upload the Farsi
114 fonts by executing the far-a01.com font uploading program. 114 fonts by executing the far-a01.com font uploading program.
115 115
116 116
117 Usage 117 Usage
118 ----- 118 -----
119 Prior to starting VIM, the environment in which VIM can run in Farsi mode, 119 Prior to starting Vim, the environment in which Vim can run in Farsi mode,
120 must be set. In addition to installation of Farsi fonts, following points 120 must be set. In addition to installation of Farsi fonts, following points
121 refer to some of the system environments, which you may need to set: 121 refer to some of the system environments, which you may need to set:
122 Key code mapping, loading graphic card in ASCII screen mode, setting the IO 122 Key code mapping, loading graphic card in ASCII screen mode, setting the IO
123 driver in 8 bit clean mode ... . 123 driver in 8 bit clean mode ... .
124 124
125 o Setting the Farsi fonts 125 o Setting the Farsi fonts
126 126
127 + For VIM GUI set the 'guifont' to far-a01. This is done by entering 127 + For Vim GUI set the 'guifont' to far-a01. This is done by entering
128 ':set guifont=far-a01' in the VIM window. 128 ':set guifont=far-a01' in the Vim window.
129 129
130 You can have 'guifont' set to far-a01 by VIM during the VIM startup 130 You can have 'guifont' set to far-a01 by Vim during the Vim startup
131 by appending the ':set guifont=far-a01' into your .vimrc file 131 by appending the ':set guifont=far-a01' into your .vimrc file
132 (in case of NT/95/98 platforms _vimrc). 132 (in case of NT/95/98 platforms _vimrc).
133 133
134 Under the X Window environment, you can also start the VIM with 134 Under the X Window environment, you can also start Vim with the
135 '-fn far-a01' option. 135 '-fn far-a01' option.
136 136
137 + For the VIM within a xterm, start a xterm with the Farsi fonts (e.g. 137 + For Vim within a xterm, start a xterm with the Farsi fonts (e.g.
138 kterm -fn far-a01). Then start the VIM inside the kterm. 138 kterm -fn far-a01). Then start Vim inside the kterm.
139 139
140 + For VIM under DOS, prior to the first usage of VIM, upload the Farsi 140 + For Vim under DOS, prior to the first usage of Vim, upload the Farsi
141 fonts by executing the far-a01.com fonts uploading program. 141 fonts by executing the far-a01.com fonts uploading program.
142 142
143 o Farsi Keymapping Activation 143 o Farsi Keymapping Activation
144 144
145 To activate the Farsi keymapping, set either 'altkeymap' or 'fkmap'. 145 To activate the Farsi keymapping, set either 'altkeymap' or 'fkmap'.
146 This is done by entering ':set akm' or ':set fk' in the VIM window. 146 This is done by entering ':set akm' or ':set fk' in the Vim window.
147 You can have 'altkeymap' or 'fkmap' set as default by appending ':set akm' 147 You can have 'altkeymap' or 'fkmap' set as default by appending ':set akm'
148 or ':set fk' in your .vimrc file or _vimrc in case of NT/95/98 platforms. 148 or ':set fk' in your .vimrc file or _vimrc in case of NT/95/98 platforms.
149 149
150 To turn off the Farsi keymapping as a default second language keymapping, 150 To turn off the Farsi keymapping as a default second language keymapping,
151 reset the 'altkeymap' by entering ':set noakm'. 151 reset the 'altkeymap' by entering ':set noakm'.
152 152
153 o right-to-left Farsi Mode 153 o right-to-left Farsi Mode
154 154
155 By default VIM starts in Left-to-right mode. Following are ways to change 155 By default Vim starts in Left-to-right mode. Following are ways to change
156 the window orientation: 156 the window orientation:
157 157
158 + Start the VIM with -F option (e.g. vim -F ... ). 158 + Start Vim with the -F option (e.g. vim -F ...).
159 159
160 + Use F8 function key to toggle between left-to-right and right-to-left. 160 + Use the F8 function key to toggle between left-to-right and right-to-left.
161 161
162 + While in Left-to-right mode, enter 'set rl' in the command line ('rl' is 162 + While in Left-to-right mode, enter 'set rl' in the command line ('rl' is
163 the abbreviation for rightleft). 163 the abbreviation for rightleft).
164 164
165 + Put the 'set rl' line in your '.vimrc' file to start the VIM in 165 + Put the 'set rl' line in your '.vimrc' file to start Vim in
166 right-to-left mode permanently. 166 right-to-left mode permanently.
167 167
168 Encoding 168 Encoding
169 -------- 169 --------
170 170
171 The letter encoding used is the VIM extended ISIR-3342 standard with a built 171 The letter encoding used is the Vim extended ISIR-3342 standard with a built
172 in function to convert between VIM extended ISIR-3342 and ISIR-3342 standard. 172 in function to convert between Vim extended ISIR-3342 and ISIR-3342 standard.
173 173
174 For document portability reasons, the letter encoding is kept the same across 174 For document portability reasons, the letter encoding is kept the same across
175 different platforms (i.e. UNIX's, NT/95/98, MS DOS, ...). 175 different platforms (i.e. UNIX's, NT/95/98, MS DOS, ...).
176 176
177 177
181 mode as follows: 181 mode as follows:
182 182
183 + CTRL-_ moves the cursor to the end of the typed text in edit mode. 183 + CTRL-_ moves the cursor to the end of the typed text in edit mode.
184 184
185 + CTRL-_ in command mode only toggles keyboard mapping between Farsi(akm)/ 185 + CTRL-_ in command mode only toggles keyboard mapping between Farsi(akm)/
186 Latin. The Farsi text is then entered in reverse insert mode. 186 Latin. The Farsi text is then entered in reverse insert mode.
187 187
188 + F8 - Toggles between left-to-right and right-to-left. 188 + F8 - Toggles between left-to-right and right-to-left.
189 189
190 + F9 - Toggles the encoding between ISIR-3342 standard and VIM extended 190 + F9 - Toggles the encoding between ISIR-3342 standard and Vim extended
191 ISIR-3342 (supported only in right-to-left mode). 191 ISIR-3342 (supported only in right-to-left mode).
192 192
193 + Keyboard mapping is based on the Iranian ISIRI-2901 standard. 193 + Keyboard mapping is based on the Iranian ISIRI-2901 standard.
194 Following table shows the keyboard mapping while Farsi(akm) mode set: 194 Following table shows the keyboard mapping while Farsi(akm) mode set:
195 195
229 229
230 o In insert/replace mode and fkmap (Farsi mode) set, CTRL-B is not 230 o In insert/replace mode and fkmap (Farsi mode) set, CTRL-B is not
231 supported. 231 supported.
232 232
233 o If you change the character mapping between Latin/Farsi, the redo buffer 233 o If you change the character mapping between Latin/Farsi, the redo buffer
234 will be reset (emptied). That is, redo is valid and will function (using 234 will be reset (emptied). That is, redo is valid and will function (using
235 '.') only within the mode you are in. 235 '.') only within the mode you are in.
236 236
237 o While numbers are entered in Farsi mode, the redo buffer will be reset 237 o While numbers are entered in Farsi mode, the redo buffer will be reset
238 (emptied). That is, you can not redo the last changes (using '.') after 238 (emptied). That is, you cannot redo the last changes (using '.') after
239 entering numbers. 239 entering numbers.
240 240
241 o While in left-to-right and Farsi mode set, CTRL-R is not supported. 241 o While in left-to-right mode and Farsi mode set, CTRL-R is not supported.
242 242
243 o While in right-to-left mode, the search on 'Latin' pattern does not work, 243 o While in right-to-left mode, the search on 'Latin' pattern does not work,
244 except if you enter the Latin search pattern in reverse. 244 except if you enter the Latin search pattern in reverse.
245 245
246 o In the command mode, there is no support for entering the numbers from left 246 o In command mode there is no support for entering numbers from left
247 to right and also for the sake of the flexibility the keymapping logic is 247 to right and also for the sake of flexibility the keymapping logic is
248 restricted. 248 restricted.
249 249
250 o Under X Window environment, if you want to run the VIM within a xterm 250 o Under the X Window environment, if you want to run Vim within a xterm
251 terminal emulator and Farsi mode set, you need to have an ANSI compatible 251 terminal emulator and Farsi mode set, you need to have an ANSI compatible
252 xterm terminal emulator. This is because the letter codes above 128 decimal 252 xterm terminal emulator. This is because the letter codes above 128 decimal
253 have certain meanings in the standard xterm terminal emulator. 253 have certain meanings in the standard xterm terminal emulator.
254 254
255 Note: Under X Window environment, VIM GUI works fine in Farsi mode. 255 Note: Under X Window environment, Vim GUI works fine in Farsi mode.
256 This eliminates the need of any xterm terminal emulator. 256 This eliminates the need of any xterm terminal emulator.
257 257
258 258
259 Bugs 259 Bugs
260 ---- 260 ----
261 While in insert/replace and Farsi mode set, if you repeatedly change the 261 While in insert/replace and Farsi mode set, if you repeatedly change the
262 cursor position (via cursor movement) and enter new text and then try to undo 262 cursor position (via cursor movement) and enter new text and then try to undo
263 the last change, the undo will lag one change behind. But as you continue to 263 the last change, the undo will lag one change behind. But as you continue to
264 undo, you will reach the original line of text. You can also use U to undo all 264 undo, you will reach the original line of text. You can also use U to undo all
265 changes made in the current line. 265 changes made in the current line.
266 266
267 For more information about the bugs refer to rileft.txt. 267 For more information about the bugs refer to rileft.txt.
268 268
269 vim:tw=78:ts=8:ft=help:norl: 269 vim:tw=78:ts=8:ft=help:norl: