Torch 安装与配置指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01047/article/details/146898728

Torch 安装与配置指南

torch A rapid admin generator for Elixir & Phoenix 项目地址: https://gitcode.com/gh_mirrors/tor/torch

1. 项目基础介绍

Torch 是一个为 Phoenix 应用程序设计的快速管理员生成器。它可以创建自定义模板，并依赖于 Phoenix HTML 生成器来工作。Torch 旨在帮助开发者快速搭建管理后台，减少重复工作，提高开发效率。

主要编程语言：Elixir

2. 项目使用的关键技术和框架

Phoenix Framework：一个基于 Elixir 的 Web 框架，用于构建可扩展的应用程序。
Elixir：一种函数式、并发、分布式编程语言，运行在 Erlang 虚拟机上。
OTP：Erlang 的开放电信平台，提供了一系列的库和系统框架，用于构建高性能、可扩展的实时系统。

3. 项目安装和配置的准备工作

在开始安装和配置 Torch 前，请确保您的开发环境已经满足了以下要求：

Elixir 1.14 或更高版本
Phoenix Framework 1.7 或更高版本
OTP 24 或更高版本
Git 用于克隆和下载项目代码

详细安装步骤

克隆项目仓库

打开终端，执行以下命令克隆项目仓库：
```
git clone https://github.com/mojotech/torch.git
cd torch
```
添加依赖

在项目的 mix.exs 文件中，将 Torch 添加到依赖列表：
```
def deps do
  [
    {:torch, "~> 5.5"}
  ]
end
```
然后运行以下命令来获取依赖：
```
mix deps.get
```

配置 Plug.Static

在你的应用 endpoint.ex 文件中，添加 Plug.Static 插件以提供静态文件服务：

plug(Plug.Static,
     at: "/torch",
     from: {:torch, "priv/static"},
     gzip: true,
     cache_control_for_etags: "public, max-age=86400",
     headers: [{"access-control-allow-origin", "*"}])

配置 Torch

在 config.exs 文件中，配置 Torch：
```
config :torch, otp_app: :my_app_name
```
替换 :my_app_name 为你的应用名称。
安装 Torch

运行以下命令安装 Torch：
```
mix torch.install
```

生成管理员界面

使用以下命令生成管理员界面：

mix torch.gen.html <Context Module> <Schema Module> <Schema Table Name> [<Column Name>:<Column Type>]+

例如，如果你想为 Post 模型生成一个博客的管理界面，可以运行：

mix torch.gen.html Blog Post posts title:string body:text published_at:datetime published:boolean views:integer

添加资源到路由

在 lib/phx1_6_web/router.ex 文件中，添加生成的资源到路由：
```
resources "/posts", PostController
```
运行迁移

运行以下命令来应用数据库迁移：
```
mix ecto.migrate
```
更新静态文件

如果需要，更新 torch.html.heex 布局文件，添加链接到你的新管理界面。