docpad-plugin-link

Take the document'sid and generate the corresponding html link

Link Plugin for DocPad

Take the document'sid and generate the corresponding html link.

Prevents the breaking of links when a document is moved to a different directory or gets renamed while also keeping the link DRY since the link title and text is also pulled from the document's meta data.

npm install --save docpad-plugin-link
git clone https://github.com/oleersoy/docpad-plugin-link.git
cd docpad-plugin-link
npm install
make compile
make test

Override the following defaults when necessary:

# ...
{
    templateData:
        site:
            url: 'http://localhost:9778/base'
}
# ...

Run the tests to see the below executed.

Documents LocationDocument IDDocument titleCallReturned
root_document.md.eco1Root Meta Data Title for 1@link(1)<%- @link(1)%>
root_document.md.eco1Root Meta Data Title for 1@link(1, {title: "Custom Title 1"})<%- @link(1, {title: "Custom Title 1"})%>
root_document.md.eco1Root Meta Data Title for 1@link(1, {text: "Custom Text 1"})<%- @link(1, {text: "Custom Text 1"})%>
root_document.md.eco1Root Meta Data Title for 1@link(1, {title: "Custom Title 1", text: " Custom Text 1"})<%- @link(1, {title: "Custom Title 1", text: "Custom Text 1"})%>
sub/sub_document.md.eco2Sub Meta Data Title for 2@link(2)<%- @link(2)%>
sub/sub_document.md.eco2Sub Meta Data Title for 2@link(2, {title: "Custom Title 2"})<%- @link(2, {title: "Custom Title 2"})%>
sub/sub_document.md.eco2Sub Meta Data Title for 2@link(2, {text: "Custom Text 2"})<%- @link(2, {text: "Custom Text 2"})%>
sub/sub_document.md.eco2Sub Meta Data Title for 2@link(2, {title: "Custom Title 2", text: " Custom Text 2"})<%- @link(2, {title: "Custom Title 2", text: "Custom Text 2"})%>

See License.md file
Copyright © 2013+ Ole Ersoy