summaryrefslogtreecommitdiff
path: root/content
diff options
context:
space:
mode:
authorleo <azuminha1@gmail.co>2025-10-16 20:20:15 -0300
committerleo <azuminha1@gmail.co>2025-10-16 20:20:15 -0300
commit0e191433328094673dacc22b16cc5d3bac02c4dc (patch)
tree6d0ce9d11b1b6039a392c4a36b25263ae2ec417c /content
parent8e7996214af853803c4dd04534b1f5646b0ac1c5 (diff)
;
Diffstat (limited to 'content')
-rw-r--r--content/_index.md24
-rw-r--r--content/post/Bem-vindo.md8
-rw-r--r--content/post/host-a-blog-with-hugo.md279
3 files changed, 311 insertions, 0 deletions
diff --git a/content/_index.md b/content/_index.md
new file mode 100644
index 0000000..d88a632
--- /dev/null
+++ b/content/_index.md
@@ -0,0 +1,24 @@
+---
+title: Home
+description: "The personal writings and expressions of Grayfox, otherwise known as you too and everyone else. It is a loving and silly place."
+---
+<img
+ id="foxy"
+ src="/images/pp.jpeg"
+ alt="cat">
+
+## :seedling: Bem-vindo
+
+Aqui guardo anotações, ideias, experimentos e bobeiras.
+Não é um manual, mas talvez alguma coisa ajude alguém além de mim.
+
+<!-- <img src="/images/partywizard.gif"> -->
+[files](https://azuminha.com/files)
+
+---
+## Sei la
+[url shortener](http://sl.azuminha.com)
+
+---
+
+## Musings
diff --git a/content/post/Bem-vindo.md b/content/post/Bem-vindo.md
new file mode 100644
index 0000000..4cb06b1
--- /dev/null
+++ b/content/post/Bem-vindo.md
@@ -0,0 +1,8 @@
++++
+date = '2025-09-27T20:29:44-03:00'
+title = 'Bem Vindo'
++++
+
+## Bem vindo
+
+Aqui é somente um teste
diff --git a/content/post/host-a-blog-with-hugo.md b/content/post/host-a-blog-with-hugo.md
new file mode 100644
index 0000000..f8cea98
--- /dev/null
+++ b/content/post/host-a-blog-with-hugo.md
@@ -0,0 +1,279 @@
++++
+date = '2025-09-30T03:09:52-03:00'
+draft = false
+title = 'Host a Blog With Hugo'
+tags = ["blog", "hugo", "server"]
+categories = ["web", "self-hosted"]
+description = "Tutorial de como criar um blog com Hugo e integrar comentários usando Comentario."
++++
+
+Hoje vou mostar como fiz para setar um blog com comentários usando [Hugo](https://gohugo.io/) e [Comentario](https://comentario.app/en/).
+
+- **Hugo** é um framework open source para construção de websites estáticos, extremamente rápido e flexível.
+- **Comentario** é uma engine open source de comentários, fácil de integrar e auto-hospedável.
+
+## 1. Utilizando o Hugo
+### Instalando o hugo
+Se sua distribuição linux for baseado em Debian rode o comando
+
+```bash
+$ sudo apt install hugo
+```
+
+caso contrario você pode verificar na documentação.
+
+Agora que você já tem ele instalado basta dar
+```bash
+hugo new site {nome-do-seu-blog}
+```
+que ele criara uma pasta com tudo que eh necessario.
+
+### Instalando um tema
+Para instalar um tema veja os temas disponiveis pela comunidade no [link](https://themes.gohugo.io/), no meu caso atualmente estou usando o [Hugo - Classic](https://themes.gohugo.io/themes/hugo-classic/).
+Depois de achar um que gostou faca:
+```bash
+cd {nome-do-seu-blog}/themes
+git init
+git submodule add link-do-github
+```
+
+Abra o arquivo hugo.toml e edite a variavel theme para a pasta criada dentro da pasta do hugo.
+
+### Criando um post
+Para criar um post eh muito simples tambem, basta rodar
+```bash
+hugo new content content/post/nome-do-post.md
+```
+Agora basta escrever o seu post em com markdown. Acesse [aqui](https://www.markdownguide.org/cheat-sheet/) para mais informacoes sobre markdown.
+
+### Buildando
+Para finalizar rode
+```bash
+hugo
+```
+que ele vai atualizar tudo que eh necessario e publicar seu post
+
+---
+## 2. Setando o comentario
+Existem diversas formas de voce instalar o comentario, porem eu fiz isso utilizando docker. Para isso certifique que você tenha o docker instalado
+```bash
+docker version
+```
+e crie um arquivo chamado docker-compose.yml
+```docker
+services:
+ app:
+ image: registry.gitlab.com/comentario/comentario:latest-ubuntu
+ environment:
+ BASE_URL: https://sua-url # mude aqui para sua url
+ SECRETS_FILE: "/secrets.yaml"
+ ports:
+ - "6969:80" # mude para a porta que você quiser
+ volumes:
+ - ./secrets.yaml:/secrets.yaml:ro
+ restart: always
+```
+essa eh so uma possivel forma, você pode editar o arquivo da maneira que preferir.
+
+Note que vou utilizar o sqlite3 como banco de dados (pois é usa menos memória), caso você queria usar postgress, ou usar um servidor diferente para o banco de dados você deve editar esse arquivo.
+
+Na mesma pasta crie um arquivo chamado secrets.yaml
+```
+sqlite3:
+ file: ./comentario.db
+```
+Essa eh a configuracao minima que você deve fazer caso queria utilizar o sqlite3.
+
+agora rode no terminal
+```bash
+docker compose up -d
+```
+
+Para finalizar basta adicionar no arquivo ./themes/hugo-classic/layouts/_default/single.html
+```html
+<script defer src="https://sua-url/comentario.js"></script>
+<comentario-comments></comentario-comments>
+```
+
+Agora eh so acessar a url que voce colocou e setar adicionar o seu servidor, como eh bem intuitivo nao vou colocar aqui
+
+---
+
+## 3. Setando o NGINX
+Caso você utilize o nginx como servidor web basta configurar a pagina principal como
+```bash
+server {
+ root /var/www/azuminha.com/public;
+
+ index index.html index.htm index.nginx-debian.html;
+
+ server_name azuminha.com www.azuminha.com; # mude aqui para sua url
+
+ charset UTF-8;
+
+ location / {
+ try_files $uri $uri/ =404;
+ }
+}
+```
+
+Você tambem deve arrumar um proxy reverso para a porta que o servico do comentario esta rodando.
+```bash
+server {
+ server_name comments.azuminha.com; # sua url que utilizou para configurar o comentario
+
+ location / {
+ proxy_pass http://0.0.0.0:6969/; # mude para a porta que vc utilizou
+ proxy_set_header Host 127.0.0.1;
+ proxy_set_header X-Real-IP $remote_addr;
+ proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+ proxy_set_header X-Forwarded-Proto $scheme;
+ }
+```
+
+Pronto agora você tem seu proprio blog hospedado pro você mesmo, sem dependencias externas. :smile:
++++
+date = '2025-09-30T03:09:52-03:00'
+draft = false
+title = 'Host a Blog With Hugo'
+tags = ["blog", "hugo", "server"]
+categories = ["web", "self-hosted"]
+description = "Tutorial de como criar um blog com Hugo e integrar comentários usando Comentario."
++++
+
+Hoje vou mostrar como fiz para configurar um blog com comentários usando [Hugo](https://gohugo.io/) e [Comentario](https://comentario.app/en/).
+
+- **Hugo** é um framework open source para construção de websites estáticos, extremamente rápido e flexível.
+- **Comentario** é uma engine open source de comentários, fácil de integrar e auto-hospedável.
+
+## 1. Utilizando o Hugo
+### Instalando o Hugo
+Se sua distribuição Linux for baseada em Debian, rode o comando:
+
+```bash
+sudo apt install hugo
+```
+
+Caso contrário, você pode verificar a instalação na documentação oficial.
+
+Agora que ele já está instalado, basta rodar:
+```bash
+hugo new site {nome-do-seu-blog}
+```
+Isso criará uma pasta com tudo o que é necessário.
+
+### Instalando um tema
+Para instalar um tema, veja os temas disponíveis pela comunidade no [link](https://themes.gohugo.io/).
+No meu caso, atualmente estou usando o [Hugo - Classic](https://themes.gohugo.io/themes/hugo-classic/).
+
+Depois de achar um tema que gostou, faça:
+```bash
+cd {nome-do-seu-blog}/themes
+git init
+git submodule add link-do-github
+```
+
+Abra o arquivo `hugo.toml` e edite a variável `theme` para o nome da pasta criada dentro de `themes`.
+
+### Criando um post
+Para criar um post é muito simples também, basta rodar:
+```bash
+hugo new content content/post/nome-do-post.md
+```
+Agora é só escrever seu post em Markdown.
+Acesse [aqui](https://www.markdownguide.org/cheat-sheet/) para mais informações sobre Markdown.
+
+### Buildando
+Para finalizar, rode:
+```bash
+hugo
+```
+Ele vai atualizar tudo o que for necessário e publicar seu post.
+
+---
+
+## 2. Configurando o Comentario
+Existem diversas formas de instalar o Comentario, porém eu fiz isso utilizando Docker.
+Para isso, certifique-se de que você tenha o Docker instalado:
+```bash
+docker version
+```
+
+Crie um arquivo chamado `docker-compose.yml`:
+```docker
+services:
+ app:
+ image: registry.gitlab.com/comentario/comentario:latest-ubuntu
+ environment:
+ BASE_URL: https://sua-url # mude aqui para sua URL
+ SECRETS_FILE: "/secrets.yaml"
+ ports:
+ - "6969:80" # mude para a porta que você quiser
+ volumes:
+ - ./secrets.yaml:/secrets.yaml:ro
+ restart: always
+```
+
+Essa é apenas uma configuração possível — você pode editar o arquivo da maneira que preferir.
+
+Note que estou utilizando o **SQLite3** como banco de dados (pois usa menos memória).
+Caso você queira usar **PostgreSQL** ou hospedar o banco de dados em outro servidor, edite esse arquivo conforme necessário.
+
+Na mesma pasta, crie um arquivo chamado `secrets.yaml`:
+```
+sqlite3:
+ file: ./comentario.db
+```
+Essa é a configuração mínima para utilizar o SQLite3.
+
+Agora rode no terminal:
+```bash
+docker compose up -d
+```
+
+Para finalizar, basta adicionar no arquivo `./themes/hugo-classic/layouts/_default/single.html`:
+```html
+<script defer src="https://sua-url/comentario.js"></script>
+<comentario-comments></comentario-comments>
+```
+
+Agora é só acessar a URL que você configurou e adicionar o seu servidor.
+Como é bem intuitivo, não vou detalhar essa parte aqui.
+
+---
+
+## 3. Configurando o NGINX
+Caso você utilize o **NGINX** como servidor web, basta configurar a página principal assim:
+```bash
+server {
+ root /var/www/azuminha.com/public;
+
+ index index.html index.htm index.nginx-debian.html;
+
+ server_name azuminha.com www.azuminha.com; # mude aqui para sua URL
+
+ charset UTF-8;
+
+ location / {
+ try_files $uri $uri/ =404;
+ }
+}
+```
+
+Você também deve configurar um **proxy reverso** para a porta em que o serviço do Comentario está rodando:
+```bash
+server {
+ server_name comments.azuminha.com; # sua URL utilizada para configurar o Comentario
+
+ location / {
+ proxy_pass http://0.0.0.0:6969/; # mude para a porta que você utilizou
+ proxy_set_header Host 127.0.0.1;
+ proxy_set_header X-Real-IP $remote_addr;
+ proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+ proxy_set_header X-Forwarded-Proto $scheme;
+ }
+}
+```
+
+Pronto! Agora você tem seu próprio blog hospedado por você mesmo, sem dependências externas. 😄
+