Creazione di generatori CLI e mirror `.md` di testo semplice per siti statici

Mentre il visual web design si basa su ricchi layout CSS, interazioni JavaScript e risorse multimediali, i crawler di Generative Engine richiedono dati di testo incontaminati e privi di rumore. Per i team di sviluppatori che gestiscono siti statici basati su framework come Hugo, automatizzare la generazione di mirror .md in testo semplice e directory/llms.txt rappresenta il massimo vantaggio competitivo tecnico.

Sfruttando gli strumenti CLI come llmstxt-generator e i formati di output di build Hugo personalizzati, gli sviluppatori possono offrire doppie interfacce visive e di testo senza problemi.

1. Dati di Google Trends: automazione statica del sito e mirror di markdown

I dati estratti tramite l’infrastruttura MCP di MarketLens mostrano un crescente interesse degli sviluppatori per gli strumenti automatizzati per la pipeline di testo AI:

2. L’architettura a doppio rendering (.html vs .html.md)

La moderna infrastruttura GEO serve due asset distinti a seconda del cliente richiedente:

+-----------------------------------------------------------------------+
|                    DUAL-RENDERING STATIC ARCHITECTURE                 |
+-----------------------------------------------------------------------+
| Human User Request   -->  https://marketlens.io/pricing.html          |
|                           (Renders Full HTML / CSS / JS Layout)       |
|                                                                       |
| AI Crawler Request   -->  https://marketlens.io/pricing.html.md       |
|                           (Renders Pure Text Markdown Mirror)         |
+-----------------------------------------------------------------------+

3. Configurazione dei formati di output Hugo per i mirror Markdown

Per configurare Hugo per compilare automaticamente un mirror Markdown .html.md per ogni articolo pubblicato, aggiungi la seguente configurazione al tuo hugo.toml:

# Hugo Custom Output Format Configuration for Markdown Mirrors
[outputFormats]
  [outputFormats.MarkdownMirror]
    mediaType = "text/markdown"
    baseName = "index"
    isPlainText = true
    fileSuffix = ".html.md"

[outputs]
  home = ["HTML", "RSS", "MarkdownMirror"]
  page = ["HTML", "MarkdownMirror"]
  section = ["HTML"]

Per le specifiche generali dei file, rivedere Implementazione dell’llms.txt standard per gli agenti AI, automatizzare le attività di creazione con Automatizzazione delle distribuzioni di Hugo con GitHub Actions CI/CD, e pianificare l’architettura del sito statico in Migrazione da WordPress a siti statici Hugo.

Modello di layout per lo specchio a pagina singola

Crea un modello di layout di pagina singola in layouts/_default/single.md:

# {{ .Title }}

> Author: {{ .Params.author | default "MarketLens Team" }}
> Date: {{ .Date.Format "2006-01-02" }}
> Canonical URL: {{ .Permalink }}

## Overview
{{ .Description }}

## Content
{{ .RawContent }}

## Frequently Asked Questions
{{ range .Params.faqData }}
### {{ .question }}
{{ .answer }}
{{ end }}

4. Automatizzazione di /llms.txt tramite CLI nelle pipeline CI/CD

Gli sviluppatori possono automatizzare la creazione dei file root /llms.txt e /llms-full.txt utilizzando il pacchetto Python llmstxt-generator durante l’esecuzione della build CI/CD.

Passaggio del flusso di lavoro di distribuzione delle azioni GitHub

Aggiungi il seguente passaggio alla tua pipeline .github/workflows/deploy.yml:

name: Generate AI Text Directory
on:
  push:
    branches: [ main ]

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - name: Set up Python
        uses: actions/setup-python@v4
        with:
          python-version: '3.10'

      - name: Install Generator CLI
        run: pip install llmstxt-generator

      - name: Build Hugo Static Site
        run: hugo --minify

      - name: Compile llms.txt & llms-full.txt
        run: |
          llmstxt-gen public/ --output public/llms.txt
          llmstxt-gen public/ --full --output public/llms-full.txt

      - name: Deploy to Cloudflare Pages
        uses: cloudflare/pages-action@v1
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
          projectName: marketlens
          directory: public

5. Delta delle prestazioni: carico utile HTML e mirroring Markdown