.
Linha horizontal para indicar mudança de temática:
------
--- Travessão.
-- Traço.
# Figura
A [Figura NN](#FigCapa) exemplifica inserção, numeração, rotulação, dimensionamento e referência de figuras em documentos [Nheengatu].
O local padrão de armazenamento de arquivos de imagens é no subdiretório `Figura` do projeto de publicação.
{#FigCapa width=30%}
# Diagrama
Uma das melhores formas de representar e explorar pensamentos, ideias e conhecimentos é através de diagramas, por isso, recomenda-se utilizar diagramas em todas as fases de um trabalho, principalmente no início, mesmo quando o contexto e o escopo ainda não tenham sido claramente definidos.
Um diagrama consiste, de fato, em uma [Figura](#figura), contudo, como alternativa rápida de composição, a [Nheengatu] possibilita a construção de diagramas através de uma linguagem textual, disponível através da ferramenta [mermaid](https://mermaid-js.github.io/mermaid/#/flowchart?id=graph), já embutida na Nheengatu no âmbito da HTML. Demonstra-se, a seguir, um exemplo abrangente de fluxograma.
:::::: {.destaque}
Diagramas [mermaid](https://mermaid-js.github.io/mermaid/#/flowchart?id=graph) estão disponíveis apenas para HTML.
::::::
graph TB
%% Comentário
inicio[Início] --> meio
fim([Fim far:fa-check-circle .]):::atencao
subgraph subg1 [Subgrafo 1]
meio(Meio) --> duvida{Dúvida}:::classe-espec
meio -.- nota>Manual da linguagem]
click nota "https://mermaid-js.github.io/mermaid/#/flowchart?id=graph" "Manual da linguagem de diagrama mermaid."
end
subgraph subg2 [Subgrafo 2]
a[AAA] -.-|armazena em| b[(BBB)]
a ==> c((CCC))
recurso[/Recurso/] -.-> c
c --- d(DDD)
end
%% Inter-relações
duvida -->|Sim| a
duvida -->|Não| fim
c --> fim
%% Estilo
classDef classe-espec fill:#fadbd8,stroke:#ff4136,color:#111111,stroke-width:1px;
Orientações de fluxo mais comuns para fluxogramas mermaid: **TB** (top to bottom) ou **LR** (left to right).
# Tabela
Estruturas de tabela orientam a leitura, economizam espaço textual e otimizam a interpretação e a correlação dos dados, como se pode observar na [Tabela NN](#Tab001), a qual foi formatada através de uma das técnicas especificadas em e melhorada pela [Nheengatu] em relação à numeração e ao referenciamento. Neste exemplo, demonstra-se também que o posicionamento dos rótulos das colunas especifica o seu alinhamento desejado: à direita, à esquerda, central e padrão.
:::::: {#Tab001}
Table: **Tabela NN.** Exemplo de tabela de dados com alinhamento de colunas.
Direita Esquerda Centro Padrão
--------- ---------- ---------- ------
12 12 12 12
123 123 123 123
1 1 1 1
::::::
Existem alternativas interessantes que auxiliam na composição de tabelas:
* [Tables Generator](http://www.tablesgenerator.com/markdown_tables)
* [Pantable](https://github.com/ickc/pantable)
* [Pandoc csv2table Filter](https://github.com/baig/pandoc-csv2table)
# Equação matemática
Equações matemáticas podem ser expressas em linha, como neste caso $\Delta = b^2-4ac$, ou no modo de exibição para ganhar destaque e numeração, como no caso da [Equação NN](#Eq001).
:::::: {#Eq001}
**Equação NN.** Equação do segundo grau.
$x = \frac{-b \pm \sqrt{\Delta}}{2a}$
::::::
Nos casos de publicações que precisam depender minimamente da Internet, a qual normalmente é necessária para construir e demonstrar fórmulas, as equações matemáticas podem ser embutidas na forma de imagens, bastando para isso habilitar a variável `embutir-equacoes: true` no cabeçalho do documento.
:::::: {.destaque}
Definir equações matemáticas realmente é um processo um pouco mais complicado, porém existem serviços *online* que auxiliam no desenho dessas fórmulas, como o editor visual .
::::::
# Código fonte
O [Código Fonte NN](#Cod001) demonstra a principal forma de incluir instruções de programação em documentos [Pandoc] que utilizam [Nheengatu]. Acesse para mais detalhes.
:::::: {#Cod001}
**Código Fonte NN.** Exemplo de código fonte de aplicação em linguagem Java.
~~~~~~ {.java .numberLines startFrom="1"}
public class AloMundo {
public static void main( String[] args ) {
System.out.println( "Alô, Mundo!" );
}
}
~~~~~~
::::::
Códigos fontes podem também ser expressos `var x = 21;`{.javascript} dentro de parágrafos.
A indicação da `linguagem de programação` não é exigida em todos os casos.
# Citação
Citações de trabalhos de terceiros requerem bancos de dados bibliográficos, como o popular [BibTeX](http://www.bibtex.org/), padrão utilizado pelo [LaTeX], o qual é representado neste projeto pelo arquivo `Bibliografia.bibtex`. A montagem manual deste tipo de arquivo pode ser feita através de serviços *online* como o , contudo, normalmente se buscam versões já prontas em repositórios de citações, como o .
Após a completa especificação do banco de dados bibliográfico, basta realizar citações como: Segundo @Biblia, Jesus escolheu 12 discípulos...
Pode-se também fazer citação em relação a um bloco de texto: "Ide por todo o mundo e pregai o Evangelho a toda criatura" [@Biblia].
É possível fazer múltiplas citações para um mesmo bloco de texto: "Jesus é o caminho, a verdade e a vida" [@Biblia; @Igreja].
A formatação das citações e da bibliografia é feita com base na *Citation Style Language*[^nota-csl] ([CSL]). A [Nheengatu] utiliza por padrão o estilo definido no arquivo `Estilo/ABNT.csl`, especificado de forma similar à norma brasileira NBR 10520 [@NBR10520]. Outros arquivos de estilo de citação podem ser obtidos no repositório ou personalizados através do editor visual .
Mais detalhes técnicos sobre como fazer citações na [Pandoc] podem ser obtidos no endereço .
[^nota-csl]:
# Lista
Existem várias formas de definir listas, como demonstradas em .
Lista compacta:
* um
* dois
* três
Lista solta, na qual se mantém um espaço livre entre os itens:
* um
* dois
* três
Listas podem conter sublistas, sendo que para isso basta alinhar o submarcador com o primeiro caractere do texto da lista superior:
* cores
+ vermelho
+ verde
+ azul
- celeste
- marinho
* formas
+ quadrado
+ círculo
Lista numerada automaticamente:
1. um
1. dois
1. três
Lista numerada automaticamente a partir de um número específico:
9) nove
1) dez
1) onze
1) doze
Lista com numeração romana:
i. um
ii. dois
iii. três
# Bloco de citação
Blocos de citação são utilizados para expor trechos de textos extraídos de outras obras.
> Feliz o homem que não procede conforme o conselho dos ímpios, não trilha o caminho dos pecadores, nem se assenta entre os escarnecedores. Feliz aquele que se compraz no serviço do Senhor e medita sua lei dia e noite.
>
> Salmos 1,1-2 [@Biblia]
# Bloco livre
Bloco livre é um pequeno texto no qual se preserva os deslocamentos e as quebras de linha. Útil para poemas e endereços:
| "Feliz o homem que não procede conforme
| o conselho dos ímpios,
| não trilha o caminho dos pecadores,
| nem se assenta entre os escarnecedores.
|
| Feliz aquele que se compraz no
| serviço do Senhor e
| medita sua lei dia e noite."
|
| Salmos 1,1-2 [@Biblia]
# Destaque
Destaque é uma região que é apresentada de tal forma a realçar o seu conteúdo em relação aos elementos adjacentes.
:::::: {.destaque}
Exemplo de texto em destaque.
Segundo parágrafo.
::::::
# Nota de rodapé
As notas de rodapé[^1] são úteis para anexar informações complementares.[^nota]
[^1]: Mais informações acerca de notas de rodapé em .
[^nota]: Exemplo de nota de rodapé com múltiplas linhas.
Parágrafo 2, Linha 1\
Parágrafo 2, Linha 2\
Parágrafo 2, Linha 3
Parágrafo 3
# Variável
A [Nheengatu] disponibiliza um meio de capturar o valor atribuído a uma variável ou atributo de objeto definido no cabeçalho do documento.
O título deste trabalho é "::title::" e será impresso no tamanho **::papersize::**.
O objeto de teste tem como valor de texto = "::teste::texto::" e número = ::teste::numero::!
# Referências {-}
:::::: {#refs}
::::::
Exemplo de parágrafo logo depois das referências.
[CSL]: https://citationstyles.org/
[EPUB]: https://pt.wikipedia.org/wiki/EPUB
[HTML]: https://www.w3schools.com/html/html_intro.asp
[LaTeX]: https://pt.wikipedia.org/wiki/LaTeX
[Lua]: https://www.lua.org/about.html
[Pandoc]: https://pandoc.org/MANUAL.html#pandocs-markdown
[PDF]: https://pt.wikipedia.org/wiki/Portable_Document_Format
[Markdown]: https://daringfireball.net/projects/markdown/
[Nheengatu]: https://joseflavio.com/nheengatu/