v1.0.0
📚 ap_ds Code Repository System
A self-hosted code hosting & documentation platform — code browsing, releases, version downloads, feedback, and admin management.
ap_ds Code Repository System is a Flask-based platform for hosting and showcasing code. It features code/file browsing with syntax highlighting, Markdown rendering, release management with version downloads (ZIP / TAR / WHL), search, user feedback, and a full admin dashboard.
✨ Features
| Feature | Description |
|---|---|
| 📂 Code Browser | Browse repository files / directories |
| 👁️ Code View | Syntax highlighting (Pygments) |
| 📄 Markdown View | Render Markdown documents |
| 📦 Release Downloads | Download version archives (ZIP / TAR / WHL) |
| 🔖 Releases Page | List versions & release notes |
| 🔍 Search | Search across the repository |
| 💬 Feedback | Users submit feedback; admin manages it |
| 🛠️ Admin Panel | Login, dashboard, branches, version upload, feedback management |
🔌 Routes
| Route | Description |
|---|---|
/ |
Homepage |
/code |
Code browsing |
/browse/<dir_path> |
Browse a directory |
/view/<file_path> |
View a file (syntax highlight) |
/download/<file_path> |
Download a file |
| `/download/zip | tar |
/releases |
Releases page |
/search |
Search |
/feedback |
Submit feedback |
/admin/* |
Admin management |
🚀 Quick Start
Prerequisites
- Python 3.8+
flask,markdown,pygments,markupsafe,werkzeug
Install & Run
pip install flask markdown pygments markupsafe werkzeug
python app.py
Then open the site in your browser.
📁 Project Structure
AP_DS_GIT_CODE/
├── app.py # Main Flask application
├── static/
│ ├── css.css # Stylesheet
│ └── fonts/ # Icon fonts
├── templates/ # 15 HTML templates
│ ├── index.html # Homepage
│ ├── code_browser.html # Code browser
│ ├── admin_*.html # Admin pages
│ └── ...
└── README.md # This document
📄 License
This project is licensed under the MIT License. See LICENSE for details.