NetBSD Developer Documentation:

Translating htdocs into Spanish

General

Coding Style
Other general things

English Words/Phrases in Spanish

Phrases that remain unchanged
Common phrases
Tricky business

General

There are a few instances where we choose not to translate a certain phrase either because it sounds awkward in Spanish or simply because there is no adequate translation. In other instances, we translate a certain phrase in always the same way, to guarantee consistency among the different pages. Please go through the following lists carefully as you translate - if you have questions regarding a certain phrase or know of a better way to deal with one, please send an email to the mailing list.

Coding Style (top)

One of the goals of the Spanish translation, aside of translating the texts, is to convert the documents to XHTML. After doing the translation you can access the W3C validator to see if your document validates against the XHTML DTD. Please, fix all problems before submitting the document for inclusion.

Here are some notable things needed to get a valid XHTML file:

All tags must be closed, either using the extended form ( ) or the short form ( ). To be completely compatible with old browsers, you must use instead of (note the space in the former).
Tag names and attribute names are in lowercase. I.e., <TITLE> is invalid.
Attributes must be surrounded by quotes or double quotes like in: <td bgcolor="white">.

Apart from this, you must add a header to the HTML document (or modify the existant one) to specify the correct DOCTYPE. The translate.sh script will take care of it, but you are encouraged to check that the changes are ok. It should look like this:

<?xml version="1.0"?>
<!DOCTYPE html PUBliC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" lang="es" xml:lang="es">

Another detail is to add the document encoding type, which is ISO-8859-1. You can do it by adding this meta tag to the document head (note the ending slash):

<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />

Other general things (top)

In Spanish, we are polite and formal. Therefore, we address the reader using "Usted" instead of "Tu". "Tu" may sound friendlier or more colloquial, yet the "Usted" is more professional, more mature and seems to go well with the spirit of NetBSD.
We play by the Scrabble Rules, that is, we regard the Larousse as the ultimate authority with respect to spelling etc.
The main goal of the translation is not to translate the page word by word, but rather to convey the information. Try to maintain the same paragraph-structure of the original site, but feel free to re-arrange and re-structure the sentences - there's nothing worse than an english-sounding Spanish sentence. Feel free to make grammatical changes as long as the meaning remains the same. One easy way is to translate the sentence word by word first and then rewrite it to sound like a normal Spanish sentence.

English Words/Phrases in Spanish

Note that, if a given phrase can not be tranlsated, we should capitalize english nouns nonetheless - it just looks better in Spanish. For example, the sentence ``Security issues in NetBSD are handled by the NetBSD security officer.'' might be translated as ``Los problemas de seguridad en NetBSD son tratados por el <cite>NetBSD security officer</cite>.''.

Phrases that remain unchanged (top)

NetBSD - that's the name. The first ``N'' and the ``BSD'' is capitalized.
NetBSD-current - a proper name.

Common phrases (top)

NetBSD Packages System and NetBSD Packages Collection - El sistema de paquetes de NetBSD y La colección de paquetes de NetBSD.
embedded - empotrado.
library (as in `` the C library'') - libreria.
email - dirección de correo electrónico (o mensaje de correo electrónico).
Contact us - this phrase appears at the bottom of each page and links to the feedback-page. Please always translate as Contacte con nosotros (done by translate.sh).
Platform - plataforma.
Hardware - hardware (it is clearer in english).
Software - programario (or software itself, preferred).
Directory - directorio.
developer - programador.
Connection - conexión.
Dates - use the Spanish date format (dd/mm/yyyy, 1 de enero, 12 de diciembre, 17/09/2002...).
Custom - propio, personal.
Kernel - núcleo.
file - archivo or fichero (archivo is preferred).
filesystem - sistema de archivos.
provides - proporciona (not provee).

Tricky business (top)

release - most likely best left untranslated, but possibly Version or Distribución.
formal release - the question is as to translate this at all. If translated, it would probably be best to use Distribución Oficial.
source tree or directory tree - árbol de código fuente or jerarquía de directorios.
free - depending on the context, this may be translated as libre or gratuito. Use your best judgement.
binary - yuck, that's an evil one. binary package may be translated as Paquete binario, binary executable should probably become binario or ejecutable.

Home Page

Developer Documentation