kj/duckbrain-docs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Simplify a few paragraphs.

Browse Source
This commit is contained in:
KJ 2024-09-06 22:20:39 -04:00
parent 7758e0058d
commit 35b7393495
1 changed files with 5 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
starting-manual.org
View File

@ -13,7 +13,7 @@ Otro punto fuerte que puedo dar de esta herramienta, es que te puede ser tremend
** Estructura de archivos de Duckbrain
Al entrar a la carpeta de Duckbrain encontrarás esta estructura de archivos (ignoramos el readme.org porque no es necesario).
Al entrar a la carpeta de Duckbrain encontrarás esta estructura de archivos (ignoramos el readme.org por obvias razones).
#+begin_src ditaa
.
@ -40,19 +40,17 @@ Primero veamos las carpetas y luego los archivos:
*** Carpeta src
En esta carpeta se encuentra todo el código PHP.
Como todo en [[https://git.kj2.me/kj/duckbrain][Duckbrain]], esta ruta se puede cambiar editando una variable en el archivo =index.php=.
En esta carpeta se encuentra todo el código PHP de lo que será nuestro proyecto. Es posible cambiarle el nombre/ruta a gusto, como te darás cuenta más adelante.
*** Carpetas: Controllers, Libs, Models, Middlewares, Views y Routers
Si sabes de estructuras de diseño, el nombre de estas carpetas ya te debe quedar claro qué va en cada una de ellas, puesto que en el nombre de la carpeta dice lo que va a ir dentro.
Si sabes de estructuras de diseño, ya te debe quedar claro qué va en cada una de estas carpetas, puesto que en el nombre de las mismas lo indica.
Si no sabes que es un Model, un Middleware, Controller, etc. entonces requieres buscar ahora mismo lo que es una arquitectura de diseño de software y leerte al menos en qué consiste la arquitectura de MVC, ya que es una arquitectura simple y la que usaremos más adelante en este manual.
Si no sabes que es un Model, un Middleware, Controller, etc. entonces requieres buscar ahora mismo lo que es una arquitectura de diseño de software y leerte al menos en qué consiste la arquitectura de MVC, ya que es una arquitectura simple y la que usaremos más adelante en este manual. Si lo comprendes, solo sigue leyendo.
Al igual que con la carpeta =src=, todo lo puedes cambiar y colocar otra estructura de carpetas y las únicas que requerirían algún tipo de edición de archivos serían las carpetas =Views= y =Router= que se editarían en el archivo =src/Libs/View.php= y el archivo =index.php= respectivamente. Las demás carpetas las puedes borrar cuando quieras y usar otra estructura, pero por lo pronto no lo hagas al menos hasta que hayas pasado la sección [[Mi primera aplicación][Mi primera aplicación]] que es cuando ya habrías leído y, con algo de suerte y pericia, asimilado los conocimientos necesarios para hacer lo que te de la gana con este ser de librería al punto de que ya le podrás colocar las tuyas propias, le borrarás alguna de las que viene por defecto porque no la necesites o incluso crees una versión extendida de las que viene por defecto para poder añadirle alguna mejora que necesites.
Desde luego, si eres un ansias y ya has programado antes en alguna arquitectura de diseño como DDD, MVC, TDD, EDD, etc. y manejas decentemente PHP, con que te leas el código del archivo =index.php= (son solo 20 líneas de código) te deberá bastar y puedes saltarte el resto del este manual y guiarte de ahora en adelante con la documentación API de las librerías.
Desde luego, si eres un ansias y ya has programado antes en alguna arquitectura de diseño como DDD, MVC, TDD, EDD, etc. y manejas decentemente PHP, con que te leas el código del archivo =index.php= (son solo 20 líneas de código) te deberá bastar y puedes saltarte el resto del este manual y guiarte de ahora en adelante con la documentación de los comentarios (docblocks) de las librerías.
*** Los archivos en la raíz