Macaw

The purpose of this page is to keep track of all things Macaw

Macaw on the Web

The BHL version of Macaw "in the cloud" is hosted by the Smithsonian Libraries and can be found at:
http://macaw.library.si.edu/

Requesting an Account

1. You must first create an Internet Archive account
2. Contact Bianca (crowleyb@si.edu) to get permission to add to the "biodiversity" collection. You do not necessarily need your own collection in IA.
3. Retrieve your Internet Archive API Key and Secret Key
4. Request an account for Macaw via https://docs.google.com/forms/d/1f2sRq8bkHHgIAXvKKrkMFV86oTlh0TsC70m3qA4hzBg/viewform we will create your account and send you further instructions.

Documentation

The documentation for Macaw are presented as Google Docs for ease of updating and collaboration. Though there is a lot here, they are incomplete and are still very much a "work in progress." If you find inconsistencies or have questions, please contact Joel at the email address below.

The URLs are listed in order of least information to most information.

• Quick Start Checklist (Under Review)
  This document contains a list of steps to use in Macaw. It's merely a checklist of steps.
  htt ps:docs.google.com/document/d/1klRRmw1JXVrLtuEsh84WLsi7k8dIo4T8PVQhZ-ol4TQ/edit?usp=sharing
  
  
• Mini-HowTo (Under Review) This contains more step-by-step information on using Macaw and entering metadata that satisfy the needs of BHL. Also contains screenshots of important steps in the process. htt ps:docs.google.com/document/d/1whTl3GNzoRbMkXKZQBVDp5KOVH7uRYSApXazDxRkfDY/edit?usp=sharing

• General User Documentation
  This is the detailed user documentation of all the components of Macaw.
  https://docs.google.com/document/d/1-_XCe2LmbroQfnOC1Y5_tNpAhzI1BOiFVjkJH_ykvak/edit?usp=sharing
  
  
• Installation Guide
  Detailed steps on setting up Macaw.
  https://docs.google.com/document/d/1ds5K2Nd0OutTVUBPhQVrsIemltd9IkQA6umjpNhH8Oo/edit?usp=sharing
  
  
• Administrators Guide
  Information for those who are managing a Macaw installation. Not nearly as complete as the General User documentation.
  https://docs.google.com/document/d/1dod9rWfAlfJWPsCZs1ZqJjI6K0kEziTHkC92wjqywKs/edit?usp=sharing
  
  
• Developers Guide
  For those developing modules, this has lots of goodies and code-related things. Not for the faint of heart!
  https://docs.google.com/document/d/1iIkKmvGAyaU_FlK3Bq4qgwlbzn9AEhFBQiOXYFvjrfM/edit?usp=sharing

Source Code

Macaw is Open Source! The source code can be found at: https://github.com/cajunjoel/macaw-book-metadata-tool

Discussion

There is a Google groups mailing list/forum that you can use to talk to other Macaw users. You can find it at:
https://groups.google.com/forum/#!forum/macaw-discussion

Other Questions?

If you have other questions, please contact Joel Richard at richardjm@si.edu