search

freelinuxdistrodeployed / LDT

Linux Deployed Tool
http://freelinuxdistrodeployed.github.io/LDT
Apache License 2.0
6 stars 2 forks source link

Cambio de pagina web #8

Closed juanAFernandez closed 9 years ago

juanAFernandez commented 9 years ago

Debemos de modificar la orientación de la página web. Tras una charla con JJ nos recomienda transformarla en un blog con la ayuda de herramientas como Jekyll u Octopress que tenemos que investigar. Debemos de crear un nuevo repositorio donde almacenar exclusivamente el contenido del blog y dejar en .io la configuración de la página web, en uno de esos ficheros que habrá en .io se especificará que cada vez que se haga un push en diarioDesarrollo (por ponerle un nombre al nuevo repositorio) se ejecuta Jekyll en .io y se actualizan los cambios. La página que tenemos actualmente se convertirá en la parte de la documentación más formal, tipo "about" típico. Será algo lioso realizar el cambio pero parece que cuando funcione ofrecerá mucha más potencia y versatilidad al poder usar directamente los markdown.

juanAFernandez commented 9 years ago

Sigo intentando hacer que funcione de forma correcta y que en vez de entorpecer, mejore el flujo de trabajo.

juanAFernandez commented 9 years ago

Tras una charla con Fergu he aclarado las dudas sobre la documentación. Lo más lógico como me ha comentado (y como he visto en otros proyectos) es tener dentro del repositorio del proyecto una rama gh-pages donde esté toda la información, la documentación, etc... Por eso la decisión final y espero que última para poder agilizar de una vez el trabajo será tener dos ramas en el repositorio. Una master donde tener todo el código de ansible y de las herramientas que usemos y otra gh-pages donde tener la estructura de Jakyll y dentro de esta en la carpeta _post tener toda la documentación con un formato específico, simplemente hay que añadir una cabecera y modificar un par de cosas en los markdown. Así tendremos un solo repositorio de este proyecto. El repositorio .github.io que existe ahora (que va a dejar de existir) sería la página de información de nuestra organización. Nuestra organización se llama de la misma forma que nuestro proyecto, esto ha podido llevar a confusión por lo que voy a crear otra issue para denominar correctamente a la organización y al proyecto, para que el nombre sea elegido por todos, si os parece, ya que el actual parece que no describe muy bien lo que vamos a hacer (bajo mi punto de vista). Directamente: #9

mortega87 commented 9 years ago

Linux Deployment Tool

juanAFernandez commented 9 years ago

Siento haber realizado tantos commits, pero ya funciona todo bien. Cada vez que avancéis algo en el proyecto cread un post. Primero haced un pull del repositorio y dentro de la carpeta _post podeis añadir los .md con el formato del post. Como podéis ver en lo que ya están hechos sólo tenéis que añadir una cabecera, como:

---
layout:     post
title:      "Consideraciones sobre SSH"
subtitle:   "Las decisiones previas"
date:       2014-11-3 12:00:00
author:     "JuanAFernandez"
header-img: "img/post-bg-06.jpg"
---

Sólo tenéis que cambiar title, subtitle, date y author. El nombre del fichero tiene que tener el formato de los otros, con la fecha y nombre separado por guiones. Jekyll reconoce Markdown excepto los bloques de código que en vez de encerarlos entre '''sh ved en Raw como están en {%highlight bash %}. También se puede poner código añadiendo tabuladores al principio y se puede probar como va a quedar en local instalando ruby y jekyll, es muy simple.

juanAFernandez commented 9 years ago

Cuando hagáis pull del repositorio podéis cambiar de rama para trabajar en las dos con git checkout nombre-rama