Traducir la documentación de Django al español

Ya sólo quedan 3 días para que comience el sprint de traducción on-line de la documentación de Django al español. Para que no haya confusiones sobre cómo participar en él os dejamos una breve guia a continuación.

Estos son los pasos para traducir cualquier documento:

1. Regístrate en el trac desde aquí

2. Decide qué documento quieres traducir a partir de todos los que hay aquí (documentación oficial de Django)

3. Comprueba que el documento elegido no se encuentre asignado a nadie ni esté ya traducido, eso significa que el documento no debe aparecer en esta lista

4. Abre un ticket desde esta página indicando en Short summary: la ruta del documento dentro de la documentación y el número de revisón (por ejemplo: contents.txt rev.8506 ó howto/index.txt rev.8506). Escribe tu nombre de usuario en Assign to: para que los demás traductores sepamos que la traducción de ese documento queda asiganada a ti. Puedes adjuntar el documento original al ticket si lo deseas.

5. Traduce el documento y aseguráte de que utilizas el encoding UTF-8 en tu editor de textos (en vim: set encoding=utf-8)

6. Haz un checkout del repositorio cambiando <USER> por tu nombre de usuario:

   svn co --username <USER> http://202.dwp.wuonm.com/svn/6/ django-es
   

7. Añade el documento traducido en el path correspondiente:

   cd django-es/trunk/docs
   cp /path/al/documento/documento-traducido.txt .
   svn add documento-traducido.txt
   svn ci
   

8. Cierra el ticket cambiando su estado a closed

¿Aún tienes dudas? Ante cualquier duda o problema que pueda surgirte estaremos encantados de poder ayudarte. Escríbenos desde el formulario de contacto o bien deja un mensaje en el grupo de correo detallando tu duda o problema.

Nota: realiza un svn update antes de cada sesión de traducción y vuelve a hacer un commit cuando dejes de traducirlo.

Al final del sprint escribiremos un post en agradecimiento a todos los que han participado y enlazando con sus sitios web. Podéis enviarnos el enlace a vuestro sitio web desde la página de contacto.

Feliz Navidad y Feliz Año Nuevo

Idiomas en nuestras URLs gracias a django-localeurl

django-localeurl es una aplicación que permite el uso de códigos de idiomas en las URLs de nuestro proyecto. Esto trae la ventaja de que cada página en cada idioma tiene una URL propia. Gracias a ello los buscadores indexan cada página en los distintos idiomas disponibles y nuestros usuarios pueden compartir las URLs de una página en el idioma que deseen. Además funciona a la perfección con el LocaleMiddleware que viene con Django y que sirve para hacer la "negociación" para descubrir el idioma del usuario en función de si ya ha seleccionado un idioma previamente, si por el contrario debe utilizar el idioma de su navegador o como último recurso el idioma por defecto de nuestro proyecto.

django-localeurl nos permitirá cambiar nuestras URLs de http://mi-proyecto.com/noticias a URLs del tipo http://mi-proyecto.com/es/noticias, http://mi-proyecto.com/de/noticias, etc. No hará falta cambiar nada en nuestra URLconf para hacerlo funcionar.

import re
LOCALE_INDEPENDENT_PATHS = (
    re.compile('^/aviso-legal/'),
    re.compile('^/privacidad/'),
)

{% load localeurl_tags %}

<a href="{% url ver-articulo articulo.id %}">Ver artículo</a>

<a href="{% locale_url "en" ver-articulo articulo.id %}">Ver artículo en inglés</a>

<p>Haz <a href="{{ mi_url|chlocale:"de" }}">click aquí</a> para cambiar a alemán.</p>
<p>La url {{ otra_url }} sin código de lenguaje es {{ otra_url|rmlocale }}</p>

Enviar e-mails con Django y GMail

Personalmente siempre he utilizado mi propio servidor SMTP para el envio de e-mails con Django, pero hoy me he topado con este post en español sobre el post original de Nathan Ostgard que explica fácilmente qué settings debes añadir a tu proyecto para que Django envíe e-mails a través de GMail. Muy útil cuando no disponemos de un servidor SMTP propio.

Los settings a añadir son los siguientes:

EMAIL_HOST = 'smtp.gmail.com'
EMAIL_HOST_USER = 'mi-usuario@gmail.com'
EMAIL_HOST_PASSWORD = 'mi-password'
EMAIL_PORT = 587
EMAIL_USE_TLS = True

Si utilizas Google Apps para tu dominio o has añadido otras cuentas de e-mail de otros dominios a tu cuenta de GMail también podrás utilizar éstas en el setting EMAIL_HOST_USER. Para que sea la cuenta de e-mail remitente por defecto puedes añadir DEFAULT_FROM_EMAIL a tu archivo de settings con la misma dirección de correo electrónico.