# SourceLoader

**Repository Path**: elyarenwer/source-loader

## Basic Information

- **Project Name**: SourceLoader
- **Description**: No description available
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-31
- **Last Updated**: 2025-10-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 项目, Python

## README

# SourceLoader - 字体预览器

这是一个简单的Flask应用，可以帮助您预览本地字体文件。

## 离线安装指南

由于Windows系统没有网络，以下是在离线环境中安装和运行的步骤：

### 1. 准备工作

- 确保您的Windows系统已安装Python（推荐3.8+）
- 推荐使用Conda虚拟环境管理依赖

### 2. 预先下载依赖（在有网络的环境中）

在有网络的环境中，下载所需的Python包：

```bash
# 方法1：使用pip下载到指定目录
pip download -d "dependencies" -r requirements.txt --platform win_amd64  --only-binary=:all:

# 方法2：如果使用conda，可以导出环境
conda create -n fontviewer python=3.8
conda activate fontviewer
conda install flask=2.2.5 werkzeug=2.2.3
pip install fonttools==4.45.0
conda env export > environment.yml
```

### 3. 安装依赖（离线环境）

将下载好的依赖和项目文件复制到没有网络的Windows系统上：

```bash
# 方法1：使用pip从本地安装
pip install --no-index --find-links=dependencies -r requirements.txt

# 方法2：使用conda环境文件
conda env create -f environment.yml
conda activate fontviewer
```

### 【还有一种方法】

#### 使用conda打包环境并迁移到无网络系统（推荐）

在有网络的环境中（如MacOS或Linux），您可以使用`conda pack`直接打包整个环境，然后在Windows系统中解压使用：

```bash
# 1. 安装conda-pack工具
conda install -c conda-forge conda-pack

# 2. 创建并激活新的conda环境
conda create -n fontviewer python=3.8
conda activate fontviewer

# 3. 安装所需依赖
conda install flask=2.2.5 werkzeug=2.2.3
pip install fonttools==4.45.0

# 4. 打包环境
conda pack -n fontviewer -o fontviewer_env.tar.gz
```

将生成的`fontviewer_env.tar.gz`文件复制到无网络的Windows系统上，然后：

```bash
# 1. 在Windows上创建目标环境目录
mkdir -p C:\Users\[您的用户名]\anaconda3\envs\fontviewer

# 2. 解压打包的环境（使用7-Zip或Windows内置的tar命令）
tar -xzf fontviewer_env.tar.gz -C C:\Users\[您的用户名]\anaconda3\envs\fontviewer

# 3. 激活环境
conda activate fontviewer
```

#### 注意事项
- 确保Windows上的conda版本与创建环境时的版本兼容
- 如果遇到激活问题，可以尝试使用以下命令修复环境路径：
  ```bash
  conda env update -f environment.yml
  ```
- 此方法确保所有依赖项（包括C扩展）都能正确迁移，特别适合Windows系统

### 4. 运行应用

在Windows系统中，使用以下命令运行应用：

```bash
# 如果使用普通Python环境
python app.py

# 如果使用conda环境
conda activate fontviewer
python app.py
```

然后在浏览器中访问：`http://localhost:5001`

### 5. 添加字体文件

将您的字体文件（.ttf, .otf, .woff, .woff2, .eot）放入`static/resources/`目录中，刷新页面即可看到字体预览。

## 依赖说明

- Flask 2.2.5 - Web框架
- Werkzeug 2.2.3 - WSGI工具库
- fonttools 4.45.0 - 用于解析字体文件

## 注意事项

- 确保`static/resources/`目录存在
- 程序会自动检测目录中的字体文件
- 如果解析字体名称失败，将使用文件名作为字体名称
- 在Windows系统上，应用默认运行在5001端口