traumverloren/how-to-readme-guestbook.md

## how-to-readme-guestbook.md

      
    Raw
  

              how-to-readme-guestbook.md
            
          
    How to Create a Guestbook for Your Github Personal Readme!

To create a "guestbook", like this we can use the image hosting & commenting abilities of Github Gists ftw! ✨
Create a Gist to Host Your Guestbook & Image


Log into Github


Go to https://gist.github.com


Select "+" in the top right corner of the toolbar to create a new gist and save it as public gist.


Then, get an image to use for your link to "Sign your guestbook". I went to https://gifcities.org/ to find the perfect geocities era gif.


Save the image locally.


Clone the gist:
# Replace <hash> with your gist's hash!!!
git clone https://gist.github.com/<hash>.git # with https
git clone git@gist.github.com:<hash>.git     # or with ssh


Add your image to your gist's repository:
git add guestbook.gif


Commit the image:
git commit -m "Add image"


Update gist:
git push origin master


Note: Steps 6-9 above are adapted from this wonderful and helpful gist!
Create a Github Personal Readme


Back at your github profile, https://github.com/YOUR_USERNAME, create a repo that is named: YOUR_USERNAME.


In that repo, create a README.md file.


Add your Guestbook Gist to your Personal Readme


Add this HTML code snippet to README.md:
<p align="center">
  <a href="https://gist.github.com/traumverloren/<HASH>">
    <img src="<YOUR IMAGE PATH GOES HERE!>" alt="Click here to sign my guestbook!">
  </a>
</p>


Replace the link in the a with your gist's URL!
<a href="https://gist.github.com/traumverloren/<HASH>">


Replace the image src with the one from your gist! (You'll need to inspect the page in the browser)
<img src="<YOUR IMAGE PATH GOES HERE!>" alt="Click here to sign my guestbook!">


Save it!


Now check out your github profile page and bask in the glory of your own guestbook! Tada!  ✨


Let me know if you create one, and I'll sign it!  😊 🖊️ 📓