54 lines
2.8 KiB
Markdown
54 lines
2.8 KiB
Markdown
# Creando una nueva aplicación
|
|
|
|
Una vez el bench esté instalado, vas a ver dos directorios principales, `apps` and `sites`. Todas las aplicaciones van a ser instaladas en apps.
|
|
|
|
Para crear una nueva aplicación, debes posicionarte en el directorio del bench y ejecutar `bench new-app {app_name}` y llenar los detalles de la aplicación. Esto a va crear los directorios y archivos necesarios para una aplicación.
|
|
|
|
$ bench new-app library_management
|
|
App Title (defaut: Lib Mgt): Library Management
|
|
App Description: App for managing Articles, Members, Memberships and Transactions for Libraries
|
|
App Publisher: Frappé
|
|
App Email: info@frappe.io
|
|
App Icon (default 'octicon octicon-file-directory'): octicon octicon-book
|
|
App Color (default 'grey'): #589494
|
|
App License (default 'MIT'): GNU General Public License
|
|
|
|
### Estructura de una aplicación
|
|
|
|
La aplicación va a ser creada en el directorio llamado `library_management` y va a tener la siguiente estructura:
|
|
|
|
.
|
|
├── MANIFEST.in
|
|
├── README.md
|
|
├── library_management
|
|
│ ├── __init__.py
|
|
│ ├── config
|
|
│ │ ├── __init__.py
|
|
│ │ └── desktop.py
|
|
│ ├── hooks.py
|
|
│ ├── library_management
|
|
│ │ └── __init__.py
|
|
│ ├── modules.txt
|
|
│ ├── patches.txt
|
|
│ └── templates
|
|
│ ├── __init__.py
|
|
│ ├── generators
|
|
│ │ └── __init__.py
|
|
│ ├── pages
|
|
│ │ └── __init__.py
|
|
│ └── statics
|
|
├── license.txt
|
|
├── requirements.txt
|
|
└── setup.py
|
|
|
|
1. `config` contiene la información de configuración de la aplicación.
|
|
1. `desktop.py` es donde los íconos del escritorio pueden ser agregados al mismo.
|
|
1. `hooks.py` es donde se configuran las integraciones con el entorno y otras aplicaciones.
|
|
1. `library_management` (dentro) es un **módulo** que está contenido. En Frappé, un **módulo** es donde los modelos y controladores se almacenan.
|
|
1. `modules.txt` contiene la lista de **módulos** en la aplicación. Cuando creas un nuevo módulo, es obligatorio que lo agregues a este archivo.
|
|
1. `patches.txt` es donde los patches para migraciones son establecidos. Son módulos de Python referenciados usando la nomenclatura de punto.
|
|
1. `templates` es el directorio donde son mantenidos las plantillas de vistas web. Plantillas para **Login** y otras páginas estandar estan contenidas en Frappé.
|
|
1. `generators` son donde las plantillas para los modelos son almacenadas, donde cada instancia de modelo tiene una ruta web separada, por ejemplo un **Blog Post** donde cada post tiene una url única. En Frappé, el manejador de plantillas utilizado es Jinja2.
|
|
1. `pages` es donde las rutas simples son almacenadas. Por ejemplo para un tipo de página "/blog".
|
|
|
|
{next}
|