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
1
https://example.com/path/to/page/talk-slug/gettysburg_address
Copied!
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 
1
https://example.com/path/to/page.html#talk-slug/gettysburg_address
2
https://example.com/path/to/page#talk-slug/gettysburg_address
3
https://example.com/path/to/page/#talk-slug/gettysburg_address
Copied!
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
1
https://example.com/path/to/page.html?talk-slug=gettysburg_address
2
https://example.com/path/to/page?talk-slug=gettysburg_address
3
https://example.com/path/to/page/?talk-slug=gettysburg_address
Copied!
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.

Old Javascript Plugin - Previous

Introduction

Next - Old Javascript Plugin

Installation

Last modified 3yr ago

Copy link

Contents