4. Full Annotation Instructions

1. Navigate in your terminal to the folder where you have saved the annotate folder within the AdArchive repository. For example, if you have saved the repository on your desktop, you would type: cd Desktop/AdArchive/annotate. (The annotate folder is its own repository within the AdArchive repository, so changes are treated separately).

2. Checkout the gh-pages branch with the command: git checkout gh-pages. If this is the first time you are using this branch, you may need to run git fetch first.

3. Create a new branch with the name of the issue you are annotating. For example, if you are annotating Sinister Wisdom issue 1, you would type: git checkout -b sinister_wisdom_1 (this command is a shortcut to both create a new branch and check it out)

4. Begin annotating. Under the #1 Select a Manifest heading (above), click on the issue that you will be annotating. Be sure to check which annotations have already been done so you are not duplicating your own or someone else’s work.

5. Once you have clicked on the issue that you will be annotating, a new viewer window will appear with multiple page images from that issue. Scroll to the bottom to find the first page of advertisement images, which is usually on the last 3 pages of the magazine issue. Click the first page of advertisement images.

6. Hit the full screen icon in the top right corner of the viewer to make the screen large enough to see the full page of advertisement images so it is big enough to select the annotations. To zoom in and out, place two fingers on your track pad and move fingers up and down.

7. Click on the speech balloons icon in the top left corner of the viewer window to open the annotation tools.

8. Select the rectangle annotation lasso.

9. Draw rectangle lasso around first annotation and release. When you release the lasso, a text box will pop up.

10. In the text box’s text field, enter who the advertisement is for (e.g.: “Soho 20”). If the advertisement title is different than the item that is being advertised, add the title of the advertisement in a line that follows (e.g.: “Title: Read Soho 20”). Normally the advertisement title and the item advertised are the same thing.

11. In the tag field, tag the item as an advertisement by typing “advertisement” into the text field.

12. Once you are done capturing the information required, hit Save to close window (or hit enter on your keyboard)

13. Follow the same process for all images that are a part of the advertisement. This includes logos and other illustrations. In the text box enter [Name of advertisement] advertisement image and in the tag field enter advertisement_image.

14. Repeat for all remaining advertisements for the issue. Do not include subscription forms, as these are not advertisements.

15. To save annotations, scroll down in the browser window past the viewer window to “#2 Save Annotations”. Click on “view cached annotation JSON’ button. A box will appear with JSON in it, organized in sequential order by page number.

16. At the bottom of this box, click on the Download [page number] JSON button.

17. The annotations will be saved to your downloads folder. Ensure that the file names are formatted with just the page number, followed by the “.json” extension, e.g. 0.json and not e.g. 0 (1).json. If not, rename them.

18. Copy the annotations file (its name will be [page number].json) and navigate to the annotate folder you have saved on your computer.

19. Open the ‘annotations’ folder within the ‘annotate’ folder.

20. Select the issue you’d like to save to.

21. Paste in the folder for the proper issue number.

22. Repeat for subsequent pages.

23. Next, you will need to clear the cached annotations from your browser storage. Scroll down to “#3 Store Annotations” step 6. In Chrome, right click on the page, select inspect>application>storage and then click on clear site data.

24. Next, return to the command window to stop the Jekyll serve command by typing: “CTRL-C”.

25. In the command line, store your annotations in subfolders and create a copy of the IIIF manifest by typing: bundle exec rake. (Note: If you encounter a problem in the process, or make a mistake, you can restart from scratch with the command git reset --hard. This will reset all of your changes to the latest commit.)

26. To commit your changes, type: git add --all and then git commit -m "annotations for sinister_wisdom_1"

27. To publish your changes to the website, merge your working branch with the gh-pages branch by checking out the gh-pages branch with git checkout gh-pages. If an error occurs in the merge process, abort the merge with git merge --abort, upload your working branch by checking it out and using the command git push -u origin [branch_name], and contact the repository administrator to complete the merge process.

28. If the merge is successful, push your changes to the gh-pages branch by typing: git push origin gh-pages. The website should update with your annotations within a few minutes. If you encounter any problems, please contact the repository administrator.