Date: Tue, 31 Mar 2020 14:01:32 -0300 From: "Danilo G. Baio" <dbaio@FreeBSD.org> To: Hiroki Sato <hrs@FreeBSD.org> Cc: javad.kouhi@gmail.com, freebsd-translators@freebsd.org Subject: Re: Self-introduction: Javad Kouhi Message-ID: <20200331170132.gyjlo7nel3cajidf@t480.local> In-Reply-To: <20200331.124527.1078840241867193092.hrs@FreeBSD.org> References: <CA%2Bg814c6HgS6zn56J4w8kFNMNXvvLTqe88E=7Dro7e2=Pv-4qQ@mail.gmail.com> <20200330230002.wvfujukeqfe63i3h@t480.local> <CA%2Bg814e5=ipStdmvPFhPaDUprmnaOapcMb1xS9fcFNCA5Y9fQQ@mail.gmail.com> <20200331.124527.1078840241867193092.hrs@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--fx5otkzimzhrnu4g Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Mar 31, 2020 at 12:45:27PM +0900, Hiroki Sato wrote: > Javad Kouhi <javad.kouhi@gmail.com> wrote > in <CA+g814e5=3DipStdmvPFhPaDUprmnaOapcMb1xS9fcFNCA5Y9fQQ@mail.gmail.co= m>: >=20 > ja> As you definitely know, English is written from left to right, but > ja> Persian and other Middle Eastern Languages such as Arabic and Hebrew > ja> are written from right to left. Since the Handbook is a technical book > ja> and it contains a lot of untranslatable words (variable names, > ja> keywords, etc), intermixing Persian and English is inevitable. So, is > ja> there any support for RTL languages? If no, how could I help with > ja> that? >=20 > DocBook XML technically supports RTL. >=20 Weblate supports RTL. https://weblate.org/en/news/archive/rtl-languages-support/ > ja> To make matters worse, there are also XML tags, which could make the > ja> code pretty ugly in RTL languages. Tags are not shown correctly (not > ja> only the user sees something like >/tag< instead of </tag>, but also > ja> they are misplaced in the source code). I've seen similar problems in > ja> other projects such as Wikipedia. The solution they have adopted is to > ja> translate the tags themselves, this way, the tags are shown correctly > ja> in the source code, making it much easier for others to change the > ja> code. So, is there a way to translate the tags? >=20 > Does "translating tags" mean replacing the tag name of <foo> with > Parisian counterpart in RTL, or the whole tag including <> in RTL? >=20 > While it is possible to create a preprocessing XSLT to convert them > back to corresponding DocBook tags, I think it is more realistic to > keep XML files in LTR as the English versions do, and translate > sentences in RTL by adding dir=3D"rtl" attribute to the XML tags > because most of XML toolchains cannot handle tags and attributes in > RTL. I am not sure if this is comfortable for RTL language users > like you, however. >=20 > Could you show a typical HTML file in UTF-8 Persian? I would like to > know what tags look like. I would like to see some examples as well. Persian was already marked as RTL on Weblate. Above the translation field, there is that virtual keyboard with options for RTL, probably those options can be useful: https://people.freebsd.org/~dbaio/weblate/2020-03-31-093250_1004x647_scrot.= png https://people.freebsd.org/~dbaio/weblate/2020-03-31-093318_1001x613_scrot.= png The UI is doing something because the string is saved differently in the repository: https://people.freebsd.org/~dbaio/weblate/2020-03-31-093415_747x699_scrot.p= ng I've built these initial translations you made, without any modification, see the results here: https://dbaio.bs2cloud.com.br/doc/fa01/fa_FA.UTF-8/books/handbook/ If this is good, I can go forward and add a Jenkins job to build it regular= ly. --=20 Danilo G. Baio (dbaio) --fx5otkzimzhrnu4g Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQKTBAABCgB9FiEEORj0UTsjzCy+enIkmpN7LfMuiNcFAl6Dd2lfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDM5 MThGNDUxM0IyM0NDMkNCRTdBNzIyNDlBOTM3QjJERjMyRTg4RDcACgkQmpN7LfMu iNcemxAAprwCBKvEyGHbmv+xECvuq987OTIBsJeVHjpvOicsAy0tlEUAzLlfgX8M o7oxWwVrUOn0wpTC4cdCM2JDzWEhGYLG8eCxmZ7k7lM5F92yuOSz5Qs0m4vFLrdt 0UrafPeu9/WuHcH5wUWN5dWL/FZPlOEWZXndT2OqiJXbZnDgzoqEjw1nTA1pJzc9 0jxgzn93EdgtAh0HAZoFchAv/TX9ytxmWBrydUqcfgbIin6ORLiOjpLHpzPT06WS GylG4PZcJL79PF/MycGbbeOwIQacy+8SXBxYBPAonJvoVnPHFcSrXfmyrUk4mHSN KG7SGhMuwdDkszxHfzzWbfm/69XfkEpoV6bR8440I2XjUTRufMKugu1lp3Ixn5pD q7mX1xyMrdr0tVfslSXbxU5CF1jmsxkpntMidpTckCTmMmFWxjJVb/wk29uubEbV uhpoHwrqkjxCLSmlsd2BG/Dqia179LPu4hRSZ1Y9tz2t6LZlkFq8kIc4l2TXR+oy v/24mqjkjxaJlbZ3A4jfO964yYEnJbCWF3+DdRpBLU6SGh2xOujDZ+goE77WiWEA erMXMR4xWuTkM9NMfkt2H5IxSiQOnYDCbpIk7s6BvPChKoSpPRc6OQRr3pDYmf1y mI0zItUnWGz/XkbAs69ksdb7H713nlp6oBuq2IMMVzkpljBttjQ= =mIJp -----END PGP SIGNATURE----- --fx5otkzimzhrnu4g--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20200331170132.gyjlo7nel3cajidf>