hugo new site probando_hugo

• Esto nos creará una carpeta con dicho nombre, dentro de la cual tendremos una estructura de ficheros como mostramos en el siguiente apartado
• Después de crear el proyecto nos muestra un mensaje de cómo podemos proceder para poder ver nuestro sitio en el navegador

• Vemos la siguiente estructura de ficheros

• Posteriormente iremos viendo el significado y utilidad de cada carpeta y ficheros.

• Por tema vamos a entender el formato o estilo de nuestra página
• Por supuesto podemos crear uno nuestro o modificar uno que esté disponible
• Los temas disponibles, los podemos ver en

https://themes.gohugo.io/

• Para instalar un tema procedemos de la siguiente manera:

Lo podemos descargar la web (opción download de la página del tema) Lo podemos instalar directamente con git en la carpeta correspondiente o especificándolo en la descarga

 git init #Inicializamos git en el directorio actual
 git submodule init  #Inicializamos git para instalar submódulos en el directorio actual
 git submodule add https://git.okkur.org/syna themes/syna #Instala este tema en la carpeta thems

• Una vez realizada esta acción, ya tendremos el tema instalado (ver contenido del directorio themes
• Podríamos instalar todos los temas y luego ir seleccionando uno u otro

 git clone --depth 1 --recursive https://github.com/gohugoio/hugoThemes.git themes

• Una vez instalado el tema, hay que especificar en el fichero de configuración qué tema vamos a usar
• La configuración del sitio se establece en el fichero config.toml

Lo abrimos y añadimos el tema en este caso syna o el que queramos establecer

theme="syna"

• Vamos añadir el tema learn y a trabajar con el

git submodule add https://github.com/matcornic/hugo-theme-learn.git ./themes/learn

• Ahora seguimos el manual de este tema y vamos modificando ficheros según nos indica y a nuestra conveniencia.

https://learn.netlify.app/en/

• Primero modificamos el fichero de configuración

# Change the default theme to be use when building the site with Hugo
theme = "hugo-theme-learn"
 
# For search functionality
[outputs]
home = [ "HTML", "RSS", "JSON"]

• La plantilla de learn se carga a partir de partes que se ubican en la subcarpeta de partials
• Cambiamos el logo de la imagen (modificamos ./partials/logo.html

• Otro tema que voy s usar yo

https://www.docsy.dev/docs/

git submodule add https://github.com/google/docsy.git ./themes/docsy

• Tiene que estar instalado postCss para transpilar ficheros sass

sudo npm install -D autoprefixer
sudo npm install -D postcss-cli
 
sudo npm install -D postcss

• Una vez descagado el tema debemos actualizarlo, ya qsudo npm install -D autoprefixer

 git clone --recurse-submodules --depth 1

• Una vez creado, tendremos unos ficheros de configuración que hay que conoce
• Observaremos que hay ficheros de configuración en diferentes niveles de las carpetas, digamos que podríamos modificar en una ubicación concreta una configuración más general.
• El fichero de configuración es config.toml
• La configuración de propia de hugo, pero cada plantilla la puede particularizar (añadir variables de configuración). También podríamos añadir nosotros nuestras propias variables.

https://learn.netlify.app/en/basics/configuration/

• Vamos a modificar las básicas según nos interese en nuestro sitio

• Los estilos son algo propio de la vista, del tema
• Los temas vienen con un estilo que puede ser configurable o podemos incluso modificarlo.
• Dentro del tema tendremos la carpeta 'static/css'. Ahí podemos ver los estilos
• Podemos ver cómo learn viene con tres estilo que podemos establecer en el fichero de configuración con la variable 'themeVariant dentro de sección de parámetros param
• Lear viene con tres estilos green, red, blue
• Podemos crear uno propio

[params]
  # Change default color scheme with a variant one. Can be "red", "blue", "green".
  themeVariant = "red"

• También podríamos cambiar el logo y el favicon copiando la imagen en la carpeta static/images y modificando los partiasl favico.html y logo.html

• Ahora vamos a escribir el contenido de nuestras páginas de nuestro sitio web
• Es muy importante organizar bien nuestro sitio web antes de empezar a añadir contenido
• El contenido será normalmente facilitado en ficheros de texto con extensión md.
• hugo tiene la gran potencia de recorrer estas carpetas de contenido y visualizarlas en las plantillas.
• Aquí tenemos un gran ejemplo de separar plantillas y contenido en armoniosa organización

Estableciendo la estructura

https://gohugo.io/content-management/organization/ https://learn.netlify.app/en/cont/pages/ Crearemos carpetas para cada contenido principal Cada carpeta debería de tener un fichero llamado _index.md que constituya el capítulo de esos contendios. Después tendremos ficheros y mas carpetas que serán el contenido de este tema concreto. Lear organiza las páginas en dos tipos: Chapter hugo new --kinD chapter temario/_index.md defaul hugo new temario/tema1.md

• Para ellos escribiremos en texto plano en ficheros md (con sintaxis Markdonw https://markdown.es/sintaxis-markdown/)
• Podremos añadir tantos ficheros como contenido queremos crear y cada fichero de la extensión que necesitemos.
• Es importante organizar bien los contenidos, de momento vamos a crear un fichero
• Se puede hacer directamente en el editor o usar comandos de hugo

 hugo new index.md

• Esto nos creará un fichero index.md en la carpeta de content

• El contenido del fichero es mínimo

• Ahora podemos escribir contenido en el fichero y observar el resultado
• Vamos a escribier en un fichero lo que quisiéramos publicar, por ejemplo escribimos

# Creación de sitios Web con Hugo
 
****Hugo**** es un sotfware que nos va a permitir crear sitios web con contenido estático.
Podemos considerarlo un CSM pero sin posibilidad de agregar bases de datos ni formularios para interactuar con el usuario
Su cometido es visualizar de forma agradable y fácil el contenido de fihceros de texto como éste.
El formato del texto escrito es formato markdown.
Así si queremos ver un listado de viñetas
 
* Este es un item
* Este es otro ite
* Etc etc
 
También podemos visualizar código fuente
````html
<h1>Esto es texto de primera línea</h1>
````
---

• fichero de configuración

 enableEmoji=true /*false default*/

• Ahora simplemente añadirmos emojin ver emoin cheat sheet (https://www.webfx.com/tools/emoji-cheat-sheet/)

• Analizando la estructura de carpetas observamos que tenemos una carpeta llamada layout, la misma que existe dentro de la carpeta theme que hayamos descargado.
• Si queremos modificar un fichero del theme, no deberíamos hacerlo ahí, ya que esa carpeta no la hemos realizado nosotros y si quisiéramos posteriormente actualizarla, se perderían todos los cambios.
• La organización de hugo está muy bien pensada y estructurada. Cualquier fichero que exista en la carpeta de layout con igual nombre (y estrcutura) sobreescribirá el fichero correspondiente de la carpeta del theme.
• Por lo tanto para cambiar el logo, deberíamos crear el fichero correspondiente en la carpeta layout raíz de nuestro proyecto

• No debemos acceder al propio css del thema y cambiarlo, aunque funcione no es una buena práctica de desarrollo
• MEjor poner nosotros nuestra propias declaraciones y hacer que éstas sean las que se visualicen (modifiquen las de por defecto)
• Esta práctica ya la hemos realizado en el ejemplo anterior
• En el caso de css, crearemos nuestro propio css que queramos añadir y lo colocaremos debajo del css que esté declarado, de forma que éste sea el que prevalezca.
• La mayoría de las plantillas, en su fichero html partials de header.html, realiza una carga de todos los ficheros css.

{{ range .Site.Params.custom_css -}}
    <link href="{{(printf "%s" .) | relURL}}{{ if $assetBusting }}?{{ now.Unix }}{{ end }}" rel="stylesheet">
    {{- end }}

• Ahora deberemos establecer esos ficheros bajo la varialbe custom_css en el fichero de configuración

[params]
custom_css=['/css/estilo.css']

• Aqui vemos un array con todos los ficheros de estilos que queramos cargar