Skip to content

Automatic anchors for headings in wiki #380

Closed
saciervo opened this Issue Jun 11, 2012 · 95 comments
@saciervo

I miss a feature for wiki pages:

Headings in the README.md get automatically wrapped by an anchor. This makes it possible to link to a certain heading inside the document. In bigger documents this makes it way easier to navigate and to create a linked table of content.

Please consider to provide this feature in github wikis.

@bootstraponline
gollum member

This feature is in gollum (#343) however it's not yet deployed to github.com. I'm not sure when github.com's wiki code will be updated.

@jhilden
jhilden commented Aug 24, 2012

+1 Looking forward to that feature being deployed

@wspringer

+1 I could really really use this as well.

@kkweng
kkweng commented Sep 13, 2012

Would be very useful for efficiently getting people to exactly the right information, looking forward to deploy.

@adagios
adagios commented Sep 19, 2012

+1 I keep thinking that it already works on github wikis, and getting disappointed :)

@olivergierke

+1

@xeolabs
xeolabs commented Sep 23, 2012

+1

@ZER0
ZER0 commented Sep 25, 2012

+1

@ofhippo
ofhippo commented Sep 26, 2012

+1

@awangit
awangit commented Oct 1, 2012

+1

@AlertusTechnologiesLLC

+1 Been using MediaWiki Syntax on my wiki pages so I could have a TOC...
If you switch to MediaWiki, external images aren't supported in the wiki syntax. But, tags will work.

@justinforce

+1

@zcbenz
zcbenz commented Oct 4, 2012

Also +1, it's crucial for API references.

@yaymukund

+1 we've got a bunch of wikis that could really use this.. :D

@RWOverdijk

+1, still not there.

@benjamin-heasly

+1, this would be great.

@johnloy
johnloy commented Oct 19, 2012

Throwing in my +1 too :)

@kyleconroy

+1

@vbe
vbe commented Oct 29, 2012

+1

@isochronous

+1

@lantz
lantz commented Oct 31, 2012

+1

@jensk
jensk commented Oct 31, 2012

+1

@misprintt

+1

@ericbottard

+1

@fgeorgatos

+1

@RWOverdijk

I don't think that the amount of +1 posts is going to change the progress, it seems abandoned..

@lantz
lantz commented Nov 2, 2012
@nairdo
nairdo commented Nov 2, 2012

+1, also agree with @kkweng and @RWOverdijk

@bootstraponline
gollum member

Unfortunately GitHub has decided to not invest resources in keeping the .com wiki up to date. I wish I could help.

@jcsmorais

Already felt this need a few times!
Supporting this would be natural and deeply appreciated :)

@ManInTheBox

+1

@ssorallen

+1

@schaary
schaary commented Dec 10, 2012

+1

@andrewachen

+1

@evgeny-goldin

+1!

@webngt
webngt commented Dec 26, 2012

+1

@szivalj
szivalj commented Dec 31, 2012

+1 :)

@atz
atz commented Jan 2, 2013

+1

@duncan-bayne

+1

@JBaldachino

+1

@advoretsky

+1

@jucor
jucor commented Jan 4, 2013

+1

@mkcode
mkcode commented Jan 7, 2013

+1

@jessereynolds

+1

@auxesis
auxesis commented Jan 8, 2013

:+1:

@AlertusTechnologiesLLC

Hey what do you know this is now the most commented issue for github/gollem and probably one of the easiest to fix...

@bootstraponline
gollum member

I'd happily update the GitHub.com production wiki software if I had access. It's fixed in github/gollum however there doesn't appear to be any resources available for updating the GitHub.com wiki.

@cowboy
cowboy commented Jan 11, 2013

GITHUB WILL YOU PLEASE UPDATE THIS OMG

Also, please don't prefix anchors with #wiki-.

@tbranyen

Right now I'm doing it manually and it's quite frustrating. Anything we can do to help move this along?

@mkcode
@71104
71104 commented Jan 12, 2013

+1

@bootstraponline
gollum member

@tbranyen I think the only way to persuade GitHub to start investing in the production wiki again would be via social media. Even simple requests that have had publicity, such as CLA support, haven't been implemented. As far as I know, there's no one at GitHub actively improving the .com wiki and that's unlikely to change. Security fixes happen however wiki feature work and bug fixes that aren't security related don't get addressed.

@cowboy @mkcode I fixed this a while ago in the gem release.

@moechofe

+1

@tilusnet

+1

@Zearin
Zearin commented Jan 26, 2013

+1! :) :) :)

Idea

(This idea courtesy of @bootstraponline. Thanks!)

Everyone who has +1-ed this: Send a tweet to @github. Link them here.

They need to know where to focus their efforts. We can help!

But, why?

This is the wrong place, because it’s silo-ed away from the rest of GitHub itself. Many have said that Gollum already has the requested functionality (although I haven’t verified it personally). If that’s true, comments in this thread are “preaching to the choir”.

GitHub needs to hear about this—but not as a Gollum issue. As a GitHub issue.


  • Edit: Linked to GitHub’s Twitter page.
@bootstraponline
gollum member

@Zearin The feature has been in gollum for over 8 months. I think the Twitter campaign is a good idea.

@dfuentes77

+1
I tweeted them as well.
I'm shocked this isn't already working.

How many other inferior wikis have had this feature for years now.

@s1kx
s1kx commented Jan 31, 2013

+1, I might switch to GitLab because of this

@Macarse
Macarse commented Jan 31, 2013

+1

@71104
71104 commented Jan 31, 2013

How many +1's are needed before we actually get it implemented?

@jmc-88
jmc-88 commented Jan 31, 2013

+1

@Zearin
Zearin commented Feb 3, 2013

How many +1's are needed before we actually get it implemented?

@71104 That’s why we recommend sending tweets to GitHub on Twitter. It appears they’re not paying attention to this issue, or their gollum team is too silo-ed away from the main team.

@71104
71104 commented Feb 3, 2013

@Zearin done, thanks.

@bootstraponline
gollum member

It appears they’re not paying attention to this issue, or their gollum team is too silo-ed away from the main team.

I think they're aware of the issue. It's just there is no gollum team.

@avanderhoorn

@github What's happening here? Almost all the features of GitHub seem to get love and attention, are well implemented and thought through. Wiki seems to be the one exception. It seems like there has been no updates to the wiki system in what feels like 2 years!!!

Its not like the updates aren't there (Gollum is still being contributed to and developed), or lack of interest from the community (see the above as a simple example). The work arounds people have to do because of WIki's short coming are starting to become a joke (like having .md's in the main repository and have the wiki reference those because the editor is better there, plus history and management there works as expected). The wiki system is a great idea that feels servilely handy caped due to lack of love and attention.

PLEASE either give some love to it or remove it all together.

@RWOverdijk

I share @avanderhoorn's passion on this matter. I love the wiki.

@alangrafu

+1

@pocorall

+1

@c10b10
c10b10 commented Feb 11, 2013

+1

@webbushka

+1 and Tweeted

@bootstraponline
gollum member

It looks like GitHub responded. I'm willing to do the work as a volunteer to upgrade the production wiki. The code is closed source though so it has to be an employee.

@aspiers
aspiers commented Feb 12, 2013

Much as I adore GitHub, they still have a bit to learn about communication with their user community. Tweeting "We hear ya" as a reply to an individual tweet is very little use because it won't be seen by the majority of users who have +1'd this issue. The correct place to respond is this issue, which all the frustrated users will be watching.

Also, it seems that the issue tracker should implement a +1 button, to avoid an endless string of "+1" comments spamming the issue.

@davispuh

Actually I wrote to GitHub support here, mentioning couple of things which could be improved, including Gollum upgrade and also for better way for users to give feedback. But that was some time ago, still haven't heard back... Guess they're probably very busy :D

@jedsundwall

+1

@ghost
ghost commented Feb 15, 2013

+1

@ghost
ghost commented Feb 15, 2013

+1

@itaifrenkel

+1

@mohamed-75

+1

@gkos
gkos commented Feb 23, 2013

+1

@up
up commented Mar 1, 2013

+1

@robert-bor

+1

@stav
stav commented Mar 10, 2013

+1

@odino
odino commented Mar 12, 2013

:+1:

@ddines
ddines commented Mar 12, 2013

+1

@hez
hez commented Mar 13, 2013

+1

@holman
holman commented Mar 15, 2013

This is unrelated, but has anyone built Node on Linux? Looks like there's a good writeup here:

https://github.com/joyent/node/wiki/Installation#building-on-gnulinux-and-other-unix

Just kidding. Just wanted to point out the new anchored headers on GitHub wikis.

Sorry for the wait on this! There are a lot of aspects behind the scenes that led to the lag, and we've got some ideas on getting to a better place with Gollum in the future. Thanks for bearing with us!

@nschonni

@holman awesome, pick your prize from here http://letsmake.github.com/bettertogether/

PS: It would be nice if the headings weren't still wrapped in non-functioning <a> tags since the new anchors are creating their own.

@ghost
ghost commented Mar 15, 2013
@bootstraponline
gollum member

Sorry for the wait on this! There are a lot of aspects behind the scenes that led to the lag, and we've got some ideas on getting to a better place with Gollum in the future. Thanks for bearing with us!

Thanks for fixing this. Are you ready to share the plans with the community? It'd be great if the wiki on GitHub was actively developed. There are tons of .com specific bugs.

How do i stop recieveing

Click "Unwatch thread."

@holman
holman commented Mar 15, 2013

Are you ready to share the plans with the community?

I can't get into specifics at this time, unfortunately.

@nairdo
nairdo commented Mar 15, 2013

No need. It looks like they are working in my project's wiki. Thank you Github!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Something went wrong with that request. Please try again.