Code Issues Pull requests Activity Actions

No description

Astro 87.9%
TypeScript 6.5%
CSS 4.4%
JavaScript 0.6%
TeX 0.6%

Find a file

valentin sentis 7a59d7a69c All checks were successful Deploy portfolio / deploy (push) Successful in 55s Details test runner		2026年06月13日 17:46:52 +02:00
.forgejo/workflows	Actualiser .forgejo/workflows/deploy.yml	2026年05月31日 23:25:26 +02:00
.vscode	initialization	2026年04月15日 23:13:45 +02:00
public	initialization	2026年04月15日 23:13:45 +02:00
src	ortho change	2026年04月16日 00:43:07 +02:00
.gitignore	initialization	2026年04月15日 23:13:45 +02:00
astro.config.mjs	change config astro	2026年04月16日 12:01:32 +02:00
dockerfile	ci: add forgejo actions deploy workflow	2026年04月15日 23:37:53 +02:00
jblzz-portfolio.yaml	ci: add forgejo actions deploy workflow	2026年04月15日 23:37:53 +02:00
LICENSE	initialization	2026年04月15日 23:13:45 +02:00
package-lock.json	initialization	2026年04月15日 23:13:45 +02:00
package.json	initialization	2026年04月15日 23:13:45 +02:00
README.md	initialization	2026年04月15日 23:13:45 +02:00
tsconfig.json	initialization	2026年04月15日 23:13:45 +02:00

README.md

Astro Scholar

A clean, modern Astro portfolio template for researchers, professors, students, and academic teams.

Lighthouse

Lighthouse score showing 100 across all categories

Why This Template

Most portfolio templates look generic. This one is built for academic storytelling:

Blog posts for ideas, notes, and essays
Project pages for research work
Publications section from BibTeX
Team and author profiles
Search and generated OG images

Built with Astro for speed, static output, and straightforward deployment.

What You Get

Astro + MDX content workflow
Blog with table of contents and reading-friendly layout
Projects and publications pages
Team page and author data model
RSS feed and sitemap generation
Search indexing via Pagefind
GitHub Pages deployment workflow
PR preview deployment workflow

Quick Start

Clone the repository.
Install dependencies.
Run the dev server.

npm install
npm run dev

Then open http://localhost:4321/astro-scholar

Commands

Command	Description
`npm run dev`	Start local dev server
`npm run build`	Build production site
`npm run preview`	Preview production build
`npm run astro -- <command>`	Run Astro CLI commands

Customization Guide

Update these files first:

src/consts.ts: site title and global constants
src/data/authors.json: author profiles
src/data/projects.json: project entries
src/data/publications.bib: publication list
src/content/blog/*.md: blog posts
src/styles/global.css: theme and typography

Layout and components:

src/layouts/BlogPost.astro: post layout
src/components/Header.astro: top navigation
src/components/Footer.astro: footer

Deployment

This repo is ready for GitHub Pages.

main branch deploys via .github/workflows/website-deploy.yml
Pull requests deploy preview sites via .github/workflows/preview.yml

Base path is configured in astro.config.mjs:

default: /astro-scholar
PR preview: /astro-scholar/pr-previews/<PR_NUMBER>

Project Structure

src/
	components/ Reusable UI components
	content/blog/ Markdown blog content
	data/ Authors, projects, publications
	layouts/ Page layouts
	pages/ Route files
	styles/ Global styles
	utils/ Utility helpers
public/
	fonts/ Webfonts and static assets

Community

Contributing guide: .github/CONTRIBUTING.md
Code of conduct: .github/CODE_OF_CONDUCT.md
Security policy: .github/SECURITY.md
Pull request template: .github/pull_request_template.md

Feedback & Suggestions

If you have any suggestions/feedback, you can contact me via my email. Alternatively, feel free to open an issue if you find bugs or want to request new features.