diff --git a/sql/README.md b/sql/README.md index d45b167d0a962cf8f76423128210309fe0aa31fc..e6be6fad0335f28c111dbc806a1cf7319e10c694 100644 --- a/sql/README.md +++ b/sql/README.md @@ -2,21 +2,21 @@ The _Digest_ is the definitive Roman law compendium compiled under emperor Justinian I (533 CE). The text is arranged in 50 books, 432 thematic sections, 9132 quoted passages and 21055 text units. This relational database presents the _Digest_ in interlinked data tables chained together by unique keys. The `digest.db` database can be used for generating advanced analytical insights about Roman law as represented by the _Digest_ and for searching text and associated data in a staructured and efficient manner. -### [<a id="toc">0. Table of contents</a>](#toc) +### 0. Table of contents -[1. Instructions for using `digest.db`](#head1) +[1. Instructions for using `digest.db`](#) -[2. Tables of the database](#head2) +[2. Tables of the database](#) -[3. Sample SQL queries](#head3) +[3. Sample SQL queries](#) -[4. Future steps](#head4) +[4. Future steps](#) -[5. Support for users](#head5) +[5. Support for users](#) -[6. Footnotes](#head6) +[6. Footnotes](#) -### [<a id="head1">1. Instructions for using `digest.db`</a>](#head1) +### 1. Instructions for using `digest.db` The database can be queried with `SQL` statements in four types of `SQLite` interfaces listed below. All of these interfaces are free of charge. They all support exporting the result of `SQL` queries in a `csv` flat file to be opened in a notebook, text or spreadsheet editor. @@ -38,9 +38,9 @@ The database can be connected directly in a Python script with the `sqlite3` pac Alternatively, one may export tables and results of `SQL` statements as `csv` flat files which could be loaded as `pandas` dataframes into a Python code for further processing. -[Back to Table of contents](#toc) +[Back to Table of contents](#) -### [<a id="head2">2. Tables of the database</a>](#head2) +### 2. Tables of the database #### 2.1 `text` @@ -66,9 +66,9 @@ The "section" table includes the titles of the _Digest_'s 432 thematic sections The "bko" table presents information related to the theory about the _Digest_'s compositional structure formulated by Friedrich Bluhme in 1820[<sup id="inline8">8</sup>](#fn8) and revised by Paul Krüger for Theodor Mommsen's edition of the _Digest_. The theory was accompanied by a tabular summary known as the Bluhme-Krüger Ordo (hence "bko") which was revised and expanded by Tony Honoré.[<sup id="inline9">9</sup>](#fn9) -[Back to Table of contents](#toc) +[Back to Table of contents](#) -### [<a id="head3">3. Sample SQL queries</a>](#head3) +### 3. Sample SQL queries There are some sample queries in the `SQL_queries.txt` file to assist users unfamiliar with the `SQL` query language. These queries are ready to be copy-pasted as a multi-line `SQL` statement into the interface of your choice. The queries can be customised by replacing the relevant values. Names of tables and their columns are fixed, but all other values can be customised. Please play around and [send a message](mailto:m.ribary@surrey.ac.uk) for [support](#head5-2). @@ -121,7 +121,7 @@ WHERE (t.text like '%proprieta%') AND (j.id = 23); [Back to Table of contents](#toc) -### [<a id="head4">4. Future steps</a>](#head4) +### 4. Future steps The current version of `digest.db` is intended to be polished with input from its users. While major flaws and inconsistencies in the data were captured during the pre-processing stage, it is expected that typographical errors and some inconsistencies remain. Please leave a comment or send an [email](mailto:m.ribary@surrey.ac.uk), if you spot an error. A reporting tool or a collaborative editing method will de added in due course. @@ -131,7 +131,7 @@ Currently there is no custom-made GUI for using `digest.db`. As the project and [Back to Table of contents](#toc) -### [<a id="head5">5. Support for users</a>](#head5) +### 5. Support for users #### 5.1 Feedback and collaborative development @@ -139,13 +139,13 @@ Please leave a comment or send an [email](mailto:m.ribary@surrey.ac.uk) with any In time, the database will receive a custom interface which builds on top the `SQLite` database and the `SQL` queries. The interface will be designed according to user feedback. Please let me know what you want to see in future releases and how the database could support your research better. -#### [<a id="head5-2">5.2 Support for SQL queries</a>](#head5-2) +#### 5.2 Support for SQL queries Please leave a comment or send an [email](mailto:m.ribary@surrey.ac.uk), if you would like to request a sample `SQL` query for your research, or if you need help with adjusting one of the existing queries. These queries will be continuously added to the `SQL_queries.txt` file. [Back to Table of contents](#toc) -### [<a id="head6">6. Footnotes</a>](#head6) +### 6. Footnotes [<sup id="fn1">1</sup>](#inline1) Peter Riedlberger and Günther Rosenbaum, eds. (2020): _Amanuensis_ V5.0. München. URL: http://www.riedlberger.de/08amanuensis.html [Last accessed on 19 May 2020] @@ -165,4 +165,4 @@ Please leave a comment or send an [email](mailto:m.ribary@surrey.ac.uk), if you [<sup id="fn9">9</sup>](#inline9) Tony Honoré, "Justinian's Digest: The distribution of authors and works to the three committees," _Roman Legal Tradition_ 3 (2006): 1-47. -[Back to Table of contents](#toc) \ No newline at end of file +[Back to Table of contents](#) \ No newline at end of file