> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kiwify.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Filtros HTML

> Filtros HTML para trabalhar com conteúdo HTML e URI em templates Liquid.

## `escape`

Escapa uma string substituindo caracteres HTML especiais por sequências de escape. Não altera strings que não têm nada para escapar.

<Columns cols={2}>
  <CodeGroup>
    ```liquid Código theme={null}
    {{ "Have you read 'James & the Giant Peach'?" | escape }}
    ```
  </CodeGroup>

  <CodeGroup>
    ```liquid Saída theme={null}
    Have you read &#39;James &amp; the Giant Peach&#39;?
    ```
  </CodeGroup>
</Columns>

<Columns cols={2}>
  <CodeGroup>
    ```liquid Código theme={null}
    {{ "Tetsuro Takara" | escape }}
    ```
  </CodeGroup>

  <CodeGroup>
    ```liquid Saída theme={null}
    Tetsuro Takara
    ```
  </CodeGroup>
</Columns>

## `escape_once`

Escapa uma string sem alterar entidades escapadas existentes. Não altera strings que não têm nada para escapar.

<Columns cols={2}>
  <CodeGroup>
    ```liquid Código theme={null}
    {{ "1 < 2 & 3" | escape_once }}
    ```
  </CodeGroup>

  <CodeGroup>
    ```liquid Saída theme={null}
    1 &lt; 2 &amp; 3
    ```
  </CodeGroup>
</Columns>

<Columns cols={2}>
  <CodeGroup>
    ```liquid Código theme={null}
    &#x7B;&#x7B; "{{"1 &lt; 2 &amp; 3" | escape}}" | escape_once }}
    ```
  </CodeGroup>

  <CodeGroup>
    ```liquid Saída theme={null}
    1 &lt; 2 &amp; 3
    ```
  </CodeGroup>
</Columns>

## `strip_html`

Remove quaisquer tags HTML de uma string.

<Columns cols={2}>
  <CodeGroup>
    ```liquid Código theme={null}
    {{ "Have <em>you</em> read <strong>Ulysses</strong>?" | strip_html }}
    ```
  </CodeGroup>

  <CodeGroup>
    ```liquid Saída theme={null}
    Have you read Ulysses?
    ```
  </CodeGroup>
</Columns>

## `newline_to_br`

Substitui toda quebra de linha (`\n`) em uma string por uma quebra de linha HTML (\`\`).

<Columns cols={2}>
  <CodeGroup>
    ```liquid Código theme={null}
    {% capture string_with_newlines %}
    Hello
    there
    {% endcapture %}

    {{ string_with_newlines | newline_to_br }}
    ```
  </CodeGroup>

  <CodeGroup>
    ```liquid Saída theme={null}
    <br/>Hello<br/>there<br/>
    ```
  </CodeGroup>
</Columns>

## `url_encode`

Converte quaisquer caracteres inseguros para URL em uma string em caracteres codificados por porcentagem.

<Columns cols={2}>
  <CodeGroup>
    ```liquid Código theme={null}
    {{ "john@liquid.com" | url_encode }}
    ```
  </CodeGroup>

  <CodeGroup>
    ```liquid Saída theme={null}
    john%40liquid.com
    ```
  </CodeGroup>
</Columns>

<Columns cols={2}>
  <CodeGroup>
    ```liquid Código theme={null}
    {{ "Tetsuro Takara" | url_encode }}
    ```
  </CodeGroup>

  <CodeGroup>
    ```liquid Saída theme={null}
    Tetsuro+Takara
    ```
  </CodeGroup>
</Columns>

## `url_decode`

Decodifica uma string que foi codificada como URL.

<Columns cols={2}>
  <CodeGroup>
    ```liquid Código theme={null}
    {{ "%27Stop%21%27+said+Fred" | url_decode }}
    ```
  </CodeGroup>

  <CodeGroup>
    ```liquid Saída theme={null}
    'Stop!' said Fred
    ```
  </CodeGroup>
</Columns>

## `xml_escape`

Escapa algum texto para uso em XML.

<Columns cols={2}>
  <CodeGroup>
    ```liquid Código theme={null}
    {{ "Have you read \'James & the Giant Peach\'?" | xml_escape }}
    ```
  </CodeGroup>

  <CodeGroup>
    ```liquid Saída theme={null}
    Have you read &#39;James &amp; the Giant Peach&#39;?
    ```
  </CodeGroup>
</Columns>

## `cgi_escape`

CGI escapa uma string para uso em URL. Substitui quaisquer caracteres especiais por substituições `%XX` apropriadas. CGI escape normalmente substitui um espaço por um sinal de mais `+`.

<Columns cols={2}>
  <CodeGroup>
    ```liquid Código theme={null}
    {{ "foo, bar; baz?" | cgi_escape }}
    ```
  </CodeGroup>

  <CodeGroup>
    ```liquid Saída theme={null}
    foo%2C+bar%3B+baz%3F
    ```
  </CodeGroup>
</Columns>

## `uri_escape`

Codifica por porcentagem quaisquer caracteres especiais em uma URI. URI escape normalmente substitui um espaço por `%20`. Caracteres reservados não serão escapados.

<Columns cols={2}>
  <CodeGroup>
    ```liquid Código theme={null}
    {{ "https://example.com/?q=foo, \bar?" | uri_escape }}
    ```
  </CodeGroup>

  <CodeGroup>
    ```liquid Saída theme={null}
    https://example.com/?q=foo,%20%5Cbar?
    ```
  </CodeGroup>
</Columns>

## `slugify`

Converte uma string em um "slug" de URL em minúsculas. O filtro slugify aceita 2 opções:

1. `mode: string`. O padrão é `"default"`. Eles são os seguintes (com o que filtram):

* `"none"`: nenhum caractere
* `"raw"`: espaços
* `"default"`: espaços e caracteres não alfanuméricos
* `"pretty"`: espaços e caracteres não alfanuméricos exceto por `._~!$&'()+,;=@`
* `"ascii"`: espaços, caracteres não alfanuméricos e não ASCII
* `"latin"`: como padrão, exceto que caracteres latinos são primeiro transliterados (ex. àèïòü para aeiou).

2. `case: boolean`. O padrão é `false`. O caso original do slug será mantido se definido como `true`.

<Columns cols={2}>
  <CodeGroup>
    ```liquid Código theme={null}
    {{ "The _config.yml file" | slugify }}
    ```
  </CodeGroup>

  <CodeGroup>
    ```liquid Saída theme={null}
    the-config-yml-file
    ```
  </CodeGroup>
</Columns>

<Columns cols={2}>
  <CodeGroup>
    ```liquid Código theme={null}
    {{ "The _config.yml file" | slugify: "pretty" }}
    ```
  </CodeGroup>

  <CodeGroup>
    ```liquid Saída theme={null}
    the-_config.yml-file
    ```
  </CodeGroup>
</Columns>

<Columns cols={2}>
  <CodeGroup>
    ```liquid Código theme={null}
    {{ "The _cönfig.yml file" | slugify: "ascii" }}
    ```
  </CodeGroup>

  <CodeGroup>
    ```liquid Saída theme={null}
    the-c-nfig-yml-file
    ```
  </CodeGroup>
</Columns>

<Columns cols={2}>
  <CodeGroup>
    ```liquid Código theme={null}
    {{ "The cönfig.yml file" | slugify: "latin" }}
    ```
  </CodeGroup>

  <CodeGroup>
    ```liquid Saída theme={null}
    the-config-yml-file
    ```
  </CodeGroup>
</Columns>

<Columns cols={2}>
  <CodeGroup>
    ```liquid Código theme={null}
    {{ "The cönfig.yml file" | slugify: "latin", true }}
    ```
  </CodeGroup>

  <CodeGroup>
    ```liquid Saída theme={null}
    The-config-yml-file
    ```
  </CodeGroup>
</Columns>