Setting up an Arcana

The process screen shots contain blank blocks. These are in position that will be replaced with the username.

Table of content:

• First login
• Creating an arcana
• Updating files in an Arcana

First login

Go to the main Arcana page and click on register. You will need to log in with your Academiccloud account.

Once this is done, you are now able to go to the dashboard:

which looks like this

You can find an overview of your profile under the profile tab. This is also the place where you can delete your profile data.

Creating an arcana

Once you have the dashboard open, clicking on “+ Add New Arcana” will create a new instance. First, you need to specify a name for this arcana

Once this is created, you should have it in your list of Arcana

By clicking on it, you can open the detailed dialog

and click on upload to process a file

Select a file and upload it. It is possible to upload PDF, Text, and Markdown files. Once you have clicked done, the file will be processed in the background

and the “Conversion status” will read “Docling in Progress”. This will switch to completed once it is done

You can check the detail by clicking on the details button

This is also the page, where you can download the Docling as a JSON file or download the use material in the Markdown format. Also, you have the option to upload a new version of the file and delete it entirely. More importantly, you can download the Markdown file and update the markers mentioned in the Docling process. This is very useful to fine tune the splitting and marking of the file for better indexing and retrieval. Once these changes are made, uploading it will start a check process to make sure the content still matches the uploaded material.

Now that the file or files are prepared, you can go back to the main dashboard and check the full Arcana

Here you can see that this Arcana is currently not indexed, meaning it is unlisted. If you have updated the material or the Markdown file, you also need to regenerate the Index. You will find the Index status to be “outdated” in this case. Clicking on “Generating Index” changes this

Which will change the status to a yellow “pending” and finally a green “indexed”.

Once your Arcana is index, you will be able to generate the Access Link and the ID for this Arcana. Click on “Access Link” to generate it.

This page will update and either show directly the link or you may need to click on it again to get the link for your Arcana

You can click on the link or copy it into a new tab, which will open Chat AI with the Arcana ID preset into the advanced options

Now you are able to share the link as well as the IDs and the Access Key for this Arcana.

Updating files in an Arcana

There is an option to download and customize annotations for uploaded files, or modify previous manual or generated annotations. After the file has been uploaded and processed, you can update its annotation if necessary. Opening the details dialog of the file either shows this for a text file (Markdown files look similar)

The details dialog for a PDF has a few more options

For all file types, there the is option to download the annotated Text/Markdown file. In case of a PDF, this annotated Markdown file - also called Markdown plus - is automatically generated by the Docling process. Also, both have the option to upload an manual annotated file (text or markdown). This is very useful to manually set the annotations or to updated them.

PDF files also have the options to reset the annotated Markdown file in case the uploaded file failed. Additionally, PDF have a JSON file from the Docling process that can be downloaded and viewed.

The avaiable annotations are explained in the Docling process under the heading Markdown Plus Annotations.