This is the source for Jeroen Decates's clinic website.
- 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.
NOTE: You only need to do these steps once.
If you don't have one already, sign up for a GitHub account.
This allows you to publish your changes to the website.
Download and install:
- GitHub Desktop, to record your changes
- Atom editor, to change the files
- Ruby to see a local copy of the website
In GitHub Desktop, clone the repository:
Select and clone the jdpsy.org repository:
Open the repository in terminal:
Type sudo ./setup.sh into the terminal, and press enter:
NOTE: Make sure you have followed the setup steps before trying this.
From GitHub Desktop, open the repository in terminal:
Start up a local copy of the site by typing hugo server and pressing enter:
Then go to http://localhost:1313/ in your browser:
Back in GitHub Desktop, open the repo in Atom:
Select the file you want to edit:
Make some changes to the text or HTML, and save:
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>Back in GitHub Desktop, switch to the Uncommitted Changes tab, and describe your changes:
Then click the Commit button at the bottom of the window.
To publish your changes to the real jdpsy.org, press the Sync button in the top right:
Go to https://jdpsy.org in your browser to see your changes.