====== Bookmark Plugin ======

---- plugin ----
description: Insert a link anchor into the page
author     : Otto Vainio
email      : otto@valjakko.net
type       : Syntax
lastupdate : 2020-07-14
compatible : Frusterick Manners, Greebo, Hogfather
depends    :
conflicts  :
similar    : anchor
tags       : bookmark, links, anchor

downloadurl: https://github.com/oiv/dokuwiki_bookmark/archive/master.zip
bugtracker : 
sourcerepo : 
donationurl: 
----

===== Description =====

With this plugin you can insert a bookmark to your page. The format is

  <BOOKMARK:bookmarkname>

This will insert code 

<code>
<a name='bookmarkname' id='bookmarkname'></a>
</code>

To link to the bookmark from the same page (i.e. to use the bookmark as an anchor link within the page), use this syntax:

<code>
[[namespace:page_name#bookmarkname|anchor_text]]
</code>

Where anchor_text is the text-link your visitors will see.

===== Installation =====

Install with Plugin Manager

===== Feature request =====

==== Optional Class tag ====

Suggestion: add an option to specify a class for a bookmark, to provide for easy CSS styling of the anchor_text. For example, %%<BOOKMARK:bookmarkname:classname|anchor_text>%% to produce <a name='bookmarkname' id='bookmarkname' class='classname'>anchor text</a>.

Use case: **%%<BOOKMARK:myterm:glossary|expanded term name>%%** so that I could style all the //glossary// terms.

==== Allow space and dash in bookmarkname ====

Suggestion: by allowing the space and dash characters in a bookmarkname, we can then refer to them in a natural way without having to use an alias. For example, %%[[#Open step]]%% could refer to %%<BOOKMARK:open step>%%. Where currently we would have to write %%[[#openstep|Open step]]%% to refer to %%<BOOKMARK:openstep>%%.