Skip to content

yosephdev/tigray.ternafit.org

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

127 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ›οΈ Tigray Knowledge Base

Tigray Knowledge Base

The World's Most Comprehensive Digital Archive of Tigray, Ethiopia

Website License: MIT GitHub last commit MkDocs Material

🌐 Visit Live Site β€’ πŸ“š Documentation β€’ 🀝 Contribute β€’ πŸ› Report Issue

A project by Ternafit NGO

πŸ“– Overview

The Tigray Knowledge Base is an authoritative, multimedia-rich platform documenting every facet of Tigray, Ethiopia. Built and maintained by Ternafit NGO, this resource serves as the definitive digital repository for researchers, journalists, policymakers, students, and anyone seeking verified information about this historic region.

🎯 Mission Statement

To preserve, document, and disseminate the rich cultural heritage, complex history, and contemporary realities of Tigray through an accessible, evidence-based, and ethically-maintained knowledge platform.

✨ Key Features

Category Features
πŸ“Š Data & Analytics Interactive charts, downloadable datasets, real-time statistics
πŸ—ΊοΈ Geography Detailed interactive maps, administrative boundaries, GIS data
πŸ“œ History & Culture Ancient civilizations to modern history, cultural heritage sites
πŸ‘₯ Demographics Population statistics, ethnic composition, social indicators
πŸ’Ό Economy Sector analysis, trade statistics, development metrics
πŸŽ“ Education & Health Institutional directories, system analyses, healthcare infrastructure
βš–οΈ Governance Current affairs, political structure, legal frameworks
πŸ” Discovery Full-text search, advanced filtering, citation management

πŸš€ Quick Start

Prerequisites

  • Python 3.8+
  • Git
  • Modern web browser

Local Development Setup

# 1. Clone repository
git clone https://github.com/yosephdev/tigray.ternafit.org.git
cd tigray.ternafit.org

# 2. Create virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 3. Install dependencies
pip install -r requirements.txt

# 4. Launch development server
mkdocs serve

# 5. Open browser to:
# http://localhost:8000

Production Build

mkdocs build  # Outputs to `site/` directory

πŸ—οΈ Architecture

Technology Stack

  • Static Site Generator: MkDocs with Material theme
  • Frontend: HTML5, CSS3, JavaScript (ES6+)
  • Data Visualization: Plotly.js, Vega-Lite
  • Mapping: Leaflet.js with OpenStreetMap
  • Hosting: Cloudflare (CDN, SSL, CI/CD)
  • Version Control: Git & GitHub

Project Structure

tigray.ternafit.org/
β”œβ”€β”€ docs/                    # Main content directory (MkDocs)
β”‚   β”œβ”€β”€ index.md            # MkDocs home (overwritten by the redesign landing page)
β”‚   β”œβ”€β”€ land/               # The Land: geography, climate, admin divisions, maps
β”‚   β”œβ”€β”€ society/            # People & Society: demographics, economy, education, health
β”‚   β”œβ”€β”€ history/            # History: ancient, Aksumite, medieval, modern, post-1991
β”‚   β”œβ”€β”€ war/                # The Tigray War (2020–2022) documentation
β”‚   β”œβ”€β”€ culture/            # Culture & Diaspora
β”‚   β”œβ”€β”€ current-affairs/    # Current Affairs: situation reports, TPLF brief, investigations
β”‚   β”œβ”€β”€ resources/          # Resources: library, datasets, maps, downloads
β”‚   β”œβ”€β”€ about/              # About Ternafit, mission, contributors, FAQ, contact
β”‚   β”œβ”€β”€ support.md          # Support Us / donate
β”‚   └── assets/             # Media & data files (css, js, images, data, maps)
β”œβ”€β”€ redesign/               # Custom landing page (HTML/CSS/JS) promoted to site root by a hook
β”œβ”€β”€ hooks/                  # MkDocs build hooks
β”œβ”€β”€ mkdocs.yml              # Configuration & unified navigation taxonomy
β”œβ”€β”€ requirements.txt        # Python dependencies
└── README.md               # This file

🀝 Contributing Guidelines

We welcome contributions from researchers, developers, designers, and subject matter experts.

Contribution Areas

  • πŸ“ Content Creation: Research articles, data analysis, historical documentation
  • πŸ’» Code Development: Feature implementation, bug fixes, performance optimization
  • 🎨 UI/UX Design: Interface improvements, accessibility enhancements
  • πŸ“Š Data Curation: Dataset collection, verification, visualization
  • 🌐 Translation: Content localization (Tigrinya, Amharic, Arabic, etc.)
  • πŸ” Quality Assurance: Fact-checking, proofreading, technical review

Contribution Workflow

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/description)
  3. Implement changes following our style guide
  4. Test thoroughly (content accuracy & technical functionality)
  5. Commit with descriptive messages (git commit -m 'Add: [feature] description')
  6. Push to your fork (git push origin feature/description)
  7. Submit a Pull Request with detailed description

πŸ’ Support & Funding

The Tigray Knowledge Base is maintained by volunteers and supported through donations. Your contribution helps us:

  • 🌍 Maintain servers and hosting infrastructure
  • πŸ“š Acquire research materials and data sources
  • πŸ” Conduct fact-checking and verification
  • πŸ› οΈ Develop new features and improvements
  • 🌐 Translate content into multiple languages

🀲 How to Support

You can support this project through:

Platform Link Purpose
GitHub Sponsors Sponsor yosephdev Direct monthly support
Open Collective tigray-knowledge-base Transparent collective funding
Buy Me a Coffee buymeacoffee.com/tigraykb One-time donations
Custom Donation Ternafit NGO Organization-wide support

Other Ways to Contribute

Not able to donate financially? You can still help:

  • ⭐ Star the repository on GitHub
  • πŸ”— Share the project with researchers and institutions
  • πŸ“ Contribute content, code, or documentation
  • πŸ› Report issues and suggest improvements
  • 🌐 Translate content into other languages

Funding Transparency

All funds received through these platforms are used exclusively for:

  1. Hosting and infrastructure costs ($50-100/month)
  2. Domain registration and SSL certificates ($30/year)
  3. Data acquisition and research materials
  4. Development tools and services
  5. Community outreach and promotion

Note: Ternafit NGO is a registered non-profit organization. Donations may be tax-deductible in some jurisdictions.

Quality Standards

  • βœ… Accuracy: All claims must be verifiable with cited sources
  • βœ… Neutrality: Maintain objective, balanced perspectives
  • βœ… Accessibility: WCAG 2.1 AA compliance for all content
  • βœ… Performance: Optimized loading times (<3s on 3G)
  • βœ… Security: No sensitive personal information

πŸ“„ Licensing

Code

  • Repository Code: MIT License - Open source with attribution

Content

  • Text & Articles: CC BY-SA 4.0 - Share with attribution
  • Data & Statistics: CC0 1.0 where possible
  • Media Assets: Varied licenses - See individual asset metadata

🏒 About Ternafit NGO

Ternafit is a registered non-governmental organization committed to:

  • Cultural Preservation: Documenting and protecting Tigrayan heritage
  • Educational Advancement: Supporting academic research and public education
  • Humanitarian Response: Providing aid during crises and recovery
  • Community Development: Fostering sustainable social progress
  • Digital Advocacy: Leveraging technology for social good

πŸ“ž Support & Contact

Technical Support

Organizational Contact

πŸ™ Acknowledgments

Contributors

Thanks to all researchers, developers, and volunteers who have contributed their expertise.

Data Sources

  • Academic institutions and research organizations
  • Government and international agency publications
  • Verified community-submitted information

Technology Partners

  • Open-source software communities
  • Cloud infrastructure providers
  • Educational institutions supporting research

πŸ“ˆ Version History

Version Date Key Changes
v2.1.0 Jan 2026 Fixed Vega-Lite rendering, restructured assets, added datasets
v2.0.0 Aug 2025 Complete redesign with professional branding
v1.5.0 Jul 2025 Added interactive data visualizations
v1.0.0 Jun 2025 Initial public release

Preserving Heritage β€’ Empowering Knowledge β€’ Building Community

⭐ Star on GitHub β€’ πŸ“’ Share on Twitter β€’ πŸ“§ Contact Us

Β© 2026 Ternafit NGO. All rights reserved where applicable.

About

The Tigray Knowledge Base is a comprehensive, multimedia-rich documentation platform covering every aspect of Tigray, Ethiopia.

Resources

License

Contributing

Stars

1 star

Watchers

1 watching

Forks

Sponsor this project

Contributors