Routing

In the following, we assume that your already have a web page where you want to embed the talque plugin. The serving url of you website is typically of the form

  • With html extension: https://example.com/path/to/page.html

  • No extension: https://example.com/path/to/page

  • Directory-style with trailing slash: https://example.com/path/to/page/

There are three ways the talque javascript plugin can integrate itself into the url structure of your website, namely

Path (HTML5) routing

This is the most advanced option. Here, urls are of the most natural form

https://example.com/path/to/page/talk-slug/gettysburg_address

The downside is that it requires special configuration from your web server so that all routes matching the regular expression https://example.com/path/to/page/[.*] are serving the same web page.

Hash routing

Here, urls use the hash mark (a.k.a. pound sign) # to separate your website and the talque-internal identifier of the content. That is, urls can be of the forms

https://example.com/path/to/page.html#talk-slug/gettysburg_address
https://example.com/path/to/page#talk-slug/gettysburg_address
https://example.com/path/to/page/#talk-slug/gettysburg_address

This works for any serving url and does not require any cooperation from your web server, but presents issues for link sharing and search engine indexing of your content.

Query parameter routing

In the final option the talque-internal identifiers are query parameters, that is, a question mark ? is added after your website url. That is, urls can be of the forms

https://example.com/path/to/page.html?talk-slug=gettysburg_address
https://example.com/path/to/page?talk-slug=gettysburg_address
https://example.com/path/to/page/?talk-slug=gettysburg_address

Your web server might interfere with the query parameters, but typically will just ignore them on content pages. In general, this does not require any specific web server configuration. Usually, we recommend this style of urls as it is both easy to set up and works well for link sharing and search engine indexing. This is also the default.