Join GitHub today
GitHub is home to over 31 million developers working together to host and review code, manage projects, and build software together.Sign up
This is a master page for information on all the technical aspects of publishing and consuming Bioschemas markup. This will grow over time. Please feel free
- to edit
- ask on the Bioschemas mailing list for more information
- or contact anybody in the Bioschemas technical group.
Bioschemas strongly recommends using JSON-LD to publish markup, as also recommended by Google. schema.org also allows RDFa and Microdata, but standardizing on JSON-LD allows Bioschemas example markup to be simpler and more consistent. JSON-LD also separates its markup from the page HTML, which may be better for scientific sites publishing large volumes of markup that may change relatively infrequently compared to the human-readable webpage.
Publishing Bioschemas markup
Make Bioschemas markup reachable
In principle, you should be able to publish Bioschemas markup in any of your webpages, much like any schema.org markup. This will always be true for general search engines such as Bing and Google, as and when they process Bioschemas markup. However, so that markup can be found by life sciences specific search engines and other applications, we recommend that if possible, all markup can be reached by crawling the website's
If this isn't possible, then Bioschemas markup should at least be discoverable through link following. This may reduce the number of consumers, since only those that implement link crawling will find it.
If markup isn't available through the sitemap.xml or link following, then its use will be restricted to applications that know to specifically crawl marked up page URLs (e.g. it won't be available for general life sciences search engines).
Does Bioschemas markup need to be published on the same page as the human readable content?
In principle, since JSON-LD separates semantic markup from the human readable HTML, it can be tempting to make the publishing process simpler by aggregating markup for many different entities and publishing it on pages separate from their human-readable representations. This may reduce the effort of publishing and the efficiency by which crawlers can find that markup, particularly if it referenced from the
However, Google states in their guidelines that there must be human readable content for that markup on the same page, in order to give the best possible general search experience. This requirement, which stems from the need to avoid misleading the user, may apply more to general Internet sites that can look to game the search system, rather than scientific data sites that are looking to provide useful data. Nonetheless, in order to make content discoverable by Google and similar search engines, we recommend that the markup always be on the same page as the associated human-readable content.
During the BioHackathon 2018 Paris it was explored if Compact Identifiers can be used as value for the
identifier property. This property has as valid value types Text and URL, and we looked into the question
if Compact Identifiers are valid URLs. This seems to be the case:
- Compact Identifiers are CURIEs (see this paper)
- CURIEs are URIs (see this specification)
- The type URLs includes URIs (see this page)
As a result, Bioschemas is interoperable with Compact Identifiers.
- The Bioschemas common crawl - how to access a common crawl for applications that need a large amount of collected Bioschemas markup but don't want to operate their own crawling facilities. Either this is collected by commoncrawl.org or published by a search engine gathering this information anyway, such as Buzzbang.