Documentação
Considerações sobre aspetos editoriais desta edição digital encontram-se em Sobre o projeto Detalhes sobre o modelo de dados, a codificação TEI e a infraestrutura técnica podem ser encontradas nesta página e noutras subpáginas da edição que estão ligadas aqui.
Codificação TEI
A concretização da edição digital tem por base principalmente standards XML e tecnologias relacionadas.
As transcrições dos documentos, das publicações e dos metadados correspondentes estão codificadas segundo os standards da Text Encoding Initiative (na versão TEI-P5).
A adaptação das normas TEI específica do projeto é descrita aqui.
Setup técnico e workflow
O setup técnico e o workflow são esboçados na seguinte figura:
Setup técnico e workflow
O workflow pode ser dividido em quatro passos principais: (1) interpretação, (2) representação, (3) transformação e (4) apresentação.
Os documentos são primeiro transcritos e codificados segundo as normas TEI.
Os documentos TEI são administrados num repositório GitHub, situado em https://github.com/cceh/pessoa, de modo a que as suas versões possam ser verificadas e para tornar possível que membros da equipa trabalhem nos ficheiros TEI de forma colaborativa.
Os facsímiles dos documentos são guardados separadamente num servidor de imagens.
Os ficheiros master do repositório GitHub são guardados numa base de dados XML (eXist-db), onde estão inseridos numa aplicação que gera o portal da edição. Os ficheiros de imagem também estão incluídos nesta aplicação através de um visualizador de imagens (OpenSeadragon).
A aplicação é principalmente baseada em ficheiros XQuery e XSLT, que produzem as páginas do portal e que servem para transformar os documentos TEI em documentos HTML. Para além disso, são usadas CSS stylesheets para orientar o estilo do portal e dos documentos editados digitalmente.
Para a criação do portal foram usados alguns componentes integrados na base de dados eXist: o framework CSS Bootstrap, a biblioteca em JavaScript JQuery e o Templating Framework de eXist.
Versões
Os dados do corpus da edição e a aplicação Web da edição digital são versionados individualmente. O esquema segundo o qual isto é feito é explicado na página seguinte: "Versões".
Licenças
Informações sobre as licenças para os dados, imagens e a aplicação Web podem ser encontradas na página "Licenças" e nos respetivos repositórios GitHub:
- Corpus: https://github.com/cceh/pessoa-corpus
- Webapp: https://github.com/cceh/pessoa
Dados
Os dados TEI dos documentos e publicações podem ser descarregados do próprio sítio Web da edição (ver a página "Downloads") ou através do repositório GitHub do corpus da edição: https://github.com/cceh/pessoa-corpus