|
| 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 | + |
| 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! |
0 commit comments