O que é templates ejs<a href="o_que_e_ejs.html" target="_blank" title="Pressione aqui para expandir este documento em nova aba."

INDEX
1. Introdução
2. Instalar ejs
3. Instalar ejs-cli
4. Descrição.
5. Exemplos
6. ejs-cli recebe um arquivo .ejs e retorna uma arquivo html
7. Referências.
8. Histórico.
CONTEÚDO
1. Introdução
  1. Objetivo:
    
    O projeto ejs (Embedded JavaScript templates) é usado para criar página html estática a partir de um modelo de extensão .ejs.
    
    Os modelos recebem varáveis para serem inseridas dentro das tags.
    
    Veja mais...
    
    [🔙]
  1. Pre-requisitos:
    1. Nodejs
    2. javascript
    1. [🔙]
  1. Benefícios:
    1. Simplificar a construção de páginas html através de modelos pre-fabricados.
    1. [🔙]
2. Descrição
  1. Tags do modelo:
    1. <% Tag 'Scriptlet', para fluxo de controle, sem saída
    2. <%_ Tag Scriptlet 'Whitespace Slurping', remove todos os espaços em branco antes dela
    3. <%= Exibe o valor no modelo (HTML com escape)
    4. <%- Exibe o valor sem escape no modelo
    5. <%# Tag de comentário, sem execução, sem saída
    6. <%% Produz um literal '<%'
    7. %> Tag de finalização simples
    8. -%> Tag do modo de corte ('nova linha slurp'), corta após a nova linha
    9. _%> Tag de finalização 'Whitespace Slurping', remove todos os espaços em branco após ela.
  2. Include do modelo
    1. As inclusões são relativas ao modelo com a tag include. (Isso requer a opção 'nome do arquivo'). Por exemplo, se você tiver "./views/users.ejs" e "./views/user/show.ejs", você usaria <%- include('user/show'); %>.
    2. Você provavelmente vai querer usar a tag de saída bruta ( <%-) com sua inclusão para evitar o escape duplo da saída HTML.
```
   
   <ul>
      <% users.forEach(function(user){ %>
         <%- include('user/show', {user: user}); %>
      <% }); %>
   </ul>
```
  3. O EJS é fornecido com uma interface de linha de comando (CLI) com recursos completos. As opções são semelhantes às usadas no código JavaScript:
    1. cache As funções compiladas são armazenadas em cache, requer filename
    2. -o / --output-file FILE Grave a saída renderizada em FILE em vez de stdout.
    3. -f / --data-file FILE Deve ser formatado em JSON. Use a entrada analisada de FILE como dados para renderização.
    4. -i / --data-input STRING Deve ser formatado em JSON e codificado por URI. Use a entrada analisada de STRING como dados para renderização.
    5. -m / --delimiter CHARACTER Use CHARACTER com colchetes angulares para abrir / fechar (o padrão é%).
    6. -p / --open-delimiter CHARACTER Use CHARACTER em vez do colchete angular esquerdo para abrir.
    7. -c / --close-delimiter CHARACTER Use CHARACTER em vez de colchete em ângulo reto para fechar.
    8. -s / --strict Quando definido como true, a função gerada está em modo estrito
    9. -n / --no-with Use o objeto 'locals' para vars ao invés de usar with (implica --strict).
    10. -l / --locals-name Nome a ser usado para o objeto que armazena variáveis locais quando não estiver usando with.
    11. -w / --rm-whitespace Remova todos os espaços em branco seguros para remover, incluindo espaços em branco à esquerda e à direita.
    12. -d / --debug Saída gerada do corpo da função
    13. -h / --help Exibir esta mensagem de ajuda.
    14. -V/v / --version Mostra a versão EJS.
    15. Exemplo de execução do ejs no prompt de comandos:
```
   ejs -p [ -c ] ./template_file.ejs -o ./output.html
   ejs ./test/fixtures/user.ejs name=Lerxst
   ejs -n -l _ ./some_template.ejs -f ./data_file.json            
```
  4. [🔙]
  5. [🔙]
3. Exemplo de código nodejs usando o Mecanismos de Modelo JavaScript EJS
  1. Exemplo de como criar projeto ejs, desde a criação do projeto, instalação dos pacotes ejs, express, das pastas e arquivos .ejs e como se relaciona usando includes
    1. server.js
    2. Esse projeto foi criado baseado no documento:
      1. Como usar o EJS para modelar seu aplicativo de nó
  2. Exemplo de como criar projeto ejs, desde a criação do projeto, instalação dos pacotes ejs, express, das pastas e arquivos .ejs e como se relaciona usando includes e variáveis.
    1. server.js
    2. Esse projeto foi criado baseado no documento:
      1. Como usar o EJS para modelar seu aplicativo de nó
4. ejs-cli recebe um arquivo .ejs e retorna uma arquivo html
  1. Parâmetros de execução:
    1. -h, --help show this help. [boolean] [default: false]
```
   ejs-cli -h
```
    2. -f, --file = forneça o caminho do arquivo de modelo ejs [string]
```
 
  
```
    3. -b, --base-dir = diretório base ao qual -f é relativo. [default: "./"]
```
   # renderiza os arquivos *.ejs em src/ e envia os arquivos compilados para dest/
   ejs-cli --base-dir src/ "*.ejs" --out dest/

   # renderiza os arquivos *.ejs em src/ e seus subdiretórios e envia arquivos compilados para dest/
   ejs-cli --base-dir src/ "**/*.ejs" --out dest/
```
    4. -e, --exclude = nomes de arquivos/diretórios a serem excluídos [espaço separado se mais de um]
```
  # exclui qualquer diretório "parcial" da renderização
  ejs-cli --base-dir src/ "**/*.ejs" --exclude "partials/" --out dest/
```
    5. -o, --out = Gerar o arquivo .html baseado no arquivo .ejs
```
  # renderiza os arquivos *.ejs no diretório de trabalho atual.
  ejs-cli "*.ejs" --out .               
  
```
    6. -O, --options = variáveis de opção (caminho do arquivo ou string JSON).
```
   # renderiza os arquivos *.ejs no diretório de trabalho atual e envia os arquivos compilados para dest/
   ejs-cli "*.ejs" --out dest/ --options options.json
  
```
5. REFERÊNCIAS
  1. [🔙]
1. HISTÓRICO
  1. 08/06/2021
    - ;
  2. 08/06/2021
    - Criar este documento baseado no modelo02.md ;
    - Escrever tópico Objetivos;
    - Escrever tópico Pre-requisitos
    - Escrever tópico Benefícios
    - Escrever tópico Referências
    - [🔙]
  3. 08/06/2021
    - Escrever tópico Descrição
    - Escrever tópico Exemplos
    - Escrever tópico Conteúdo 01
    - Atualizar o histórico deste documento.
    - Testar este documento depois após uma semana de concluído.
    - [🔙]