Changeset 192

Show
Ignore:
Timestamp:
04/11/07 19:13:55 (2 years ago)
Author:
bermiferrer
Message:

Updating docs

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • trunk/docs/tutorial-fr.markdown

    r173 r192  
    386386C'est tout pour le moment. Ce tutoriel continuera bien sûr d'évoluer, et il y en aura d'autres, car ce ne sont pas là les seules fonctionnalités d'Akelos ! 
    387387Si vous voyez une faute de frappe ou de français, n'hésitez pas à me le faire savoir ! 
     388 
     389--------------------- 
     390 
     391Traduit par: Naixn 

  • wiki/TutorialFrench.wiki

    r184 r192  
    11#labels Featured,Tutorial 
    2 Translated by: Naixn 
     2Traduit par: Naixn 
    33 
    44= Comment créer une application simple grâce au framework Akelos = 

  • wiki/TutorialSpanish.wiki

    r187 r192  
    66== Introducción == 
    77 
    8 Este tutorial te mostrará cómo crear una aplicación con el Akelos Framework. 
    9  
    10 Esta aplicación servirá para manejar libros y sus autores y la llamaremos *booklink* 
     8Este tutorial te muestra cómo crear una aplicación con el Akelos Framework. 
     9 
     10Esta aplicación sirve para manejar libros y sus autores y la llamaremos *booklink* 
    1111 
    1212== Requisitos para este tutorial == 
    …… 
    1717  * PHP4 ó PHP5 
    1818 
    19 Esta configuración se puede encontrar en la mayoría de los servidores y proveedores de hosting Linux. Akelos funciona bajo múltiples configuraciones, pero a para este tutorial nos centraremos en ésta concretamente. 
     19Esta configuración se puede encontrar en la mayoría de los servidores y proveedores de hosting Linux. Akelos funciona bajo múltiples configuraciones, pero para este tutorial nos centraremos en los requisitos anteriores. 
    2020 
    2121== Descarga e Instalación == 
    2222 
    23 Hasta que no esté disponible la versión 1.0, te recomendamos que te descargues la última versión trunk (troncal). Para ello necesitarás tener instalado [http://subversion.tigris.org/ subversion]. Podrás retirar una “copia de trabajo” del código fuente de Akelos con el comando: 
     23Hasta que no esté disponible la versión 1.0, te recomendamos que te descargues la última versión trunk (troncal). Para ello necesitas tener instalado [http://subversion.tigris.org/ subversion].   
     24Puedes retirar una "copia de trabajo" del código fuente de Akelos con el comando: 
    2425 
    2526{{{ 
    …… 
    6566== Instalando una nueva aplicación con Akelos == 
    6667 
    67 Ya has descargado Akelos y te has asegurado que puedes de ejecutar scripts PHP desde tu linea de comandos (no es necesario para ejecutar aplicaciones realizadas con Akelos, pero sí que es necesario para seguir este tutorial) 
     68Ya te has descargado Akelos y te has asegurado de que puedes ejecutar scripts PHP desde tu linea de comandos (no es necesario para ejecutar aplicaciones realizadas con Akelos, pero sí que es necesario para seguir este tutorial) 
    6869 
    6970Ahora se pueden seguir dos vías: 
    7071 
    7172  1. Crear una aplicación con Akelos y enlazarla a las librerías del Framework. 
    72   1. Comenzar a codificar tu aplicación desde esta carpeta, con el de seguridad que implica que los _visitantes_ de tu sitio pueadan dirigirse con su navegador directamente a cualquier fichero del Framework o de tu aplicación sin pasar por en controlador principal. 
    73  
    74 Asumiendo que has descargado Akelos en `HOME_DIR/akelos` y que estás dentro del directorio `akelos`, puedes comprobar las opciones disponibles para instalar tu nueva aplicación con el comando: 
     73  1. Comenzar a escribir el código tu aplicación desde esta carpeta, con el riesgo que conlleva que los _visitantes_ de tu sitio puedan dirigirse con su navegador directamente a cualquier fichero del Framework o de tu aplicación sin pasar por el controlador principal. 
     74 
     75Si te ya has descargado Akelos en `HOME_DIR/akelos` y estás dentro del directorio `akelos`, puedes comprobar las opciones disponibles para instalar tu nueva aplicación con el comando: 
    7576 
    7677./script/setup -h 
    …… 
    8283 -deps --dependencies      Incluye una copia del framework dentro del directorio de la aplicación. (true) 
    8384 -d --directory=<value>    Directorio de destino para instalar la aplicación. 
    84  -f --force                Sobreescribe archivos que ya existan. (false) 
    85  -h --help                 Muestra esta ayuda. 
    86  -p --public_html=<value>  Ubicación donde la aplicación será accedida por el servidor web. () 
     85 -f --force                Sobrescribe archivos que ya existen. (false) 
     86 -h --help                 Muestra la ayuda que ahora mismo estás leyendo. 
     87 -p --public_html=<value>  Ubicación que el servidor web utilizará para iniciar la aplicación. () 
    8788 -q --quiet                Suprime la salida por pantalla normal. (false) 
    88  -s --skip                 Ignora archivos que ya existan en el directorio. (false) 
     89 -s --skip                 Ignora archivos que ya existen en el directorio. (false) 
    8990}}} 
    9091 
    …… 
    101102     app/ << La aplicación, incluyendo controladores, vistas, modelos e instaladores 
    102103     config/ << Los aburridos archivos de configuración (haremos la configuración vía web) 
    103      public/ << Esta es la única carpeta publica dentro del enlace simbólico /www/htdocs/booklink  
     104     public/ << Ésta es la única carpeta pública dentro del enlace simbólico /www/htdocs/booklink  
    104105     script/ << Utilidades para generación de código y ejecución de pruebas unitarias (tests) 
    105106}}} 
    …… 
    123124El siguiente paso es crear una base de datos para la aplicación. Si tienes planeado usar SQLite sobre PHP5 puedes saltarte este paso. 
    124125 
    125 Cómo crear una base de datos MySQL está fuera del alcance de este tutorial, así que deberás googlear cómo hacer esto en tu sistema, o intentar tomar como ejemplo este caso común para la creación de las mismas, donde creamos tres bases de datos diferentes. Una para cada entorno (producción, desarrollo y testing). 
     126En este tutorial no podemos  explicar cómo crear una base de datos MySQL pero quizá te sirva de ayuda tomar como ejemplo este caso común donde creamos tres bases de datos diferentes, una para cada entorno (producción, desarrollo y testing). 
    126127 
    127128{{{ 
    …… 
    143144==== Usando el instalador web ==== 
    144145 
    145 Ahora ya puedes acceder al asistente de configuracion de tu aplicacion en http://localhost/booklink 
    146  
    147 Sigue los pasos del asistente para configurar el acceso a tu base de datos, configuraciones regionales y permisos de archivo, para así generar un archivo de configuración. Yo mientras tanto iré por un café mientras vas creando la aplicación *booklink* tranquilamente. 
     146Ahora ya puedes acceder al asistente de configuración de tu aplicacion en http://localhost/booklink 
     147 
     148Sigue los pasos del asistente para configurar el acceso a tu base de datos, configuraciones regionales y permisos de archivo, para así generar un archivo de configuración. Yo mientras vas creando la aplicación *booklink* tranquilamente, iré a buscar un café. 
    148149 
    149150==== Configuración manual de la aplicación ==== 
    …… 
    151152Guarda los archivos `config/DEFAULT-config.php` y `config/DEFAULT-routes.php` como `config/config.php` y `config/routes.php` y modifica lo que consideres necesario siguiendo las indicaciones del fichero. 
    152153 
    153 Puede que también necesites ajustar manualmente la ruta base de reescritura de URLs, si deseas poder usar URLs bonitas, editando el archivo `public/.htaccess` y colocando el RewriteBase como: 
     154Si deseas utilizar URLs _elegantes_ necesitas definir la ruta base para la reescritura de URLs, editando el archivo `public/.htaccess` y definiendo RewriteBase como: 
    154155 
    155156{{{ 
    …… 
    163164Ahora necesitas definir las tablas y columnas donde la aplicación almacenará la información de los libros y los autores. 
    164165 
    165 Cuando se trabaja con otros desarrolladores, los cambios en las bases de datos pueden ser difíciles de distribuir entre todos ellos. Akelos brinda una solución a este problema llamada _instalador_ o _migración_. 
    166  
    167 Así que crearás la estructura de la base de datos usando un installer con la finalidad de distribuir los cambios que realices en la estructura de la base de datos de booklink. El uso de _instaladores_ te permitirá también definir las tablas y columnas de tu base de datos de manera independiente al tipo de base de datos que utilices. 
     166Cuando se trabaja con otros desarrolladores, los cambios en las bases de datos pueden ser difíciles de distribuir entre todos ellos. Akelos ofrece una solución a este problema llamada _instalador_ o _migración_. 
     167 
     168Para crear la estructura de la base de datos utilizarás un installer para distribuir las modificaciones que realices en ella.   
     169El uso de _instaladores_ te permitirá definir las tablas y columnas de tu base de datos independientemente de si usas MySQL, SQLite u otro. 
    168170 
    169171Ahora crearás un archivo llamado `app/installers/booklink_installer.php` con el siguiente código correspondiente al Instalador de Booklink: 
    …… 
    193195}}} 
    194196 
    195 Eso es suficiente para que Akelos cree la estructura de tu base de datos. Si solo especificas el nombre de la columna, Akelos asumirá el mejor tipo de dato basándose en convenciones de normalización de base de datos. Si deseas tener total control de la configuración de tus tablas, puedes usar [http://phplens.com/lens/adodb/docs-datadict.htm sintaxis php para Adodb Datadict] 
    196  
    197 Ahora debemos ejecutar el instalador, con el comando: 
     197Eso es suficiente para que Akelos cree la estructura de tu base de datos. Si sólo especificas el nombre de la columna, Akelos determinará el tipo de datos basándose en convenciones de normalización de base de datos. Si deseas tener total control de la configuración de tus tablas, puedes usar [http://phplens.com/lens/adodb/docs-datadict.htm sintaxis Datadict de php Adodb] 
     198 
     199Ahora ejecuta el instalador, con el comando: 
    198200 
    199201{{{ 
    …… 
    201203}}} 
    202204 
    203 y eso creará las tablas definidas por el instalador. Si estas usando una base de datos MySQL, creará las siguientes estructuras: 
     205y eso creará las tablas definidas en el instalador. Si estás usando una base de datos MySQL, creará las siguientes estructuras: 
    204206 
    205207*TABLA BOOKS* 
    …… 
    236238=== Los archivos de tu aplicación y las convenciones de nomenclatura de Akelos === 
    237239 
    238 Estas son las convenciones que permiten mantener la filosofía de convención sobre configuración de Akelos. 
     240Éstas son las convenciones que permiten mantener la filosofía de convención sobre configuración de Akelos. 
    239241 
    240242==== Modelos ==== 
    …… 
    287289  1. El controlador buscará un modelo que coincida con el parámetro `controlador` de la petición. En este caso buscará `/app/models/book.php`. Si lo encuentra, creará una instancia del modelo en el atributo del controlador `$this->Book`. si hay un `id` en la petición, buscará en la tabla Books de la base de datos el registro con id 2 y eso permanecerá en `$this->Book` 
    288290  1. Ahora llamará a la acción `show` de la clase `BookController` si estuviese disponible. 
    289   1. Una vez que la acción `show` ha sido ejecutada, el controlador buscará el archivo de la vista en `/app/views/book/show.tpl` y renderizará el resultado en la variable `$content_for_layout`. 
     291  1. Una vez que la acción `show` se ejecuta, el controlador buscará el archivo de la vista en `/app/views/book/show.tpl` y renderizará el resultado en la variable `$content_for_layout`. 
    290292  1. Ahora Akelos buscará un layout con el mismo nombre que el controlador en `/app/views/layouts/book.tpl`. Si lo encuentra renderizará el mismo, insertando el contenido de `$content_for_layout` y enviando la salida al navegador. 
    291293