docs: Create anchor permalinks for titles

[rakyll]

It's impossible to give a link to a specific section. It'd be nice to create anchor links for h1...6 tags, the way Github is doing on md generated files.

[stephenplusplus]

Yeah, this is a nightmare in Angular because of the hash-based routing system. There are some hacks out there, I'll try to implement one tonight.

[silvolu]

Do we need Angular?

[stephenplusplus]

It's handling a lot of magic for us now, so yes based on using what we already have, but no, if we want to spend time to reimplement in another solution. I'm not sure we will be any better off, however, as we have to rely on hash based routing with any solution, and I'm not sure how well frameworks support double fragments - .io/gcloud-node/#/docs/datastore/dataset#get.

[silvolu]

Took a deeper look and I now understand :)

[ryanseys]

Why do we have to rely on hash based routing?

On Friday, September 5, 2014, Stephen Sawchuk notifications@github.com
wrote:

It's handling a lot of magic for us now, so yes based on using what we
already have, but no, if we want to spend time to reimplement in another
solution. I'm not sure we will be any better off, however, as we have to
rely on hash based routing with any solution, and I'm not sure how well
frameworks support double fragments -
.io/gcloud-node/#/docs/datastore/dataset#get.

—
Reply to this email directly or view it on GitHub
#184 (comment)
.

[stephenplusplus]

We can't do our own server side logic with github pages to route all non-static file requests to index.html.