Skip to content

Latest commit

 

History

History
87 lines (66 loc) · 3.94 KB

README.md

File metadata and controls

87 lines (66 loc) · 3.94 KB

🕸️ My personal website repo afinamore.io

It is powered by Hugo and Github pages, and its structure is a work in progress.

Specifically, I took the resume theme, which I extended/altered as it follows:

  • The navigation bar is completely re-designed from scratch, taking inspiration from Nina Zakharenko website which uses Beautiful Hugo
  • Added a new section to display my academic publications with (i) expand/collapse elements and (ii) some parameters in config.toml

📌 Todo

  • Add light/dark theme switch
  • Complete integration of blog posts
  • Related to the previous, extend the research section with detail on research areas of interest (adding some blog posts about it might also be beneficial)
  • Extend support of navbar to dropdown menus
  • Better integration of academic publications from a raw bibtex file

Folder structure

The key layout files are:

  • layout/_default/baseof.html : the raw skeleton of each page
  • layout/index.html : master hugo template of the home page (sections are shown/hidden based on config.toml setup)
  • layout/partials/nav.html : the navbar template
  • layout/partials/portfolio/academic_publications.html : the research papers template
  • layouts/single_page/academic_publications.html : separate page for details on research (only full research paper list) The other files are either layout/partials or layout/partials/portfolio

The key files for content are:

  • content/_index.md : the personal info for the "home" section in the home page
  • content/research/_index.md : research separate page
  • data/experience.json : personal detail about work experience
  • data/academic_publications.json : raw details on research papers

CSS and Javascripts:

  • assets/sass/main.scss : all styling rules (coloring variables at the top)
  • static/js/navbar.js : controls navbar item style wrt scrolling
  • static/js/pubs.js : expand/collapse control for research paper details

Development

  • To spawn a local server, run bash ./run.sh which is simply triggering hugo server -D --disableFastRender
  • To compile locally, run hugo which generate the content under /docs as from these instructions Note: Still unclear to me why locally the SCSS gets a hash as URL, and this breaks the layout
  • To deploy, create a script with the following
#!/bin/sh

# If a command fails then the deploy stops
set -e

printf "\033[0;32mDeploying updates to GitHub...\033[0m\n"

# Build the project.
hugo # if using a theme, replace with `hugo -t <YOURTHEME>`

# Go To Public folder
cd docs

# Add changes to git.
git add .

# Commit changes.
msg="rebuilding site $(date)"
if [ -n "$*" ]; then
	msg="$*"
fi
git commit -m "$msg"

# Push source and build repos.
git push # origin main

Reference links

Hugo:

  • Hugo-resume theme link
  • Organize content link

Styling:

Deployment:

  • How to register into google search engine link
  • How to configure godaddy domains: link