# 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.](/files/5bU1nIFr3zl1BydH4shh)

Aqui, precisaremos dos códigos geradas na [etapa anterior](/organizando-os-geodados-no-mapbox.md). 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](/readme.md).

![](/files/mS4T6TChUT7JblyGTla6)

### 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="/files/eV7WNKkDtygIywoYZjm7" %}
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`.

![](/files/lNKzffTpEWjjfDbJTDp9)

#### 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.

![](/files/awVQUfgFtx86tAlBwIin)

#### 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.

![](/files/FiBAmWrG2VRW8tA87QSc)

### 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.

![](/files/plU0DOk7tEHcvdvfMaxW)

* 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.documental.xyz/publicando-uma-historia.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
