# RevLog Edition Tool

- Edition Tool, Virtual Research Environment

- Name: AskSten Scriptorium

- Requirements:
 - Usability:
  - Easy-to-use
  - Plug&Play
  - local
  - GUI
  - collaborative
  - auto-save, ctrl-z (?)
 - I/O: standard formats and models, possibility to import in Omeka S

## Steps

### 0) Text

Form (text's metadata):
  * Title
  * Author (Wikidata URI)
  * Date of origin (Wikidata URI)
  * Place of origin
  * Language
  * Direction of the script
  * Notes
  * Editor(s)

```xml
<teiHeader>
    <fileDesc>
        <titleStmt>
            <title><!-- title of the resource --></title>
        </titleStmt>
        <publicationStmt>
            <p><!-- Information about distribution of the resource--></p>
        </publicationStmt>
        <sourceDesc>
            <p><!-- Information about source from which the resource derives --></p>
        </sourceDesc>
    </fileDesc>
</teiHeader>
```
### 1) Recensio (=Witnesses)

Add witness form:

- Ms Identifier
    - Settlement
    - Repository
    - Id
- Contents...
- Physical Description
    - Form (e.g. codex)
    - Material: parchment|paper
    - Extent
    - Layout:
        - Columns
        - Lines
    - Hands:
- Images: URL (IIIF) or PDF

```xml
<msDesc>
 <msIdentifier>
  <settlement>Oxford</settlement>
  <repository>Bodleian Library</repository>
  <idno type="Bod">MS Poet. Rawl. D. 169.</idno>
 </msIdentifier>
 <msContents>
  <msItem>
   <author>Geoffrey Chaucer</author>
   <title>The Canterbury Tales</title>
  </msItem>
 </msContents>
 <physDesc>
  <objectDesc>
   <p>A parchment codex of 136 folios, measuring approx
       28 by 19 inches, and containing 24 quires.</p>
   <p>The pages are margined and ruled throughout.</p>
   <p>Four hands have been identified in the manuscript: the first 44
       folios being written in two cursive anglicana scripts, while the
       remainder is for the most part in a mixed secretary hand.</p>
  </objectDesc>
 </physDesc>
</msDesc>
```
Desiderata:
  * [x] Choose siglum of witness 
  * [ ] Witnesses: add input field folios (e.g. ff. 59ra-61vb)
  * [ ] Add section "Editions" => add existing edition with this fields: author, title, editor, publisher, year of publication, place of publication, pages
  * [ ] Import options: txt, doc/docx, xml/tei, latex (?)

### 2) Collatio

- [ ] automatic marking of variations
- [x] automatic completion of text (tab)
- [ ] automatic selection of text (right click)
- [ ] dealing with punctuation
- [ ] define collation's sensibility (punctuation, brackets, format, case, spaces, language specific options)
- [ ] navigation
- [ ] add folio/page beginning
- [ ] add column beginning
- [ ] add line beginning
- [ ] tricky: transpositions
- [ ] tricky: big texts => automatic split
- [ ] export collation
- [ ] mark entities and add Wikidata (persons, places, institutions, references, quotations)
- [ ] select more than one cell
- [ ] merge cells
- [ ] add another row (as another witness) for Editor(s) emendationes and conjectures

#### Text internal history

- [x] addition [= new column]
    - [ ] iteration
- [x] omission [= missing value for cell]
    - [ ] deficit [diff. with om.?]
- [x]substitution [= another reading in cell]
- [x] alteration [= another reading in cell]
    - [ ] delevit
    - [ ] erasit
    - [ ] expunxit
    - [ ] praem.
    - [ ] supplevit
    - [ ] adnot.
    - [ ] subl.
- [ ] inversion (words, passages) [check]
    - [ ] inv.
    - [ ] transp. [how]
- [ ] _Saut du même au même_
    - [ ] backward = dittography
    - [ ] forward = omission
- [ ] a.c. and p.c. [how? divide cell: a.c. and p.c.] + corr.
- [ ] sed del. et corr. mg. [?]

- **notes on notes**:
    - alia manu
    - mg. /sub. lin. / sup. lin. / inf. / sup.
    - hom. (for omissions)
    - lectio dubia
    - sic

- **Text external history**
    - illegible => lacuna: the ms once contained something that has disappeared (can take the aspect of an omissions in the copies)
    - corruption [?]

#### Buttons to add

- **Tags**:
    - Alteration: [del.] [eras.] [exp.] [praem.] [suppl.] [adnot.] [subl.] [corr. => a.c + p.c.]
    - Notes: [a.m.] [mg.] [sub. lin.] [sup. lin.] [inf.] [sup.] [hom.] (for omissions) [sic]
    - Ms: [illeg.] [lacuna] [lec. dub]
- **Comments**:
    - pre :〈words〉 before the lemma/reading text.
    - post:〈words〉 after the lemma/reading text.
    - prewit:〈words〉 before the list of witnesses for the lemma/reading.
    - postwit:〈words〉 after the list of witnesses for the lemma/reading.


### 3) Classification and Stemma Codicum

1. Presentation of errors/variants in a table
2. Presentation of errors/variants in a list


### 4) Editorial Decisions

- [ ] Add apparatus (critical, sources)
- [ ] Apparatus settings (positive/negative, in line/block, direction)

### 5) Critical Edition

- [ ] Add translation
- [ ] Add semantic comments (stand-off)


### 6) Visualisation

 1. PDF (LaTeX ekdosis)
 2. HTML (XSLT)