Improve output format in XML, PDF and EPUB

[arojascastro]

I have tested a sample of those on the server with the aim of generating files in various formats using the Download option.

Preliminary analysis

• 1. PDF (LaTeX version) does not work in any case.
• 2. Tex source code works in all cases, but the file has no metadata
• 3. PDF (fo version) works in some cases (in letters), but the file has no metadata and the diplomatic transcription is provided.
• 4. fo source code works in all cases, does not appear to be malformed.
• 5. EPUB works in all cases, but the generated documents do not have metadata and the diplomatic transcription is provided.
• 6. XML does not work in any case

Question: is this an ODD problem? @tuurma

If so, can you help me to identify errors and fix them? This could be part of our workshop as well if requires longer time and bigger effort...

[tuurma]

For PDF generation you need to configure LaTeX on the server and point to a relevant path in modules/config.xqm

{
  "details" : null,
  "description" : "Cannot run program \"/usr/local/bin/pdflatex\" (in directory \"/tmp\"): error=2, No such file or directory. An IO error occurred while executing the process /usr/local/bin/pdflatex: Cannot run program \"/usr/local/bin/pdflatex\" (in directory \"/tmp\"): error=2, No such file or directory [at line 179 of unknown]"
}

[arojascastro]

Thank you! I have contacted Markus and shared the information.

[tuurma]

We'd need more concrete specifications for what is expected, ideally a screenshot of what is with a mockup for what should be, perhaps starting with FO (or LaTeX if you get the setup on the server right)

[arojascastro]

True. Basically, a first improvement would be to include some of the metadata in the output document that allows to identify the edition, source, and editor. I will prepare something before the workshop.

[arojascastro]

I have attached a mockup done by hand here

Basically, we want to keep it simple:

1. one list of items that allow us to identify the document (citation, source, licence)
2. a line that separates the metadata from the text
3. the title in bigger and/or bold
4. the text, preferably in diplomatic transrciption with page breaks
5. notes if any

The citation should collapse information from some elements from the header and follow this pattern:

Author. "Title of the edition". Dossier Digital: Alexander von Humboldt y Cuba (1800-1830), Editor (ed.), Berlin-Brandenburgische Akademie der Wissenschaften y Oficina del Historiador de la Ciudad de la Habana, Year of publication.

For example:

Arango y Parreño, Francisco de. "Observaciones sobre el Ensayo politico con relacion a la Isla de Cuba que ha escrito el Señor Baron de Humboldt". Dossier Digital: Alexander von Humboldt y Cuba (1800-1830), Kathrin Kraller (ed.), Berlin-Brandenburgische Akademie der Wissenschaften y Oficina del Historiador de la Ciudad de la Habana, 2021.

What do you all think @trafikante @tuurma @vylop ? Can we see this together on 22 October -- perhaps as an exercise? Otherwise, we can work on it after the workshop online, it is not a priority right now.

[trafikante]

Looks good. Is it possible to include a URL/PURL in the citation?

Arango y Parreño, Francisco de. "Observaciones sobre el Ensayo politico con relacion a la Isla de Cuba que ha escrito el Señor Baron de Humboldt". Dossier Digital: Alexander von Humboldt y Cuba (1800-1830), Kathrin Kraller (ed.), Berlin-Brandenburgische Akademie der Wissenschaften y Oficina del Historiador de la Ciudad de la Habana, 2021. URL: https://xmldev.bbaw.de/prohd/apps/ProHD/prohd0015.xml

One more thing: Is it possible to decide on the fonts we use for pdf output?
Would be great to take use our ProHD fonts!

• Montserrat (Family)
• Roboto Slab

Examples from our designer included
Tipografia Institucional.pdf
Tipografia Complementaria.pdf

[arojascastro]

Looks good. Is it possible to include a URL/PURL in the citation?

Arango y Parreño, Francisco de. "Observaciones sobre el Ensayo politico con relacion a la Isla de Cuba que ha escrito el Señor Baron de Humboldt". Dossier Digital: Alexander von Humboldt y Cuba (1800-1830), Kathrin Kraller (ed.), Berlin-Brandenburgische Akademie der Wissenschaften y Oficina del Historiador de la Ciudad de la Habana, 2021. URL: https://xmldev.bbaw.de/prohd/apps/ProHD/prohd0015.xml

We can @trafikante but we do not have a stable URL yet... This can be added after deciding where to host the web application (in Cuba or in Germany?) and getting/buying a web domain... I think...

[trafikante]

ok, important point. Please @arojascastro put this (hosting of TEIPublisher) on the agenda for the workshop. Implementation has to in Cuba, otherwise we get responsibility issues. They have to be in charge but it should work so that we all have accese (like it is the case with the DSpace Repo),