glsl-sandbox - GitLite

KO | EN

gitlite — search

#ai #llm #go #android #machine-learning #rust #linux #docker #macos #nodejs #java #awesome #vue #openai

glsl-sandbox

(★ 1,679)

Shader editor and gallery.

파일 탐색기

최종 버전 다운로드 (.zip)

- - workflow.yml
- - diff.html
  - gallery.html
  - login.html
- - data_test.go
  - effects.go
  - effects_test.go
  - import.go
  - store.go
  - users.go
  - users_test.go
- - thumb.go
  - thumb_test.go
- auth.go
- server.go
- - codemirror.css
  - default.css
- - fullscreen.svg
- - codemirror.js
  - glsl.js
  - helpers.js
  - jquery.js
  - LICENSE-LZMA
  - lzma.js
  - lzma_worker.js
- index.html
- index_.html
.goreleaser.yml
docker-compose.yml
Dockerfile
entrypoint.sh
go.mod
go.sum
LICENSE
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/mrdoob/glsl-sandbox

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd glsl-sandbox

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Docker

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

docker compose up -d --build

정의된 모든 컨테이너(서버, DB 등)를 한 번에 빌드하고 백그라운드에서 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

3. Go

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Go Go 언어 컴파일러 및 도구 모음입니다.

$ go build ./server/cmd/glslsandbox

Go 프로그램을 컴파일해 실행 파일을 만듭니다.

✅ 빌드가 에러 없이 끝나면 성공입니다. go run . 을 썼다면 터미널 출력을 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# glsl-sandbox

## Server development

### Setup

* Fork repository
* Download repository and create new development branch:

```
$ git clone git@github.com:<your user>/glsl-sandbox
$ cd glsl-sandbox
$ git checkout -b <feature name>
```

* Download and uncompress test data:

```
$ curl -O https://downloads.zooloo.org/glslsandbox-data.tar.gz
$ tar xvf glslsandbox-data.tar.gz
```

* Build server binary needs go compiler:

```
$ go build ./server/cmd/glslsandbox
```

* Alternatively you can download and uncompress the binary in the repository directory from https://github.com/mrdoob/glsl-sandbox/releases/latest

* Run server:

```
$ ./glslsandbox
```

* The first time it starts it creates an admin user and the credentials are printed.

* The server should be accessible on http://localhost:8888

* Admin interface is on http://localhost:8888/admin

### Template and javascript modifications

The server reloads templates and assets on each query. This eases the development as you can modify the files and changes will take effect reloading the page.

There's only one template that is used for both the gallery (index) and admin page. The file is `server/assets/gallery.html` and uses go language templates. You can find more information about its syntax here:

* https://gohugo.io/templates/introduction/
* https://pkg.go.dev/text/template
* https://pkg.go.dev/html/template

Currently the page receives this data:

```go
// galleryEffect has information about each effect displayed in the gallery.
type galleryEffect struct {
	// ID is the effect identifyier.
	ID int
	// Version is the latest effect version.
	Version int
	// Image holds the thumbnail name.
	Image string
	// Hidden tells if the effect has been moderated.
	Hidden bool
}

// galleryData has information about the current gallery page.
type galleryData struct {
	// Effects is an array with all the effects for the page.
	Effects []galleryEffect
	// URL is the path of the gallery. Can be "/" or "/admin".
	URL string
	// Page holds the current page number.
	Page int
	// IsPrevious is true if there is a previous page.
	IsPrevious bool
	// PreviousPage is the previous page number.
	PreviousPage int
	// IsNext is true if there is a next page.
	IsNext bool
	// NextPage is the next page number.
	NextPage int
	// Admin is true when accessing "/admin" path.
	Admin bool
}
```

This is, `galleryData` for the page and `galleryEffect` for each effect. For example, to print all the effect IDs you can use:

```html
<ul>
{{ range .Effects }}
    <li>{{ .ID }}</li>
{{ end }}
<ul>
```

The following directories are accessible from the server and can be modified if needed:

* `server/assets/css` -> `/css`
* `server/assets/js` -> `/js`

By default the data files are read from `./data`. This path can be hanged with the environment variable `DATA_PATH`. For example:

```
$ DATA_PATH=/my/data/directory ./glslsandbox
```

The data directory contains the sqlite database (`glslsandbox.db`) and the thumbnails (`thumbs` directory).