Diferencia entre revisiones de «Usuario:ManuelRomero/hugo»
De WikiEducator
(→Docsy) |
(→Errores. Solución usar el tema como módulo) |
||
(7 revisiones intermedias por el mismo usuario no mostrado) | |||
Línea 1: | Línea 1: | ||
===Docsy === | ===Docsy === | ||
+ | ====Instalar como submódulo==== | ||
+ | hugo new site sitio_nuevo | ||
+ | |||
+ | |||
====imgproc==== | ====imgproc==== | ||
*Si quiero usar el shortdoce '''''imgproc''''' | *Si quiero usar el shortdoce '''''imgproc''''' | ||
Línea 46: | Línea 50: | ||
</source> | </source> | ||
*En el fichero '''''md''''' se incluye el nombre de emojin que podemos sacar del '''''cheat sheet''''' https://www.webfx.com/tools/emoji-cheat-sheet/ | *En el fichero '''''md''''' se incluye el nombre de emojin que podemos sacar del '''''cheat sheet''''' https://www.webfx.com/tools/emoji-cheat-sheet/ | ||
+ | |||
+ | ===Errores. Solución usar el tema como módulo=== | ||
+ | *Me encuentro con este error | ||
+ | Error: Error building site: "/home/oem/hugo/web/content/es/_index.html:6:1": failed to extract shortcode: template for shortcode "blocks/cover" not found | ||
+ | Built in 5 ms | ||
+ | (3/05/2023) | ||
+ | SOLUCIÓN | ||
+ | Agrego el tema como un módulo en el fichero config,toml o hugo.toml | ||
+ | <source lang=yaml> | ||
+ | [module] | ||
+ | # uncomment line below for temporary local development of module | ||
+ | # replacements = "github.com/google/docsy -> ../../docsy" | ||
+ | [module.hugoVersion] | ||
+ | extended = true | ||
+ | min = "0.75.0" | ||
+ | [[module.imports]] | ||
+ | path = "github.com/google/docsy" | ||
+ | disable = false | ||
+ | [[module.imports]] | ||
+ | path = "github.com/google/docsy/dependencies" | ||
+ | disable = false | ||
+ | </source> | ||
+ | |||
+ | *Ahora cargo el módulo | ||
+ | <source lang=bash> | ||
+ | hugo mod init . | ||
+ | </source> | ||
+ | {{nota|El punto final no estoy seguro. si haces un hugo serve también funciona la descarga del módulo/s (el tema)}} | ||
+ | |||
+ | ==Syna== | ||
+ | ====Documentación==== | ||
+ | https://github.com/okkur/syna | ||
+ | https://about.okkur.org/syna/docs/ | ||
+ | ====Instalación==== | ||
+ | <source lang=bash> | ||
+ | hugo new site main | ||
+ | cd main | ||
+ | cd themes | ||
+ | git clone https://git.okkur.org/syna themes/syna | ||
+ | </source> | ||
+ | *Establecer el tema en '''''config.toml'''''. | ||
+ | <source lang=bash> | ||
+ | .... | ||
+ | theme = 'syna' | ||
+ | .... | ||
+ | </source> | ||
+ | ====Contenido==== | ||
+ | * | ||
+ | *En esta plantilla el contenido está basado en páginas y fragmentos o '''''framgment'''' | ||
+ | *Ĉada página está formada por uno o varios fragmentos | ||
+ | *Para crear una página creamos un directorio con un fichero. | ||
+ | **Si no hay secciones se llamará '''''index.md'''''. | ||
+ | **Si hay secciones se llamará '''''_index.md'''''. | ||
+ | <source lang=bash> | ||
+ | hugo new docencia_reglada/_index.md | ||
+ | hugo new myself/index.md | ||
+ | </source> | ||
+ | |||
+ | *Para crear páginas de contenido lo podemos hacer de dos formas: | ||
+ | # Creando un grupo de páginas simple:'''''single'''''. | ||
+ | # Creando lista de páginas '''''list''''' | ||
+ | |||
+ | ;Modo single: (MRM revisar esta sección) | ||
+ | *En este caso cada nueva sección va a ser un directorio y va a cointener un fichero llamado index.md que será el índice de la sección | ||
+ | *El directorio creado será el nombre del fragmento | ||
+ | *Cada nueva página deberá de referenciar el fragmento del que depende | ||
+ | vamos a agruparlas en '''''directorios''''' con un fichero '''''index.md'''''. | ||
+ | ;Modo list: (MRM revisar esta sección) | ||
+ | * | ||
+ | *El directorio creado será el nombre del fragmento | ||
+ | *Cada nueva página deberá de referenciar el fragmento del que depende | ||
+ | vamos a agruparlas en '''''directorios''''' con un fichero '''''index.md'''''. |
Revisión de 15:59 4 may 2023
Contenido
Docsy
Instalar como submódulo
hugo new site sitio_nuevo
imgproc
- Si quiero usar el shortdoce imgproc
- Situación
tengo un fichero p.e objetivo.md dónde quiero usar una imagen llamada objetivo_general.png
- Acción'
Creo en content... un directorio llamado objetivo en él creo un fichero llamado index.md con el contenido de objetivo.md Igualmente copio la imagen objetivo_general.png Establezco el recuros de la imagen en el frontmatter de index.md:
*********** resources: - src: "objetivo.jpg" ---
markmap
- En el config.toml
# Para crear gráficos direccionales [params.markmap] enable = true
- En el fichero md
```markmap #raiz_1 ##raiz_1_1 ##raiz_1_2 ##raiz_1_3 ### raiz_1_3_1 ### raiz_1_3_2 ### raiz_1_3_2 .... ```
emojin
- Común para todo hugo
- En el config.toml
# Para poder cargar emogin https://www.webfx.com/tools/emoji-cheat-sheet/
enableEmoji = true
- En el fichero md se incluye el nombre de emojin que podemos sacar del cheat sheet https://www.webfx.com/tools/emoji-cheat-sheet/
Errores. Solución usar el tema como módulo
- Me encuentro con este error
Error: Error building site: "/home/oem/hugo/web/content/es/_index.html:6:1": failed to extract shortcode: template for shortcode "blocks/cover" not found
Built in 5 ms (3/05/2023) SOLUCIÓN Agrego el tema como un módulo en el fichero config,toml o hugo.toml
[module] # uncomment line below for temporary local development of module # replacements = "github.com/google/docsy -> ../../docsy" [module.hugoVersion] extended = true min = "0.75.0" [[module.imports]] path = "github.com/google/docsy" disable = false [[module.imports]] path = "github.com/google/docsy/dependencies" disable = false
- Ahora cargo el módulo
hugo mod init .
(: El punto final no estoy seguro. si haces un hugo serve también funciona la descarga del módulo/s (el tema))
Syna
Documentación
https://github.com/okkur/syna https://about.okkur.org/syna/docs/
Instalación
hugo new site main cd main cd themes git clone https://git.okkur.org/syna themes/syna
- Establecer el tema en config.toml.
....
theme = 'syna'
....
Contenido
- En esta plantilla el contenido está basado en páginas y fragmentos o framgment'
- Ĉada página está formada por uno o varios fragmentos
- Para crear una página creamos un directorio con un fichero.
- Si no hay secciones se llamará index.md.
- Si hay secciones se llamará _index.md.
hugo new docencia_reglada/_index.md hugo new myself/index.md
- Para crear páginas de contenido lo podemos hacer de dos formas:
- Creando un grupo de páginas simple:single.
- Creando lista de páginas list
- Modo single
- (MRM revisar esta sección)
- En este caso cada nueva sección va a ser un directorio y va a cointener un fichero llamado index.md que será el índice de la sección
- El directorio creado será el nombre del fragmento
- Cada nueva página deberá de referenciar el fragmento del que depende
vamos a agruparlas en directorios con un fichero index.md.
- Modo list
- (MRM revisar esta sección)
- El directorio creado será el nombre del fragmento
- Cada nueva página deberá de referenciar el fragmento del que depende
vamos a agruparlas en directorios con un fichero index.md.