Add link to root directory

[whitneyit]

Currently, the htmlPath function correctly returns a series of links to child directories of a resource, but it does not provide a link to the "root" folder.

For example. Given you have navigated to "/foo/bar", the following html is created:

<h1>
    /
    <a href="/foo">foo</a>
    /
    <a href="/bar">bar</a>
</h1>

Would you guys be open to a PR that would simply prepend the following "<a href="/">~</a>" to what is being returned by htmlPath so as the generated html would look like this:

<h1>
    <a href="/">~</a>
    /
    <a href="/foo">foo</a>
    /
    <a href="/foo/bar">bar</a>
</h1>

This way there is a quick link back to the root folder of the directory that is being served.

[dougwilson]

I'm not sure if ~ makes sense (especially since that signifies "user's home directory" in linux-like stuff). What does Apache do (this is modeled after Apache)?

[whitneyit]

Yea I just chose the tilde cause nothing else really fit. The apache variant doesn't include a breadcrumb. If you want some examples just google "mp3 apache index of".

We could recycle one of the icons and serve that instead?

[dougwilson]

If you want some examples just google "mp3 apache index of".

Ooo, good idea!

We could recycle one of the icons and serve that instead?

You mean use an icon for that path component? That could probably work. My only other thought was a ".", which is so tiny and probably no one would notice, or maybe a word? I do agree we should add the root link, though :) Just trying to think of a good way to fit it in.

[whitneyit]

Yea a word seems simple enough, maybe, "root", "index", or something like that. Also, what the name of the root folder? So if you're serving from ~/Code/project the example above could be [project] / [foo] / [bar]. I'm not a total fan of that but it's an option.

In regards to icons, If you checkout the breadcrumbs on the apple site, they use their logo as the to go to the home page. So using an icon their isn't totally unacceptable.

[whitneyit]

How about we just use ~. I chose it cause it means home as you said and that's what you're doing, navigating home. If there are any other complaints or pull requests it can be addressed there. Until then, how about we merge this instead of it getting forgotten.

[dougwilson]

Until then, how about we merge this instead of it getting forgotten.

It doesn't get forgotten :) Issues like this stay in my inbox until they are resolved. We'll probably simply use an image. Perhaps drive.png, or if you think of a better one from this list: http://www.famfamfam.com/lab/icons/silk/previews/index_abc.png

[whitneyit]

Yea drive.png works for me. Do you want me to create a PR?

[dougwilson]

lol, I'm just going to use ~

[whitneyit]

lol. Cheers

[dougwilson]

Published as 1.6.0