diff --git a/docs/tutorial.md b/docs/tutorial.md deleted file mode 100644 index 187a4b3..0000000 --- a/docs/tutorial.md +++ /dev/null @@ -1,110 +0,0 @@ -## Creando un nuevo website - -Para crear un nuevo website con paramecio2 debe de usar el comando instalado `paramecio2` - -Introduzca en su linea de comandos lo siguiente: - - user@localhost: paramecio2 --help - - usage: paramecio2 [-h] --path PATH [--modules MODULES] [--symlink] [--url URL] [--folder FOLDER] - - A tool for create new paramecio2 sites - - options: - -h, --help show this help message and exit - --path PATH The path where the paramecio site is located - --modules MODULES A list separated by commas with the git repos for download modules for this site - --symlink Set if create direct symlink to paramecio in new site - --url URL The http/https base url of the real proxy server. Example: https://www.exampledomain.com, default is http://localhost:5000 - --folder FOLDER If you deploy in a subdirectory, set it, without beggining and ending slashes - - -El único parametro requerido es `--path`, que indica la carpeta donde será guardado su nuevo sitio. - -Ejemplo: `paramecio2 --path site` - -Aparecerán diversas opciones para contestar: - -- Email for site: - -Con esta opción puede añadir un correo por defecto que será usado para algunas cuestiones internas de envío de emails. - -- Do you want use paramecio with MySQL database? y/n: - -Esta opción es para añadir una base de datos MariaDB/MySQL al sistema. - -> Recuerde que MariaDB es una base de datos compatible con MySQL y es la recomendada por parte de los desarrolladores para su uso con Paramecio2. - -Si se elige `y`(sí) aparecerán unas nuevas opciones para configurar la base de datos del nuevo website con paramecio2: - -- MySQL database server host, by default localhost: - -Añada el servidor de datos mysql para el website creado con paramecio2. Por defecto es el servidor de bases de datos local. - -- MySQL database name, by default paramecio_db: - -El nombre de la base de datos que se usará para paramecio2. Si no existe, el sistema intentará crearla. - -- MySQL database user, by default root: - -El usuario de la base de datos, por defecto, el usuario root. - -- MySQL database password, by default "": - -La contraseña de la base de datos. Por defecto, se deja en blanco. - -- Do you want create admin site? y/n: - -Si elegiste usar una base de datos MySQL, podrás tener opción para crear una zona de administración, a la que se podrá añadir módulos usando flask y la aplicación wsgi admin_app. - -Si todo va bien, obtendremos este mensaje final: - -`Created admin site...` - -Una vez visto ese mensaje, podremos acceder al administrador de nuestro nuevo sitio y podremos crear al usuario administrador. - -## Iniciando el nuevo website. - -Si el path usado para el nuevo sistema paramecio2 es `site`, podremos entrar a una carpeta llamada así dentro del directorio donde ejecutamos el comando `paramecio2`. - -Con flask, podemos hacer usar su entorno de desarrollo, usando el comando `flask`. - -Entramos en `site`. Usando Linux por ejemplo: - - cd site - -Ahora ejecutamos el comando `flask`: - - flask --app app run --debug - -Debería aparecer lo siguiente: - - * Serving Flask app 'app' - * Debug mode: on - WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead. - * Running on http://127.0.0.1:5000 - Press CTRL+C to quit - * Restarting with watchdog (inotify) - * Debugger is active! - * Debugger PIN: 537-905-394 - -Si no da error, ya tienes instalado correctamente un sitio usando `Paramecio2 framework`. - -## Creando un nuevo usuario para el administrador. - -Si creaste el sitio con un administrador, podrás acceder a él en esta dirección web por defecto: - - http://localhost:5000/admin - -Obviamente deberás cambiar la URL a la dirección con la que configuraste Paramecio2. - -Más información sobre Flask: (https://flask.palletsprojects.com/en/3.0.x/) - - - - - - - - - diff --git a/mkdocs.yml b/mkdocs.yml index bcbf242..9197079 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -42,4 +42,4 @@ nav: # rest of the navigation... - Index: index.md - Installation: install.md -- Tutorial: tutorial.md +