Re: Arabic translation for nmap-man.xml

[Daniel Miller <bonsaiviking () gmail com>]

Mohammad,

Thanks for taking the time to work on this! I don't have experience working
with right-to-left (RTL) languages, but it seems there would be three
places that could require some extra work to make it happen:

1. Editor. You will have to use a plaintext editor that supports RTL
editing. My own preferred editor, Vim, claims to support Arabic:
http://vimdoc.sourceforge.net/htmldoc/arabic.html I'm sure there are others.

2. XML. It appears that the Docbook XML format supports RTL languages by
putting the dir="rtl" attribute into any element that contains RTL text.
This ought to only be necessary at the highest-level element, using
dir="ltr" to override when necessary.

3. Stylesheets. The Docbook XSL stylesheets are used to convert the XML
into a couple different formats. Hopefully these are aware of the dir
attribute and will translate that into the appropriate markup. Certainly
the HTML output that is used on nmap.org will be capable of presenting the
text properly.

4. Nroff. It looks like most nroff viewers (primarily the "man" command)
may not support RTL languages. I haven't checked thoroughly, though. At the
least, we should look at how Red Hat or Debian packages for multilingual
support do things.

I think that if you can get 1 and 2 working, you should just jump in to the
translation effort. The others are technical challenges that we can work on
overcoming as we come to them. I don't want to discourage you at all, since
Arabic is such a global language that is a big gap in our translations.

Thanks again for offering to undertake this!

Dan

On Mon, Jan 9, 2017 at 2:12 AM, Mohammad Youssef <mhd.y02 () gmail com> wrote:

> Hi All and Happy new year,
>
> Any suggestion to work or to test the Arabic translation of nmap-man.xml?
> Details below
>
> Thanks,
> Mohammad
>
> ---------- Forwarded message ----------
> From: Fyodor <fyodor () nmap org>
> Date: Mon, Jan 9, 2017 at 9:33 AM
> Subject: Re: Arabic translation for nmap-man.xml
> To: Mohammad Youssef <mhd.y02 () gmail com>
>
>
>
>
> On Sat, Dec 31, 2016 at 2:38 PM, Mohammad Youssef <mhd.y02 () gmail com>
> wrote:
>
> > Hi Fyodor,
> >
> > Happy new year,
> >
> > I just started translating the nmap-man.xml to Arabic, I'm using XML
> > Notepad 2007, since Arabic is Right-to-Left language and none-Latin letters
> > so it seems to me what I'm doing will not be working. how we can examine
> > the file to know if it will work online or not?
>
> Hi Mohammad.  I'm glad to hear that you're working on an Arabic
> translation.  I'd suggest writing to the dev () nmap org mailing list as
> someone there might have suggestions for dealing with Arabic in DocBook XML.
>
> Cheers,
> Fyodor
>
>
>
>
> _______________________________________________
> Sent through the dev mailing list
> https://nmap.org/mailman/listinfo/dev
> Archived at http://seclists.org/nmap-dev/
_______________________________________________
Sent through the dev mailing list
https://nmap.org/mailman/listinfo/dev
Archived at http://seclists.org/nmap-dev/