# Publicando uma história

Para publicar uma história, selecione a opção `Stories` e, em seguida, o botão `Create entry` na sua instalação. Repare que serão exibidas duas abas: `Content` and `Mapbox`. Na primeira, iremos inserir o conteúdo da página propriamente dito e, na segunda, fazemos a integração com o Mapbox. Iremos começar por esta última.

### Integração com o Mapbox

Clique na segunda aba, `Mapbox`.

![Integração do Statamic com o Mapbox ao criar uma nova história.](https://3665796612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5CzhNylOYIcqlWOt9qG1%2Fuploads%2FnNUGwUfAuxnbTgeOyfy6%2Fnew_entry.png?alt=media\&token=d5432fe6-cdf4-4acb-abb1-7c4c472ae609)

Aqui, precisaremos dos códigos geradas na [etapa anterior](https://docs.documental.xyz/organizando-os-geodados-no-mapbox). Cole os códigos obtidos para os campos `Mapbox Style` e `Mapbox Access Token`.

Depois disso, será necessário definir qual será a visualização inicial ou "ponto de partida" no mapa. Você pode definir também uma localização (latitude e longitude, `Mapbox start lat` e `Mapbox Access Token`, respectivamente) e um nível de zoom para sua visualização.

Confira abaixo um exemplo real de como é a visualização de três valores diferente para o zoom, com imagens do projeto [Territórios de Exceção](https://docs.documental.xyz/readme).

![](https://3665796612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5CzhNylOYIcqlWOt9qG1%2Fuploads%2FsZi4MPGE9kjfn7PCYhBI%2F3zooms.png?alt=media\&token=c16b78a6-397c-4df0-ae0c-cc59e5d29361)

### Content

A aba está dividia em duas partes. Na seção superior, é possível definir um título (title), resumo (abstract) e uma imagem de capa (cover image) para a história. Em seguida, há a seção `NARRATIVE`. A versão atual do Documental disponibiliza quatros tipos de elementos para a construção da narrativa.

{% file src="<https://3665796612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5CzhNylOYIcqlWOt9qG1%2Fuploads%2FHzi2OrZMJUFjsgGYlR8P%2Fnarrative.png?alt=media&token=30e1aa8f-cf8e-402f-98c6-3bc7d9a6c6a5>" %}
Opções de elementos para construção da narrativa.
{% endfile %}

Para a construção de narrativas baseadas em mapas, a mais importante delas é o `Map blocks`. Porém, abaixo, iremos ver em detalhes todas opções.

### Cover

Este elemento permite a inclusão de imagens, vídeos ou títulos ocupando toda largura da tela. Como o nome indica, é útil para fazer "capas", que servem para apresentar as seções ou capítulos (*chapters*) do seu trabalho.

É possível incluir, por exemplo, uma foto ou vídeo de impacto como imagem de fundo (*background*) e inserir campos de texto. Em `Chapter intro`, existem campos para definição de título e subtítulo. Textos mais longos podem ser incluídos como `Texto block`. Ambos irão aparecer sobrepostos na imagem de fundo, se definida.&#x20;

Para melhorar a legibilidade do texto, é possível também definir uma nível de transparência para a imagem, no campo `Overlay Opacity`.

![](https://3665796612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5CzhNylOYIcqlWOt9qG1%2Fuploads%2FODh1b8XRwsu3OG8vHz5o%2Fcover.png?alt=media\&token=f64c1baf-6c14-4446-b6ea-b868385c3523)

#### Article

O elemento `Article` permite a inclusão de textos corridos, que aparecem centralizados na tela sobre um fundo branco. O Statamic oferece alguns recursos de formatação para hierarquização de títulos, negrito, itálico, listagens e enumerações, citações, links e códigos.

![](https://3665796612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5CzhNylOYIcqlWOt9qG1%2Fuploads%2F93L3P6UsczzGLEBjkykB%2Farticle.png?alt=media\&token=2e1f974d-e00d-4447-ae5c-8892f9b86f37)

#### Video gallery

Este recurso permite a incorporação (*embed)* de fontes externas de vídeos, como o YouTube e o Vimeo. É possível definir um título geral para a galeria e um ou mais vídeos para serem exibidos, cada um pode ter também seu próprio título.

Na visualização, os vídeos aparecem centralizados, ocupando toda largura da tela, e podem ser reproduzidos na própria página.

![](https://3665796612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5CzhNylOYIcqlWOt9qG1%2Fuploads%2FzZn1k61BwfLVEFG3owhd%2Fvideogallery.png?alt=media\&token=bc5f1d79-8290-4be7-b3c5-3b956f2ede05)

### Map Blocks

Os blocos de mapas ("map blocks") são a essência da construção de narrativas baseadas em mapas no Documental. Além das informações latitude/longitude e de um bloco de texto a ser exibido sobre o mapa, é possível ainda configurar outras opções.

![](https://3665796612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5CzhNylOYIcqlWOt9qG1%2Fuploads%2F6aiRfUTL4MeVk2PAqJjr%2Fmapblocks.png?alt=media\&token=983dbed0-8dd7-4cc6-82c1-d0b92b862ddb)

* Duration: duração da transição entre os blocos, em milissegundos;
* Zoom: nível de zoom do mapa;
* [Bearing](https://docs.mapbox.com/help/glossary/bearing/): este campo permite rotacionar o mapa. Se o valor dele for 0, significa que o mapa ficará visualizado com o norte "para cima". Os valores 90, 180 e 270 representam o leste, sul e oeste, respectivamente.&#x20;
* Pitch: permite definir uma "inclinação" da câmera;

#### Layers

Na seção 'Layers', listamos os dados geográficos do Mapbox que devem ser exibidos. Também é possível fazer filtros para que apenas determinadas feições (features) dos dados apareçam.

#### Labels

Permite definir rótulos explicativos para os dados, como legendas descritivas para visualizações de dados.
