86 lines
3.4 KiB
Markdown
86 lines
3.4 KiB
Markdown
# Exit to Community Hugo Site
|
|
|
|
**An informational website by the Exit to Community Collective.**
|
|
|
|
This is a Hugo static site that migrated content from a Notion database to create the Exit to Community documentation site.
|
|
|
|
## Project Overview
|
|
|
|
The site documents case studies, legal snippets, and resources related to "Exit to Community" - the practice of converting startups into community-owned cooperatives.
|
|
|
|
## Key Technical Details
|
|
|
|
### Site Structure
|
|
- **Hugo static site generator** with custom layouts
|
|
- **No CMS** - Decap CMS was removed due to login issues
|
|
- **Content in Markdown** with YAML frontmatter
|
|
- **Custom CSS styling** with E2C yellow branding (#F4D03F)
|
|
|
|
### Content Types
|
|
- **Case Studies** (`/content/case-studies/`) - 24 case studies with logos and descriptions
|
|
- **Legal Snippets** (`/content/legal-snippets/`) - Legal documents and frameworks
|
|
- **Resources** (`/content/resources/`) - Media, education, and primer content
|
|
- **Main Pages** - Homepage, contact, add-your-story with integrated forms
|
|
|
|
### Important Files
|
|
- `/layouts/_default/baseof.html` - Main template with CSS and header/footer
|
|
- `/layouts/_default/list.html` - Card layout for case studies and other listings
|
|
- `/layouts/_default/single.html` - Individual page template with logo display
|
|
- `/layouts/index.html` - Homepage template (prevents auto-generated cards)
|
|
- `/static/img/logos/` - Case study logos (64px on cards, 120px on detail pages)
|
|
|
|
### Styling Notes
|
|
- Uses local Space Grotesk font files (no external Google Fonts dependency)
|
|
- Yellow hero section with ribbon background header
|
|
- Card-based layout with hover effects
|
|
- Responsive design with mobile breakpoints
|
|
- Case study logos have white background with padding and borders
|
|
- Custom styled contact and story submission forms
|
|
|
|
### Content Management
|
|
- All content files have clean YAML frontmatter (title first, logical ordering)
|
|
- Case studies include `image: /img/logos/[filename]` for logos
|
|
- Descriptions are full-length (not truncated) on listing pages
|
|
- No bold formatting in markdown headers
|
|
- Tags are used for categorization (no separate categories field)
|
|
|
|
### Build/Test Commands
|
|
- `hugo server -D` - Development server
|
|
- `hugo` - Build static site
|
|
- No specific linting commands identified yet
|
|
|
|
### Recent Work Completed
|
|
- Migrated all content from Notion exports
|
|
- Added ribbon background to header
|
|
- Cleaned up content file structure for human readability
|
|
- Added case study logos from external directory
|
|
- Fixed layout issues and duplicate content problems
|
|
- Removed Decap CMS system
|
|
- Implemented responsive card layouts with proper logo sizing
|
|
- Created custom styled forms for contact and story submission
|
|
- Set up git repository with appropriate .gitignore
|
|
|
|
## Development
|
|
|
|
### Local Setup
|
|
1. Install Hugo: https://gohugo.io/installation/
|
|
2. Clone this repository
|
|
3. Run `hugo server -D` for development
|
|
4. Visit http://localhost:1313
|
|
|
|
### Deployment
|
|
|
|
To deploy changes, simply push them to the `main` branch and they should automatically publish.
|
|
|
|
## External Dependencies
|
|
- Hugo static site generator
|
|
- Local font files (Space Grotesk)
|
|
- No external CMS or database dependencies
|
|
|
|
## Future Considerations
|
|
- May need to add linting/typecheck commands when identified
|
|
- Content updates should maintain the clean YAML structure
|
|
- New case studies should follow the established pattern with logos
|
|
- Consider adding search functionality if the content grows significantly
|
|
- Form submissions need backend integration for actual processing
|