Github Project Wiki: separate page filename from page title

Posted by Marko Apfel on Geeks with Blogs See other posts from Geeks with Blogs or by Marko Apfel
Published on Mon, 26 Nov 2012 06:45:00 GMT Indexed on 2012/11/26 11:07 UTC
Read the original article Hit count: 319

Filed under:

Starting Point

In a former version of a project wiki on Github was a separation between the page filename and page title. So we build up our Wiki in a manner, that some well defined prefixes in the filename describe the overall context of the particular page.

Sample:

image

At the page themselves we used a title-tag on top of the page to get the title in the rendered HTML-page.

Here “= Tabelle: Anhänge bzw. Attachments” for the page with filename “data+table+Attachment”.

image

This was rendered as

image

We see:

  • there is a file “data+table+Attachment”
  • and a title-tag “= Tabelle: Anhänge bzw. Attachments”
  • as well as a rendering with the title “Tabelle: Anhänge bzw. Attachments”.

This was fine.

Problem

Now the Github-Wiki uses the title of the page as the filename and vice versa. This ends up in a cluttered file system and also in suppressing titles in the page themselves.

So this page

image

renders to

image

As we could see:

  • the title tag “= Organisation: IT-Infrastruktur” is not more rendered.
  • Instead the filename “organisation+IT Infrastructure” is choosen as the title for the page.

That sucks.

Solution

I reported this by Github again and hope for a fix.

© Geeks with Blogs or respective owner