Home

Welcome to the Help pages for Sinopia, the LD4P2 Sandbox Environment.

How to get help

There are several ways to get help or report an issue. Use the one that works best for you:

• Post on the #sinopia Slack channel in the LD4 workspace (join the workspace)
• To ask your question privately, email [email protected]
• To report an issue directly to the development team, add an issue on our Waffle board
• For questions related to cataloging, send an email to the Sinopia catalogers listserv

Latest Release

Release 0.2.0 brings us to Milestone 2 "Profile Dress Rehearsal". Features include:

• Create profiles in Profile Editor and load into Linked Data Editor.
• Specify lookups via Questioning Authority in Profile Editor, and do lookups in the Linked Data Editor.

There's a demonstration Profile that shows how various Profile configurations will look in the Linked Data Editor. Click the Raw button and download the JSON. Then go to the [Sinopia Linked Data Editor] (http://sinopia.io/editor), click Import Profile, and upload the JSON file.

Full 0.2.0 release notes

What's Next

Work on Milestone 3 "Profile Opening Night" is in progress. Milestone 3 includes:

• User authentication
• Uploading Profiles to an "available profiles" menu. View mockups of profile loading workflow showing how a profile owner would add a new profile to Sinopia for use in the Linked Data Editor, and update an existing profile by uploading a new version.

Milestone 3 details

View details of all 5 milestones in the Technical Project Plan

FAQ

• Why does the Profile Editor keep saying "Part of the form are invalid" when I try to export my Profile? This message means that your Profile is missing some elements. A Profile has to have at least one Resource Template, and a Resource Template has to have at least one Property Template. There are also individual fields that are required; required fields are indicated with an asterisk (*). And fields that expect a URI require a value that's in the pattern of a URI.
• Does the Profile Editor generate JSON compatible with the Linked Data Editor? Yes.
• I'm getting errors when I try to load my Profile into the Linked Data Editor. Why? There are a few reasons: (1) Profiles created earlier in the development cycle may not be compatible. (2) Although the Profile Editor includes some validation, it is possible to create a profile that isn't completely compatible with the Linked Data Editor. For example, the Linked Data Editor expects "Author" to be longer than 2 characters, but the Profile Editor doesn't care. (3) You created a profile "by hand" and it doesn't conform to the profile schema. The Linked Data Editor should give you an informative error message if upload fails. Use any of the Help channels if you're having difficulties.
• How can you make sure a profile created outside Sinopia will be compatible? See the JSON Schema for Profiles, version 0.0.9. That page also explains how to use the ajv CLI library for JSON schema validation. You could run that (or a different validator) against your text-editor-created profile.
• Where are the LC profiles that are compatible with Sinopia? In the Sinopia Sample Profiles repository. Choose a profile, click Raw button, then export, then import that exported JSON file into the Linked Data Editor. After Milestone 3, these Profiles will be available directly in the Linked Data Editor.