Changeset 193

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

Updating docs

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • trunk/docs/tutorial-es.markdown

    r187 r193  
    55-------------------------- 
    66 
    7 Este tutorial te mostrará cómo crear una aplicación con el Akelos Framework.  
    8  
    9 Esta aplicación servirá para manejar libros y sus autores y la llamaremos **booklink** 
     7Este tutorial te muestra cómo crear una aplicación con el Akelos Framework.  
     8 
     9Esta aplicación sirve para manejar libros y sus autores y la llamaremos **booklink** 
    1010 
    1111Requisitos 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 
    2121Descarga 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 [subversion](http://subversion.tigris.org/). 
    24 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 [subversion](http://subversion.tigris.org/). 
     24Puedes retirar una "copia de trabajo" del código fuente de Akelos con el comando: 
    2525 
    2626    svn co http://akelosframework.googlecode.com/svn/trunk/ akelos 
    …… 
    5555--------------------------------------------- 
    5656 
    57 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) 
     57Ya 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) 
    5858 
    5959Ahora se pueden seguir dos vías: 
    6060 
    6161 1. Crear una aplicación con Akelos y enlazarla a las librerías del Framework. 
    62  2. 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.       
     62 2. Comenzar a escribir el código de 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.         
    6363  
    64 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: 
     64Si ya te 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: 
    6565 
    6666   ./script/setup -h 
    …… 
    7272    -deps --dependencies      Incluye una copia del framework dentro del directorio de la aplicación. (true) 
    7373    -d --directory=<value>    Directorio de destino para instalar la aplicación. 
    74     -f --force                Sobreescribe archivos que ya existan. (false) 
    75     -h --help                 Muestra esta ayuda. 
    76     -p --public_html=<value>  Ubicación donde la aplicación será accedida por el servidor web. () 
     74    -f --force                Sobrescribe archivos que ya existen. (false) 
     75    -h --help                 Muestra la ayuda que ahora mismo estás leyendo. 
     76    -p --public_html=<value>  Ubicación que el servidor web utilizará para iniciar la aplicación. () 
    7777    -q --quiet                Suprime la salida por pantalla normal. (false) 
    78     -s --skip                 Ignora archivos que ya existan en el directorio. (false) 
     78    -s --skip                 Ignora archivos que ya existen en el directorio. (false) 
    7979         
    8080Así que ejecutando el siguiente comando: (reemplazar `/www/htdocs` con tu  ruta al directorio público del servidor web. En algunos Hosting Compartidos es `/home/USUARIO/public_html`) 
    …… 
    8787        app/ << La aplicación, incluyendo controladores, vistas, modelos e instaladores 
    8888        config/ << Los aburridos archivos de configuración (haremos la configuración vía web) 
    89         public/ << Esta es la única carpeta publica dentro del enlace simbólico /www/htdocs/booklink  
     89        public/ << Ésta es la única carpeta pública dentro del enlace simbólico /www/htdocs/booklink  
    9090        script/ << Utilidades para generación de código y ejecución de pruebas unitarias (tests) 
    9191 
    …… 
    107107El siguiente paso es crear una base de datos para la aplicación. Si tienes planeado usar SQLite sobre PHP5 puedes saltarte este paso. 
    108108 
    109 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). 
     109 En 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). 
    110110 
    111111    mysql -u root -p 
    …… 
    128128#### Usando el instalador web #### 
    129129 
    130 Ahora ya puedes acceder al asistente de configuracion de tu aplicacion en http://localhost/booklink     
    131  
    132 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. 
     130Ahora ya puedes acceder al asistente de configuración de tu aplicacion en http://localhost/booklink     
     131 
     132Sigue 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é. 
    133133 
    134134#### Configuración manual de la aplicación #### 
    …… 
    136136Guarda 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. 
    137137 
    138 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: 
     138Si deseas usar URLs bonitas necesitas definir la ruta base para la reescritura de URLs, editando el archivo `public/.htaccess` y definiendo RewriteBase como: 
    139139 
    140140    RewriteBase /booklink 
    …… 
    147147Ahora necesitas definir las tablas y columnas donde la aplicación almacenará la información de los libros y los autores.  
    148148 
    149 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*. 
    150  
    151 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. 
    152 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. 
     149Cuando 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*. 
     150 
     151Para crear la estructura de la base de datos utilizarás un installer para distribuir las modificaciones que realices en ella. 
     152El uso de *instaladores* te permitirá definir las tablas y columnas de tu base de datos independientemente de si usas MySQL, SQLite u otro. 
    153153 
    154154Ahora crearás un archivo llamado `app/installers/booklink_installer.php` con el siguiente código correspondiente al Instalador de Booklink: 
    …… 
    181181     ?> 
    182182 
    183 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 [sintaxis php para Adodb Datadict](http://phplens.com/lens/adodb/docs-datadict.htm) 
    184  
    185 Ahora debemos ejecutar el instalador, con el comando: 
     183Eso 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 [sintaxis Datadict de php Adodb](http://phplens.com/lens/adodb/docs-datadict.htm) 
     184 
     185Ahora ejecuta el instalador, con el comando: 
    186186 
    187187    ./script/migrate Booklink install 
    188188 
    189 y eso creará las tablas definidas por el instalador. Si estas usando una base de datos MySQL, creará las siguientes estructuras: 
     189y eso creará las tablas definidas en el instalador. Si estás usando una base de datos MySQL, creará las siguientes estructuras: 
    190190 
    191191**TABLA BOOKS** 
    …… 
    219219### Los archivos de tu aplicación y las convenciones de nomenclatura de Akelos ### 
    220220 
    221 Estas son las convenciones que permiten mantener la filosofía de convención sobre configuración de Akelos. 
     221Éstas son las convenciones que permiten mantener la filosofía de convención sobre configuración de Akelos. 
    222222 
    223223#### Modelos #### 
    …… 
    275275 4. Ahora llamará a la acción `show` de la clase `BookController` si estuviese disponible. 
    276276 
    277  5. 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`. 
     277 5. 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`. 
    278278 
    279279 6. 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. 
    …… 
    311311    ?> 
    312312 
    313 Ahora que los modelos son concientes el uno del otro necesitas modificar el controlador book, para que incluya las instancias de los modelos `author` y `book` 
     313Ahora que los modelos son concientes el uno del otro necesitas modificar el controlador book, para que incluya las instancias de los modelos `author` y `book` 
    314314 
    315315*/app/controllers/book_controller.php*