diff --git a/Anson-Projects/wiki-data/README.md b/Anson-Projects/wiki-data/README.md index 3a0654adc..1da1a5dd9 100644 --- a/Anson-Projects/wiki-data/README.md +++ b/Anson-Projects/wiki-data/README.md @@ -1,19 +1,21 @@ -# 📍 Wikipedia Map +# 📍 WikiMap -A beautiful web application that shows Wikipedia articles near your location using Apple MapKit JS. Discover interesting places and stories around you! +Discover Wikipedia articles near you that need your help! WikiMap shows nearby Wikipedia articles on an interactive map, highlighting those that need photos, content, or improvements. ## 🌟 Features -- **Interactive Maps**: Powered by Apple MapKit JS for beautiful, smooth map experience -- **Location-Based Discovery**: Automatically finds Wikipedia articles near your current location -- **Adjustable Radius**: Search within 1km, 5km, or 10km radius -- **Rich Article Previews**: Click markers to see article descriptions and thumbnails -- **Responsive Design**: Works great on desktop and mobile devices -- **Fast & Cached**: Smart caching for better performance +- **Interactive Maps**: Powered by Apple MapKit JS with native user location tracking +- **Smart Clustering**: Markers cluster at distance and ungroup when zoomed in +- **Help Wikipedia**: Color-coded markers show articles that need photos or content +- **Walking & Driving Modes**: Search within 2km walking or 10km driving distance +- **Rich Article Previews**: Click markers to see descriptions and contribute +- **Native Navigation**: Direct links to Apple Maps/Google Maps for directions +- **Duplicate Handling**: Automatically offsets markers at identical locations +- **Responsive Design**: Works on desktop and mobile devices ## 🚀 Live Demo -The app is automatically deployed to GitLab Pages: `https://yourusername.gitlab.io/wiki-map` +Visit [around.ansonbiggs.com](https://around.ansonbiggs.com) to try it out! ## 🛠️ Setup @@ -80,22 +82,11 @@ wiki-map/ ## 🌐 Deployment -### GitLab Pages (Automatic) +This is a static site that can be deployed to any hosting service: -This project is configured for automatic deployment to GitLab Pages: - -1. Push your code to GitLab -2. The `.gitlab-ci.yml` file automatically deploys to Pages -3. Your site will be available at `https://yourusername.gitlab.io/wiki-map` - -### Manual Deployment - -You can deploy this to any static hosting service: - -- **Netlify**: Drag and drop the folder -- **Vercel**: Connect your Git repository -- **GitHub Pages**: Push to a GitHub repository -- **Firebase Hosting**: Use `firebase deploy` +- **Netlify/Vercel**: Connect your Git repository for automatic deployments +- **GitHub/GitLab Pages**: Push to your repository +- **Any static host**: Upload the files via FTP or deployment tools ## 🔧 Configuration Options @@ -111,11 +102,12 @@ All styles are in `styles.css` and use CSS custom properties for easy theming. ## 🌍 How It Works -1. **Location Detection**: Uses browser geolocation to find your position +1. **Location Detection**: Uses MapKit's native user location tracking 2. **Wikipedia Search**: Queries Wikipedia's geosearch API for nearby articles -3. **Enhancement**: Fetches article descriptions and thumbnails -4. **Map Display**: Shows articles as markers on the Apple map -5. **Interaction**: Click markers to see article previews and links +3. **Help Detection**: Identifies articles needing images or content expansion +4. **Smart Display**: Color-codes markers and handles duplicate locations +5. **Dynamic Clustering**: Clusters at distance, ungroups when zoomed in +6. **Interaction**: Click markers to view details and contribute to Wikipedia ## 📱 Browser Support @@ -146,13 +138,22 @@ All styles are in `styles.css` and use CSS custom properties for easy theming. - Some areas may have fewer geotagged articles - Check browser console for API errors +## 🎨 Color Legend + +- 🔴 **Crimson** - Needs both image and content +- 🟠 **Orange** - Needs image +- 🟡 **Gold** - Needs content expansion +- 🟢 **Green** - Complete article + ## 🤝 Contributing +Contributions welcome! Visit the [GitLab repository](https://gitlab.com/Anson-Projects/wiki-data) to: + 1. Fork the repository 2. Create a feature branch 3. Make your changes 4. Test thoroughly -5. Submit a pull request +5. Submit a merge request ## 📄 License diff --git a/Anson-Projects/wiki-data/index.html b/Anson-Projects/wiki-data/index.html index 4d906ae96..125760f7c 100644 --- a/Anson-Projects/wiki-data/index.html +++ b/Anson-Projects/wiki-data/index.html @@ -86,7 +86,9 @@