Diferencia entre revisiones de «Usuario:ManuelRomero/hugo»

De WikiEducator
Saltar a: navegación, buscar
(Docsy (imgproc))
(Errores. Solución usar el tema como módulo)
(9 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 19: Línea 23:
 
====markmap====
 
====markmap====
 
*En el config.toml
 
*En el config.toml
<source lang="bash">
+
<source lang="yaml">
 
# Para crear gráficos direccionales
 
# Para crear gráficos direccionales
 
[params.markmap]
 
[params.markmap]
Línea 25: Línea 29:
 
</source>
 
</source>
 
*En el fichero '''''md'''''
 
*En el fichero '''''md'''''
<source lang="json>
+
<source lang="yaml">
 
```markmap
 
```markmap
 
#raiz_1
 
#raiz_1
Línea 37: Línea 41:
 
```
 
```
 
</source>
 
</source>
 +
====emojin====
 +
*Común para todo hugo
 +
*En el config.toml
 +
<source lang="yaml">
 +
 +
# Para poder cargar emogin https://www.webfx.com/tools/emoji-cheat-sheet/
 +
enableEmoji = true
 +
</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/
 +
 +
===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 16:59 4 may 2023

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

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  .

(Comment.gif: 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:
  1. Creando un grupo de páginas simple:single.
  2. 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.