tanous / website

Tarek Anous group website

Tarek Anous's group website

This Readme is copied and edited from Chris Mcfarland's group website github deployment page. Follow the link for more information.

This static website is built using the Academic Template for hugo. It is deployed by Netlify at www.tarek-ano.us.

New group members should follow this short tutorial in order add themselves to the website. This task should familiarize you with Package Management Systems for installing software, and git - the most common version control system in use today. If you haven't used these systems, I'd first read about them a little bit.

The two most common package management systems are apt (for linux/ubuntu) and brew (for MacOSX).

Here's a short tutorial on git.

This tutorial should also teach you a little bit about 'static website builders', although you wont be doing anything sophisticated.

Local deploy

1. Install Git, Hugo and Go (e.g. apt install git hugo go or brew install git hugo go).
2. Pull website & launch:

git clone https://github.com/tanous/website.git
cd website
hugo server -D

3. Vist at http://localhost:1313/

Adding yourself to the "People" page

Once you have the website deployed on your local machine, you can add yourself to the website.

1. Migrate to the list of authors, and copy my folder as a template:

cd content/authors
cp -r anous <YourLastName>

2. Edit your bio by deleting my info and adding yours (the comments in my bio should be sufficient to clarify what goes where, but feel free to ask):

cd <YourLastName>
nano _index.md

3. Replace my avatar.jpg with a picture of yourself (but keep the filename the same).

4. As long as the hugo server on your local machine continues to run, your edits will render in real time. Check out your page!

5. If all looks good, commit your changes, and push to github:

git add *     # adds all changes that you made to your commit (do just "git add _index.md avatar.jpg" if you edited other files)
git commit -m "Adding <YourLastName>"
git push

There you go! You'll find your new version of the website on github instantly, and www.tarek-ano.us will update shortly thereafter.

Troubleshooting

1. Hugo caches the theme and certain intermediate files/modules, which can sometimes cause bugs to persist even after you remove them. Purging the cache will often fix these issues, which is accomplished by running the command:

hugo mod clean

Adding a publication

To add a publication, use the academic CLI tool to create a new publication folder in the content/publications/ directory with

academic import --bibtex data/<NewPublication>.bib

See https://wowchemy.com/docs/content/publications/ for more information.