Skip to content

Commit ee8bf5c

Browse files
committed
adds translation to llms.txt blog post
1 parent d94a382 commit ee8bf5c

File tree

2 files changed

+131
-0
lines changed

2 files changed

+131
-0
lines changed
Lines changed: 128 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,128 @@
1+
---
2+
title: 'Como criar um arquivo llms.txt no Jekyll e GitHub Pages'
3+
layout: post
4+
date: 2025-08-31T10:00:00.000+00:00
5+
image: "https://res.cloudinary.com/jesstemporal/image/upload/v1640360836/covers/tutorial_gfgm5n.png"
6+
type: post
7+
lang: pt
8+
tags:
9+
- ia
10+
- agentes de ia
11+
- jekyll
12+
- blog
13+
- português
14+
comments: true
15+
bookbanner: true
16+
description: 'Aprenda como gerar automaticamente um arquivo llms.txt no Jekyll'
17+
related: true
18+
posts_list:
19+
- do-tema-ao-ar
20+
- temas-jekyll
21+
- force-rebuild-jekyll
22+
translations:
23+
- lang: en
24+
url: /how-to-create-llms-txt-in-jekyll
25+
author_note: false
26+
---
27+
28+
Você já quis deixar o conteúdo do seu blog mais acessível para sistemas de IA e LLMs (large language models)? Ou talvez você tenha se perguntado como fornecer uma versão "limpa" dos seus posts sem todos as tags do HTML?
29+
30+
O arquivo `llms.txt` é a solução. Ele fornece uma forma padronizada para sites exporem seu conteúdo para sistemas de IA. E se você está usando Jekyll com GitHub Pages, pode criar esse arquivo automaticamente com apenas algumas linhas e um template Liquid.
31+
32+
Se você acabou de começar a usar o Jekyll: ele é um gerador de sites estáticos escrito em Ruby que é perfeito para blogs especialmente quando usado no GitHub Pages. Você pode aprender mais sobre Jekyll e como começar a usa-lo neste outro post: [Colocando um site no ar com Jekyll](https://jtemporal.com/do-tema-ao-ar/).
33+
34+
## O que é o llms.txt
35+
36+
O arquivo `llms.txt` é um formato de texto simples projetado para tornar sites mais acessíveis para sistemas de IA e LLMs. Baseado na especificação do [llmstxt.org](http://llmstxt.org/), ele fornece uma forma padronizada de expor o conteúdo do seu site em um formato legível pelas IAs que tanto usamos hoje em dia.
37+
38+
A estrutura básica inclui:
39+
- Uma breve descrição do seu site
40+
- Informações importantes sobre seus projetos, serviços ou conteúdo
41+
- Links para páginas ou conteúdo importantes
42+
- Qualquer outra informação que você gostaria que sistemas de IA soubessem sobre seu site
43+
44+
Para um blog em Jekyll armazenado num repositório do GitHub, o `llms.txt` é perfeito para fornecer aos LLMs acesso direto aos seus posts em seu formato Markdown original, tornando mais fácil para a IA entender e referenciar seu conteúdo com precisão.
45+
46+
## Criando um arquivo llms.txt
47+
48+
Criar um arquivo `llms.txt` para seu site Jekyll é relativamente simples. Você criará um novo arquivo na raiz do seu projeto Jekyll e usar Liquid para gerar automaticamente o conteúdo.
49+
50+
Esse é o passo a passo:
51+
52+
1. **Criar o arquivo**: No diretório raiz do seu repositóeion, crie um novo arquivo chamado `llms.txt`
53+
2. **Adicionar o template**: Use o seguinte template como ponto de partida:
54+
55+
{% raw %}
56+
```liquid
57+
---
58+
layout: null
59+
---
60+
61+
# Feed LLM para jtemporal.com
62+
_Gerado em: {{ site.time | date_to_rfc822 }}_
63+
64+
65+
## Todos os posts
66+
Os links abaixo levam você ao conteúdo Markdown original.
67+
68+
{% for post in site.posts %}- [{{ post.title }}](https://raw.githubusercontent.com/jtemporal/jtemporal.github.io/refs/heads/main/{{ post.path }})
69+
{% endfor %}
70+
```
71+
{% endraw %}
72+
73+
Algumas coisas para prestar atenção:
74+
75+
- `layout: null` garante que o arquivo seja gerado como texto puro, não HTML
76+
- {% raw %}`{{ site.time | date_to_rfc822 }}`{% endraw %} adiciona um timestamp mostrando quando o arquivo foi gerado pela última vez
77+
- O loop {% raw %}`{% for post in site.posts %}`{% endraw %} cria automaticamente uma lista de todos os seus posts do blog
78+
- {% raw %}`{{ post.path }}`{% endraw %} dá o caminho relativo para o arquivo Markdown de cada post
79+
- O formato de URL do GitHub raw permite acesso direto ao Markdown fonte
80+
81+
O resultado gerado deve ser algo assim:
82+
83+
![Screenshot da saída do llms.txt mostrando a lista gerada de posts do blog com links para arquivos Markdown raw](https://res.cloudinary.com/jesstemporal/image/upload/v1756477506/llms-txt-jtemporal.png)
84+
85+
## Adicionar llms.txt ao _config.yml
86+
87+
Na lista de `includes` no seu arquivo `_config.yml` adicione o `llms.txt`. Essa lista tem todos os arquivos que devem ser servidos com seu site uma vez que o build seja feito. A minha ficava assim antes:
88+
89+
```ini
90+
# Include list
91+
include: [.well-known, EnJtResume.pdf, folium]
92+
```
93+
94+
E agora também tem o `llms.txt` no final do array:
95+
```ini
96+
# Include list
97+
include: [.well-known, EnJtResume.pdf, folium, llms.txt]
98+
```
99+
100+
## Testando suas alterações
101+
102+
Antes de fazer o deploy das suas alterações, é uma boa ideia testá-las localmente:
103+
104+
1. **Faça o build do seu site localmente**:
105+
```bash
106+
bundle exec jekyll build
107+
```
108+
109+
2. **Sirva seu site**:
110+
```bash
111+
bundle exec jekyll serve
112+
```
113+
114+
3. **Verifique seu arquivo llms.txt**: Uma vez que seu site esteja rodando (geralmente em `http://localhost:4000`), navegue para `http://localhost:4000/llms.txt` para ver seu arquivo gerado.
115+
116+
Você deve ver um arquivo de texto puro com as informações do seu site e uma lista de todos os seus posts do blog com links para seu conteúdo Markdown raw no GitHub. Se tudo estiver funcionando, chegou a hora de fazer o deploy!
117+
118+
## Recapitulando
119+
120+
Criar um arquivo `llms.txt` para seu site Jekyll é um processo simples de três passos:
121+
122+
1. **Criar o arquivo**: Adicione `llms.txt` ao diretório raiz do seu Jekyll com o template Liquid
123+
2. **Configurar o Jekyll**: Adicione `llms.txt` à lista `include` no seu `_config.yml`
124+
3. **Buildar e fazer deploy**: Seu arquivo estará disponível em `seusite.com/llms.txt`
125+
126+
Essa abordagem mantém automaticamente seu arquivo `llms.txt` atualizado conforme você adiciona novos posts do blog, e fornece aos sistemas de IA acesso direto ao seu conteúdo em seu formato Markdown original. É uma ótima forma de tornar seu blog Jekyll mais acessível para o ecossistema crescente de ferramentas e serviços de IA.
127+
128+
A melhor parte? Uma vez configurado, não requer manutenção alguma: o Jekyll cuida de tudo automaticamente quando você fizer um novo build do seu site!

_posts/2025-08-29-how-to-create-llms-txt-in-jekyll.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,9 @@ posts_list:
2020
- publishing-a-website-with-jekyll
2121
- choosing-a-jekyll-theme
2222
- force-rebuild-jekyll-en
23+
translations:
24+
- lang: pt
25+
url: /como-criar-um-arquivo-llms-txt-no-jekyll
2326
---
2427

2528
Have you ever wanted to make your blog content more accessible to AI systems and large language models? Or maybe you've wondered how to provide a clean, machine-readable version of your posts without the HTML clutter?

0 commit comments

Comments
 (0)