Criação do Site

Usando o Hugo no Computador Local

A primeira etapa do processo consiste na criação do site no computador local usando o Hugo.

Instalar o Hugo

Se o gerador de sites estáticos Hugo não estiver instalado no computador local, deve ser instalado para se poder criar o site.

Aqui é mostrada a instalação do Hugo no sistema operacional FreeBSD 13:

$ sudo pkg install gohugo

$ hugo version
hugo v0.81.0-59D15C97+extended freebsd/amd64 BuildDate=2021-02-21T09:15:53Z+0000

Criar o site

O nome escolhido para o site foi Documentação Técnica e vai ser criado no computador local, no diretório docs sob o diretório home do usuário.

$ hugo new site docs

Congratulations! Your new Hugo site is created in /home/halley/docs.

Just a few more steps and you're ready to go:

1. Download a theme into the same-named folder.
   Choose a theme from https://themes.gohugo.io/ or
   create your own with the "hugo new theme <THEMENAME>" command.
2. Perhaps you want to add some content. You can add single files
   with "hugo new <SECTIONNAME>/<FILENAME>.<FORMAT>".
3. Start the built-in live server via "hugo server".

Visit https://gohugo.io/ for quickstart guide and full documentation.

Adicionar o tema

O tema escolhido foi o Ace documentation, prório para documentação de projetos.

$ cd docs/themes/

$ git clone https://github.com/vantagedesign/ace-documentation
Cloning into 'ace-documentation'...
remote: Enumerating objects: 549, done.
remote: Counting objects: 100% (133/133), done.
remote: Compressing objects: 100% (87/87), done.
remote: Total 549 (delta 52), reused 84 (delta 32), pack-reused 416
Receiving objects: 100% (549/549), 2.15 MiB | 122.00 KiB/s, done.
Resolving deltas: 100% (186/186), done.

Configurar o Hugo

O Hugo deve ser configurado para utilizar o tema adicionado e o idioma português do Brasil. Para isso foi editado o arquivo config.toml no diretório raiz do site:

$ cd ..
$ nano config.toml
baseURL = "http://example.org/"
languageCode = "pt-br"
title = "Documentação Técnica"
theme = "ace-documentation"

Criar os documentos iniciais

Inicialmente foram criados os diretórios e documentos da estrutura inicial do site. Posteriormente estes arquivo foram editados para acrescentar conteúdo e outras páginas foram adicionadas ao site.

$ hugo new _index.md
/home/halley/docs/content/_index.md created

$ hugo new hugo/_index.md
/home/halley/docs/content/hugo/_index.md created

$ hugo new hugo/instalacao.md
/home/halley/docs/content/hugo/instalacao.md created

$ hugo new hugo/versao.md
/home/halley/docs/content/hugo/versao.md created

$ hugo new freebsd/_index.md
/home/halley/docs/content/freebsd/_index.md created

$ hugo new freebsd/instalacao.md
/home/halley/docs/content/freebsd/instalacao.md created