{"meta":{"title":"Como criar um conteúdo reutilizável","intro":"Você pode criar um conteúdo reutilizável que pode ser referenciado em vários arquivos de conteúdo.","product":"Contribuir com o GitHub Docs","breadcrumbs":[{"href":"/pt/contributing","title":"Contribuir com o GitHub Docs"},{"href":"/pt/contributing/writing-for-github-docs","title":"Escrevendo para GitHub Docs"},{"href":"/pt/contributing/writing-for-github-docs/creating-reusable-content","title":"Criar conteúdo reutilizável"}],"documentType":"article"},"body":"# Como criar um conteúdo reutilizável\n\nVocê pode criar um conteúdo reutilizável que pode ser referenciado em vários arquivos de conteúdo.\n\n## Sobre itens reutilizáveis\n\nReutilizáveis são longas cadeias de texto, como parágrafos ou listas de procedimentos, que podem ser usados em vários arquivos de conteúdo.\n\nUsamos o Markdown (em vez do YAML) para elementos reutilizáveis. O Markdown possibilita que o pipeline de localização divida as cadeias de caracteres em segmentos traduzíveis menores, resultando em menos erros de tradução e menos rotatividade quando o conteúdo em inglês de origem é alterado.\n\nCada elemento reutilizável está localizado em um arquivo Markdown próprio.\n\nO caminho e o nome de arquivo de cada arquivo Markdown determinam qual será o caminho dele no objeto de dados. Por exemplo, um arquivo chamado `/data/reusables/foo/bar.md` estará acessível como `{% data reusables.foo.bar %}` nas páginas.\n\nEm geral, os arquivos reutilizáveis são divididos em diretórios por tarefa. Por exemplo, se você estiver criando uma cadeia de caracteres reutilizável para artigos sobre GitHub notificações, você a adicionará no diretório `data/reusables/notifications/`, em um arquivo chamado `data/reusables/notifications/YOUR-REUSABLE-NAME.md`. A referência de conteúdo que você adicionará à origem será semelhante a `{% data reusables.notifications.YOUR-REUSABLE-NAME %}`.\n\n### Como aplicar o controle de versão aos reutilizáveis\n\nOs componentes reutilizáveis podem incluir condicionais do Liquid para renderizar conteúdo de forma condicional, dependendo da versão atual em exibição. <!-- For more information, see [AUTOTITLE](/contributing/writing-for-github-docs/using-markdown-and-liquid-in-github-docs). -->\n\n## Sobre variáveis\n\nAs variáveis são cadeias de caracteres curtas de texto reutilizável.\n\nUsamos arquivos YAML para as variáveis.\n\nO caminho, o nome de arquivo e as chaves de cada arquivo YAML determinam qual será o caminho dele no objeto de dados.\n\nPor exemplo, este arquivo YAML, `data/variables/foo/bar.yml`, contém duas variáveis:\n\n```yaml\n# the YAML file can contain multiple short strings in one file\nmeaning_of_life: 42\n\n# the strings can also be nested if needed\nnested:\n  values:\n    too: Yes!\n```\n\nOs valores poderão ser acessados como `{% data foo.bar.meaning_of_life %}` e `{% data foo.bar.nested.values.too %}`."}