Skip to content

tic-ull/github-pages

Repository files navigation

Sitio de Ejemplo de GitHub Page para proyectos de la Universidad de La Laguna

* Instalación
  -  git clone
  -  Virtualenv + requirements

* 2 ramas:
  -  master: source
  -  gh-pages: generada

* Comandos de utilidad:
  -  make devserver - Servidor de Desarrollo, lanzado en background  (localhost:8000)
  -  make html - Gerena el HTML de la página en el directorio output
  -  make github - Genera el HTML y los pushea en la rama gh-pages

* Pautas para adaptar el sitio:
  - Configuración general: pelicanconf.py y publishconf.py
  - Contenido de las páginas: content/pages

- Formulario de contacto (sólo para servidores php):
    Para añadir y usar el formulario de contacto de ejemplo (content/pages/contact.md):
        Habilitar el script apps.js (descomentar la línea correspondiente en pelicanconf.py)
        Configurar el fichero content/php/mailer.php con las direcciones de correo a usar

    Para eliminar el formulario de contacto
        Eliminar los ficheros content/js/app.js y content/php/mailer.php

- ¿Cómo añadir widgets adicionales en el lateral derecho?
    Se activan y configuran en el archivo de configuración pelicanconf.py (SOCIAL, WORK_SUPPORTED_BY_HTML, etc.)

- ¿Cómo añadir un índice en la página?
    Uso del plugin toc (Índice), el índice se genera automáticamente
    Añadir un id en cada h2 que desee que aparezca en el índice (Ej: <h2 id="sample">Sample</h2>)

- ¿Cómo poner una galería?
    Uso del plugin gallery.
    Añadir las imagenes en directorios en /content/images/gallery
    Definir el diccionario GALLERY_ALBUMS en la configuración pelicanconf.py, con los albumes que deseemos mostrar en la galería y su nombre 'nombre_directorio_imagenes': 'titulo_publico_galeria'

    Hay 2 tipos de galeria.