This is the core website code for the Hard-to-Reach Population Methods Research Group (HPMRG).
It based on an Academic style organizational template using the Hugo Academic theme. It is based on the work of of Qingyuan Zhao who deserved the credit for both creating the template and also publishing it so that others can benefit from it. Thank you, Qingyuan Zhao! See his post for a guide.
Based on Qingyuan's work, I decided to use Hugo. It is renowned as "the world's fastest framework for building websites". I use the Academic theme for Hugo as it implements many features for academic researchers.
It helps to have Hugo installed locally as you can compile the website and see what you will get. Installing Hugo in Mac OS X is straightforward with homebrew. Simply run
brew install hugoFirst, clone this repository. I put mine in "handcock.github.io". Rename it to <git hub ID>.github.io
You can preview the website by running
hugo server --baseURL https://localhost:1313/from the website directory (e.g., "handcock.github.io"). This builds the website and creates a local web server to host it. It generates a link (the default is https://localhost:1313/) which can be pasted into a web browser. In the background, the hugo server also detects any change to the content and updates the website automatically.
The files are all writen as text files in markdown. The content sub-folder contains all the Markdown files
for website content.
├── content
│ ├── authors
│ ├── featured
│ ├── group
│ ├── home
│ ├── post
│ ├── project
│ ├── publication
│ ├── research
│ ├── talk
│ └── teaching
Most of its sub-directories correspond to a
section of my webpage (take a look at it); in particular, home corresponds to the
homepage of your website. Another unique folder is the authors,
which contains basic information about the website owner and all other
authors (not needed for a personal website). The publication corresponds to each of my publications.
Basically, you will edit the text files in each of these sub-directiries to change them to ones that are for you (as now they are all for me!).
See its documentation for more information.
Commit your website as a repository on github (with <git hub ID>.github.io as a name).
After successfully committed, go to your repository and click on the “Settings” on the top right, then scroll down to the "Pages" section. Under "Build and deployment" set the branch to "gh-pages" and "Save".
After a minute a published link will appear on the page and it is live.
See [the official documentation(https://gohugo.io/hosting-and-deployment/hosting-on-github/) for how to do other things. Note that the
.github/workflows/gh-pages.yml is already set up and you need not change it.