Cómo hacer tus páginas web como un verdadero vago y que queden muy bien
Pelican se compone de una serie de programas que nos facilitan la labor de hacer páginas web con información. Es ideal para que hagas tu blog y subas las páginas a algún servidor de páginas estáticas, como el que nos regala GitLab. Sin embargo, tu web parecerá más viva que nunca.
¿Cómo lo hacemos? Utilizando un lenguaje de marcas muy sencillo. Se llama Markdown. Consiste en describir como queremos el documento y Pelican nos programará todas las páginas como si las hubieran hecho un grupo de expertos programadores.
Si quieres echar ya un vistazo y comprobar que es sencillísimo ve a esta Chuleta Markdown
Instalación
Para instalar y utilizar pelican debes tener primero instalado el interprete de Python, ya que todo el framework está programado en este lenguaje. Si utilizas Linux estás de suerte, ya lo tienes instalado. En windoze tendrás que instalarlo desde Aqui
Comenzamos la instalación actualizando el programa instalador de los módulos de Python:
pip install --upgrade-pip
A continuación debemos instalar el modulo que va a "entender" el mini lenguaje Markdown. Es muy sencillo, desde la consola escribimos :
Los linuxeros posiblemente tengamos que poner delante un sudo
Pasamos a instalar la gran maravilla, Pelican
Iniciar proyecto
Bueno, ya que estamos aqui, vamos a probar con un ejemplo si está todo correcto.
Desde consola creamos una carpeta e iniciamos. Para ello ponemos:
mkdir ejemplo
cd ejemplo
pelican-quickstart
Nos hará una serie de preguntas.
Welcome to pelican-quickstart v3.7.1.
This script will help you create a new Pelican-based website.
Please answer the following questions so this script can generate the files
needed by Pelican.
Esto es buena señal, ya sabemos que Pelican está correctamente instalado y está dispuesto a ayudarnos.
> Where do you want to create your new web site? [.]
Aqui pondremos donde queremos crear el proyecto del sitio web. Como estamos en la carpeta donde queremos que esté, pulsamos intro. Si ponemos una palabra, nos creará una carpeta con ese nombre.
> What will be the title of this web site? prueba
Nos pregunta por el nombre del sitio web. Yo le he puesto prueba, tu pon lo que quieras
> Who will be the author of this web site? josema966
Aqui le ponemos el nombre del autor
> What will be the default language of this web site? [es] es
El idioma... Español
> Do you want to specify a URL prefix? e.g., http://example.com (Y/n) n
Aqui lo he dejado con 'n' ya que no es necesario para subirlo luego a GitLab. Si ya sabes el prefijo donde irá alojada la página, escribelo. Bien puedo poner: http://josema966.gitlab.io
> Do you want to enable article pagination? (Y/n)
> How many articles per page do you want? [10]
> What is your time zone? [Europe/Paris]
> Do you want to generate a Fabfile/Makefile to automate generation and publishing? (Y/n)
> Do you want an auto-reload & simpleHTTP script to assist with theme and site development? (Y/n)
Aqui dejamos los parametros que nos sugiere ya que están bien. Hacemos que se puedan paginar los artículos para que las páginas no sean muy largas, ponemos 10 artículos máximo por página. La zona la dejamos igual, aunque creo que en Paris hay una hora menos. Prueba con Europe/Madrid
> Do you want to upload your website using FTP? (y/N)
> Do you want to upload your website using SSH? (y/N)
> Do you want to upload your website using Dropbox? (y/N)
> Do you want to upload your website using S3? (y/N)
> Do you want to upload your website using Rackspace Cloud Files? (y/N)
> Do you want to upload your website using GitHub Pages? (y/N)
Estas las dejo en N ya que prefiero subir las páginas, una vez hechas, a mano. Sería buena opción activar el SSH y tal vez GitHub, pero nosotros lo haremos a mano y en GitLab. Es exactamente lo mismo uno que otro.
Done. Your new project is available at /home/josema/ProyectosSoftware/GitLabPages/prue-pelican
¡Pues ya está, ya lo tenemos todo! ¿Quieres probarlo? Pon:
sudo ./develop_server.sh start 8080
Ya está, Pelican ya ha confeccionado las páginas de ejemplo y ha abierto un servidor web en nuestro ordenador para que podamos probarlas.
A continuación abre tu navegador favorito y pon la siguiente dirección
Ya está. Lo chulo de esto es que, si tenemos el server rodando, cuando modifiquemos los textos, automáticamente se confeccionarán las páginas y se mostraran en el navegador... Sin tener que repetir pasos, ni ordenes. ¿A que mola?
Para parar el servidor y dejarlo hasta mañana :
sudo ./develop_server.sh stop