Skip to content

Commit

Permalink
tutorial
Browse files Browse the repository at this point in the history
  • Loading branch information
ahb108 committed Jan 24, 2016
1 parent e0a0580 commit e6db7cd
Show file tree
Hide file tree
Showing 2 changed files with 154 additions and 118 deletions.
60 changes: 39 additions & 21 deletions template.html
Original file line number Diff line number Diff line change
Expand Up @@ -165,23 +165,31 @@ <h4>Input any radiocarbon dates in this report:</h4>
<!-- Modal start -->
<div class="modal fade" id="myModal" tabindex="-1" role="dialog" aria-labelledby="myModalLabel" aria-hidden="true">
<div class="modal-dialog">
<!-- Modal header -->
<div class="modal-header">
<h3>Gathering radiocarbon dates from fieldwork reports</h3>
</div>
<!-- Modal header -->
<div class="modal-header">
<h3>Gathering radiocarbon dates from fieldwork reports</h3>
</div>

<!-- Step 1 of the tutorial -->
<div id="0" class="modal-body" style="display:none">
<!-- Step 1 of the tutorial -->
<div id="0" class="modal-body" style="display:none">
<p>
This project asks you to look through fieldwork reports written by commerical
archaeological units across the UK who conduct desktop assessments, watching briefs,
surveys and full-scale excavations in advance of modern development projects.
Radiocarbon dates are sometimes taken as part of this work, but have as yet not been gathered systematically from these reports.
The tasks for this crowd-sourcing project can be completed on a desktop computer,
laptop or tablet. You can use any web browser, although
we recommend Firefox for the best report-searching functions. For any given task, you will be presented with one multi-page fieldwork report. Scroll through it until you find mention of a radiocarbon date. We are
looking for the following information for each date (if available):
</p>
<div id="1" class="modal-body" style="display:none">
<p>
This project asks you to look through fieldwork reports written by commerical
archaeological units across the UK. The tasks can be completed on a desktop computer,
laptop or tablet. You can use any web browser, although
we recommend Firefox for the best report-searching functions. For any given task, you will be presented with one multi-page fieldwork report. Scroll through it until you find mention of a radiocarbon date. We are
looking for the following information for each date (if available):
You will see that we wish you to fill in information about any dates in the spreadhseet columns provided below the report.
Brief remarks on the intended role of each column are provided below:
</p>
<ol>
<li>
LabCode: This is the code assigned by the radiocarbone laboratory.
LabCode: This is the code assigned by the radiocarbon laboratory.
For example, for the first date in the example image below your could write "SUERC-16897 (GU-16061)".
</li>
<li>
Expand All @@ -198,6 +206,17 @@ <h3>Gathering radiocarbon dates from fieldwork reports</h3>
dC13: This is a common extra measurement used to correct the sampel for different fractions of different carbon isotopes. It is often referred to as "δ13C and in ‰ units".
Please simply put the decimal number, not any unit symbols etc. So for example, for the first date in the image below, you would put "-22.2" in the dC13 column.
</li>
</ol>
<img src="http://micropasts-other.s3.amazonaws.com/other/exampledates.png" class="img-polaroid" alt="An example of two radiocarbon mentioned in a fieldwork report." width="50%"/>
</div>

<div id="2" class="modal-body" style="display:none">
<p>
You will see that we wish you to fill in information about any dates in the spreadhseet columns provided below the report.
Brief remarks on the intended role of each column are provided below:
</p>
<ol>

<li>
Material: Please enter the material the sample was taken on. For example this is often "bone" or "charcoal" or "grain".
Please also put any informaiton about the species, for example "wheat","human" or "oak". Always retain the original wording: if the species is "Hordeum" which refers to barley (as in the example below), please write "Hordeum".
Expand All @@ -220,27 +239,26 @@ <h3>Gathering radiocarbon dates from fieldwork reports</h3>
<img src="http://micropasts-other.s3.amazonaws.com/other/exampledates.png" class="img-polaroid" alt="An example of two radiocarbon mentioned in a fieldwork report." width="50%"/>
</div>

<!-- Step 2 of the tutorial -->
<div id="1" class="modal-body" style="display:none">
<div id="3" class="modal-body" style="display:none">
<p>
Just a few more tips before you start:
</p>
<ol>
<li>
Sometimes dates are not as nicely tabulated as in the previous example image.
Sometimes instead they are just mentioned in the main text. In such cases,
Sometimes dates are not as nicely tabulated as in the previous example image.
Sometimes instead they are just mentioned in the main text. In such cases,
just do your best to add whatever information about the date that you can find in the text.
</li>
<li>
With the Firefox browser and some others, you can use the search function to fin those places in the text which have radiocarbon dates.
This often quicker than reading through the whole text which can sometimes be quite long.
With the Firefox browser and some others, you can use the search function to fin those places in the text which have radiocarbon dates.
This often quicker than reading through the whole text which can sometimes be quite long.
For example you could search the text for the word "radiocarbon" or for the "±" symbol./li>
<li>
If for one of the columns in your spreadsheet you cannot find information (e.g. if no mention is made of dC13 values),
If for one of the columns in your spreadsheet you cannot find information (e.g. if no mention is made of dC13 values),
then just leave that column blank in what you submit.
</li>
<li>
If you find no dates whatsoever in the text, please take a second look through the text, but if you are sure then just submit a blank spreadsheet.
If you find no dates whatsoever in the text, please take a second look through the text, but if you are sure then just submit a blank spreadsheet.
We have sought to exclude most reports that have no mention whatsoever of a radiocarbon date, but some will remain that do not have any.
</li>
</ol>
Expand Down Expand Up @@ -285,7 +303,7 @@ <h3>Gathering radiocarbon dates from fieldwork reports</h3>
$("#prevBtn").show();
}

if (step == 1) {
if (step == 3) {
$("#nextBtn").hide();
$("#startContrib").show();
}
Expand Down
212 changes: 115 additions & 97 deletions tutorial.html
Original file line number Diff line number Diff line change
Expand Up @@ -10,114 +10,132 @@ <h3>Gathering radiocarbon dates from fieldwork reports</h3>
<div id="0" class="modal-body" style="display:none">
<p>
This project asks you to look through fieldwork reports written by commerical
archaeological units across the UK. The tasks can be completed on a desktop computer,
archaeological units across the UK who conduct desktop assessments, watching briefs,
surveys and full-scale excavations in advance of modern development projects.
Radiocarbon dates are sometimes taken as part of this work, but have as yet not been gathered systematically from these reports.
The tasks for this crowd-sourcing project can be completed on a desktop computer,
laptop or tablet. You can use any web browser, although
we recommend Firefox for the best report-searching functions. For any given task, you will be presented with one multi-page fieldwork report. Scroll through it until you find mention of a radiocarbon date. We are
looking for the following information for each date (if available):
</p>
<ol>
<li>
LabCode: This is the code assigned by the radiocarbone laboratory.
For example, for the first date in the example image below your could write "SUERC-16897 (GU-16061)".
</li>
<li>
AgeBP: This is probably the tricky bit. We are looking for the 'uncalibrated' date if possible, seomtimes call the ' C14 Age BP' (BP is before present) of the
'conventional age' or the 'uncalibrated age'. The date is often followed by a "±" symbol and then a measure of its accuracy or error (see below).
For the first date in the example image below, the AgeBP would be "915". Sometimes a 'calibrated' date or dates are mentioned (often expressed as a range BC/AD).
You can put these in the Comments column, but please look for an uncalibrated date (which should be present most of the time) to place in the AgeBP column
(or otherwise leave the column blank)./li>
<li>
Error: This is the instrument error associated with the uncalibrated radiocarbon measurment, usually express immediately after a ± symbol.
For example in the first date in the example below, you might write "35".
</li>
<li>
dC13: This is a common extra measurement used to correct the sampel for different fractions of different carbon isotopes. It is often referred to as "δ13C and in ‰ units".
Please simply put the decimal number, not any unit symbols etc. So for example, for the first date in the image below, you would put "-22.2" in the dC13 column.
</li>
<li>
Material: Please enter the material the sample was taken on. For example this is often "bone" or "charcoal" or "grain".
Please also put any informaiton about the species, for example "wheat","human" or "oak". Always retain the original wording: if the species is "Hordeum" which refers to barley (as in the example below), please write "Hordeum".
If it is says "barley", write "barley". Try to separate material and species by a colon, so for example "grain: Hordeum".
</li>
<li>
SiteName: Please give the name of the site here, complete with county name as well if present
(hint: of the site name is in th title of the report)
</li>
<li>
SiteContext: This is for anything relating to the feature on a site from which the sample was taken
(e.g. "outer ring ditch", "pit 236" or, in the example below, "context 4/5")
</li>
<li>
Comments: You make your own remarks here if you like and/or add further information about
a particular date you think is useful. For example, sometimes the type of bone (e.g. radius,
ulna) will be mentioned, or a field sample number.
</li>
</ol>
<img src="http://micropasts-other.s3.amazonaws.com/other/exampledates.png" class="img-polaroid" alt="An example of two radiocarbon mentioned in a fieldwork report." width="50%"/>
</div>
<div id="1" class="modal-body" style="display:none">
<p>
You will see that we wish you to fill in information about any dates in the spreadhseet columns provided below the report.
Brief remarks on the intended role of each column are provided below:
</p>
<ol>
<li>
LabCode: This is the code assigned by the radiocarbon laboratory.
For example, for the first date in the example image below your could write "SUERC-16897 (GU-16061)".
</li>
<li>
AgeBP: This is probably the tricky bit. We are looking for the 'uncalibrated' date if possible, seomtimes call the ' C14 Age BP' (BP is before present) of the
'conventional age' or the 'uncalibrated age'. The date is often followed by a "±" symbol and then a measure of its accuracy or error (see below).
For the first date in the example image below, the AgeBP would be "915". Sometimes a 'calibrated' date or dates are mentioned (often expressed as a range BC/AD).
You can put these in the Comments column, but please look for an uncalibrated date (which should be present most of the time) to place in the AgeBP column
(or otherwise leave the column blank)./li>
<li>
Error: This is the instrument error associated with the uncalibrated radiocarbon measurment, usually express immediately after a ± symbol.
For example in the first date in the example below, you might write "35".
</li>
<li>
dC13: This is a common extra measurement used to correct the sampel for different fractions of different carbon isotopes. It is often referred to as "δ13C and in ‰ units".
Please simply put the decimal number, not any unit symbols etc. So for example, for the first date in the image below, you would put "-22.2" in the dC13 column.
</li>
</ol>
<img src="http://micropasts-other.s3.amazonaws.com/other/exampledates.png" class="img-polaroid" alt="An example of two radiocarbon mentioned in a fieldwork report." width="50%"/>
</div>

<!-- Step 2 of the tutorial -->
<div id="1" class="modal-body" style="display:none">
<p>
Just a few more tips before you start:
</p>
<ol>
<li>
Sometimes dates are not as nicely tabulated as in the previous example image.
Sometimes instead they are just mentioned in the main text. In such cases,
just do your best to add whatever information about the date that you can find in the text.
</li>
<li>
With the Firefox browser and some others, you can use the search function to fin those places in the text which have radiocarbon dates.
This often quicker than reading through the whole text which can sometimes be quite long.
For example you could search the text for the word "radiocarbon" or for the "±" symbol./li>
<li>
If for one of the columns in your spreadsheet you cannot find information (e.g. if no mention is made of dC13 values),
then just leave that column blank in what you submit.
</li>
<li>
If you find no dates whatsoever in the text, please take a second look through the text, but if you are sure then just submit a blank spreadsheet.
We have sought to exclude most reports that have no mention whatsoever of a radiocarbon date, but some will remain that do not have any.
</li>
</ol>
</div>
<div id="2" class="modal-body" style="display:none">
<p>
You will see that we wish you to fill in information about any dates in the spreadhseet columns provided below the report.
Brief remarks on the intended role of each column are provided below:
</p>
<ol>

<li>
Material: Please enter the material the sample was taken on. For example this is often "bone" or "charcoal" or "grain".
Please also put any informaiton about the species, for example "wheat","human" or "oak". Always retain the original wording: if the species is "Hordeum" which refers to barley (as in the example below), please write "Hordeum".
If it is says "barley", write "barley". Try to separate material and species by a colon, so for example "grain: Hordeum".
</li>
<li>
SiteName: Please give the name of the site here, complete with county name as well if present
(hint: of the site name is in th title of the report)
</li>
<li>
SiteContext: This is for anything relating to the feature on a site from which the sample was taken
(e.g. "outer ring ditch", "pit 236" or, in the example below, "context 4/5")
</li>
<li>
Comments: You make your own remarks here if you like and/or add further information about
a particular date you think is useful. For example, sometimes the type of bone (e.g. radius,
ulna) will be mentioned, or a field sample number.
</li>
</ol>
<img src="http://micropasts-other.s3.amazonaws.com/other/exampledates.png" class="img-polaroid" alt="An example of two radiocarbon mentioned in a fieldwork report." width="50%"/>
</div>

<!-- End of stepped modal body -->
<div id="3" class="modal-body" style="display:none">
<p>
Just a few more tips before you start:
</p>
<ol>
<li>
Sometimes dates are not as nicely tabulated as in the previous example image.
Sometimes instead they are just mentioned in the main text. In such cases,
just do your best to add whatever information about the date that you can find in the text.
</li>
<li>
With the Firefox browser and some others, you can use the search function to fin those places in the text which have radiocarbon dates.
This often quicker than reading through the whole text which can sometimes be quite long.
For example you could search the text for the word "radiocarbon" or for the "±" symbol./li>
<li>
If for one of the columns in your spreadsheet you cannot find information (e.g. if no mention is made of dC13 values),
then just leave that column blank in what you submit.
</li>
<li>
If you find no dates whatsoever in the text, please take a second look through the text, but if you are sure then just submit a blank spreadsheet.
We have sought to exclude most reports that have no mention whatsoever of a radiocarbon date, but some will remain that do not have any.
</li>
</ol>
</div>

<!-- Modal footer -->
<div class="modal-footer">
<a id="prevBtn" href="#" onclick="showStep('prev')" class="btn btn-default">Previous</a>
<a id="nextBtn" href="#" onclick="showStep('next')" class="btn btn-success">Next</a>
<button id="startContrib" data-dismiss="modal" class="btn btn-primary" style="display:none"/>
<i class="glyphicon glyphicon-thumbs-up"></i> Let's start!</a>
<!-- End of stepped modal body -->

<!-- Modal footer -->
<div class="modal-footer">
<a id="prevBtn" href="#" onclick="showStep('prev')" class="btn btn-default">Previous</a>
<a id="nextBtn" href="#" onclick="showStep('next')" class="btn btn-success">Next</a>
<button id="startContrib" data-dismiss="modal" class="btn btn-primary" style="display:none"/>
<i class="glyphicon glyphicon-thumbs-up"></i> Let's start!</a>
</div>
</div>
</div>
</div>
</div>

<script>
var step = -1;
function showStep(action) {
$("#" + step).hide();
if (action == 'next') {
step = step + 1;
}
if (action == 'prev') {
step = step - 1;
}
if (step == 0) {
$("#prevBtn").hide();
} else {
$("#prevBtn").show();
}
<script>
var step = -1;
function showStep(action) {
$("#" + step).hide();
if (action == 'next') {
step = step + 1;
}
if (action == 'prev') {
step = step - 1;
}
if (step == 0) {
$("#prevBtn").hide();
} else {
$("#prevBtn").show();
}

if (step == 1) {
$("#nextBtn").hide();
$("#startContrib").show();
if (step == 3) {
$("#nextBtn").hide();
$("#startContrib").show();
}
$("#" + step).show();
}
$("#" + step).show();
}

showStep('next');
$("#modal").modal('show');
</script>
showStep('next');
$("#modal").modal('show');
</script>

0 comments on commit e6db7cd

Please sign in to comment.