search

tararoys / simple-documentation-process

Using Jekyll to simplify capturing documentation
2 stars 2 forks source link

Where is this repository's website? #3

Open tararoys opened 7 years ago

tararoys commented 7 years ago

The problem:

Github changed where the 'go to github pages' button was in the years since I last looked at my github page.

I want to find out where that new button is so that I can see the published page.

Clues:

tararoys commented 7 years ago

Clues:

This is a jekyll blog. Years ago, during Dev Bootcamp, (around 2015) Github allowed you to publish websites by posting the code and articles for a jekyll blog. You then used the Github Pages system (basically pressing a button somewhere) and a webpage would appear. You could visit that webpage from your repository by going to the same place you created the page and pressing the link to the webpage.

I think all of this was under settings, back whe settings was on the right-hand side of the webpage and not across the top.

Time to go investigate how github pages works again.

tararoys commented 7 years ago

To create a webpage pertaining to a particular project, you have a branch in your project called github-pages.

My project has a branch called Github Pages.

Project Pages

Unlike user and organization Pages, Project Pages are kept in the same repository as the project they are for, except that the website content is stored in a specially named gh-pages branch or in a docs folder on the master branch. The content will be rendered using Jekyll, and the output will become available under a subpath of your user pages subdomain, such as username.github.io/project (unless a custom domain is specified). (source)[ https://jekyllrb.com/docs/github-pages/#project-pages]

Let's try tararoys.github.io/simple-documentation-process

This takes me to the project page for this repository. Good. This solves the question of "Where is this respository's website?"

It does not solve my unasked question of "where did the user-interface button for creating and accessing github pages go?" But I don't care for this issue. Moving on.

tararoys commented 7 years ago

The question of "where on the github user interface can I find out where the github pages website is has been answered. It is under the settings button. The left-most tab at the top of the page, the one with the gear beside it.

On that page about halfway down is a box that says

GitHub Pages Your site is published at http://tararoys.github.io/simple-documentation-process/ GitHub Pages is designed to host your personal, organization, or project pages from a GitHub repository.

Source Your GitHub Pages site is currently being built from the gh-pages branch. Learn more. gh-pages branch Save

https://github.com/tararoys/simple-documentation-process/settings