# Características avançadas

# Reutilizando o Conteúdo da Página

<span>No BookStack, você pode achar que deseja incluir o mesmo bloco de conteúdo em vários lugares. Você pode copiar e colar esse conteúdo em várias páginas, mas, se esse conteúdo precisar ser alterado, será necessário atualizá-lo várias vezes em diferentes páginas. Introduzido no BookStack v0.14 é a capacidade de incluir outras páginas e também incluir blocos únicos de conteúdo de outras páginas.</span>

<span>Observe que o comportamento de inclusão não é recursivo, portanto, a inclusão só funcionará em um único nível. Isso garante desempenho e impede que os usuários quebrem páginas criando loops de inclusão.</span>

## <span>Incluir tags</span>

<span>Para incluir o conteúdo de uma página em outra, você pode usar a seguinte sintaxe:</span>

`{{@page_id}}`<span> ou </span>`{{@page_id#content_id}}`

<span>Aqui estão alguns exemplos disso em uso:</span>

- `{{@5}}`<span> - Inclui todo o conteúdo da página com um ID de '5'.</span>
- `{{@10#bkmrk-copyright-year}}`<span>- Inclui o conteúdo dentro do elemento de id </span>`bkmrk-copyright-year`<span>na página com um id de '10'.</span>

<span>Você simplesmente insere isso no editor de páginas e, quando a página é visualizada, o conteúdo será buscado dinamicamente. Isso significa que você pode atualizar o conteúdo referenciado e ele mostrará as mesmas alterações em qualquer página em que o conteúdo estiver incluído.</span>

## <span>Agarrando facilmente a sintaxe</span>

<span>Encontrar o ID de uma página pode ser difícil, portanto, uma maneira rápida e fácil de encontrar tags de inclusão é incorporada ao BookStack. Veja uma página com algum conteúdo que você deseja reutilizar. Use o mouse para selecionar algum conteúdo e você verá um popup aparecer. Por padrão, isso contém um link direto para esse conteúdo. Se você clicar no ícone de link à esquerda, ele alternará para mostrar a tag de inclusão para esse conteúdo. Basta copiar isso e colocá-lo em outra página. Remova o </span>`#`<span>ID e o conteúdo para incluir todo o conteúdo da página, em vez de apenas um único bloco.</span>

## <span>Forçando IDs de conteúdo</span>

<span>Ao incluir um bloco específico de conteúdo, o id do bloco é usado (parte após o hash). Por padrão, eles são gerados pelo BookStack quando você salva uma página. Se você estiver usando o editor WYSIWYG, o ID permanecerá o mesmo, a menos que o bloco seja removido ou reformatado. No editor de marcação, ele muda a cada gravação e faz referência ao conteúdo de modo que, embora permaneça o mesmo, há uma boa chance de um ID ser alterado.</span>

<span>Devido ao fato de que os códigos podem mudar, é recomendável forçar os códigos em seu conteúdo:</span>

#### <span>Editor WYSIWYG</span>

<span>No editor WYSIWYG, você pode forçar uma ID entrando na visualização do código-fonte e adicionando-a manualmente:</span>

![Forçando IDs WYSIWYG](https://www.bookstackapp.com/images/docs/user/forcing-wysiwyg-ids.png)

<div id="bkmrk--0"><div><div><div><div><div><div><div><div>```
```

</div></div></div></div></div></div></div></div></div>#### <span>Editor de Markdown</span>

<div id="bkmrk--1"><div><div><div><div><div><div><div><div>```
```

</div></div></div></div></div></div></div></div></div><span>No editor de marcação, você pode simplesmente inserir HTML com um ID para garantir que ele não seja alterado:</span>

<div id="bkmrk-1-%23-conte%C3%BAdo-antigo-"><div><div><div><div><div><div><div><div><div><textarea spellcheck="false" tabindex="0"></textarea></div><div><div><div><div><div><div></div><div></div><div></div><div><div></div></div><div><div><div><div><span>1</span></div></div>```
<span role="presentation"><span># Conteúdo antigo</span></span>
```

</div><div><div><div><span>2</span></div></div>```
<span role="presentation"><span>Copyright BookStack Enterprises 2017</span></span>
```

</div><div><div><div><span>3</span></div></div>```
<span role="presentation"><span>Detalhes</span></span>
```

</div><div><div><div><span>4</span></div></div>```
<span role="presentation"><span># Revisado com ID</span></span>
```

</div><div><div><div><span>5</span></div></div>```
<span role="presentation"><span class="cm-tag cm-bracket"><span>< </span></span><span class="cm-tag"><span>p </span></span> <span class="cm-attribute"><span>id</span></span><span> = </span><span class="cm-string"><span>"include-copyright-text" </span></span><span class="cm-tag cm-bracket"><span>></span></span><span> Direitos autorais BookStack Enterprises 2017 </span><span class="cm-tag cm-bracket"><span></ </span></span><span class="cm-tag"><span>p </span></span><span class="cm-tag cm-bracket"><span>></span></span></span>
```

</div></div></div></div></div></div><div></div><div><div></div></div></div></div><div>[<svg fill="#FFFFFF" height="24" viewbox="0 0 24 24" width="24" xmlns="http://www.w3.org/2000/svg"></svg><span> Edite essa página</span>](https://github.com/BookStackApp/website/blob/master/content/docs/user/reusing-content.md)</div></div></div></div></div></div></div></div></div>