|
| 1 | +# NMorais Lab — Disease Transcriptomics Lab Website |
| 2 | + |
| 3 | +> **Built with the assistance of [Claude Sonnet 4.6](https://www.anthropic.com/claude) by Anthropic.** |
| 4 | +> The initial codebase, structure, and design were generated and refined using Claude Sonnet 4.6 as a senior web development assistant. All scientific content and logos belong to the NMorais Lab. |
| 5 | +
|
| 6 | +--- |
| 7 | + |
| 8 | +## Overview |
| 9 | + |
| 10 | +A static, single-repository website for the **Disease Transcriptomics Lab (NMorais Lab)** at NOVA Medical School, Lisbon. Designed to be hosted on **GitHub Pages** with a custom domain. |
| 11 | + |
| 12 | +--- |
| 13 | + |
| 14 | +## File Architecture |
| 15 | + |
| 16 | +``` |
| 17 | +nmoraislab/ |
| 18 | +│ |
| 19 | +├── index.html ← Main entry point — assembles all sections via <script> includes |
| 20 | +│ |
| 21 | +├── css/ |
| 22 | +│ └── styles.css ← All design tokens, layout, and component styles |
| 23 | +│ |
| 24 | +├── js/ |
| 25 | +│ └── main.js ← Navigation, scroll animations, mobile menu |
| 26 | +│ |
| 27 | +├── sections/ |
| 28 | +│ ├── hero.html ← Hero / landing section |
| 29 | +│ ├── about.html ← About the lab + mission |
| 30 | +│ ├── team.html ← PI card + team member cards ← EDIT TEAM HERE |
| 31 | +│ ├── software.html ← Web apps + software tools ← EDIT TOOLS HERE |
| 32 | +│ ├── publications.html ← Selected publications list ← EDIT PUBS HERE |
| 33 | +│ └── news.html ← Social media feed widget ← EDIT NEWS HERE |
| 34 | +│ |
| 35 | +└── assets/ |
| 36 | + └── logos/ |
| 37 | + ├── logo-icon.png ← DNA icon (white, transparent bg) — used in nav |
| 38 | + └── logo-full-dark.png ← Full logo (white text, transparent bg) — used in hero |
| 39 | +``` |
| 40 | + |
| 41 | +--- |
| 42 | + |
| 43 | +## How to Edit Content (No Coding Required) |
| 44 | + |
| 45 | +Each section lives in its own file inside `/sections/`. Open the relevant file in any text editor (Notepad, TextEdit, VS Code) and look for the `<!-- EDIT ... HERE -->` comments. |
| 46 | + |
| 47 | +| File | What to edit | |
| 48 | +|---|---| |
| 49 | +| `sections/team.html` | Add/remove team member cards, update names, emails, roles, social links | |
| 50 | +| `sections/software.html` | Add new tools, update links, change descriptions | |
| 51 | +| `sections/publications.html` | Add publications in reverse chronological order | |
| 52 | +| `sections/news.html` | Paste your Curator.io / Elfsight social feed embed code | |
| 53 | +| `sections/about.html` | Update lab description, replace lab photo | |
| 54 | +| `sections/hero.html` | Edit headline and hero tagline | |
| 55 | + |
| 56 | +--- |
| 57 | + |
| 58 | +## Hosting on GitHub Pages (Recommended) |
| 59 | + |
| 60 | +### Step 1 — Create a repository |
| 61 | +1. Go to [github.com](https://github.com) and create a **new repository**. |
| 62 | +2. Name it `nmoraislab.github.io` (for a root URL) **or** any name like `website` (the site will be at `yourusername.github.io/website`). |
| 63 | +3. Set visibility to **Public**. |
| 64 | + |
| 65 | +### Step 2 — Upload the files |
| 66 | +Upload the entire folder contents (all files and folders) to the repository root. |
| 67 | +Or use Git: |
| 68 | +```bash |
| 69 | +git init |
| 70 | +git add . |
| 71 | +git commit -m "Initial lab website" |
| 72 | +git remote add origin https://github.com/YOUR_ORG/nmoraislab.github.io.git |
| 73 | +git push -u origin main |
| 74 | +``` |
| 75 | + |
| 76 | +### Step 3 — Enable GitHub Pages |
| 77 | +1. Go to **Settings → Pages**. |
| 78 | +2. Under *Source*, select **Deploy from a branch → main → / (root)**. |
| 79 | +3. Click **Save**. Your site will be live at `https://YOUR_ORG.github.io` within ~2 minutes. |
| 80 | + |
| 81 | +### Step 4 — Connect a custom domain (e.g. `lab.nmoraislab.org`) |
| 82 | +1. In the repository root, create a file named exactly `CNAME` containing just your domain: |
| 83 | + ``` |
| 84 | + lab.nmoraislab.org |
| 85 | + ``` |
| 86 | +2. In your DNS provider, add these **A records** pointing to GitHub's servers: |
| 87 | + ``` |
| 88 | + 185.199.108.153 |
| 89 | + 185.199.109.153 |
| 90 | + 185.199.110.153 |
| 91 | + 185.199.111.153 |
| 92 | + ``` |
| 93 | +3. Also add a **CNAME record**: `www` → `YOUR_ORG.github.io` |
| 94 | +4. Back in GitHub → Settings → Pages → Custom domain, enter `lab.nmoraislab.org` and enable **Enforce HTTPS**. |
| 95 | + |
| 96 | +DNS propagation takes up to 48 hours. After that, HTTPS is automatic via Let's Encrypt. |
| 97 | + |
| 98 | +--- |
| 99 | + |
| 100 | +## Social Feed (News Section) |
| 101 | + |
| 102 | +The news section is designed to host a **Curator.io** embed (free tier supports ~25 posts). |
| 103 | + |
| 104 | +1. Sign up at [curator.io](https://curator.io) |
| 105 | +2. Connect your **LinkedIn Company page** and/or **Bluesky** account |
| 106 | +3. Create a feed, style it to match the site (teal/white palette) |
| 107 | +4. Copy the two-line embed code and paste it into `sections/news.html` |
| 108 | + Look for: `<!-- PASTE CURATOR.IO EMBED CODE HERE -->` |
| 109 | + |
| 110 | +--- |
| 111 | + |
| 112 | +## Updating the Site |
| 113 | + |
| 114 | +After any edit, simply **commit and push** to the `main` branch on GitHub. Pages re-deploys automatically within ~60 seconds. |
| 115 | + |
| 116 | +For non-Git users: use the **GitHub web editor** (click any file → pencil icon ✏️ → edit → Commit changes). |
| 117 | + |
| 118 | +--- |
| 119 | + |
| 120 | +## Credits |
| 121 | + |
| 122 | +- Website generated with **Claude Sonnet 4.6** (Anthropic, 2025) |
| 123 | +- Fonts: [Playfair Display](https://fonts.google.com/specimen/Playfair+Display) + [DM Sans](https://fonts.google.com/specimen/DM+Sans) via Google Fonts |
| 124 | +- Social feed: [Curator.io](https://curator.io) |
| 125 | +- Hosting: [GitHub Pages](https://pages.github.com) |
| 126 | +- Lab logo design: NMorais Lab |
| 127 | + |
| 128 | +--- |
| 129 | + |
| 130 | +*NMorais Lab · Disease Transcriptomics · NOVA Medical School · GIMM · Lisbon, Portugal* |
0 commit comments