Affiliations Component Setup Guide
Affiliations Component Setup Guide
This guide will help you set up and customize the affiliations display component on your academic website.
Overview
The affiliations component is a sophisticated, interactive display that showcases your institutional affiliations with:
- Elegant card-based layout with hover effects
- Toggle functionality to show/hide affiliations
- Modal popups with detailed information
- Responsive design that works on all devices
- Accessibility features for screen readers
- Support for logos and fallback displays
Files Created
Core Component Files
_includes/affiliations.html
- Main component template_sass/_affiliations.scss
- Styling and animations_data/affiliations.yml
- Configuration data_affiliations/*.md
- Individual affiliation descriptions
Content Files
_affiliations/mit-sloan.md
- MIT Sloan description_affiliations/igl-research-network.md
- IGL Research Network description_affiliations/cornell-university.md
- Cornell University description_affiliations/charles-river-associates.md
- Charles River Associates description
Logo Setup
Logo Requirements
- Format: PNG, JPG, or SVG
- Size: Maximum 200px width/height (will be scaled appropriately)
- Quality: High resolution for crisp display
- Background: Transparent preferred for PNG files
Logo Locations
Place logos in the images/affiliations/
directory with these filenames:
mit-sloan-logo.png
- MIT Sloan logoigl-logo.png
- Innovation Growth Lab logocornell-logo.png
- Cornell University logocra-logo.png
- Charles River Associates logo
Obtaining Official Logos
MIT Sloan School of Management
- Visit: https://mitsloan.mit.edu/brand-guidelines/downloads
- Requires MIT Touchstone login for access
- Use the horizontal logo for best display
- Follow MIT brand guidelines for proper usage
Cornell University
- Visit: https://brand.cornell.edu/downloads/
- Download appropriate logo size
- Consider using the simplified version for web display
- Follow Cornell brand guidelines
Innovation Growth Lab
- Contact: https://www.innovationgrowthlab.org/
- Request logo usage permission
- Use official branding materials
Charles River Associates
- Contact their marketing department for logo usage
- Ensure compliance with their brand guidelines
Logo Fallbacks
If logos are not available, the component automatically displays:
- University icon (Font Awesome)
- Institution short name
- Styled fallback appearance
Customization Options
Adding New Affiliations
- Update
_data/affiliations.yml
:- id: "new-institution" name: "Full Institution Name" short_name: "Short Name" type: "current" # or "past" logo: "/images/affiliations/new-logo.png" logo_alt: "Institution Logo" website: "https://institution.edu/" description_file: "new-institution" order: 5
- Create description file
_affiliations/new-institution.md
: ```markdown — title: “Full Institution Name” short_name: “Short Name” type: “current” website: “https://institution.edu/” —
Institution Name
Your detailed description here…
### Styling Customization
The component uses CSS custom properties for easy customization:
```scss
:root {
--primary-color: #0056b3; // Main theme color
--secondary-color: #28a745; // Current affiliation accent
--text-light: #6c757d; // Past affiliation accent
}
Responsive Behavior
- Desktop: 2-4 column grid layout
- Tablet: 1-2 column layout
- Mobile: Single column layout
- Print: Expanded view, no interactive elements
Integration
Homepage Integration
The component is already integrated into _pages/about.md
right after your introduction.
Research Page Integration
Also integrated into _pages/publications.md
in the research introduction section.
Custom Integration
To add to other pages:
<div class="affiliations-container" id="affiliations-container">
<div class="affiliations-header">
<h3>Affiliations</h3>
</div>
<div class="affiliations-grid">
<a href="/affiliations/mit-sloan/" class="affiliation-link">
<div class="affiliation-item current"
data-affiliation="mit-sloan"
data-tooltip-content="MIT Sloan School of Management I am currently pursuing my PhD at MIT’s Sloan School of Management in the Technological Innovation, Entrepreneurship, and Strategic Management (TIES) program. Program Focus The... Click to read more →"
role="button"
tabindex="0"
aria-label="Learn more about MIT Sloan"
title="MIT Sloan">
<div class="affiliation-logo">
<img src="/images/affiliations/mit-sloan-logo.png"
alt="MIT Sloan School of Management Logo"
loading="lazy"
onerror="this.style.display='none';">
</div>
<div class="affiliation-info">
<h3 class="affiliation-name">MIT Sloan</h3>
<span class="affiliation-type-badge current">
Current
</span>
</div>
</div>
</a>
<a href="/affiliations/igl-research-network/" class="affiliation-link">
<div class="affiliation-item current"
data-affiliation="igl"
data-tooltip-content="Innovation Growth Lab Research Network I am a part of the Innovation Growth Lab (IGL) Research Network, an open community of researchers dedicated to advancing knowledge on science, innovation, and... Click to read more →"
role="button"
tabindex="0"
aria-label="Learn more about Innovation Growth Lab"
title="Innovation Growth Lab">
<div class="affiliation-logo">
<img src="/images/affiliations/igl-logo.png"
alt="Innovation Growth Lab Logo"
loading="lazy"
onerror="this.style.display='none';">
</div>
<div class="affiliation-info">
<h3 class="affiliation-name">Innovation Growth Lab</h3>
<span class="affiliation-type-badge current">
Current
</span>
</div>
</div>
</a>
<a href="/affiliations/cornell-university/" class="affiliation-link">
<div class="affiliation-item past"
data-affiliation="cornell"
data-tooltip-content="Cornell University Cornell University served as the foundation of my academic journey, where I developed the analytical skills and interdisciplinary perspective that continue to shape my research today. My time... Click to read more →"
role="button"
tabindex="0"
aria-label="Learn more about Cornell University"
title="Cornell University">
<div class="affiliation-logo">
<img src="/images/affiliations/cornell-logo.png"
alt="Cornell University Logo"
loading="lazy"
onerror="this.style.display='none';">
</div>
<div class="affiliation-info">
<h3 class="affiliation-name">Cornell University</h3>
<span class="affiliation-type-badge past">
Past
</span>
</div>
</div>
</a>
<a href="/affiliations/charles-river-associates/" class="affiliation-link">
<div class="affiliation-item past"
data-affiliation="cra"
data-tooltip-content="Charles River Associates At Charles River Associates (CRA), I gained invaluable experience as an economic litigationconsultant, applying rigorous analytical methods to real-world business and policy challenges. This role provided practical... Click to read more →"
role="button"
tabindex="0"
aria-label="Learn more about Charles River Associates"
title="Charles River Associates">
<div class="affiliation-logo">
<img src="/images/affiliations/cra-logo.png"
alt="Charles River Associates Logo"
loading="lazy"
onerror="this.style.display='none';">
</div>
<div class="affiliation-info">
<h3 class="affiliation-name">Charles River Associates</h3>
<span class="affiliation-type-badge past">
Past
</span>
</div>
</div>
</a>
</div>
</div>
Accessibility Features
- Keyboard Navigation: Tab through elements, Enter/Space to activate
- Screen Reader Support: Proper ARIA labels and roles
- Focus Management: Clear focus indicators and modal focus trapping
- Reduced Motion: Respects user preference for reduced animations
- High Contrast: Supports high contrast display modes
Performance Considerations
- Lazy Loading: Logo images load only when needed
- Efficient Animations: Hardware-accelerated CSS transitions
- Minimal JavaScript: Lightweight, vanilla JS implementation
- Print Optimized: Clean print styles without animations
Browser Support
- Modern Browsers: Full functionality in Chrome, Firefox, Safari, Edge
- Older Browsers: Graceful degradation with fallbacks
- Mobile Browsers: Optimized touch interactions
Troubleshooting
Logos Not Displaying
- Check file paths in
_data/affiliations.yml
- Ensure logos exist in
images/affiliations/
directory - Verify image file formats (PNG, JPG, SVG)
- Check file permissions
Styling Issues
- Ensure
_sass/_affiliations.scss
is imported inassets/css/main.scss
- Clear browser cache
- Check for CSS conflicts with existing styles
Modal Not Opening
- Verify JavaScript is enabled
- Check browser console for errors
- Ensure Jekyll collections are properly configured
Customization Ideas
Color Themes
- Modify CSS custom properties for different color schemes
- Add institution-specific color coding
- Create dark mode variations
Layout Options
- Adjust grid columns for different screen sizes
- Modify card spacing and sizing
- Create alternative list or timeline layouts
Animation Effects
- Customize hover transitions
- Add entrance animations
- Modify modal transitions
Content Enhancement
- Add date ranges for affiliations
- Include role or position information
- Add links to specific projects or publications
Maintenance
Regular Updates
- Update affiliation descriptions as needed
- Add new affiliations as they occur
- Refresh logos if institutions rebrand
- Review and update content annually
Content Guidelines
- Keep descriptions concise but informative
- Focus on research relevance and impact
- Maintain consistent tone and style
- Include specific details that add value
This affiliations component provides a sophisticated and professional way to showcase your institutional connections while maintaining excellent user experience and accessibility standards.