Ορειβατικό Ημερολόγιο

A minimalist, design-first, local-only calendar aggregating upcoming mountaineering events and excursions from major Athenian alpine clubs.

Built for sheer speed, typographic legibility, and zero unnecessary operational overhead.

---

⛰️ Supported Clubs & Crawlers

The application dynamically crawls, parses, and aggregates calendar events from:

• ΑΟΣ (Αθηναϊκός Ορειβατικός Σύλλογος)
  • Program & Events: https://aos.gr/trechouses-kai-eperchomenes-anavaseis-kai-ekdiloseis/
  • Excursion Program: https://aos.gr/programma-exormiseon-ianouarios-2026-septemvrios-2026/
• ΕΟΣ Αθηνών
  • Excursion Calendar: https://www.eosathinon.gr/anavaseis/programma/
• ΕΟΣ Αχαρνών
  • Live Booking Engine: https://eosacharnon.xmiddleware.com/el (sourced via portal)
• ΕΟΣ Ηλιούπολης
  • Mountain Excursions Category: https://eosh.gr/wp/product-category/greek-mountains-climbs/
• ΕΠΟΣ Φυλής
  • Calendar Category: https://eposfilis.gr/events/category/%ce%b7%ce%bc%ce%b5%cf%81%ce%bf%ce%bb%cf%8c%ce%b3%ce%b9%ce%bf/
• ΠΟΑ (Πεζοπορικός Όμιλος Αθηνών)
  • Detailed Program: https://poa.gr/index.php/programma/
• ΦΟΝΙ (Φυσιολατρικός Όμιλος Νέας Ιωνίας)
  • Excursions Category: https://www.foni.org.gr/category/ekdromes/
• ΦΟΠ (Φυσιολατρικός Όμιλος Πειραιώς)
  • Excursion Program: https://fop.gr/

---

⚙️ How It Works (The Data Pipeline)

The project relies entirely on a lightweight, static pipeline that does not require databases or external servers:

graph LR
    A[LINKS.md] --> B[scripts/fetch-raw.js]
    B -->|Raw HTML| C[_input/ folder]
    C --> D[scripts/extract-text.js]
    D -->|Plain Text| E[_input/*.txt]
    E --> F[scripts/parse-events.js]
    F -->|Regex Heuristics| G[src/data/events.json]
    G --> H[Astro static build]
    H --> I[dist/index.html]

Loading

1. Crawler (scripts/fetch-raw.js): Reads the URLs from LINKS.md and fetches the raw HTML pages of each club, caching them in the local _input/ folder.
2. Text Extractor (scripts/extract-text.js): Strips layout noise, scripts, and styling to create clean, plain-text files.
3. Parser (scripts/parse-events.js): Uses custom-tailored regex patterns to scan the plain-text documents, normalizes Greek characters and accents (so searches are accent-insensitive), filters out past events, and aggregates everything into src/data/events.json.
4. Static Generator: Astro builds the front-end directly from the JSON database into static HTML.

---

🛠️ The Tech Stack

Frontend

• Framework: Astro v4 (Static Site Generation / output: "static")
• Styling: Tailwind CSS
• Typography: IBM Plex Sans (for readable, high-legibility UI) and IBM Plex Mono (for structured alignment, dates, and badges) via Google Fonts.

Backend / Utilities

• Runtime: Node.js (tested on v20.20.0)
• Scraping Helper: Cheerio (for fast HTML traversal)

---

🚀 Getting Started

Prerequisites

Make sure you have Node.js (v20+) and npm installed.

Setup

1. Clone the repository:

   git clone git@github.com:kostis-kounadis/Mount-Athens.git
   cd Mount-Athens

2. Install dependencies:

   npm install

Running Locally

To start the local development server:

npm run dev

Open http://localhost:4321/ in your browser.

Updating the Events Database

To crawl and parse fresh data from the club websites:

# 1. Fetch raw HTML
npm run fetch-raw

# 2. Extract and parse events into src/data/events.json
node scripts/parse-events.js

Building for Production

To compile the static pages:

npm run build

The output will be generated in the dist/ directory.

---

🎨 Creative & Technical Disclaimer

This project is conceived and designed by a mediocre hiker graphic designer, with a decent amount of coffee, negligible coding skills, an unhealthy knack for how things work, and built with AI coding agents.

---

📄 License

This project is open-source and licensed under the permissive MIT License.