Mesopotamia

The Land of the Four River Banks

II. Operations
5. Implementation

Data handling

Programs

Bernardo Forni – October 2022, August 2024

Back to top: Data handling

Introduction

Computer programs are used to aid in the generation and organization of the websites.

The first program used was DABI, which assisted in writing the bibliography and generating relative indices. Subsequently, the program was greatly extended to help in creating the entire website, and was renamed MID.

Back to top: Data handling

Programs

Back to top: Data handling

MID

Markdown Input to Display (in short MID), is a Python program that aids in writing whole websites. It generates static HTML files from Markdown pages (.md), that are easier to produce and manage.

Each page has associated metadata information at the top of the file, used to specify specific characteristics that the output page should have and connections to other pages. For example, it is used to choose the correct navigations (left hand side), titles and topological indices.

The functionality of DABI is contained within MID, as to allow connections between the bibliography and the entire website.

The content of pages and databases are in Markdown. The philosophy of this language is to be as easy-to-read and easy-to-write as is feasible. For an introduction to the syntax refer to this cheatsheet.

Cf. the Cybernetica Mesopotamica website.

Back to top: Data handling

DABI

Digital Analysis of Bibliographical Information (in short DABI), is a Python program that aids in writing digital bibliographies and relative indices. It generates static HTML files from a flat-file databases (.d).

Each database entry has associated metadata information at the top of the file, this data is used to make connections between the different informations. For example it is used to generate entries in the authorship, the search functionality, the indices, links to and from the bibliography.

Back to top: Data handling

Code

The code is publicly available on GitHub: https://github.com/urkesh-org/DABI.

It contains documentation on how to run the program on your own computer using Python.

The author of the code is Bernardo Forni; you are welcome to write him for any questions about the program.

The code is licensed under MIT: permission to copy provided attribution and preservation of copyright.

Back to top: Data handling