loading...

Publishing an organization homepage on Github Pages

createdd profile image Daniel Deutsch ・3 min read

Publishing an organization homepage on Github Pages

➡️ Github Repo is available here ⬅️

I am organizing a local group meetup of FreeCodeCamp called FreeCodeCamp Vienna. Months ago we decided to create a simple homepage to represent the group and it's progress online, but we never seemed to find the time to do it. Following the idea "better a quick homepage than no homepage at all" I decided to create one and publish it on Github Pages. Not only does it allow us to host our static page, but also serves as a perfect example for how easy something can be published online.

📄 Table of contents


"Opportunities Don’t Come Knocking On The Door. They Present Themselves When You Knock The Door Down!" – Greg Plitt

Name your repository

When publishing to Github Pages choosing the right repository name is crucial.

This page from Github explains it perfectly:

img

Therefore you need to name the repository exactly like the organization with ".github.io" at the end.

gif

Build your Homepage

After creating the repository build your homepage with HTML, CSS and Javascript.

Tip: I was using codepen during development. It is REPL and allows you to receive instant feedback from the code you are writing.

In order to speed up the layout process and add cool features I was using Materializecss. I have used it in the past and always had been happy with the results.

Put your Code on Github

Next, put your files on Github follwing the instructions.

Be sure to have the files on your "Master" branch

img

And choose the source of your Github Pages for the master branch.

Organization pages need the source files in the Master branch according to Github.

Set the source for your Github Pages

gif

Your settings should look like this:

img

See your amazing homepage at the provided link

Follow the provided link or type your organization name with ".github.io" in the URL bar.

gif

See the result for FreeCodeCamp Vienna

https://fccvienna.github.io/

See the building process on Youtube

img

Thanks for reading my article! Feel free to leave any feedback!

Posted on by:

Discussion

markdown guide