[[PageOutline(1-4,,pullout)]]
[wiki:HarriotConventions Conventions for editing]
[wiki:HarriotWorkflow Notes on the workflow]
= The Harriot online Project =
== Project info ==
The work of the English mathematician and philosopher Thomas Harriot (1560-1621) is amazingly broad, ranging from the concern with linguistic and ethnological questions to the theory of algebraic equations. In particular, topics of practical mathematics and natural philosophy that concerned also Galileo, such as fortification, shipbuilding, astronomy, optics, and mechanics, play a central role in Harriot's work. However, unlike his famous Italian contemporary, Harriot did not publish any of his scientific results, the only exception being a small report on his voyage to the New World that he undertook as versatile expert in the service of his first patron, Sir Walter Ralegh. Harriot's work therefore has to be reconstructed from his manuscripts. This fact has considerably hampered Harriot's reception, not only by his contemporaries, but also in the history of science.

Here, for the first time, a large selection from Harriot's manuscripts is made openly accessible through an electronic presentation: Harriot's notes on motion. Harriot left about 8,000 folio pages mainly containing his working notes and only few pages prepared for presentation (Add MSS 6782 - 6789 in the British Library and HMC 240, 241 in Petworth House, Sussex). The selection presented here contains about 350 folio pages preserved in the British Library. The folios have been chosen in a survey of the total of 8,000 pages by rough analysis of their contents in the attempt to produce a collection as complete as possible.

The notes document Harriot's work on the problem of motion in which he is primarily concerned with projectile motion and the motion of fall. The manuscripts are, however, highly unordered. Based on the results of scholarly work, the electronic presentation will in the near future be increasingly complemented with navigational tools that shall make the manuscripts more accessible. 


[http://echo.mpiwg-berlin.mpg.de/content/scientific_revolution/harriot Resources in ECHO]
== Online versions ==
 * [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/HSPGZ0AE Thomas Harriot, Mss. 6782]
 * [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/VWXURW4V Thomas Harriot, Mss. 6783]
 * [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/XT0KZ8QC Thomas Harriot, Mss. 6784]
 * [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/KN1CRTZ2 Thomas Harriot, Mss. 6785]
 * [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/TRMFCPMB Thomas Harriot, Mss. 6786]
 * [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/MAH52R5E Thomas Harriot, Mss. 6787]
 * [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/AYB35Z4D Thomas Harriot, Mss. 6788]
 * [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/0VGM2B80 Thomas Harriot, Mss. 6789]

* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/R1DY9HDM Harriot, Thomas, HMC 240 I, 1-170]
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/DRRCWU07 Harriot, Thomas, HMC 240 II, 171-253]
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/2649T4PH Harriot, Thomas, HMC 240 III, 254-321]
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/CKSNUDWF Harriot, Thomas, HMC 240 IV, 322-402]
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/928CQY8W Harriot, Thomas, HMC 240 V, 403-453]
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/W3V8W30U Harriot, Thomas, HMC 241 I, Algebra, geometry, calendar, conic sections]
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/ZAURCQY3 Harriot, Thomas, HMC 241 II, Calculations from the observations of Hannelius, Warner, Copernicus, Tycho Brahe, on the vernal & autumnal equinoxes, the solstices, orbit of the earth, length of the year etc.]
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/FKB80BKX Harriot, Thomas, HMC 241 III, Snell, Eratosthenes, Batavus. Kepler De stella martis]
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/N9KD9BFM Harriot, Thomas, HMC 241 IV, Drawings of constellations and miscellaneous calculations, etc., Iupiter's satellites]
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/1RN76C9P Harriot, Thomas, HMC 241 V, Triangles]
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/HE20QBY3 Harriot, Thomas, HMC 241 VIa, Projectiles, centre of gravity, reflexion of bodies]
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/C97A3X92 Harriot, Thomas, HMC 241 VIb, The doctrine of nautical triangles]
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/DSADGEXE Harriot, Thomas, HMC 241 VII, Comets of 1607 and 1618]
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/E3FVUFB5 Harriot, Thomas, HMC 241 VIII, Spots on the sun]
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/ND5A7WZT Harriot, Thomas, HMC 241 IX, The moon]
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuViewfull?url=/mpiwg/online/permanent/library/1B0KX1PP Harriot, Thomas, HMC 241 add., Two folios found amongst the Harriot papers]
== Subversion repository ==
As of September 2012, the project's files are also part of the MPIWG-MPDL Content Project's repository ([source:/trunk/texts/Harriot link]). This will make updating the repository or local copies much easier. The respective branch can be checked out by directing a Subversion client to {{{https://it-dev.mpiwg-berlin.mpg.de/svn/mpdl-project-content/trunk/texts/Harriot}}}. The structure of the repository remains the same:
 * [source:/trunk/texts/Harriot/Maps Maps] contains schematic maps of how the folios might be structured thematically
 * [source:/trunk/texts/Harriot/Transcripts Transcripts] contains transcriptions in XML files
 * [source:/trunk/texts/Harriot/Documents Documents] contains miscellaneous documents, e. g. typing conventions

== Versioned File Folders (deprecated as of September 2012) ==
At the MPIWG, versioned file folders are used to store maps and transcriptions. Users can download the current version or any older version of a document. If they decide to work on a document, it is recommended to download and lock the respective file so that no other user can work on it in the meantime.
 * [http://pythia.mpiwg-berlin.mpg.de/department1/harriotOnline/maps Maps] contains schematic maps of how the folios might be structured thematically
 * [http://pythia.mpiwg-berlin.mpg.de/department1/harriotOnline/transcripts Transcripts] contains transcriptions in XML files
 * [http://pythia.mpiwg-berlin.mpg.de/department1/harriotOnline/documents Documents] contains miscellaneous documents, e. g. typing conventions

== Maps ==
The maps are edited with the free (but not open source) editor [http://www.yworks.com/en/products_yed_about.html yEd]. The symbols for the maps are stored in palette (attached to this page), which makes sure that the right symbols are used.

=== Purpose of the maps ===
The present order of the pages in the folios is not correct. The maps serve as a secondary way to group the pages according to topics and to virtually connect pages that belong to the same subject. 

=== Export to interactive maps ===
There is also an experimental representation of the maps as an RDF graph ([http://euler.mpiwg-berlin.mpg.de/LodLive/?http://example.org/harriotOnt/HarriotGraph Enter here]). As of now, it is only accessible inside the institute.

The visualization is made with a tool called [http://blog.lodlive.it/ LodLive]), and it can also be queried by going to the [http://euler.mpiwg-berlin.mpg.de/LodLive/ query page]. Instructions how to use the tool are [https://it-dev.mpiwg-berlin.mpg.de/tracs/mpdl-project-content/raw-attachment/wiki/Harriot/using_lodlive.pdf attached to this page].

A thorough documentation will soon be available on [http://intern.mpiwg-berlin.mpg.de/digitalhumanities/it-group-projects/harriot/dokumentation Drupal], you can see [https://it-dev.mpiwg-berlin.mpg.de/tracs/metadataprovider/browser/GraphML2RDF%20(PYTHON) the source code] for the conversion script as well as check it out from the Mercurial repository with the command

{{{
hg clone https://it-dev.mpiwg-berlin.mpg.de/hg/graphML2RDF
}}}
=== Export to static maps ===
The maps can be exported to html and a [http://echo.mpiwg-berlin.mpg.de/content/scientific_revolution/harriot/maps/0_TOPICS.pt webpage] exists that displays all the maps and can be browsed.

Export from yEd has to be done manually for each map (there is no mass exporter), but the settings remain stable per session. The required steps are:
 1. Set the export directory (remains stable per session)
 1. Export as HTML-Imagemap with the following settings
  1. Clipping: Default (leave settings as they are)
  1. Image: Choose PNG and Antialiasing
  1. HTML: uncheck both boxes (open link in new window, export description as tooltip) and replace the existing template with the following code (adapted to ECHO's Zope environment):
{{{
<html metal:use-macro="here/main_template/macros/page">
<head><title></title>
<!-- insert date here -->
<style type="text/css">
.tooltip {
  font-size:10pt;
  background-color:#FFFFCC;
  border:1px solid black;
  padding:2px
}
</style>
</head>
<body>
<span metal:fill-slot="body">
<a target="_blank" href="./index.pt">Index of topics</a>&nbsp;&nbsp;&nbsp;<a target="_blank" href="./legendManuscripts.pt">Legend</a>

${DIAGRAM}
</span>
</body>
</html>
}}}
  1. The "Sources" section contains links to external sources, describing the persons (Wikipedia, DNB, VIAF &c). A little bit more code has to be kept in the page to make the little menu work that pops up when the name is being clicked:
{{{
<html metal:use-macro="here/main_template/macros/page">
  <head>
    <title>Empty Title</title>
<!-- insert date here -->
  </head>
  <body>
    <span metal:fill-slot="body">
      <style type="text/css">
        #authorMenu {display:none
        position:absolute;
        z-index:200; /* always on top*/
        padding-left: 35px;
        margin-left: 100px;
        margin-top: 12em;
        width: 250px;
        border: 2px solid rgba(128, 128, 128, 0.5);
        border-style: ridge;
        border-radius: 10px;
        background: rgba(128, 128, 128, 0.5);
        <!-- background-color: #777; -->
        color: white;
        font-size: 0.95em;
        }
      </style>
      <script type="text/javascript">
        function showElement(layer){
        var myLayer = document.getElementById(layer);
        if(myLayer.style.display=="none"){
        myLayer.style.display="block";
        myLayer.backgroundPosition="top";
        } else {
        myLayer.style.display="none";
        }
        }
      </script>
      <a target="_blank" href="./index.pt">Index of topics</a>&nbsp;&nbsp;&nbsp;<a target="_blank" href="./legendManuscripts.pt">Legend</a>
      <!-- insert menu here -->
      ${DIAGRAM}
    </span>
  </body>
</html>

}}}
  1. Furthermore, a different script has to be executed on these maps. It also requires the persons maps to be exported apart from the others (but maybe it would not hurt to have the css and javascript snippets in the other maps as well)
  1. Tiling: Do not activate Tiling
 1. To export all the maps, it is best to open all the files, start to export the first one (thereby setting above settings) and close that one. After that the following key sequence can be used: {{{Cmd-E, Return, Return, Cmd-W}}}. This will export and close each map.
 1. The resulting html files have to be edited, because a link to another map (i. e. another graphml file) will retain the extension graphml in the source code. A python script (attached to this page) takes care of this replacement and renames the files to the extension {{{*.pt}}}.
 1. The persons maps also require another script, because so far the information about the external links is not included. Right now, it resides in a csv-file which is then evaluated by a python script (also attached).
 1. The pt-files have to be copied to {{{tuxserve03:18021/echo_nav/echo_pages/content/scientific_revolution/harriot/maps}}}

=== Index of groups ===
There is now also an index page, generated directly from the graphml-files. This is an alphabetical list of all the group headings. The code is attached to this page.

== Transcriptions ==
Transcriptions are made directly in XML according to the ECHO schema ([wiki:echo-schema Documentation] (mostly German)). A beginner's guide will be online here soon. We also recommend the use of text editors that offer autocompletion in connection with the Schema which facilitates the editing. Attached is an XSD version of the schema which can be used while editing texts in Eclipse. To make it work properly, the following line has to be added to the {{{echo}}}-Tag at the top of the document:
{{{
xsi:schemaLocation="http://www.mpiwg-berlin.mpg.de/ns/echo/1.0/ harriot_xsd/echo.xsd "
}}}

As for formulas, it possible to use LaTeX markup. There is a script that converts that code into MathML ([https://it-dev.mpiwg-berlin.mpg.de/svn/digitizing-tools/scripts/mathml/ link]).

=== Macros ===
For both Eclipse and Emacs, a template has been created to quickly insert Commentaries and Translations. As this will later be fed into the annotation system, date and username are also inserted. Unfortunately, in Eclipse the date format is dependant on your machine's language settings. Both template files are in the SVN repository.