web:Documentação dos sites: mudanças entre as edições

sem sumário de edição
Sem resumo de edição
Sem resumo de edição
Linha 19: Linha 19:


== Arquitetura e reuso do sistema ==
== Arquitetura e reuso do sistema ==
[[file:TempEngWeb016.svg|thumb|180px|Sistemas de ''template'': o [[wikipedia:Template processor|''template engine'']] (processador) é alimentado pelos ''dados'' e o ''template'' mais adequado à visualização do tipo de dado.]]
[[file:TempEngWeb016-v2.png|thumb|180px|Sistemas de ''template'': o [[wikipedia:Template processor|''template engine'']] (processador) é alimentado pelos ''dados'' e o ''template'' mais adequado à visualização do tipo de dado.]]
[[File:StaticTemplates.gif|thumb|Arquitetura ''"Outside server template system"'' para o conteúdo institucional.]]
 
[[File:StaticTemplates.gif|thumb|Arquitetura ''"Outside server template system"'' para o conteúdo institucional. <br />Na prática é implementado como ''cache'' de ''server-side''.]]
 
[[file:ServerSideTemplates.gif|thumb|'''''Server-side''' template system''.]]
[[file:ClientSideTemplates.gif|thumb|'''''Client-side''' template system''.]]
 


Os principais aspectos da arquitetura são relativos: ao [[wikipedia:Web template system|''sistema de template'']] (ilustrado) e aos microserviços ([[wikipedia:Web service|''web services'']]).
Os principais aspectos da arquitetura são relativos: ao [[wikipedia:Web template system|''sistema de template'']] (ilustrado) e aos microserviços ([[wikipedia:Web service|''web services'']]).
Linha 26: Linha 31:
O pilar da transparência levou à arquitetura diferenciada na publicação do conteúdo:
O pilar da transparência levou à arquitetura diferenciada na publicação do conteúdo:
* Conteúdo institucional via arquitetura "Outside server template system" (preferível) ou "Server-side template system".
* Conteúdo institucional via arquitetura "Outside server template system" (preferível) ou "Server-side template system".
* O restante opcional, pode fazer também uso de "Client-side template system". Tipicamente a navegação intranet, depois do ''login'' seria client-side.  
*O restante opcional, pode fazer também uso de "Client-side template system". Tipicamente a navegação intranet, depois do ''login'' seria client-side.


== Estrutura e requisitos das páginas==
==Estrutura e requisitos das páginas==
...  
...
* Institucional  
*Institucional


== Frameworks e gestão de conteúdo ==
==Frameworks e gestão de conteúdo==
Foram tomadas as seguintes decisões de projeto para a construção de todos os sites:
Foram tomadas as seguintes decisões de projeto para a construção de todos os sites:
* Conteúdo de '''documentação técnica''' em [[wikipedia:Mediawiki|Mediawiki]]: todos na <code>wiki.addressforall.org</code>, separando-se cada projeto através de ''namespaces''.  
*Conteúdo de '''documentação técnica''' em [[wikipedia:Mediawiki|Mediawiki]]: todos na <code>wiki.addressforall.org</code>, separando-se cada projeto através de ''namespaces''.
* Conteúdo '''institucional gerado como HTML estático''' por [[wikipedia:Server-side scripting|''server-side building'']],  com tecnologia [[wikipedia:Next.js|NextJS]].
*Conteúdo '''institucional gerado como HTML estático''' por [[wikipedia:Server-side scripting|''server-side building'']],  com tecnologia [[wikipedia:Next.js|NextJS]].
* Conteúdo institucional, visualização de dados, intranet e relatórios públicos: tecnologia [[wikipedia:React (software)|'''ReactJS''']] em ''server-side'' e ''client-side''.
*Conteúdo institucional, visualização de dados, intranet e relatórios públicos: tecnologia [[wikipedia:React (software)|'''ReactJS''']] em ''server-side'' e ''client-side''.
 
== Demais decisões na implementação dos pilares == 


* O conteúdo institucional deve ser publicado como [https://github.com/okfn-brasil/HTML5-onlyContent HTML5-onlyContent] e com interpretações visual (usuário humano) e robótica (marcação semântica) baseadas na mesma única fonte de verdade, conforme [https://github.com/okfn-brasil/lexml-dou LexML-DOU] dos diários oficiais.
==Demais decisões na implementação dos pilares==  


* ...
*O conteúdo institucional deve ser publicado como [https://github.com/okfn-brasil/HTML5-onlyContent HTML5-onlyContent] e com interpretações visual (usuário humano) e robótica (marcação semântica) baseadas na mesma única fonte de verdade, conforme [https://github.com/okfn-brasil/lexml-dou LexML-DOU] dos diários oficiais.


*...


[[Categoria:Conceitos]]
[[Categoria:Conceitos]]
2 544

edições