search

the-teachingRSE-project / competencies

The teachingRSE project: "Teaching and Learning Research Software Engineering"
Creative Commons Attribution 4.0 International
28 stars 19 forks source link

doc, docx, or .rtf output for F1000 research #369

Open CaptainSifff opened 4 days ago

CaptainSifff commented 4 days ago

F1000 Research only accepts, doc, docx, or rtf... I managed to get this through for now by wrapping the pdf in a zip(which they accept)

But I can't imagine that this holds forever... Can someone, @jngrad , @MakisH look into the toolchain on how to get a quick .doc out of it? F1000 research typesets the titlepage by itself, so the most difficult thing I suppose is the layout of the tables...

jcohen02 commented 4 days ago

😮 That's very surprising - I can understand that they don't take LaTeX source but really surprised that they don't accept PDFs!

CaptainSifff commented 4 days ago

Screenshot_20241009_204535

CaptainSifff commented 4 days ago

This paper makes it a bit difficult to find reviewers who have not published with any of the main authors during the past years: https://experts.illinois.edu/en/publications/what-do-we-not-know-about-research-software-engineering together with the FAIR4RS paper....

CaptainSifff commented 3 days ago

OK, I've received the notification, that .pdf is not ok...

CaptainSifff commented 2 days ago

This is the command that I use for converting the .md file: pandoc --standalone --bibliography=bibliography.bib --biblatex --filter pandoc-xnos --toc --number-sections -o comp.docx competencies.md It gets the refs wrong and the organization table wrong. For converting the tex file that is generated as an intermediate file in our pipeline, I use: pandoc --standalone -o comp.docx --bibliography=bibliography.bib --filter pandoc-xnos --toc --number-sections --biblatex competencies.tex and I get the seniority table rendered wrong, and also no bibliography list.

CaptainSifff commented 2 days ago

files. compmd.docx comptex.docx

jngrad commented 2 days ago

I don't really know a good toolchain for such a transformation. Since this manuscript is already published on ArXiv, there's no harm in uploading it to a free conversion server, such as the Adobe PDF to Word tool. It produces a rather decent file. @CaptainSifff I would recommend you go with that option. The bibliography is a numbered list, instead of being dynamically generated from a MS Word bibliography database, and the glossaries aren't stored in a data structure. It probably isn't too much of an issue, given the journal accepts RTF files, which also don't have a bibliography database and glossary feature, as far as I know.

For completeness, I also tried opening the PDF in MS Word. While most of the styling is preserved, the more complex tables are broken, and the competency icons are really damaged, sometimes multiple icons are fused into the same vector graphic element and can no longer flow with the text. Lastly, I tried opening it in Google Docs and exporting it to MS Word format, but the entire structure is broken.

competencies-adobe.docx competencies-ms-word.docx competencies-google-docs.docx

Also, unrelated to the problem at hand, while manually repairing the competencies-ms-word.docx file, I found out the manuscript contains a seemingly broken sentence: "the RSE’s obligation to In addition to the values".

MakisH commented 2 days ago

Also, unrelated to the problem at hand, while manually repairing the competencies-ms-word.docx file, I found out the manuscript contains a seemingly broken sentence: "the RSE’s obligation to In addition to the values".

This is now fixed in #367

Based on the discussion on Matrix, let's wait and see if LaTeX is ok before investing more effort on the conversion.

CaptainSifff commented 2 days ago

Thank you for your work!