Academic Personal Website

A minimalist academic personal website built with Astro, ready for deployment to GitHub Pages.

Getting Started

Prerequisites

• Node.js 18+
• npm

Install & Run Locally

npm install
npm run dev

Open http://localhost:4321 in your browser.

Build

npm run build

The static output is generated in dist/.

Preview the Build

npm run preview

---

Deployment to GitHub Pages

1. Configure astro.config.mjs - replace username with your GitHub username and, if your repository is not named <username>.github.io, set base to your repo name:

   export default defineConfig({
     site: 'https://your-username.github.io',
     base: '/',          // or '/your-repo-name' if needed
   });

2. Push to GitHub - the included GitHub Actions workflow (.github/workflows/deploy.yml) will automatically build and deploy on every push to main.

3. Enable GitHub Pages in your repository settings:

   • Go to Settings > Pages
   • Source: GitHub Actions

---

Project Structure

/
|-- public/
|   |-- favicon.png
|   |-- avatar-placeholder.svg
|   |-- website_lgabriel.jpg
|   `-- website_lgabriel_nav.webp
|-- src/
|   |-- components/
|   |   |-- Header.astro       # Sticky top navigation bar
|   |   `-- Footer.astro       # Site footer with social links
|   |-- layouts/
|   |   |-- BaseLayout.astro   # Root HTML shell (head, body, header, footer)
|   |   |-- MarkdownLayout.astro
|   |   `-- PageLayout.astro   # Content page wrapper with optional heading
|   |-- pages/
|   |   |-- index.astro        # Homepage
|   |   |-- bio.astro          # Bio
|   |   |-- publications.astro # Publication list
|   |   `-- contact.astro      # Contact information
|   `-- styles/
|       `-- global.css         # Design tokens, reset, utility classes
|-- astro.config.mjs
|-- package.json
`-- tsconfig.json

Customisation

• Personal info: Update name, position, and content in each page under src/pages/.
• Navigation links: Edit the navLinks array in src/components/Header.astro.
• Colors & typography: Adjust CSS custom properties at the top of src/styles/global.css.
• New pages: Create a new .astro file in src/pages/ and add a link in Header.astro.