problems with EFES

65 views
Skip to first unread message

Daria R.

unread,
Jul 23, 2024, 5:35:33 AM7/23/24
to EFES users

Good morning,

After using EFES for a few months without any issues, I started encountering some problems and decided to download the program again. I followed the instructions, deleting the old repository and creating a new one. I harvested and indexed the inscriptions. Now, when I click on “inscriptions” or “search,” I can see the list of my documents, but when I click on a specific inscription, I am taken to an empty page where I can only download its XML file (as shown in the screenshot). Additionally, when I click on “bibliographic concordance,” the page is also empty. I tried several times in the last few days, but I do not manage to understand what is happening. 

What might I have done wrong?

Best wishes and thanks, 

Daria Russo
Screenshot 2024-07-23 alle 11.16.47.png

Martina Filosa

unread,
Jul 23, 2024, 5:39:54 AM7/23/24
to efes-...@googlegroups.com
Dear Daria,

Could you please check the following path: webapps/ROOT/kiln/stylesheets and report back on whether the folder epidoc is there? Feel free to send a screenshot!

All best,

Martina

--
You received this message because you are subscribed to the Google Groups "EFES users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to efes-users+...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/efes-users/e4df21fe-129f-42ac-9b2b-c83afc8fac42n%40googlegroups.com.


--

Martina Filosa, M.A.

Wissenschaftliche Mitarbeiterin

ANR/DFG DigiByzSeal - VolkswagenStiftung DiBS

Universität zu Köln
Institut für Altertumskunde
Abteilung Byzantinistik und Neugriechische Philologie
Albertus-Magnus-Platz
D-50923 Köln



Daria R.

unread,
Jul 23, 2024, 6:00:09 AM7/23/24
to EFES users
Dear Martina, 

there's an empty epidoc folder! I attach the screenshot!
Thank you for your help!
All best, 

Daria 
Screenshot 2024-07-23 alle 11.59.02.png

Martina Filosa

unread,
Jul 23, 2024, 6:35:41 AM7/23/24
to efes-...@googlegroups.com
That's what I was afraid of :) We recently made a change in the way EFES treats the EpiDoc Stylesheets, and, apparently, if you try to download the source code, it will not take them into account. I would suggest you download the EpiDoc stylesheets from here: https://github.com/EpiDoc/Stylesheets and put the content in webapps/ROOT/kiln/stylesheets/epidoc and try to start EFES anew. 

Let me know if this works!

Cheers,

m.

Gabriel Bodard

unread,
Jul 23, 2024, 6:41:01 AM7/23/24
to efes-...@googlegroups.com
Just to follow up on Martina's excellent advice… can I confirm (Daria) that when you say you downloaded EFES you mean you downloaded the ZIP file from Github (rather than cloning the software using Git) and extracted it on your desktop?

Many thanks,

Gabby

-- 
Dr Gabriel BODARD (he/him)
Reader in Digital Classics

Director of Studies (research): Digital Humanities Research Hub
Director of Studies (research): Institute of Classical Studies

Mailing address:
  Institute of Classical Studies
  University of London
  Senate House
  Malet Street
  London WC1E 7HU
 
Due to new IT security rules, I am currently not able to read or reply to email outside of office hours, or while travelling or working from home. This may result in slower replies than usual.

From: efes-...@googlegroups.com <efes-...@googlegroups.com> on behalf of Martina Filosa <martina...@gmail.com>
Sent: 23 July 2024 11:34
To: efes-...@googlegroups.com <efes-...@googlegroups.com>
Subject: Re: [efes-users] problems with EFES
 

Daria R.

unread,
Jul 23, 2024, 7:34:34 AM7/23/24
to EFES users
Dear Martina, dear Gabby, 

thank you for your advice: now EFES works again! And yes, I downloaded the ZIP file from GitHub (as I think I did the first time that I downloaded it). 
I didn't have to extract it on my desktop: my Mac unzipped it automatically after the completion of the download. 
With very best wishes and thanks!

Daria 

Gabriel Bodard

unread,
Jul 23, 2024, 7:45:18 AM7/23/24
to efes-...@googlegroups.com
Perfect, thanks for clarifying. In that case Martina's advice was 110% the correct thing to do.

(We will very soon publish a more convenient solution to this issue. Watch this space!)

Gabby

-- 
Dr Gabriel BODARD (he/him)
Reader in Digital Classics

Director of Studies (research): Digital Humanities Research Hub
Director of Studies (research): Institute of Classical Studies

Mailing address:
  Institute of Classical Studies
  University of London
  Senate House
  Malet Street
  London WC1E 7HU
 
Due to new IT security rules, I am currently not able to read or reply to email outside of office hours, or while travelling or working from home. This may result in slower replies than usual.

From: efes-...@googlegroups.com <efes-...@googlegroups.com> on behalf of Daria R. <dariar...@gmail.com>
Sent: 23 July 2024 12:34
To: EFES users <efes-...@googlegroups.com>

Gabriel Bodard

unread,
Jul 25, 2025, 11:15:38 AMJul 25
to efes-...@googlegroups.com
Dear all,

Latest update on Daria's bug report from last year. We propose to add the following to the EFES Quickstart:
### To include the EpiDoc XSLT Stylesheets in your EFES instance:

1. If you have cloned EFES using GitHub Desktop
   - Do nothing. The stylesheets will already have been cloned into `webapps/ROOT/kiln/stylesheets/epidoc` for you from the submodule
2. If you have cloned EFES using Git from the commandline/terminal/bash:
   - Navigate into the EFES folder, and type the command `git submodule update --init` . This will clone the submodule for you as per (1) above.
3. If you have downloaded a static version of EFES as a ZIP from Github:
   - Download the ZIP of the EpiDoc Stylesheers from <https://github.com/EpiDoc/Stylesheets/>, extract the ZIP archive into a new folder, and copy the contents of this folder into `webapps/ROOT/kiln/stylesheets/epidoc` in your EFES instance.
Does that seem adequate to you?

(Hopefully we'll have an easier solution to use case #3 on the next EpiDoc and EFES release, later this year.)

Gabriel Bodard

unread,
Aug 7, 2025, 12:59:57 PMAug 7
to efes-...@googlegroups.com
Dear all,

Following from the below, please note that (with Poli's advice and approval) I have updated both the Quickstart section and the Installing EFES for the First Time pages in the EFES User Guide: https://github.com/EpiDoc/EFES/wiki/Installation.

I would be grateful for any feedback the next time you point a student or other newcomer at these pages and they try to install EFES by themselves the first time.

All best,

Gabby

-- 
Dr Gabriel BODARD (he/him)
Reader in Digital Classics

Director of Studies (research): Digital Humanities Research Hub
Director of Studies (research): Institute of Classical Studies

Mailing address:
  Institute of Classical Studies
  University of London
  Senate House
  Malet Street
  London WC1E 7HU
 
Due to new IT security rules, I am currently not able to read or reply to email outside of office hours, or while travelling or working from home. This may result in slower replies than usual.


From: 'Gabriel Bodard' via EFES users <efes-...@googlegroups.com>
 
Reply all
Reply to author
Forward
0 new messages