# 极简导航网

**Repository Path**: hkysw/minimalist-navigation-network

## Basic Information

- **Project Name**: 极简导航网
- **Description**: 这是一个极简导航网站项目。它旨在提供一个清爽、美观且易于定制的个人上网主页，方便用户快速访问常用的网站和工具。

主要特点包括：

- 动态加载 ：通过读取 config.php 文件动态生成导航链接卡片。
- 响应式设计 ：能够自适应不同设备屏幕（电脑、平板、手机）。
- 美观界面 ：采用了现代化的设计风格，包含卡片式布局和图标展示。
- 简易定制 ：用户可以通过修改 config.php 文件
- **Primary Language**: PHP
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/hkysw/minimalist-navigation-network
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 2
- **Created**: 2025-06-15
- **Last Updated**: 2025-10-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Minimalist Navigation Site

#### Description
This is a lightweight, responsive personal navigation website project. It aims to provide a concise, aesthetically pleasing, and easily customizable internet portal for users to quickly access frequently used websites and tools.

Main Features:
*   **Static and Dynamic Combination**: The core display page is `index.php`, which dynamically generates link cards by reading the `config.php` (PHP array format) configuration file.
*   **Responsive Design**: Automatically adapts to different screen sizes (PC, tablet, mobile), providing a consistent browsing experience.
*   **Beautiful UI**: Adopts a modern design style, including frosted glass effects, card-based layout, smooth transition animations, etc.
*   **Automatic Icon Fetching**: Attempts to automatically fetch and display the favicon of the target website from multiple sources.
*   **Click Tracking**: Records the number of clicks on links via the `click.php` script (this feature depends on a server-side PHP environment and file write permissions).
*   **Easy to Customize**: Easily add, delete, or edit navigation links by modifying the `config.php` file. CSS styles are also easy to adjust to meet personalized needs.
*   **Custom Backgrounds**: Supports loading different background images based on device type (PC/mobile).

#### Software Architecture
*   **Frontend**: HTML, CSS, JavaScript (Vanilla JS)
*   **Backend (Configuration & Click Tracking)**: PHP
*   **Data Storage (Configuration)**: `config.php` (PHP Array)
*   **Data Storage (Click Counts)**: `config.php` (Updated via PHP script)

#### Installation

1.  **Environment Requirements**:
    *   A web server that supports PHP (e.g., Apache, Nginx).
    *   PHP version 7.0 or higher is recommended.
2.  **Deployment**:
    *   Upload all project files to your web server's root directory or a specified subdirectory.
    *   Ensure the server has write permissions for the `config.php` file (if you need to use the click tracking feature and want it to automatically update click counts).
3.  **Configuration**:
    *   Open the `config.php` file.
    *   Modify or add your website link information in PHP array format, including `title`, `description`, `url`, `icon` (Font Awesome icon class name or leave empty for JS to auto-fetch), and `clicks` (initial click count, usually set to 0).

#### Instructions

1.  **Access Homepage**: Visit your deployed `index.php` page in a browser.
2.  **Add/Modify Links**: Directly edit the PHP array content in the `config.php` file.
3.  **Customize Styles**: The main CSS styles are included within the `<style>` tags in the header of the `index.php` file. You can directly modify these styles or include external CSS files.
4.  **Background Images**:
    *   By default, background images are loaded from `https://lh.ithxs.com/apis.php?act=pe` (mobile) and `https://lh.ithxs.com/apis.php?act=pc` (desktop).
    *   You can change these URLs to your own image addresses in the CSS section of `index.php`.

#### Contribution

1.  Fork the repository.
2.  Create a new `Feat_xxx` or `Fix_xxx` branch.
3.  Commit your code (please ensure consistent code style and add necessary comments).
4.  Create a new Pull Request and describe your changes in detail.

#### Features

*   This project pursues minimalism and efficiency for quick deployment and use.
*   It provides basic website navigation functionality with some modern frontend effects.
*   Suggestions for improvement or contributions are welcome!