Hugo

Tags:

Create a new site

hugo new site FirstHugoSite
hugo server

See Also:
[^] https://gohugo.io/getting-started/quick-start/

Create a new Docsy documentation site

hugo new site my-new-site
cd  my-new-site
hugo mod init github.com/me/my-new-site
hugo mod get github.com/google/docsy@v0.6.0
cat >> config.toml <<EOL
[module]
proxy = "direct"
[[module.imports]]
path = "github.com/google/docsy"
[[module.imports]]
path = "github.com/google/docsy/dependencies"
EOL
hugo server
hugo new site my-new-site
cd  my-new-site
hugo mod init github.com/me/my-new-site
hugo mod get github.com/google/docsy@v0.6.0
(echo [module]^

proxy = "direct"^

[[module.imports]]^

path = "github.com/google/docsy"^

[[module.imports]]^

path = "github.com/google/docsy/dependencies")>>config.toml
hugo server

See Also:
[^] https://www.docsy.dev/docs/get-started/docsy-as-module/start-from-scratch/
[^] https://github.com/google/docsy/blob/main/userguide/config.yaml

Install google tag

Create the file layouts\partials\google\analytics.html and place the following code snippet inside

<!-- Global Site Tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-100000000-1"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments)};
  gtag('js', new Date());

  gtag('config', 'UA-100000000-1');
</script>

Taxonomies

[^] https://gohugo.io/content-management/taxonomies/
[^] https://www.docsy.dev/docs/adding-content/taxonomy/

Shortcodes

[^] https://gohugo.io/content-management/shortcodes/
[^] https://www.docsy.dev/docs/adding-content/shortcodes/

Generate diagram and flowcharts

[^] Mermaid - Generate diagram and flowcharts from markdown https://mermaid.js.org/#/
[^] Mermaid live editor
[^] https://diagrams.mingrammer.com/
[^] https://plantuml.com/nwdiag
[^] http://go.drawthe.net/
[^] https://github.com/openwisp/netjsongraph.js

Markdown references

[^] https://www.markdownguide.org/tools/hugo/
[^] https://learn.netlify.app/en/cont/markdown/
[^] https://gohugo.io/content-management/formats/#learn-markdown
[^] https://www.markdownguide.org/extended-syntax/

Update Hugo modules

hugo mod get -u