acoliver 2002/09/18 16:30:34 Modified: src/documentation/xdocs/trans/es index.xml Log: addt'l spanish thanks to Agustin Martin Barbera ([EMAIL PROTECTED]) Revision Changes Path 1.2 +152 -197 jakarta-poi/src/documentation/xdocs/trans/es/index.xml Index: index.xml =================================================================== RCS file: /home/cvs/jakarta-poi/src/documentation/xdocs/trans/es/index.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- index.xml 12 Jun 2002 04:21:26 -0000 1.1 +++ index.xml 18 Sep 2002 23:30:34 -0000 1.2 @@ -1,197 +1,152 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "./dtd/document-v11.dtd"> - -<document> - <header> - <title>Welcome to POI</title> - <authors> - <person id="AO" name="Andrew C. Oliver" email="[EMAIL PROTECTED]"/> - <person id="GJS" name="Glen Stampoultzis" email="[EMAIL PROTECTED]"/> - </authors> - </header> - - <body> - <section title="Logo Contest"> - <!-- - <p> - The POI committers have voted to - <link href="http://jakarta.apache.org/ant";>"innovate"</link> and hold a - logo contest. The big P at the top of the page is just a placeholder. - So the rules are pretty much this: - </p> - <ul> - <li> - <link href="http://burnallgifs.org/";>Only PNG submissions</link> - be accepted (we can convert them as needed). - </li> - <li> - Submissions must be sent to the <link - href="http://jakarta.apache.org/site/mail.html";>POI - User's mailing list</link> via an http link. If you do not - have an available webserver contact Andy (acoliver at apache dot - org) and ask him to post it for you (and he will if it doesn't - suck royally). Large binary attachments annoyingly posted to - the list will be rebuked. :-) - </li> - <li> - Image authors must be willing to work with us on any font and - sizing issues, etc. - </li> - <li> - All submissions become property of the Apache Software - Foundation to do whatever it wants with them (thanks!). - </li> - <li> - A non-binding poll will be taken and everyone can vote. - </li> - <li> - Based on the poll results and the fact that Andy won't vote for - anything that isn't some kind of tiki god or hawaiian theme - (maybe a poi pounder would be acceptable), the committers will - vote on the new POI logo. - </li> - <li> - Logos should be submitted in two flavors: one for the top of the - page and another for posting on other sites that note projects - that use POI technology. - </li> - <li> - The winner will get credit posted somewhere on the POI site and - have their logo used wherever POI is proudly served. - </li> - </ul> - <p> - You can see the current submissions <link - href="news/logocontest.html">here.</link> - </p> --> - <p> - Entries for the POI logo contest are now finished. Time to begin voting. Remember, Andy really - likes Tiki gods, but Glen suggests voting for what you like. :-) - </p> - <p> - <link href="http://vote.sparklit.com/web_poll.spark/640946";>Vote here now!!!</link> - </p> - <p> - <link href="http://vote.sparklit.com/poll.spark/640946";>Click here</link> to see the current results. - </p> - </section> - <section title="Purpose"> - <p> - The POI project consists of APIs for manipulating various file formats - based upon Microsoft's OLE 2 Compound Document format using pure Java. - </p> - <p> - OLE 2 Compound Document Format based files include most Microsoft Office - files such as XLS and DOC. - </p> - <p> - As a general policy we try to collaborate as much as possible with other projects to - provide this functionality. Examples include: <link href="http://xml.apache.org/cocoon";>Cocoon</link> for - which you'll soon find generators and serializers for our projects; - <link href="http://www.openoffice.org";>Open Office.org</link> with whom we collaborate in documenting the - XLS format; and <link href="http://jakarta.apache.org/lucene";>Lucene</link> for which we'll soon have file - format interpretors. When practical, we donate components directly to those projects for POI-enabling them. - </p> - <section title="Why/when would I use POI?"> - <p> - We'll tackle this on a component level. POI refers to the whole project. - </p> - <p> - So why should you use POIFS or HSSF? - </p> - <p> - You'd use POIFS if you had a document written in OLE 2 Compound Document Format, probably written using - MFC, that you needed to read in Java. Alternatively, you'd use POI to write OLE 2 Compound Document Format - if you needed to inter-operate with software running on the Windows platform. We are not just bragging when - we say that POIFS is the most complete and correct port of this file format to date! - </p> - <p> - You'd use HSSF if you needed to read or write an XLS (Excel) file using Java. You can also read and modify - spreadsheets using this API, although right now writing is more mature. - </p> - </section> - - <section title="What does POI stand for?"> - <p> - POI stands for Poor Obfuscation Implementation. Why would we name our project such a derogatory name? Well, - Microsoft's OLE 2 Compound Document Format is a poorly conceived thing. It is essentially an archive structured - much like the old DOS FAT filesystem. Redmond chose, instead of using tar, gzip, zip or arc, to invent their own - archive format that does not provide any standard encryption or compression, is not very appendable and is prone - to fragmentation. - </p> - <p> - Poi is also a Hawaiian delicacy that <link href="http://www.m-w.com";>Merriam Webster's dictionary</link> defines as: - "A Hawaiian food of taro root cooked, pounded, and kneaded to a paste and often allowed to ferment." This seemed - strangely descriptive of the file format. - </p> - <p> - So if you like acronyms, then POI is an acronym. If you hate them, then we just used the name of the food for our - project. If you wish to signify your love or hate for acronyms, use POI or Poi to refer to the project respectively. - </p> - </section> - - </section> - - - <section title="Components To Date"> - <section title="Overview"> - <p>A common misconception is that POI writes Excel files. POI is the name of the project. POI contains several - components, one of which, HSSF, writes Excel files. The following are components of the entire POI project - and a brief summary of their purpose.</p> - </section> - <section title="POIFS (POI Filesystem)"> - <p>POIFS is the oldest and most stable part of the project. It is our port of the OLE 2 Compound Document Format to - pure Java. It supports both read and write functionality. All of our components ultimately rely on it by - definition. Please see <link href="../../poifs/index.html">the POIFS project page</link> for more information.</p> - </section> - <section title="HSSF (Horrible Spreadsheet Format)"> - <p>HSSF is our port of the Microsoft Excel 97(-2002) file format (BIFF8) to pure Java. It supports read and write - capability. Please see <link href="../../hssf/index.html">the HSSF project page</link> for more information.</p> - </section> - <section title="HDF (Horrible Document Format)"> - <p>HDF is our port of the Microsoft Word 97 file format to pure Java. It supports read and write capability. - Please see <link href="../../hdf/index.html">the HDF project page for more information</link>. This component is - in the early stages of design. Jump in!</p> - </section> - <section title="HPSF (Horrible Property Set Format)"> - <p>HPSF is our port of the OLE 2 property set format to pure - Java. Property sets are mostly use to store a document's properties - (title, author, date of last modification etc.), but they can be used - for application-specific purposes as well. Currently HPSF supports - read functionality only. Please see <link - href="../../hpsf/index.html">the HPSF project page</link> for more - information.</p> - </section> - - </section> - - <section title="What happened to the HSSF Serializer?"> - <p>The HSSF Serializer, which was part of our 1.0 release and last builds on - <link href="http://www.sourceforge.net/projects/poi";>Sourceforge</link>, has been donated to the - <link href="http://xml.apache.org/cocoon/";>Cocoon</link> project, and is available starting from version - 2.0.2.</p> - </section> - - <section title="Contributing "> - <p> - So you'd like to contribute to the project? Great! We need enthusiastic, hard-working, talented folks to help - us on the project in several areas. The first is bug reports and feature requests! The second is documentation - - we'll be at your every beck and call if you've got a critique or you'd like to contribute or otherwise improve - the documentation. We could especially use some help documenting the HSSF file format! Last, but not least, we - could use some binary crunching Java coders to chew through the convolution that characterizes Microsoft's file - formats and help us port new ones to a superior Java platform! - </p> - <p>So if you're motivated, ready, and have the time, join the mail lists and we'll be happy to help you get started on the - project! - </p> - - - </section> - </body> - <footer> - <legal> - Copyright (c) @year@ The Apache Software Foundation All rights reserved. - $Revision$ $Date$ - </legal> - </footer> -</document> +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "./dtd/document-v11.dtd"> + +<document> + <header> + <title>Bienvenido a POI</title> + <authors> + <person id="AO" name="Andrew C. Oliver" email="[EMAIL PROTECTED]"/> + <person id="GJS" name="Glen Stampoultzis" email="[EMAIL PROTECTED]"/> + </authors> + </header> + + <body> + <section title="Concurso de Logotipo"> + <p> + Se ha terminado el plazo de entrega para el concurso de logotipo de POI. Ahora hay que votar. Recuerda, + a Andy le gustan mucho los dioses Tiki, pero Glen os sugiere que vot�is por el que m�s os guste. + :-) + </p> + <p> + <link href="http://vote.sparklit.com/web_poll.spark/640946";>���Vote aqu� ahora!!!</link> + </p> + <p> + <link href="http://vote.sparklit.com/poll.spark/640946";>Pinche aqu�</link> para ver los resultados actuales. + </p> + </section> + <section title="Prop�sito"> + <p> + El proyecto POI consiste en APIs para manipular varios formatos de ficheros, + basados en el formato de Documento Compuesto OLE 2 de Microsoft, utilizando Java puro. + </p> + <p> + Entre los ficheros basados en el formato de Documento Compuesto OLE 2 de Microsoft se + incluyen la mayor parte de los ficheros de Microsoft Office tales como XLS y DOC. + </p> + <p> + Como regla general intentamos colaborar lo m�s posible con otros proyectos para proporcionar esta + funcionalidad. Algunos ejemplos: <link href="http://xml.apache.org/cocoon";>Cocoon</link> para + el que pronto encontrar�is generadores y serializadores para nuestros proyectos; + <link href="http://www.openoffice.org";>Open Office.org</link> con quienes colaboramos en la + documentaci�n del formato XLS; y <link href="http://jakarta.apache.org/lucene";>Lucene</link> para + el que pronto tendremos int�rpretes del formato de fichero. Cuando sea pr�ctico, donaremos componentes + directamente a aquellos proyectos para dotarles de capacidad-POI. + </p> + <section title="�Por qu�/cu�ndo utilizar�a POI?"> + <p> + Abordaremos esto a nivel de componente. POI se refiere al proyecto completo. + </p> + <p> + As� que, �por qu� deber�a utilizar POIFS o HSSF? + </p> + <p> + Utilizar�as POIFS si tuvieras un documento escrito en el Formato de Documento Compuesto OLE 2, probablemente + escrito utilizando MFC, que necesitaras leer en Java. Alternativamente, utilizar�as POI para escribir + en el Formato de Documento Compuesto OLE 2 si necesitaras inter-operar con programas ejecut�ndose en la + plataforma Windows. No nos estamos jactando cuando decimos que POIFS es la adaptaci�n m�s completa y correcta + de este formato de fichero hasta la fecha. + </p> + <p> + Utilizar��s HSSF si necesitaras leer o escribir un fichero XLS (Excel) utilizando Java. Tambi�n se pueden + leer y modificar hojas de c�lculo utilizando este API, aunque ahora mismo la escritura est� m�s madura. + </p> + </section> + + <section title="�Qu� significa POI?"> + <p> + POI significa Implementaci�n Pobre de Ofuscaci�n (Poor Obfuscation Implementation). �Por qu� dar�amos a + nuestro proyecto un nombre tan derogatorio? Bien, el Formato de Documento Compuesto OLE 2 de Microsoft es + algo bastante mal concebido. Esencialmente es un fichero estructurado muy a la manera del viejo sistema FAT + del DOS. Redmon eligi�, en vez de utilizar tar, gzip, o arc, inventar su propio formato de fichero que no + proporciona ning�n est�ndar de cifrado o compresi�n, no es f�cil de unir con otros ficheros del mismo tipo, y + es dado a sufrir problemas de fragmentaci�n. + </p> + <p> + Poi tambi�n es una delicatessen Hawaiiana que <link href="http://www.m-w.com";>el diccionario Merriam Webster's</link> + define como "Comida Hawaiiana de raiz de taro cocinada, machacada y amasada en una pasta que a menudo se deja fermentar." + Esto extra�amente parec�a una descripci�n del formato del fichero. + </p> + <p> + As� que si te gustan los acr�nimos, entonces POI es un acr�nimo. Si los odias, entonces s�lo usamos el nombre de la + comida para nuestro proyecto. Si deseas expresar amor u odio por los acr�nimos, utiliza POI o Poi respectivamente + para referirte al proyecto. + </p> + </section> + + </section> + + + <section title="Componentes hasta Hoy"> + <section title="Visi�n General"> + <p>Un concepto err�neo es que POI escribe ficheros Excel. POI es el nombre del proyecto. POI contiene varios + componentes, uno de los cuales, HSSF, escribe ficheros Excel. Siguen a continuaci�n los componentes del + proyecto POI completo y un peque�o sumario de su prop�sito.</p> + </section> + <section title="POIFS (Sistema de Ficheros POI)"> + <p>POIFS es la parte m�s vieja y m�s estable del proyecto. Es nuestra adaptaci�n del Formato de Documento Compuesto + OLE 2 a Java puro. Soporta funcionalidad de lectura y escritura. Todos nuestros componentes se sirven de �l por + definici�n. Por favor, vea <link href="../../poifs/index.html">la p�gina del proyecto POIFS</link> para m�s informaci�n.</p> + </section> + <section title="HSSF (Formato de Hoja de C�lculo Horrible)"> + <p>HSSF es nuestra adaptaci�n del formato de fichero de Microsoft Excel 97(-2002) a Java puro. Soporta lectura y + escritura. Por favor, vea <link href="../../hssf/index.html">la p�gina del proyecto HSSF</link> para m�s informaci�n.</p> + </section> + <section title="HDF (Formato de Documento Horrible)"> + <p>HDF es nuestra adaptaci�n del formato de fichero de Microsoft Word 97 a Java puro. Soporta lectura y escritura. + Por favor, vea <link href="../../hdf/index.html">la p�gina del proyecto HDF para m�s informaci�n</link>. Este + componente est� en la fase inicial de dise�o. �Salta dentro!</p> + </section> + <section title="HPSF (Formato de Conjunto de Propiedades Horrible)"> + <p>HPSF es nuestra adaptaci�n del formato de conjunto de propiedades OLE 2 a java puro. + Los conjuntos de propiedades se utilizan mayoritariamente para almacenar las propiedades de un documento + (t�tulo, autor, fecha de la �ltima modificaci�, etc.), pero tambi�n pueden ser utilizados para prop�sitos + espec�ficos de una aplicaci�n. Actualmente HPSF soporta s�lo funcionalidad de lectura. Por favor, vea + <link href="../../hpsf/index.html">la p�gina del proyecto HPSF</link> para m�s informaci�n.</p> + </section> + + </section> + + <section title="�Qu� le ocurri� al Serializador HSSF?"> + <p>El Serializador HSSF, que era parte de nuestra release 1.0 y de las �ltimas compilaciones en + <link href="http://www.sourceforge.net/projects/poi";>Sourceforge</link>, ha sido donado al proyecto + <link href="http://xml.apache.org/cocoon/";>Cocoon</link>, y est� disponible a partir de la versi�n + 2.0.2.</p> + </section> + + <section title="Contribuyendo "> + <p> + �As� que te gustar�a contribuir al proyecto? �Genial! Necesitamos gente entusiasta, que trabaje duro, + que tenga talento para ayudarnos con el proyecto en varias �reas. �La primera es petici�n de nuevas + funciones y aviso de errores! La segunda es documentaci�n - estaremos a tu entera disposici�n si + tienes alguna cr�tica o te gustar�a contribuir o mejorar de alguna forma la documentaci�n. �Especialmente + no nos vendr�a mal algo de ayuda en documentar el formato de fichero HSSF! �Por �ltimo, aunque no por ello + menos importante, nos vendr�a bien algunos programadores Java que mastiquen binario, para que le echen el diente + a la convoluci�n que caracteriza los formatos de fichero de Microsoft y para que nos ayude a adaptar nuevos + formatos a una plataforma Java superior! + </p> + <p> �As� que si est�s motivado, listo, y tienes tiempo, �nete a las listas de correo y estaremos encantados de ayudarte a + empezar en el proyecto! + </p> + + + </section> + </body> + <footer> + <legal> + Copyright (c) @year@ The Apache Software Foundation All rights reserved. + $Revision$ $Date$ + </legal> + </footer> +</document> + +
-- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
