Usuario:ManuelRomero/hugo

Docsy

Crear un nuevo sitio como submódulo

hugo new site sitio_nuevo

• En este caso voy a usar el tema docsy
• Tengo 3 formas de hacerlo:

1. Clonando el tema directamente (no recomendado=
2. Clonando el tema como un submodulo de git (recomendado)

Idioma no válido.

Necesita especificar un idioma como esto: <source lang="html4strict">...</source>

lenguajes soportados para sintaxis remarcada:

4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript, actionscript3, ada, algol68, apache, applescript, apt_sources, arm, asm, asp, asymptote, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_loadrunner, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, coffeescript, cpp, cpp-qt, csharp, css, cuesheet, d, dcl, dcpu16, dcs, delphi, diff, div, dos, dot, e, ecmascript, eiffel, email, epc, erlang, euphoria, f1, falcon, fo, fortran, freebasic, freeswitch, fsharp, gambas, gdb, genero, genie, gettext, glsl, gml, gnuplot, go, groovy, gwbasic, haskell, haxe, hicest, hq9plus, html4strict, html5, icon, idl, ini, inno, intercal, io, j, java, java5, javascript, jquery, kixtart, klonec, klonecpp, latex, lb, ldif, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, mmix, modula2, modula3, mpasm, mxml, mysql, nagios, netrexx, newlisp, nsis, oberon2, objc, objeck, ocaml, ocaml-brief, octave, oobas, oorexx, oracle11, oracle8, oxygene, oz, parasail, parigp, pascal, pcre, per, perl, perl6, pf, php, php-brief, pic16, pike, pixelbender, pli, plsql, postgresql, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, pys60, python, q, qbasic, rails, rebol, reg, rexx, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, spark, sparql, sql, stonescript, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, upc, urbi, uscript, vala, vb, vbnet, vedit, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, whois, winbatch, xbasic, xml, xorg_conf, xpp, yaml, z80, zxbasic

1. creando un modulo de go (el más recomendado)

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:

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.