From 8e7239e66c74d1acab828e26ffb6137143ff486a Mon Sep 17 00:00:00 2001 From: helgus Date: Fri, 21 Mar 2025 14:32:51 +0300 Subject: [PATCH 1/3] Update README.md --- README.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 4746170..ec4d04c 100644 --- a/README.md +++ b/README.md @@ -12,16 +12,18 @@ In order to recreate the server setup, you have to make the following steps: 1. Install BaseX. Make sure that [Saxon](https://www.saxonica.com/) is in your classpath (the open source HE will do). This can be done either directly through the environment variable CLASSPATH, or by putting Saxon's JAR files (all of them, including those in `lib/`) into `basex/lib/custom`. -2. Create databases called `abaevdict`, `abaevdict_en`, `abaevdict_ru`, `abaevdict_index`. Their roles are as follows: +2. Put the content of this repo into the `basex/webapp` directory. + +3. Create databases called `abaevdict`, `abaevdict_en`, `abaevdict_ru`, `abaevdict_index`. Their roles are as follows: - `abaevdict` contains the bilingual XML files of the dictionary encoded in the [Abaev TEI](https://github.com/abaevdict/tei-abaev) format. These generally come from the [abaev-xml](https://code.cucurri.ru/abaevdict/abaev-xml) repo. - `abaevdict_en` and `abaevdict_ru` contain the preprocessed, standardized English and Russian XML editions of HEDO. This is done because maintaining a single bilingual database is impractical: users will want to interact with the English and Russian versions only. At some point, they may even diverge. For basic linking, entry IDs should suffice. - `abaevdict_index` includes various helper documents that are not directly displayed, but used for faster lookup, and for REST API queries. -3. Import the contents of the `entries` folder of [abaev-xml](https://code.cucurri.ru/abaevdict/abaev-xml) into the db `abaevdict`, and the file `biblio/abaev_biblio.xml` into the db `abaevdict_index`. +4. Import the contents of the `entries` folder of [abaev-xml](https://code.cucurri.ru/abaevdict/abaev-xml) into the db `abaevdict`, and the file `biblio/abaev_biblio.xml` into the db `abaevdict_index`. -4. Execute the script `scripts/update-indices.bxs` from the GUI or CLI. This does the following things: +5. Execute the script `scripts/update-indices.bxs` from the GUI or CLI. This does the following things: - optimizes `abaevdict`; - imports language data from the CSV file; - creates the lookup table for entries; @@ -33,4 +35,4 @@ In order to recreate the server setup, you have to make the following steps: Full execution of these actions takes a while, but it doesn't need to be redone unless the database changes; in the latter case, you can get away with regenerating only individual entries, although this has to be done manually for now -5. Run the BaseX http server (`basexhttp`). It will provide all services at `http://localhost:8080` by default. +6. Run the BaseX http server (`basexhttp`). It will provide all services at `http://localhost:8080` by default. From 356e945f0f5638ecfc62c3ca61924dd2811c63a4 Mon Sep 17 00:00:00 2001 From: helgus Date: Fri, 21 Mar 2025 14:34:11 +0300 Subject: [PATCH 2/3] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index ec4d04c..676c135 100644 --- a/README.md +++ b/README.md @@ -21,7 +21,7 @@ In order to recreate the server setup, you have to make the following steps: - `abaevdict_en` and `abaevdict_ru` contain the preprocessed, standardized English and Russian XML editions of HEDO. This is done because maintaining a single bilingual database is impractical: users will want to interact with the English and Russian versions only. At some point, they may even diverge. For basic linking, entry IDs should suffice. - `abaevdict_index` includes various helper documents that are not directly displayed, but used for faster lookup, and for REST API queries. -4. Import the contents of the `entries` folder of [abaev-xml](https://code.cucurri.ru/abaevdict/abaev-xml) into the db `abaevdict`, and the file `biblio/abaev_biblio.xml` into the db `abaevdict_index`. +4. Import the contents of the `entries` folder of [abaev-xml](https://code.cucurri.ru/abaevdict/abaev-xml) into the db `abaevdict`, and the file `biblio/abaev_biblio.xml` into the db `abaevdict_index`. Do not import them as subdirectories/collections; just put them under the database root. 5. Execute the script `scripts/update-indices.bxs` from the GUI or CLI. This does the following things: - optimizes `abaevdict`; From a5bf12d77c70e80d7f0df68aac71b63bf11d3832 Mon Sep 17 00:00:00 2001 From: helgus Date: Fri, 21 Mar 2025 14:55:49 +0300 Subject: [PATCH 3/3] Add AGPL badge to README --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 676c135..7ad4146 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ # BaseX webapp of the electronic HEDO +AGPL v3 + This repository contains the webapp files to be used with [BaseX](https://basex.org/) running as a webapp, plus some scripts to convert between different XML representations. Original code written by Oleg Belyaev in 2024–2025.