Re: automatic generation of quickref.html

----- Original Message ----- 
From: "Marc Gueury" <[email protected]>
To: <[email protected]>
Sent: Thursday, March 24, 2005 10:57 PM
Subject: Re: [Tidy-dev] automatic generation of quickref.html


> Arnaud Desitter wrote:
>
>>
>> ----- Original Message ----- From: "Marc Gueury" <[email protected]>
>> To: "Arnaud Desitter" <[email protected]>
>> Cc: "Jelks Cabaniss" <[email protected]>; "Charlie" <[email protected]>; 
>> <[email protected]>
>> Sent: Wednesday, March 23, 2005 10:15 PM
>> Subject: Re: [Tidy-dev] automatic generation of quickref.html
>>
>>
>>> I have an additional remark about translation.
>>>
>>> If you look the code of tidylib, all the strings that are translatable 
>>> are
>>> all contained in the localize.c file. In a bad way, I think for some 
>>> reason
>>> I will probably explain in another mail. (in short, localize.c contains 
>>> code
>>> and strings + there is no way to make a multilingual tidy program).
>>>
>>> Whatever, all the translations and translatable strings are contained
>>> in that single file. So that, if, for example, somebody wants to 
>>> translate tidy.
>>> It is quite easy. He just need to change that file. I think that the 
>>> description
>>> should follow the same principle.
>>>
>>> Place your code in a new file. But the strings in localize.c.
>>>
>>> Also, I have additional request: please add an API for tidyLib
>>> to get help for one parameter only for allowing UI program
>>> using tidylib to show help about one parameter in a tooltip for example.
>>>
>>
>> Have a look at:
>> tidydoc.h
>> http://sourceforge.net/tracker/download.php?group_id=27659&atid=390965&file_id=124822&aid=1008089
>> and the API in genquickref.h
>> http://sourceforge.net/tracker/download.php?group_id=27659&atid=390965&file_id=124821&aid=1008089
>>
>> Is it what you ask for ?
>>
> Hi Arnaud,
>
> Perfect :-)
> I think tidyOptGetDocDesc is what I need to get the description of one 
> parameter.
>

Could you put this information in  http://tidy.sf.net/feature/1169855 ?


> About translation, I would prefer to keep all english word out of the 
> genquickref.c.
> For example, by defining constant in the H file.

To address http://tidy.sf.net/feature/1169855, only the content of tidydoc.h
and the APIs in genquickref.c would go in tidylib. "quickref.html" is a
seperate issue. And so is localization ("tidydoc.h" being isolated, 
translating
it is possible).

Regards,

> The reason is quite simple, I have received mails from several people that 
> wished
> to translate the Firefox tidy extension in french, spanish, japanese and 
> so on.
> Finally, we are a little stuck on the string translation in the tidy 
> source code, because
> it is impossible for me to ask to people translating to recompile tidy on 
> Windows, Linux
> and MacOs for each translation. I would like to find a good idea for 
> translating tidy.
> But without tidy able to accept an optional external file as input for 
> translation of string,
> I see no way to solve it.
> If it is done in a day in the future, all strings will need to be grouped 
> together in a file.
> This is why I prefer that you put all the strings together somewhere. So, 
> if one day, the
> tidy localize.c is rewritten to improve the above, it would not be too 
> difficult to do.
>
> Thanks by advance,
>
> Marc
>
> Marc
>
>> Regards,
>>
>>
>>> Thanks by advance,
>>>
>>> Marc
>>>
>>
>>
>>
>
>
>
> -------------------------------------------------------
> SF email is sponsored by - The IT Product Guide
> Read honest & candid reviews on hundreds of IT Products from real users.
> Discover which products truly live up to the hype. Start reading now.
> http://ads.osdn.com/?ad_id=6595&alloc_id=14396&op=click
> _______________________________________________
> Tidy-develop mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/tidy-develop
> 



-------------------------------------------------------
SF email is sponsored by - The IT Product Guide
Read honest & candid reviews on hundreds of IT Products from real users.
Discover which products truly live up to the hype. Start reading now.
http://ads.osdn.com/?ad_id=6595&alloc_id=14396&op=click