Cilogi guides contain a variety of links. This tutorial explains them and lets you create some to try out.
The types of link are
- Audio links. Audio links are like normal Markdown links, looking like
[text](<file>)where file might be
the-road-to-the-isles.mp3. The file doesn't contain any directory information but does contain the file extension.
The main feature of audio links is that an embedded audio player will be created, rather than a link. As we saw in the tour tutorial this is useful if we're building audio tours, or want audio available for any particular page.
- Internal links. Internal links are to other pages in the guide, and take special forms, similar to the audio link, but without the embedding. The forms are:
[text](page/<index>)for indexed pages, with index being a positive integer. There is no extension needed.
[text](image/<name>)for an image, where name is the (globally unique) file name, such as
flower.jpg. The extension is needed and
flower.jpgis not the same as
[text](tour/<name>)where name is the Id of the tour supplied when the tour was created.
[text](listing/<name>)where name is the Id of the listing supplied when the listing was created.
[text](map/<name>)where name is the Id of a map, supplied when the map was created.
- Wiki links.
[text](/wiki/<name>)where the name is that of a Wikipedia page. So for example a Wikipedia address
/wiki/Oak. The Wikipedia page will be formatted for the guide and presented with the standard headers and menus in place so that it seems to be an integral component of the guide.
- External links. These are links to other websites which, if followed, will leave the guide.
Its convenient to insert links into the text of a page. For instance, if a visitor is reading a page about a fern in the Main Range it might make sense to reference a related plant in the Kibble Palace. Page text including
see [name of plant](page/375) in the [Kibble Palace](page/201) is enough to provide these links for visitors.