Skip to content

Commit

Permalink
Update asset path
Browse files Browse the repository at this point in the history
  • Loading branch information
Jakob Jünger committed Dec 17, 2024
1 parent f755237 commit 150f708
Show file tree
Hide file tree
Showing 17 changed files with 17 additions and 18 deletions.
11 changes: 5 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,24 @@
<img align="right" width="48" height="48" src="assets/img/epigraf-icon.png" alt="Epigraf logo">
<img align="right" width="48" height="48" src="/docs/assets/img/epigraf-icon.png" alt="Epigraf logo">

# Epigraf

Epigraf is a research platform for collecting, annotating, linking and publishing multimodal text data.
The data model supports research databases ranging from epistolary editions to social media corpora.
Epigraf is currently used primarily for editing epigraphic data - inscriptions in connection with the objects to which they are attached.
It includes a publication system for various document formats such as Word or TEI, structured JSON, XML and CSV data, and triples in TTL, JSON-LD and RDF/XML.

See the [user documentation](https://epigraf.inschriften.net/help)
and the [developer documentation](https://digicademy.github.io/epigraf/) for further information.

Want to try it out? Contact us for a test account on one of our machines.

*Note about the development status:* Epigraf has a history.
Epigraf has a history.
You will find archeological layers and legacy code from former development epochs
when visiting the code base and documentation.
Some of them are well preserved, others are deteriorating.
In any case, they provide fertile soil for future development.
Look out for the flowers that are in bloom and help nurture the garden.

![Epigraf use cases](assets/img/epigraf-use-cases.png)
**Want to try it out?** Contact us for a test account on one of our machines.

![Epigraf use cases](docs/assets/img/epigraf-use-cases.png)


## How to run Epigraf
Expand Down
Binary file removed docs/assets/img/documentation_frontend.png
Binary file not shown.
Binary file removed docs/assets/img/edit-with-epigraf_playground~394.png
Binary file not shown.
Binary file removed docs/assets/img/edit-with-epigraf_stage~61.png
Binary file not shown.
Binary file removed docs/assets/img/epigraf-architecture-ii.png
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file removed docs/assets/img/epigraf-model-class-hierarchy.png
Binary file not shown.
Binary file removed docs/assets/img/epigraf-mvc-class-hierarchy-en.png
Binary file not shown.
Binary file removed docs/assets/img/epigraf-view-class-hierarchy.png
Binary file not shown.
4 changes: 2 additions & 2 deletions docs/backend/controller.md
Original file line number Diff line number Diff line change
Expand Up @@ -170,7 +170,7 @@ User settings in Epigraf are either stored in the user record or in the session.
All controllers extend the `AppController` class (`src/Controller/AppController.php`)
which is derived from the base `Controller` class provided by the CakePHP framework.

![Application controller class hierarchy](assets/img/classes-controller-app.png){:width="55%"}
![Application controller class hierarchy](/assets/img/classes-controller-app.png){:width="55%"}

On the application level, controllers serve the following purposes:

Expand All @@ -189,7 +189,7 @@ The Epi plugin implements an own `Epi\AppController` class (`plugins/Epi/Control
derived from the global AppController, adding functionality for project database handling.
All project database controllers within the Epi plugin extend this class.

![Epi plugin controller class hierarchy](assets/img/classes-controller-epi.png){:width="60%"}
![Epi plugin controller class hierarchy](/assets/img/classes-controller-epi.png){:width="60%"}

They Epi plugin controllers serve the following purposes:

Expand Down
4 changes: 2 additions & 2 deletions docs/backend/model.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ All Tables are derived from `src/Model/Table/BaseTable.php` and all Entities fro
Common methods in the table classes are `findHasParams()` and `findContainFields()`
which are used by the controllers to filter and retrieve data from the database based on query parameters.

![Model class hierarchy (App)](assets/img/classes-model-app.png){:width="60%"}
![Model class hierarchy (App)](/assets/img/classes-model-app.png){:width="60%"}

There are some pecularities in the models. You may need to read the section about project database models
to understand the full picture:
Expand Down Expand Up @@ -64,7 +64,7 @@ Tables classes are usually derived from `plugins/Epi/src/Model/Table/BaseTable.p
and entity classes from `plugins/Epi/src/Model/Entity/BaseEntity.php`.
Both project database level base classes extend the corresponding application's base classes.

![Model class hierarchy (Epi)](assets/img/classes-model-epi.png){:width="80%"}
![Model class hierarchy (Epi)](/assets/img/classes-model-epi.png){:width="80%"}

Some special cases have to be considered:

Expand Down
2 changes: 1 addition & 1 deletion docs/backend/view.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ different view classes are used.
The ApiView based classes are also used in the export pipelines
to generate TEI-documents and other structured data formats.

![View class hierarchy](assets/img/classes-views.png){: width="55%"}
![View class hierarchy](/assets/img/classes-views.png){: width="55%"}


## Rendering HTML for the Browser
Expand Down
2 changes: 1 addition & 1 deletion docs/database/datamodel.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ The project databases include the following tables:

See the user help for further information about the available fields in each table.

![Graphic illustration of the data model](../assets/img/epigraf-data-model.png)
![Graphic illustration of the data model](..//assets/img/epigraf-data-model.png)

## Domain Model Configuration

Expand Down
2 changes: 1 addition & 1 deletion docs/frontend/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,4 +12,4 @@ For interactive trees, tables and other widgets, Epigraf implements an own EpiWi
Bundling JavaScript files, CSS files, language resources and images is done using Webpack.
All bundles can be generated at once by calling `npm run build`.

![Edit with Epigraf](assets/img/epigraf-editor.png)
![Edit with Epigraf](/assets/img/epigraf-editor.png)
6 changes: 3 additions & 3 deletions docs/frontend/widgets.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ The base classes of the framework are defined in `htdocs/js/base.js`:
A document consists of several parts such as sections, footnotes and notes.
Document classes hold together the different parts and manage the interaction between them.

![Inheritance hierarchy](assets/img/classes-widget-basemodel.png){:width="24%"}
![Inheritance hierarchy](/assets/img/classes-widget-basemodel.png){:width="24%"}

### The Widget Life Cycle

Expand Down Expand Up @@ -127,7 +127,7 @@ Frames are HTML elements attached to derivates of the `BaseFrame` class that han
- `TabFrame`: Responsible for tab sheets within in sidebars.
- `PopupWindow`: Responsible for popups and dialogs.

![Inheritance hierarchy](assets/img/classes-widget-baseframe.png){:width="32%"}
![Inheritance hierarchy](/assets/img/classes-widget-baseframe.png){:width="32%"}

The frame classes handle dynamic content loading and trigger the respective widget lifecycle methods:
- `loadElement()` displays a DOM element already constructed on the page.
Expand Down Expand Up @@ -215,7 +215,7 @@ Both are descendants of the `BaseForm` class supporting features for saving data
- Handle form validation and the form submission lifecycle.
- Emit events for other widgets reacting to content updates.

![Inheritance hierarchy](assets/img/classes-widget-basedocumentmodel.png){:width="70%"}
![Inheritance hierarchy](/assets/img/classes-widget-basedocumentmodel.png){:width="70%"}

The `EntityWidget` is used for simple entities, usually displayed in a vertical table.
It inherits all methods and properties from the base from widget
Expand Down
4 changes: 2 additions & 2 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Some of them are well preserved, others are deteriorating.
In any case, they provide fertile soil for future development.
Look out for the flowers that are in bloom and help nurture the garden.

![Epigraf use cases](assets/img/epigraf-use-cases.png)
![Epigraf use cases](/assets/img/epigraf-use-cases.png)

# Getting Started

Expand Down Expand Up @@ -77,7 +77,7 @@ MariaDB and the file system is used to store [data](/docs/database). There is on
user accounts and application-wide data. For the research data, multiple project databases are created.
Frontend and database content is cached using Redis. If no Redis server is available, the cache is stored in the file system.

![Epigraf architecture](assets/img/epigraf-architecture.png){:width="90%"}
![Epigraf architecture](/assets/img/epigraf-architecture.png){:width="90%"}

# Directory structure

Expand Down

0 comments on commit 150f708

Please sign in to comment.