Skip to content

auxesis/jdpsy.org

Repository files navigation

jdpsy.org

This is the source for Jeroen Decates's clinic website.

screenshot of home page

How does this work?

  • jdpsy.org is served off Netlify. Netlify is a free website hosting system.
  • The jdpsy.org website is stored in a repository. A repository is a collection of files under a directory. A repository tracks all the changes you make to files in the repository. Your repository lives on GitHub.
  • The jdpsy.org website is built using a tool called Hugo. Hugo is a very simple system for building websites.
  • You make changes to the jdpsy.org website in a local copy of the repository. This local copy is sometimes called a clone.
  • When you make changes to the local copy, you must record the changes. We do this by making a commit. A commit is one or more changes (like adding an image, removing some text), with a description of the change. The description is helpful for remembering why you made a change.
  • When you've finished making your changes, you publish the website by syncing the repository back to GitHub.
  • GitHub Pages sees your changes, and publishes them so everyone else can see them at https://jdpsy.org.

First time setup

NOTE: You only need to do these steps once.

You need a GitHub account

If you don't have one already, sign up for a GitHub account.

This allows you to publish your changes to the website.

You need some software to get started

Download and install:

  • GitHub Desktop, to record your changes
  • Atom editor, to change the files
  • Ruby to see a local copy of the website

Set up your local copy of the site

In GitHub Desktop, clone the repository:

screenshot of cloning the repo

Select and clone the jdpsy.org repository:

screenshot of selecting the repo

Open the repository in terminal:

screenshot of launching terminal  in GitHub Desktop

Type sudo ./setup.sh into the terminal, and press enter:

screenshot of running setup script

How to make changes

NOTE: Make sure you have followed the setup steps before trying this.

See a local copy of the site

From GitHub Desktop, open the repository in terminal:

screenshot of launching terminal  in GitHub Desktop

Start up a local copy of the site by typing hugo server and pressing enter:

screenshot of starting hugo

Then go to http://localhost:1313/ in your browser:

screenshot of the dev site in the browser

Make some changes

Back in GitHub Desktop, open the repo in Atom:

screenshot of opening the repo in atom

Select the file you want to edit:

screenshot of selecting a file in atom

Make some changes to the text or HTML, and save:

screenshot of selecting a file in atom

See the changes in the browser by navigating to the page.

The website is built with Hugo, Bootstrap, and Font Awesome.

If you want to make changes to the page layout or the display of content, check out Bootstrap's excellent reference documentation.

You can browse icons on Font Awesome, and add elements to the page to use the icon:

<i class="fa fa-flag"></i>

Record your changes

Back in GitHub Desktop, switch to the Uncommitted Changes tab, and describe your changes:

screenshot of committing the change in GitHub Desktop

Then click the Commit button at the bottom of the window.

Publish your changes

To publish your changes to the real jdpsy.org, press the Sync button in the top right:

screenshot of selecting a file in atom

Go to https://jdpsy.org in your browser to see your changes.

About

Jeroen Decates's clinic website

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors