This extension introduces a range of specialized blocks that simplify the creation of presentations of datasets according to the DCAT standard. With the blocks you can list, search or filter datasets as well as provide a landing page for each dataset. The use cases ranges from creating a web for a single data provider with a few datasets to a full fledged regional or national dataportal with thousands of datasets. In addition there is also a few blocks that supports presenting ideas and showcases connected to datasets.
Using the extension involves three steps:
Step 1 - deciding on a blocks configuration¶
First, check the ready made examples to find a suitable starting point. Second, you will always need to provide a basic configuration containing:
- Which data catalog to show (provided by pointing to your instance of the Entrystore API).
- In case you want to have a landing page for each datasets you have to indicate the path to the page in the
Finally, you may want to turn on or off some functionality of your blocks via their parameters. See the reference section for details of what is possible.
The result of this step is that you have one or two snippets of HTML code ready to be inserted into one or two webpages. Below we see example 1:
<div data-entryscape="datasetStandaloneListLayout" data-entryscape-entrystore="_ES_API_"></div> <script src="https://static.cdn.entryscape.com/blocks/0.20/ext/opendata-sv.js"></script> <script src="https://static.cdn.entryscape.com/blocks/0.20/app.js"></script>
Note that you would have to replace the text
_EX_API_ with a link to a real EntryStore API.
Step 2 - integrating the blocks into your web¶
How this step is realized depends on which mechanism you use for maintaining your webbsite. The most common scenario is that you utilize a CMS (e.g. Wordpress, Drupal, EpiServer) where you can edit your pages.
When you edit a webpage in a CMS you are most likely presented with an authoring environment that looks like a word-processor. That means that you can write text without having to care about how the content you produce are expressed as HTML. However, to embedd the blocks you will need to insert raw HTML code, more specifically a few div elements and two scripts. Luckily, in many cases the authoring environment provides a way for you to do this, e.g. by allowing you to add a section / component / block of raw HTML code as a part of the webpage.
If there is no way to inser raw HTML code, or you cannot find it, we recommend that you contact someone in your organization or an external consultant that knows how to do this. It might be that the CMS configuration needs to be changed slightly or even that someone need to do some small development (in most cases this should not be needed).
Step 3 - Adjusting the design¶
After the integration you should see the result in your webpage(s), but it might need some tweaks from a design perspective. A typical scenario is that your web has a style guide that should be adheared to.
Adjusting the design is done by providing specific CSS rules that tweak fonts, colors, spacings etc. If you use a CMS there might be a possibility to provide the CSS rules as part of the webpage. Another alternative is to provide an external file with CSS rules that you point to as part of the raw HTML code you inserted in step 2.
Disregarding of the method you choose, you need to have knowledge of how to write these CSS rules. As an integral part of writing the CSS rules are how to make them apply to the right thing in the blocks driven user interface. This is accomplished by using the right classes. Currently there is no extensive documentation on which css classes to use, instead we encourage to use the developer mode of the browser and inspect the corresponding user interface. All classes that start with
esbRowExpand etc. are stable and are safe to use in CSS rules.