-
Notifications
You must be signed in to change notification settings - Fork 52
Technical
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 or contact anybody in the Bioschemas technical group for more information or help.
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 markup is no good if consuming applications cannot find it or parse it efficiently. Here are some general recommendations and pointers.
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 strongly recommend that all markup can be reached by crawling the website's sitemap.xml.
If possible, it's best to publish Bioschemas markup on statically rendered pages. This will make it available to the widest range of consumers. However, we understand that in various web frameworks and architecture this isn't realistically possible and markup needs to be added dynamically through Javascript. However, please be aware that this will make it available only to crawlers that implement headless rendering of pages before they scrape the schemas data.
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 sitemap.xml.
However, Google states in their guidelines that their 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.
Adding profile specific relations to BioChemEntity and DataRecord
- 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.