#==============================================================================
#. Título: Literate Programming
#. Autor : José Cláudio Faria/UESC/DCET
# Data  : 2023-04-20 16:35:23
# Objetivos: Complemento do tópico Leitura e Gravação de dados
# =============================================================================
#... Otimizado para uso no Tinn-R (https://tinn-r.org/pt/)
# =============================================================================

#. Paradigmas de escrita de textos
#.. WYSIWYG ('What You See Is What You Get' ou 'O que você vê é o que você obtém')
- O termo é usado para classificar ferramentas de edição e desenvolvimento que permitem visualizar,
  em tempo real, exatamente aquilo que será publicado ou impresso.

#.. NOWEB
- Um texto de entrada noweb contém o código-fonte do programa intercalado com a documentação.

- Linguagem de marcação ou tags, liberdade para escrever, a formatação e apresentação final é feita
  por ferramentas computacionais.
          
- Os principais componentes do noweb são dois programas: "notangle", que extrai o código-fonte "máquina" 
  dos textos-fonte, e "noweave", que produz documentação imprimível bem formatada.

#. Literate Programming (Programação literária (ou programação letrada)) - Noweb
#... https://pt.wikipedia.org/wiki/Programa%C3%A7%C3%A3o_letrada

Na prática, programação literária é atingida pela combinação da documentação (legível por humanos)
e código fonte (legível pela máquina) em um único arquivo fonte, de modo a manter uma correspondência
próxima entre a documentação e o código fonte.

- TeX
- LaTeX + R   -> PDF, HTML
- Mardown + R -> HTML
- HTML + R    -> HTML

#.. Compiladores TeX/LaTeX
- TexLive: https://www.tug.org/texlive/
- Miktex : https://miktex.org/

#.. 1 origem - n destinos
- Txt2tags + Python: https://txt2tags.org/
- Deplate  + Ruby  : https://deplate.sourceforge.net/
- Mardown          : https://docs.pipz.com/central-de-ajuda/learning-center/guia-basico-de-markdown#open

#.. Conversor universal (n origens - n destinos)
- PANDOC (Haskel): https://pandoc.org/