# 爱导航

**Repository Path**: dujun_h5/love-navigation

## Basic Information

- **Project Name**: 爱导航
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-28
- **Last Updated**: 2026-08-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Love Navigation

## Project Introduction
This is a Node.js-based static navigation website generation tool. The main purpose of the project is to build a concise and efficient navigation page to collect and display various high-quality web resources (especially currently popular AI tools). It scrapes data via Node.js scripts and utilizes a template engine to render the data into final HTML static files.

## Main Features
1.  **Data Scraping**: Provides a `scraper.js` script that can automatically pull the latest site categories and link data from configured API endpoints.
2.  **Static Build**: The `build-site.js` script combines JSON data with HTML templates to generate deployable `index.html` files.
3.  **Icon Processing**: Automatically downloads and manages site Favicon icons, ensuring icons are displayed even when offline or during slow loading.
4.  **UI Design**: Based on Bootstrap 5 and custom CSS, providing a fresh UI style.
5.  **Dark Mode**: Supports Dark Mode following the system settings or manual switching.
6.  **Search Function**: Built-in search box supporting quick site location.

## Directory Structure
```
├── build-site.js      # Core build script, responsible for generating the final webpage
├── scraper.js         # Data scraping script, used to update data under the data/ directory
├── parse-html.js      # HTML parsing helper script
├── data/              # Stores project data (JSON format)
│   ├── all-data.json  # Complete site data
│   ├── data-lite.json # Simplified data
│   └── favicons.json  # Site icon mapping relationships
├── css/               # Style files
│   ├── bootstrap.min.css
│   ├── custom.css     # Custom styles (including Dark Mode, etc.)
│   ├── font_*.css     # Icon font styles
│   └── ...
├── js/                # Frontend scripts
│   ├── app.min.js     # Core interaction logic
│   ├── custom.js      # Custom configuration
│   └── ...
├── images/            # Image resources, mainly icons
│   └── favicons/      # Cached icon files
└── index.html         # Generated entry file
```

## Quick Start

### Environment Requirements
*   Node.js (v14 or higher recommended)
*   NPM or Yarn

### 1. Install Dependencies
This project primarily relies on the Node.js standard library; generally, no additional third-party packages are needed to run the scripts. If errors occur, please supplement according to the `require` statements within the scripts.

### 2. Update Data
If you need to update the website content, please run the data scraping script:
```bash
node scraper.js
```
This script will request the configured API address and save the latest category and URL data to the `data/` directory.

### 3. Build Website
After data updates are complete, run the build script to generate static pages:
```bash
node build-site.js
```
Upon successful execution, `index.html` will be generated or updated in the current directory.

### 4. Local Preview
After building, simply open `index.html` directly in a browser to preview the result.

## Customization
*   **Data Source**: Modify the `API_BASE` variable in `scraper.js` to point to your data interface.
*   **Styles**: You can modify CSS variables or style rules in `css/custom.css` to customize theme colors.
*   **Layout**: `build-site.js` contains the page HTML generation logic; the DOM structure (such as sidebar, category display method) can be adjusted as needed.

## Tech Stack
*   **Node.js**: Backend build and script execution
*   **HTML5/CSS3**: Page structure and styles
*   **Bootstrap 5**: Responsive UI framework
*   **jQuery**: DOM manipulation and interaction logic

## Open Source License
This project is licensed under the MIT License.