FormingWorlds
diff --git a/‎README.md‎
Lines changed: 67 additions & 20 deletions b/‎README.md‎
Lines changed: 67 additions & 20 deletions
diff --git a/‎_config.yml‎
Lines changed: 15 additions & 3 deletions b/‎_config.yml‎
Lines changed: 15 additions & 3 deletions
diff --git a/‎_data/settings.yml‎
Lines changed: 8 additions & 44 deletions b/‎_data/settings.yml‎
Lines changed: 8 additions & 44 deletions
@@ -1,33 +1,80 @@
-# Website [proteus-framework.org](https://proteus-framework.org)
+# PROTEUS Framework Website
 
-## How to edit the page
+Source for [proteus-framework.org](https://proteus-framework.org), the website of the PROTEUS coupled planet evolution framework.
 
-Explanations for deployment and local testing are here:
-https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll
+Built with [Jekyll](https://jekyllrb.com/) and hosted on GitHub Pages.
 
-Also useful for jekyll itself: https://jekyllrb.com/
+## Site structure
 
-The order of making changes to the website is as follows:
-- Create a new branch
-- Add the feature or fix
-- Create a pull request
-- Upon merge into `main` the website will be updated automatically
+| Path | What it does |
+|------|-------------|
+| `_pages/` | Markdown pages: modules, demos, publications, people, etc. |
+| `_includes/home.html` | Homepage content (hero + module overview) |
+| `_includes/components/teams/team-carousel-2.html` | People cards and team listing |
+| `_includes/header.html` | Navbar |
+| `_includes/footer.html` | Footer |
+| `_layouts/default.html` | Base HTML layout (head, scripts, theme detection) |
+| `_data/settings.yml` | Central config: menu items, footer links, social links, SEO |
+| `assets/styles/custom/_styles.scss` | All custom CSS (colours, dark/light mode, layout) |
+| `assets/img/faces/` | Team photos (AVIF format, 600x600) |
+| `assets/img/` | Other images (hero, logos, icons) |
 
-There are more tips and tricks specifically related to the used template in `_README.md`.
+## How to edit the website
 
-## How to test the page locally
+### Workflow
 
-### Install jekyll
-```
-gem install bundler jekyll
+1. Create a new branch from `main`
+2. Make your changes
+3. Test locally (see below)
+4. Open a pull request
+5. Once merged into `main`, the website updates automatically via GitHub Pages
+
+### Common tasks
+
+**Edit page text**: Open the relevant file in `_pages/` (e.g. `publications.md`, `modules.md`) and edit the markdown/HTML content.
+
+**Add or update a team member**: Edit `_includes/components/teams/team-carousel-2.html`. Copy an existing card block and update the name, role, photo path, links, and research topics. Photos go in `assets/img/faces/` as AVIF, ideally 600x600.
+
+**Change navigation or footer links**: Edit `_data/settings.yml`.
+
+**Change colours or styling**: Edit `assets/styles/custom/_styles.scss`. The site uses CSS custom properties (e.g. `var(--accent)`) defined at the top of that file for both dark and light themes.
+
+## Local development
+
+### Prerequisites
+
+You need Ruby and Bundler. On macOS, the system Ruby is outdated, so install a current version first:
+
+```sh
+brew install ruby
 ```
 
-On Macs there is already an outdated ruby version installed, which interferes with this. To solve this, reinstall ruby through `brew` and symlink it in your `.zshrc` (it will print out the required commands for this at the end of the installation). Once that is done and you have `ruby` and `gem` up-to-date on your system (+ `gem install github-pages`), the command above will function as expected.
+After installation, follow the instructions Homebrew prints to add the new Ruby to your `PATH` (typically adding a line to `~/.zshrc`). Then restart your terminal and install Bundler:
 
-### Display the local version of the page
+```sh
+gem install bundler
 ```
+
+### Running the site locally
+
+```sh
 cd FormingWorlds.github.io
-bundle install
+bundle install        # install dependencies (first time only)
 bundle exec jekyll serve
-````
-=> Now browse to `http://localhost:4000`
+```
+
+Open [http://localhost:4000](http://localhost:4000) in your browser. The site rebuilds automatically when you save changes to most files (except `_config.yml`, which requires restarting the server).
+
+### Troubleshooting
+
+- **`bundle install` fails**: Make sure you are using the Homebrew Ruby, not the macOS system Ruby. Run `which ruby` to check.
+- **Styles not updating**: SCSS changes require Jekyll to recompile. If live reload is not picking them up, restart the server.
+- **`_config.yml` changes not showing**: This file is only read at startup. Stop the server (Ctrl+C) and run `bundle exec jekyll serve` again.
+
+## Technical notes
+
+- **Theme**: Based on Argon Design System (Bootstrap 4, Creative Tim). Heavily customised.
+- **Dark/light mode**: Dark is the default. Toggle via the sun/moon button in the navbar. Preference is stored in `localStorage` and respects `prefers-color-scheme` when no preference is set.
+- **Images**: Team photos are in AVIF format for smaller file sizes. If adding new photos, convert to AVIF at 600x600 and use `object-position: top` in the card CSS so faces are not cropped.
+- **Publications**: Maintained as a static list in `_pages/publications.md`. No build-time data fetching.
+- **Redirects**: Some legacy paths (`/papers/`, `/blog/`, `/contact/`) redirect to current pages via front matter redirects in `_pages/`.
@@ -5,11 +5,22 @@ site: PROTEUS Framework
 domain: formingworlds.github.io
 
 title: PROTEUS Framework
+description: "Open-source framework for simulating the coupled interior-atmosphere evolution of rocky planets, from magma oceans to habitable worlds."
+lang: en
 
 author: Tim Lichtenberg
 
 url: https://proteus-framework.org
-baseurl: 
+baseurl:
+
+# Social / SEO (used by jekyll-seo-tag)
+logo: /assets/img/brand/PROTEUS_white_on_black.png
+social:
+  name: PROTEUS Framework
+  links:
+    - https://github.com/FormingWorlds/PROTEUS
+twitter:
+  card: summary_large_image
 
 collections:
   pages:
@@ -26,6 +37,7 @@ defaults:
       path: ""
     values:
       layout: "default"
+      image: /assets/img/og-default.jpg
   -
     scope:
       path: ""
@@ -37,7 +49,7 @@ defaults:
       path: ""
       type: "posts"
     values:
-      layout: "post" 
+      layout: "post"
 
 sass:
   sass_dir: assets/styles
@@ -52,7 +64,7 @@ plugins:
   - jekyll-github-metadata
 
 paginate: 6
-paginate_path: "/papers/page:num/"
+paginate_path: "/page:num/"
 
 github: [metadata]
 
 
@@ -13,78 +13,42 @@ header_settings:
 
 home_settings:
   # Choose a layout for your home page:
-    # landing – an example landing page made using the Argon design system
-    # papers – use your papers as the home page
+    # landing - an example landing page made using the Argon design system
+    # papers - use your papers as the home page
   theme: landing
 
 blog_settings:
-  # Choose a format for your papers listings:
-    # basic – a simple list of papers
-    # narrow – a masonary grid of papers
-    # grid – a full-width square grid of papers
   theme: basic
-  # Should we display a narrow grid of other papers at the bottom of each paper?
-  read_more: "yes"
+  read_more: "no"
 
-# Setup your navigation below – how to use the icons: 
-  # 1. See all the icons available here https://demos.creative-tim.com/argon-design-system-pro/docs/1.0/foundation/icons.html
-  # 2. Get the name of the icon e.g basket, then prefix with ni to make ni-basket. 
-  # 3. Add a color of the icon - text-primary, text-success, text-info, text-danger, text-warning and text-default all work! 
 menu_settings:
   menu_items:
     - title: 'Home'
       url: '/'
 
-      # submenu_items:
     - title: 'Documentation'
       submenu_items:
       - title: PROTEUS
         url: https://proteus-framework.org/PROTEUS/
-        icon: ni-books text-primary    
+        icon: ni-books text-primary
       - title: Modules
         url: /modules
         icon: ni-bold-right text-primary
 
     - title: 'Demos'
       url: '/demos'
 
-    # - title: Modules
-    #   url: /modules
-    #   icon: ni-laptop text-danger
-
-    # - title: 'Policy'
-    #   url: '/policy'
-    #   icon: ni-settings-gear-65 text-default
-
     - title: 'Publications'
-      url: 'https://scixplorer.org/public-libraries/EVAJ1UgWTCy2Z7TRoSmjtQ'
-      icon: ni-book-bookmark text-primary
+      url: '/publications'
 
     - title: 'People & Contact'
       url: '/people'
 
 footer_settings:
   footer_tagline: PROTEUS framework for planetary evolution
 
-contact_settings:
-  form_action: 'https://formspree.io/hello@jekyllthemes.io'
-  confirmation_url: '/thanks'
-  email_subject: 'Contact form submission'
-  send_button_text: 'Send Message'
-
 social_settings:
-  facebook_url: ''
-  twitter_url: ''
-  instagram_url: ''
-  youtube_url: ''
-  vimeo_url: ''
-  pinterest_url: ''
-  tumblr_url: ''
-  dribbble_url: ''
-  behance_url: ''
   github_url: 'https://github.com/FormingWorlds/PROTEUS'
-  reddit_url: ''
-  linkedin_url: ''
 
 authors:
   nicholls:
@@ -93,6 +57,6 @@ authors:
     name: Tim Lichtenberg
 
 advanced_settings:
-  analytics_code: 
-  header_js: 
-  footer_js: 
+  analytics_code: '<script async src="https://www.googletagmanager.com/gtag/js?id=G-ZCDRX6PC62"></script><script>window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments);}gtag("js",new Date());gtag("config","G-ZCDRX6PC62");</script>'
+  header_js:
+  footer_js: