ArCo Lab Website

Applied AI research in medicine
Universita Campus Bio-Medico di Roma

Jekyll · GitHub Pages · Static deployment

About

This repository contains the public website of ArCo Lab, the Unit of Artificial Intelligence and Computer Systems at Universita Campus Bio-Medico di Roma.

The site is a static Jekyll website. It presents the lab's people, research projects, publications, educational activities, news, and contact information. It is designed to be hosted under the University's domain through the custom GitHub Actions deployment workflow.

Website sections

• Home - Lab overview, research highlights, selected recent publications, projects, and team.
• Team - Researcher profiles, interests, biographies, and related publications.
• Projects - Active and completed research projects.
• Publications - Searchable publications with keyword, project, and year filters.
• Education - Courses and teaching activities.
• News - Editorial updates and research announcements.
• Contact - Lab contact details and institutional links.

Repository structure

_pages/                  Main pages and team profiles
_projects/               Project pages generated from the project sheet
_data/                   Generated site data
_bibliography/           Generated publication bibliography
assets/                  Published images, branding, styles, and scripts
scripts/                 Content synchronization and writeback scripts
shared/                  Local CSV sources and ignored configuration files
update_the_website/      Content update documentation
.github/workflows/       Build and deployment automation

Local development

The supported local environment is Docker. Start the development server with:

docker compose up --build

The site is available at http://localhost:8080.

For a production-style build:

docker compose run --rm jekyll bundle exec jekyll build --trace

The generated site is written to _site/, which is ignored by Git.

Updating content

Team, Projects, Publications, News, and Education are maintained through shared Google Sheets and Drive folders. Collaborators should use the English content update guide.

The technical workflow and section-specific notes are in update_the_website/. Generated files should not be edited manually: synchronization scripts regenerate them from the shared sources.

Local service-account credentials, sync configuration files, upload folders, and CSV working copies are ignored by Git and must never be committed.

Deployment

Pushing site changes to main triggers .github/workflows/deploy.yml. The workflow builds the Jekyll site and publishes the static artifact for GitHub Pages.

Design and identity

The ArCo Lab visual identity is stored in assets/branding/arco/. The main logo is used by the website and this README.