Diferencia entre revisiones de «Usuario:ManuelRomero/hugo»
(→Errores. Solución usar el tema como módulo) |
|||
| Línea 1: | Línea 1: | ||
===Docsy === | ===Docsy === | ||
| − | ==== | + | ====Crear un nuevo sitio como submódulo==== |
| + | <source lang=bash> | ||
hugo new site sitio_nuevo | hugo new site sitio_nuevo | ||
| + | </source> | ||
| + | |||
| + | *En este caso voy a usar el tema docsy | ||
| + | *Tengo 3 formas de hacerlo: | ||
| + | # Clonando el tema directamente (no recomendado= | ||
| + | # Clonando el tema como un submodulo de git (recomendado) | ||
| + | <source | ||
| + | git init | ||
| + | git submodule add https://github.com/google/docsy.git themes/docsylang=bash> | ||
| + | </source> | ||
| + | # creando un modulo de go (el más recomendado) | ||
| + | |||
| + | |||
| + | |||
| + | |||
Revisión de 21:25 2 dic 2023
Contenido
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:
- Clonando el tema directamente (no recomendado=
- 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
- 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:
- 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.
