No me di cuenta y respond� s�lo a Rafa... -----Mensaje original----- De: Rafael Luque Leiva [mailto:[EMAIL PROTECTED] Enviado el: viernes, 19 de septiembre de 2003 6:35 Para: Martin Barbero, Agustin Asunto: RE: Localization doclets
On Thu, 2003-09-18 at 21:54, Martin Barbero, Agustin wrote: > Un doclet lee la informaci�n de los comentarios en formato javadoc (entiendo) > Y si metes ah� los dos idiomas, el doclet por defecto sacar�a los dos idiomas a la > vez y se liar�a casi seguro con las palabras clave. Exactamente. Desde luego no estoy hablando del standard doclet del SDK, sino de un doclet de terceros. En cualquier caso, despu�s de indagar m�s me da la impresi�n de que no existe, as� que nos vamos a plantear desarrollarlo nosotros y as� de paso hacemos otra peque�a aportaci�n free a la comunidad ;-) desde Orange Soft. > > Habr�a que utilizar alguna manera de no romper la generaci�n de la documentaci�n por > defecto. > Dise�ando de nuevo todas las palabras clave, tipo @author_es , @returns_es, etc. > Aunque no s� qu� hace javadoc si se encuentra con etiquetas que no entiende (si las > tira ser�a ideal). Otra vez tienes raz�n. Hay que crear nuevas tags que este nuevo doclet ser� capaz de interpretar. > > Agust�n. PD: �por qu� no me contestaste a mindfood? Rafa > > -----Mensaje original----- > De: Rafael Luque Leiva [mailto:[EMAIL PROTECTED] > Enviado el: jueves, 18 de septiembre de 2003 12:59 > Para: [EMAIL PROTECTED] > Asunto: Localization doclets > > > > Hola, > > En un proyecto en el que estoy trabajando necesitamos escribir la > especificaci�n de la API en varios idiomas (inicialmente en espa�ol e > ingl�s). Lo ideal ser�a poder incluir distintos idiomas directamente en > los comentarios Javadoc de las clases Java. > > Tras una peque�a b�squeda, parece que Sun dispone de unos doclets para > traducir comentarios javadoc, pero por el momento son s�lo de "uso > interno". Adem�s, est�n orientados a la forma de trabajar en proyectos > m�s grandes, puesto que un preprocesador extrae los comentarios a > ficheros externos para facilitar la labor de los traductores. > > En mi caso, no existe esa distinci�n entre el rol del desarrollador y > del traductor, as� que considero m�s �til que los comentarios en > distintos idiomas se encuentren en los archivos de cada clase. De ese > modo, se facilita mucho el trabajo de sincronizaci�n entre las > diferentes versiones de documentaci�n. > > �Alguien conoce alg�n doclet que permita hacer esto? > > Gracias, > > -- Rafa > > > --------------------------------------------------------------------- > Para eliminar la suscripci�n, mail a: [EMAIL PROTECTED] > Para comandos adicionales, mail a: [EMAIL PROTECTED] > > > > -- Rafael Luque, <[EMAIL PROTECTED]> Metadatos RDF: http://www.orange-soft.com/people/luque/contacto.rdf Clave PGP: http://www.orange-soft.com/people/luque/clavepgp --------------------------------------------------------------------- Para eliminar la suscripci�n, mail a: [EMAIL PROTECTED] Para comandos adicionales, mail a: [EMAIL PROTECTED]
