URL structure
Conzept is mainly based around URLs and iframes. Conzept tries to make each (first-order) content view linkable using the below URL parameters and URL action types.
URL parameters
There are various parameters available to structure URLs.
parameter | description | default value |
---|---|---|
l | language | “en” |
lv | language variant (currently only applies to Chinese languages) | “zh-my” |
t | action-type | “string” |
ds | active datasource-set | - |
d | active datasource list | “wikipedia,wikidata” |
sortby | result sorting key | “relevance-desc” |
i | entity ID (such as the Wikidata Q-identifier) | - |
u | URL-string | - |
s | sidebar visibility | true |
v | view-mode requested, can be “desktop” or “mobile” | (note: automatically determined by the device type, but can be overruled with this parameter) |
c | custom data field (its format is not specified) | - |
singleuse | prevents permanently storing the datasources activated by the URL datasources-parameter (this is useful for recursive Conzept views, such as used in presentations) | false |
query | structured search query in JSON | - |
commands | command API DSL code in Scheme Lisp (as used for presentations) | - |
URL action types
The types parameter (“t”) in Conzept URLs indicated what type of content should be loaded.
The following action-types are available:
type | argument data-type | description | comment |
---|---|---|---|
string | search-term string | string-based search in the active datasources | |
wikipedia-qid | Wikidata Qid | request the Wikipedia or the Wikidata page of an entity (in that order) | |
link | URL | setup a content pane and load the URL into the content pane | |
link-split | URL | setup two content panes and load the URL into the first content pane, in the second-content pane load the Wikipedia page for the search-string | |
articles | search-term string | (only used internally) to update the sidebar with a new string-search (and not update the content area) | |
random | (none) | (only used internally) to load a random Wikipedia topic | |
wander | search-term string | loads the video-app to stream a series of YouTube videos | |
presentation | search-term string | creates a presentation (if the topic refers to a Wikidata topic) | |
geospatial | custom-geo-data string | search by geopoint (TODO: geoshape, geobox) | creates a geographical query (together with the custom-parameter string: lat;lon;radius) |
example URLs
Here are some example URLs:
- conze.pt/explore/Semantic_Web (Minimal URL with a search-string. The user-language will be based on: the stored language setting, the browser language or simply fallback to English.)
- conze.pt/explore/Semantic%20web?l=en&ds=science&t=string&sortby=date-desc&s=true (newest “science” datasource-set search)
- conze.pt/explore/Semantic_Web?l=en&t=string&s=true (“default datasource” search for the English language)
- conze.pt/explore/Semantic_Web?l=de&t=string&s=true (“default datasource” search for the German language)
- conze.pt/explore/?l=en&t=wikipedia-qid&i=Q5483435&s=true (load a certain Wikidata Qid topic. This will try to load it as a Wikipedia article, or else fallback to showing the Wikidata page.)
- conze.pt/explore/Semantic_Web?l=en&t=link&i=Q54837&u=/app/video/#/search/"Semantic_web" (Loads the video-app link in the content pane.)
- conze.pt/explore/Semantic_Web?l=de&t=link-split&i=Q54837&u=/app/links/?l=de&t=Semantic_Web&s=true (Link-split example loading the link-graph app link, for the German language.)
- conze.pt/explore/Semantic_Web?l=en&t=presentation (Creates a presentation based on the search-string, if the topic also has an associated Wikidata Qid)
- conze.pt/explore/history?l=en&d=europeana&t=string&filterby=video&sortby=distance-asc&datemin=1900-07-01&datemax=2024-12-01&geofilter=37.98803;23.73168;50000;GR&batchsize=5&c=37.989166,23.732222 (search for the term “history”, in the “Europeana” datasource, for videos, within 50km radius of a location in Athens, and published within a certain date-range)
×
>
<