From fb638a8049485924fec7f358922874ab7afc481a Mon Sep 17 00:00:00 2001 From: anvergara Date: Fri, 9 Jul 2004 08:09:43 +0000 Subject: [PATCH] Some finger errors revised --- lang/es/docs/coding.html | 83 +++++++++++++++++++-------------------- lang/es/docs/release.html | 72 ++++++++++++++++----------------- 2 files changed, 77 insertions(+), 78 deletions(-) diff --git a/lang/es/docs/coding.html b/lang/es/docs/coding.html index d5a8520fbb..c916ed3670 100644 --- a/lang/es/docs/coding.html +++ b/lang/es/docs/coding.html @@ -6,13 +6,14 @@

Manual de Estilo del Código

Cualquier proyecto colaborativo necesita que que la consistencia +

Cualquier proyecto colaborativo necesita que la consistencia y la estabilidad sean fuertes.

Esta manual de estilo ha sido escrito para conseguir que - todo el código de Moodle cumpla estas características. Es cierto que la parte - más antigua del código no cumple lo aquí especificado en algunos casos, pero - esto será solucionado en breve. Todo el código nuevo definitivamente deberá - adherirse a estos estándares de la forma más exacta posible.

Este manual de estilo ha sido escrito para conseguir que + todo el código de Moodle cumpla estas características. Es cierto + que la parte más antigua del código no cumple lo aquí especificado + en algunos casos, pero esto será solucionado en breve. Todo el código + nuevo definitivamente deberá adherirse a estos estándares de la + forma más exacta posible.

Reglas Generales

Todos los archivos con código deberían utilizar la extensión @@ -26,24 +27,20 @@
Todos los avisos de copyright deben ser mantenidos. Puedes incluir los tuyos propios si resulta necesario.
Todos los archivos deben incluir el el archivo principal - config.php.
Todos los archivos deben incluir el archivo principal config.php.
Cada archivo debería comprobar que el usuario está autenticado correctamente, utilizando las funciones require_login() y isadmin(), isteacher(), iscreator() o isstudent().
Todos los accesos a la base de datos deberían utilizar las - funciones de finidas en - lib/datalib.php cuando sea posible - - - esto permite la compatibilidad con un gran número de bases de datos. - - Deberías encontrar que prácticamente todo es posible utilizando estas funciones. - Si quieres esribir código SQL entonces deberás comprobar que: funciona en - cualquir plataforma; restringido a funciones específicas de tu código (normalmente - un archivo lib.php); y claramente comentado.
Todos los accesos a la base de datos deberían utilizar + las funciones definidas en lib/datalib.php cuando sea posible - esto permite + la compatibilidad con un gran número de bases de datos. Deberías + encontrar que prácticamente todo es posible utilizando estas funciones. + Si quieres escribir código SQL entonces deberás comprobar que: + funciona en cualquier plataforma; restringido a funciones específicas + de tu código (normalmente un archivo lib.php); y claramente comentado.
No crees o utilices variables globales distintas de las estándar $CFG, $SESSION, $THEME y $USER.
Todas las variables deberían ser inicializadas o, al menos, @@ -57,22 +54,23 @@
Todos los archivos de ayuda deberían ser traducibles - crea nuevos textos en el directorio "es/help" y llámalos utilizando la función helpbutton().
La información que llaga desde el navegador (enviada con - los métodos GET o POST) automáticamente tiene las "magic_quotes" aplicadas - (sin importar la configuración de PHP) por lo que uedes insertarla contotal - seguridad en la base de datos. El resto de la información(obtenida desde - los archivos, o desde la base de datos) - debe ser escapada con la función addslashes() antes - de insertarla en la base de datos.
La información que llega desde el navegador (enviada + con los métodos GET o POST) automáticamente tiene las "magic_quotes" + aplicadas (sin importar la configuración de PHP) por lo que puedes + insertarla con total seguridad en la base de datos. El resto de la información(obtenida + desde los archivos, o desde la base de datos) debe ser escapada con la función + addslashes() antes de insertarla en la base de + datos.

Estilo del Código

Comprendo que puede ser un poco frustrante modificar tu - estilo de programación si has trabajado en otras coasa, pero compara esa frustración - con la frustración de toda la gente que intente, más adelante, encontrar el - sentido del código de Moodle si es una mezcla de estilos. Obviamente, hay muchos - puntos a favor y en contra de cada estilo que la gente utiliza, pero el que - se detalla aquí es el que deberás utilizar.

Comprendo que puede ser un poco frustrante modificar tu + estilo de programación si has trabajado en otras cosas, pero compara + esa frustración con la frustración de toda la gente que intente, + más adelante, encontrar el sentido del código de Moodle si es + una mezcla de estilos. Obviamente, hay muchos puntos a favor y en contra de + cada estilo que la gente utiliza, pero el que se detalla aquí es el que + deberás utilizar.

El sangrado del texto debe ser siempre de 4 espacios. No utilices los tabuladosres NUNCA.

define("FORUM_MODE_FLATOLDEST", 1);

Los nombres de las funciones tienen que - ser palabras sencillas en minúsculas y en Inglés, y empezar con el nombre - del módulo al que pertenecen para evitar conflictos entre módulos. Las palabras - deberían separarse por guiones bajos. Los parámentros, si es posible, tendrán - valores por defecto. Fíjate en que no has espacio entre el nombre de la función +
Los nombres de las funciones tienen que + ser palabras sencillas en minúsculas y en Inglés, y empezar + con el nombre del módulo al que pertenecen para evitar conflictos entre + módulos. Las palabras deberían separarse por guiones bajos. + Los parámentros, si es posible, tendrán valores por defecto. + Fíjate en que no haya espacio entre el nombre de la función y lo siguiente (paréntesis).

function forum_set_display_mode($mode=0) {
@@ -121,9 +120,9 @@ }
}
Los bloques de código siempre deben - estar encerrados por llaves(incluso si solo constan de una línea). Moodle - utiliza este estilo: +
Los bloques de código siempre deben + estar encerrados por llaves (incluso si solo constan de una línea). + Moodle utiliza este estilo:
if ($quiz->attempts) {
if ($numattempts > @@ -209,9 +208,9 @@
name - el nombre completo de la instancia

El resto de las tablas asociadas con un módulo que contiene - información sobre 'cosas', deberían ser llamandas modulo_cosas(fíjate - en el plural!).

El resto de las tablas asociadas con un módulo que + contiene información sobre 'cosas', deberían ser llamandas modulo_cosas + (fíjate en el plural!).

Los nombres de los campos (columnas) deberían ser sencillos y cortos, siguiendo las mismas reglas que los nombres de las variables.

Cuando sea posible, las columnas que contengan una referencia diff --git a/lang/es/docs/release.html b/lang/es/docs/release.html index a4cd99f21f..ab0f5b41cb 100644 --- a/lang/es/docs/release.html +++ b/lang/es/docs/release.html @@ -1,14 +1,14 @@ - -Moodle Docs: Current Release notes - + +Moodle Docs: notas sobre la versión actual + - + - + @@ -20,18 +20,18 @@

Problemas resueltos:

Algunos códigos HTML que afectaban a la estabilidad del edito +
Algunos códigos HTML que afectaban a la estabilidad del editor HTML bajo IE6 en algunas páginas han sido solucionados.
Algunos problemas en las opciones de auto-vínculo en los filtros arreglados.
Modificada la barra de navegación (utilzando el carácter »).
Modificada la barra de navegación (utilizando el carácter »).
Los archivos de Flash ahora tienen su propio icono.
La inclusión de enlaces al curso en el editor HTML has sido +
La inclusión de enlaces al curso en el editor HTML ha sido corregida.
El bloque de enlaces a las secciones ahora mantiene el "focus".
Los archivos del sitio ahora respetan al configuración "forcelogin".
Los archivos del sitio ahora respetan la configuración "forcelogin".
La actualización de bloques sin base de datos funciona.
Actualizaciones en los lenguajes.

@@ -45,16 +45,16 @@

Principales nuevas características:

Nueva utilidad de Calendario (gracias a Jon Papaioannou y la Greek School Network!).
Nueva utilidad de Bloques, permitiendo quelos bloques +
Nueva utilidad de Bloques, permitiendo que los bloques sean incluidos y movidos por la página del curso (gracias a Jon Papaioannou, Eloy Lafuente y otros!).
Nuevo sistma de difusión RSS permite a los - Foros y alos Glosarios (y más adelante, a otros módulos) + Foros y a los Glosarios (y más adelante, a otros módulos) publicar vía RSS (Gracias, Eloy!).
El filtro multimedia ahora soporta la inclusión @@ -65,9 +65,9 @@

Otras nuevas características:

Un nuevo tipo de recuros (llamado "Directorio") mostrará un +
Un nuevo tipo de recursos (llamado "Directorio") mostrará un directorio entero de ficheros (incluyendo subdirectorios).
Los recuros que son archivos (subidos o páginas web) ahora muestran un icono distintivo en la página principal del curso.
Cuando el acceso de Google está activado, la página de traducción de Google funciona también.
Las sesiones son ahora almacenadas de forma privada en el directorio - de datos de Moodle - esto hace que Moodle funciona mejor en clusters + de datos de Moodle - esto hace que Moodle funcione mejor en clusters y soluciona algunos problemas de expiración de sesiones en servidores web compartidos.
Las imágenes de los usuarios puedens ser borradas fácilmente desde @@ -105,7 +105,7 @@
Añadido mejor soporte para la importación de cuestionarios desde Blackboard.
El guión cron de PHP ahora puede ser ejecutado como un binario.
El editor HTML ha sido mejorado enórmemente.
El editor HTML ha sido mejorado enormemente.
La página por defecto de actividad reciente es ahora calculada desde el último acceso al curso (o dos días, lo que sea más reciente). Anteriormente era calculada desde la última conexión al sitio.

Problemas resueltos:

Cientos de pequeños fallos han sido solucionados en todas partes, generalmente mejorando la apariencia y la robustez de Moodle.

Varios problemas menores resueltos:

Corregidos algunos problemas que causaban que los gráficos de las encuestas no se mostraran en algunas circustancias.

Principales nuevas características:

Nuevo soporte para grupos en los cursos (con muchas opciones).
Filtros de texto que permiten procesar los textos @@ -201,7 +201,7 @@

Cursos:

Las actividades pueden tener sangrias en la visualización del curso, permitiendo estructurarlas mejor.

Administración del sitio:

Solucionado un importante problema de seguridad para evitar que los profesores accedan a Moodle como profesores si los administradores @@ -291,7 +291,7 @@

Themes:

Solución de problemas para que Internet Explorer utilice la hoja de estilos de una manera más robusta.

Traducciones:

Nuevos lenguajes: Gallego y Lituano.
Mejorado el interfaz de edición de lenguajes - ahora permite elegir @@ -320,7 +320,7 @@

Copia de Seguridad / Restauración:

Las copias de seguridad automáticas pueden ser programadas por el administrador para todos los cursos a la vez.

Filtros de texto y formateo:

Avido: Los nuevos filtros de texto incrementarán la carga de tu servidor, particularmente cuando se trata de filtros complicados. Utilízalos @@ -356,7 +356,7 @@

API del desarrollador:

Una nueva guía del código está disponible.
Una nueva guía de filosofía está disponible ;-)

Chats

Las sesiones del chat pueden ser borradas.
Los chats programados muestran la franja horaria para ser más claros.

Foros:

Las preferencias de visualización de los foros son recordadas entre sesiones.

Diarios:

Las preguntas del diario pueden utilizar ahora el editor HTML.
Solucionados algunos problemas con la valoración de los diarios.

Cuestionarios:

Las preguntas y las categorías pueden ser editadas sin necesidad de editar un cuestionario.

Recursos:

Los profesores pueden visualizar los ficheros de forma más directa al crear recursos de archivo subido.

Talleres:

Cambios en el sitema de valoración cruzada.
Nueva fase de valoración.

Miscellaneous

Moodle ignora cualquier carpeta que Frontpage haya podido añadir (_vti_cnf).

Documentación - de + de Moodle

Version: $Id$