mirror of
https://github.com/jokob-sk/NetAlertX.git
synced 2025-12-07 09:36:05 -08:00
MKDocs
This commit is contained in:
jokob-sk
@@ -3,6 +3,24 @@
|
|||||||
>[!NOTE]
|
>[!NOTE]
|
||||||
> Replace `/development` with the path where your code files will be stored. The default container name is `netalertx` so there might be a conflict with your running containers.
|
> Replace `/development` with the path where your code files will be stored. The default container name is `netalertx` so there might be a conflict with your running containers.
|
||||||
|
|
||||||
|
### Development Guidelines
|
||||||
|
|
||||||
|
**Priority Order (Highest to Lowest):**
|
||||||
|
1. 🔼 Fixing core bugs that lack workarounds.
|
||||||
|
2. 🔵 Adding core functionality that unlocks other features (e.g., plugins).
|
||||||
|
3. 🔵 Refactoring to enable faster development.
|
||||||
|
4. 🔽 UI improvements (PRs welcome).
|
||||||
|
|
||||||
|
💡 **Design Philosophy:**
|
||||||
|
Focus on core functionality and integrate with existing tools rather than reinventing the wheel.
|
||||||
|
Examples:
|
||||||
|
- Using **Apprise** for notifications instead of implementing multiple separate gateways.
|
||||||
|
- Implementing **regex-based validation** instead of one-off validation for each setting.
|
||||||
|
|
||||||
|
📌 **Note on UI requests:**
|
||||||
|
UI changes have lower priority due to framework limitations and mobile support constraints.
|
||||||
|
PRs are welcome, but **keep them small & focused**.
|
||||||
|
|
||||||
## 1. Download the code:
|
## 1. Download the code:
|
||||||
|
|
||||||
- `mkdir /development`
|
- `mkdir /development`
|
||||||
@@ -67,4 +85,24 @@ Most code changes can be tetsed without rebuilding the container. When working o
|
|||||||
|
|
||||||
3. If none of the above work, restart the docker image. This is usually the last resort as sometimes the Docker engine becomes unresponsive and the whole engine needs to be restarted.
|
3. If none of the above work, restart the docker image. This is usually the last resort as sometimes the Docker engine becomes unresponsive and the whole engine needs to be restarted.
|
||||||
|
|
||||||
|
## ➕ Contributing & Pull Requests
|
||||||
|
|
||||||
|
**Before submitting a PR, please ensure:**
|
||||||
|
✔ Changes are **backward-compatible** with existing installs.
|
||||||
|
✔ No unnecessary changes are made.
|
||||||
|
✔ New features are **reusable**, not narrowly scoped.
|
||||||
|
✔ Features are implemented via **plugins** if possible.
|
||||||
|
|
||||||
|
### ✅ Suggested Test Cases
|
||||||
|
|
||||||
|
- Fresh install (no DB/config).
|
||||||
|
- Existing DB/config compatibility.
|
||||||
|
- Notification testing:
|
||||||
|
- Email
|
||||||
|
- Apprise (e.g., Telegram)
|
||||||
|
- Webhook (e.g., Discord)
|
||||||
|
- MQTT (e.g., Home Assistant)
|
||||||
|
- Settings persistence.
|
||||||
|
- Updating a Device
|
||||||
|
- Plugin functionality.
|
||||||
|
- Error log inspection.
|
||||||
|
|||||||
128
docs/index.md
128
docs/index.md
@@ -1,17 +1,16 @@
|
|||||||
# 📖 Documentation Overview
|
# NetAlertX documentation
|
||||||
|
|
||||||
## ℹ️ In-App Help
|
## ℹ️ In-App Help
|
||||||
|
|
||||||
<details>
|
- Hover over settings, fields, or labels.
|
||||||
<summary>🔍 How to access in-app help</summary>
|
- Click the blue ❔ (question-mark) icons.
|
||||||
|
- Access the in-app **Help / FAQ** section for frequently asked questions.
|
||||||
|
|
||||||
- Hover over settings, fields, or labels.
|
---
|
||||||
- Click the blue ❔ (question-mark) icons.
|
|
||||||
- Access the in-app **Help / FAQ** section for frequently asked questions.
|
|
||||||
|
|
||||||
|
## 📚 Table of Contents
|
||||||
|
|
||||||
</details>
|
{% include "_toc.md" %}
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -21,126 +20,17 @@
|
|||||||
The recommended installation method is via Docker.
|
The recommended installation method is via Docker.
|
||||||
👉 [Follow the official installation guide](https://github.com/jokob-sk/NetAlertX/blob/main/dockerfiles/README.md).
|
👉 [Follow the official installation guide](https://github.com/jokob-sk/NetAlertX/blob/main/dockerfiles/README.md).
|
||||||
|
|
||||||
### 💻 Bare-Metal / On-Server (Experimental)
|
### 💻 Bare-Metal / On-Server (Experimental - looking ofr maintainers)
|
||||||
- 🧪 [(Experimental) On-hardware installation](https://github.com/jokob-sk/NetAlertX/blob/main/docs/HW_INSTALL.md)
|
- 🧪 [(Experimental) On-hardware installation](https://github.com/jokob-sk/NetAlertX/blob/main/docs/HW_INSTALL.md)
|
||||||
- Alternative bare-metal forks:
|
- Alternative bare-metal forks:
|
||||||
- ✅ [leiweibau's fork](https://github.com/leiweibau/Pi.Alert/) (maintained)
|
- ✅ [leiweibau's fork](https://github.com/leiweibau/Pi.Alert/) (maintained)
|
||||||
- ❌ [pucherot's original code](https://github.com/pucherot/Pi.Alert/) (unmaintained)
|
- ❌ [pucherot's original code](https://github.com/pucherot/Pi.Alert/) (unmaintained)
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📚 Table of Contents
|
|
||||||
|
|
||||||
### ⚙ Initial Setup
|
|
||||||
- [Getting Started & Configuration](/docs/INITIAL_SETUP.md)
|
|
||||||
- [Synology Guide](/docs/SYNOLOGY_GUIDE.md)
|
|
||||||
- [Subnets & VLANs Configuration](/docs/SUBNETS.md)
|
|
||||||
- [Scanning Remote Networks](/docs/REMOTE_NETWORKS.md)
|
|
||||||
- [SMTP Server Configuration](/docs/SMTP.md)
|
|
||||||
- [Custom Icons Setup](/docs/ICONS.md)
|
|
||||||
- [Notifications Setup](/docs/NOTIFICATIONS.md)
|
|
||||||
- [Reverse DNS Name Resolution](/docs/REVERSE_DNS.md)
|
|
||||||
- [Network Treemap Configuration](/docs/NETWORK_TREE.md)
|
|
||||||
- [Backups & Data Retention](/docs/BACKUPS.md)
|
|
||||||
- [Plugins Overview](/front/plugins/README.md)
|
|
||||||
|
|
||||||
### 🐛 Debugging & Troubleshooting
|
|
||||||
- [General Debugging Tips](/docs/DEBUG_TIPS.md)
|
|
||||||
- [UI Not Showing Debug](/docs/WEB_UI_PORT_DEBUG.md)
|
|
||||||
- [Invalid JSON Errors](/docs/DEBUG_INVALID_JSON.md)
|
|
||||||
- [Plugin Troubleshooting](/docs/DEBUG_PLUGINS.md)
|
|
||||||
- [File Permissions Issues](/docs/FILE_PERMISSIONS.md)
|
|
||||||
- [Performance Optimization](/docs/PERFORMANCE.md)
|
|
||||||
|
|
||||||
### 🔝 Popular & Suggested Guides
|
|
||||||
- [Home Assistant Integration](/docs/HOME_ASSISTANT.md)
|
|
||||||
- [Bulk Device Editing](/docs/DEVICES_BULK_EDITING.md)
|
|
||||||
|
|
||||||
### ⚙ System Management
|
|
||||||
- [Device Management (Legacy Docs)](/docs/DEVICE_MANAGEMENT.md)
|
|
||||||
- [Random MAC & MAC Icon Meaning](/docs/RANDOM_MAC.md)
|
|
||||||
|
|
||||||
### 🔎 Practical Examples
|
|
||||||
- [N8N Webhook Integration](/docs/WEBHOOK_N8N.md)
|
|
||||||
|
|
||||||
### 🔄 Miscellaneous
|
|
||||||
- [Version History (Legacy)](/docs/VERSIONS_HISTORY.md)
|
|
||||||
- [Reverse Proxy Setup (Nginx, Apache, SWAG)](/docs/REVERSE_PROXY.md)
|
|
||||||
- [Updating the Application](/docs/UPDATES.md)
|
|
||||||
- [Authelia Setup (Draft)](/docs/AUTHELIA.md)
|
|
||||||
|
|
||||||
### 👩💻 For Developers
|
|
||||||
- [Developer Environment Setup](/docs/DEV_ENV_SETUP.md)
|
|
||||||
- [Server Code Structure](/server/README.md)
|
|
||||||
- [Database Schema & Details](/docs/DATABASE.md)
|
|
||||||
- [API Endpoints Overview](/docs/API.md)
|
|
||||||
- [Plugin Development Guide](/docs/PLUGINS_DEV.md)
|
|
||||||
- [Settings System Details](/docs/SETTINGS_SYSTEM.md)
|
|
||||||
- [Version Update Notifications](/docs/VERSIONS.md)
|
|
||||||
- [Frontend Development Notes](/docs/FRONTEND_DEVELOPMENT.md)
|
|
||||||
- [Webhook Secret Handling](/docs/WEBHOOK_SECRET.md)
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 👨💻 Development Priorities
|
## Help and Support
|
||||||
|
|
||||||
**Priority Order (Highest to Lowest):**
|
|
||||||
1. 🔼 Fixing core bugs that lack workarounds.
|
|
||||||
2. 🔵 Adding core functionality that unlocks other features (e.g., plugins).
|
|
||||||
3. 🔵 Refactoring to enable faster development.
|
|
||||||
4. 🔽 UI improvements (PRs welcome).
|
|
||||||
|
|
||||||
💡 **Design Philosophy:**
|
|
||||||
Focus on core functionality and integrate with existing tools rather than reinventing the wheel.
|
|
||||||
Examples:
|
|
||||||
- Using **Apprise** for notifications instead of implementing multiple separate gateways.
|
|
||||||
- Implementing **regex-based validation** instead of one-off validation for each setting.
|
|
||||||
|
|
||||||
📌 **Note on UI requests:**
|
|
||||||
UI changes have lower priority due to framework limitations and mobile support constraints.
|
|
||||||
PRs are welcome, but **keep them small & focused**.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🙏 Feature Requests
|
|
||||||
|
|
||||||
Please include:
|
|
||||||
- The **goal** (e.g., *"I want to do X so that Y..."*).
|
|
||||||
- Workarounds you've tried.
|
|
||||||
- Why a built-in feature is the better solution.
|
|
||||||
|
|
||||||
Example format:
|
|
||||||
> *I want to be able to do XYZ so that ZYX. I considered these approaches XYZ, but they have these limitations...*
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ➕ Contributing & Pull Requests
|
|
||||||
|
|
||||||
**Before submitting a PR, please ensure:**
|
|
||||||
✔ Changes are **backward-compatible** with existing installs.
|
|
||||||
✔ No unnecessary changes are made.
|
|
||||||
✔ New features are **reusable**, not narrowly scoped.
|
|
||||||
✔ Features are implemented via **plugins** if possible.
|
|
||||||
|
|
||||||
### ✅ Suggested Test Cases
|
|
||||||
- Fresh install (no DB/config).
|
|
||||||
- Existing DB/config compatibility.
|
|
||||||
- Notification testing:
|
|
||||||
- 📧 Email
|
|
||||||
- 🔔 Apprise (e.g., Telegram)
|
|
||||||
- 🌐 Webhook (e.g., Discord)
|
|
||||||
- 📡 MQTT (e.g., Home Assistant)
|
|
||||||
- Settings persistence.
|
|
||||||
- Plugin functionality.
|
|
||||||
- Error log inspection.
|
|
||||||
|
|
||||||
### 🔎 Important Notes:
|
|
||||||
- **Persistent settings** are stored in `app.conf`.
|
|
||||||
- **Session-based settings** are stored in the `Parameters` DB table and reset on container restart.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🐛 Reporting Bugs
|
|
||||||
|
|
||||||
Before opening an issue:
|
Before opening an issue:
|
||||||
- 🔍 [Check common issues](https://github.com/jokob-sk/NetAlertX/blob/main/docs/DEBUG_TIPS.md#common-issues).
|
- 🔍 [Check common issues](https://github.com/jokob-sk/NetAlertX/blob/main/docs/DEBUG_TIPS.md#common-issues).
|
||||||
|
|||||||
0
front/php/templates/language/fr_fr.json
Normal file → Executable file
0
front/php/templates/language/fr_fr.json
Normal file → Executable file
0
front/php/templates/language/it_it.json
Normal file → Executable file
0
front/php/templates/language/it_it.json
Normal file → Executable file
0
front/php/templates/language/pl_pl.json
Normal file → Executable file
0
front/php/templates/language/pl_pl.json
Normal file → Executable file
0
front/php/templates/language/pt_br.json
Normal file → Executable file
0
front/php/templates/language/pt_br.json
Normal file → Executable file
0
front/php/templates/language/uk_ua.json
Normal file → Executable file
0
front/php/templates/language/uk_ua.json
Normal file → Executable file
83
mkdocs.yml
83
mkdocs.yml
@@ -2,58 +2,47 @@ site_name: NetAlertX Docs
|
|||||||
site_url: https://jokob-sk.github.io/NetAlertX/
|
site_url: https://jokob-sk.github.io/NetAlertX/
|
||||||
nav:
|
nav:
|
||||||
- Home: index.md
|
- Home: index.md
|
||||||
- API: API.md
|
- Installation:
|
||||||
- Authentication:
|
- Installation: HW_INSTALL.md
|
||||||
|
- Migration Guide: MIGRATION.md
|
||||||
|
- Docker Compose: DOCKER_COMPOSE.md
|
||||||
|
- Docker File Permissions: FILE_PERMISSIONS.md
|
||||||
|
- Synology Guide: SYNOLOGY_GUIDE.md
|
||||||
|
- Community Guides: COMMUNITY_GUIDES.md
|
||||||
|
- Setup:
|
||||||
|
- Subnets: SUBNETS.md
|
||||||
|
- Remote Networks: REMOTE_NETWORKS.md
|
||||||
|
- Notifications Guide: NOTIFICATIONS.md
|
||||||
|
- Emails: SMTP.md
|
||||||
- Authelia: AUTHELIA.md
|
- Authelia: AUTHELIA.md
|
||||||
- Backups: BACKUPS.md
|
- Backups: BACKUPS.md
|
||||||
- Community Guides: COMMUNITY_GUIDES.md
|
|
||||||
- Customization:
|
|
||||||
- Custom Properties: CUSTOM_PROPERTIES.md
|
|
||||||
- Device Display Settings: DEVICE_DISPLAY_SETTINGS.md
|
|
||||||
- Database:
|
|
||||||
- Overview: DATABASE.md
|
|
||||||
- Performance: PERFORMANCE.md
|
- Performance: PERFORMANCE.md
|
||||||
- Debugging:
|
- Home Assistant: HOME_ASSISTANT.md
|
||||||
- Debugging Invalid JSON: DEBUG_INVALID_JSON.md
|
- Reverse DNS: REVERSE_DNS.md
|
||||||
- Debugging Plugins: DEBUG_PLUGINS.md
|
- Pi-hole Guide: PIHOLE_GUIDE.md
|
||||||
- Debugging Tips: DEBUG_TIPS.md
|
- Reverse Proxy: REVERSE_PROXY.md
|
||||||
- Development:
|
- Webhooks (n8n): WEBHOOK_N8N.md
|
||||||
- Setup: DEV_ENV_SETUP.md
|
- Device guides:
|
||||||
- Frontend Development: FRONTEND_DEVELOPMENT.md
|
|
||||||
- Devices:
|
|
||||||
- Management: DEVICE_MANAGEMENT.md
|
- Management: DEVICE_MANAGEMENT.md
|
||||||
- Bulk Editing: DEVICES_BULK_EDITING.md
|
- Bulk Editing: DEVICES_BULK_EDITING.md
|
||||||
- Random MAC: RANDOM_MAC.md
|
- Random MAC: RANDOM_MAC.md
|
||||||
- Docker:
|
- Custom Properties: CUSTOM_PROPERTIES.md
|
||||||
- Docker Compose: DOCKER_COMPOSE.md
|
- Device Display Settings: DEVICE_DISPLAY_SETTINGS.md
|
||||||
- File Permissions: FILE_PERMISSIONS.md
|
- Session Info: SESSION_INFO.md
|
||||||
- Home Assistant: HOME_ASSISTANT.md
|
- Icons: ICONS.md
|
||||||
- Hardware:
|
- Network Topology: NETWORK_TREE.md
|
||||||
- Installation: HW_INSTALL.md
|
- Troubleshooting:
|
||||||
- Icons: ICONS.md
|
- Debugging Tips: DEBUG_TIPS.md
|
||||||
- Migration Guide: MIGRATION.md
|
- Debugging Invalid JSON: DEBUG_INVALID_JSON.md
|
||||||
- Network:
|
- Debugging Plugins: DEBUG_PLUGINS.md
|
||||||
- Tree: NETWORK_TREE.md
|
- Debugging Web UI Port: WEB_UI_PORT_DEBUG.md
|
||||||
- Remote Networks: REMOTE_NETWORKS.md
|
- Development:
|
||||||
- Subnets: SUBNETS.md
|
- Environment Setup: DEV_ENV_SETUP.md
|
||||||
- Reverse DNS: REVERSE_DNS.md
|
- Frontend Development: FRONTEND_DEVELOPMENT.md
|
||||||
- Notifications:
|
|
||||||
- Overview: NOTIFICATIONS.md
|
|
||||||
- SMTP: SMTP.md
|
|
||||||
- Performance: PERFORMANCE.md
|
|
||||||
- Pi-hole Guide: PIHOLE_GUIDE.md
|
|
||||||
- Plugins:
|
|
||||||
- Development: PLUGINS_DEV.md
|
- Development: PLUGINS_DEV.md
|
||||||
- Webhook (n8n): WEBHOOK_N8N.md
|
|
||||||
- Webhook Secret: WEBHOOK_SECRET.md
|
- Webhook Secret: WEBHOOK_SECRET.md
|
||||||
- Proxy & Reverse DNS:
|
- API: API.md
|
||||||
- Reverse Proxy: REVERSE_PROXY.md
|
- Database: DATABASE.md
|
||||||
- Session Info: SESSION_INFO.md
|
- Settings: SETTINGS_SYSTEM.md
|
||||||
- Settings:
|
|
||||||
- System Settings: SETTINGS_SYSTEM.md
|
|
||||||
- Synology Guide: SYNOLOGY_GUIDE.md
|
|
||||||
- Updates & Versions:
|
|
||||||
- Updates: UPDATES.md
|
- Updates: UPDATES.md
|
||||||
- Versions: VERSIONS.md
|
- Versions: VERSIONS.md
|
||||||
- Web UI:
|
|
||||||
- Debugging Web UI Port: WEB_UI_PORT_DEBUG.md
|
|
||||||
Reference in New Issue
Block a user