Primeros pasos
Para comenzar tienes que utilizar el comando frontweb. Este comando tiene dos modos de ejecución:
>>> frontweb
usage: python /usr/local/bin/frontweb <subcommand> [options] [args]
Comandos disponibles:
init Genera un proyecto nuevo en para construir un sitio web.
run Inicia un servidor en modo desarrollo para mostrar el sitio.
El comando init genera un nuevo website y run lo pone en funcionamento.
Creando nuestro website
Comencemos creando un nuevo sitio, ejecuta los siguientes comandos:
frontweb init
Y cuando el sistema lo solicite, ingresa el nombre para tu sitio web, por ejemplo 'miweb':
Cuidado, el archivo 'data/configuracion.ini' no existe. Ingresa el nombre de proyecto: miweb
Esto generará un nuevo directorio y aparecerán algunas notas en pantalla:
Se ha creado el directorio 'miweb'. Ingrese en el, y luego ejecute 'frontweb run' para iniciar el servidor. Generando el archivo 'url.py' de ejemplo. Generando el directorio 'data'
Primer prueba
Ya se han creado los archivos iniciales para poner en funcionamiento el sitio web. Ahora tienes que ingresar a este nuevo directorio con tu web e iniciar el servidor:
cd miweb frontweb run
entonces aparecerá un mensaje en pantalla indicando que el servidor web ya está esperando clientes:
Validating models... 0 errors found Django version 1.2.5, using settings 'webfrontweb.settings' Development server is running at http://127.0.0.1:8000/ Quit the server with CONTROL-C.
Ahora puedes abrir un navegador web e ingresar a tu sitio con la URL: localhost:8000, donde 8000 es el puerto en el que corre la aplicación. Ten en cuenta que este número se puede especificar directamente en la linea de comandos, por ejemplo podrías cualquiera de los dos comandos como ejemplo:
frontweb run -p 8080 python manage.py 0.0.0.0:8000
Personalizando el sitio
Cuando ejecutamos el comando frontweb init se crearon varios elementos dentro del directorio principal.
Los primeros archivos del directorio representan un proyecto django, así que puedes usarlo como molde para añadirle aplicaciones o simplemente para extraer lo que no necesites.
Entre estos archivos, los mas importantes son settings.py y urls.py.
Directorio data
Este es el directorio principal de tu sitio, cada articulo que escribes tiene que estar en un archivo .rst o .txt distinto, respetando la sintaxis de restructuredText.
También hay varios archivos especiales que puedes modificar para personalizar tu sitio. Estos archivos son:
- index.rst
- representa la página principal.
- footer.rst
- es el pie de página.
- title.rst
- la cabecera del sitio.
- navbar.rst
- la barra de navegación.
- sidebar.rst
- el panel lateral para poner contenido personalizado.
