export source code

Author: pereorga

.editorconfig

@@ -0,0 +1,16 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 2
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[{*.go,go.mod,Makefile,Caddyfile}]
+indent_style = tab
+indent_size = 4
+
+[*.html]
+indent_size = 4

.env.example

@@ -0,0 +1,4 @@
+# Environment variables for DIRELEX
+# Copy this file to .env and modify as needed
+
+PORT=80

.github/workflows/docker-test.yml

@@ -0,0 +1,30 @@
+name: Docker Startup Test
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
+
+jobs:
+  test-docker-startup:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@main
+
+      - name: Start Docker Compose services
+        run: docker compose up -d
+
+      - name: Wait for and test web server
+        run: |
+          timeout 30 sh -c 'until curl -f http://localhost > /dev/null 2>&1; do echo "Waiting for app..."; sleep 2; done'
+
+      - name: Show logs on failure
+        if: failure()
+        run: docker compose logs
+
+      - name: Cleanup
+        if: always()
+        run: docker compose down -v

.gitignore

@@ -0,0 +1,7 @@
+*.local.*
+*.min.css
+*.min.js
+/build/
+/direlex
+/tmp/
+node_modules/

Dockerfile

@@ -0,0 +1,32 @@
+# --- Build stage ---
+FROM golang:1.26-alpine@sha256:d4c4845f5d60c6a974c6000ce58ae079328d03ab7f721a0734277e69905473e5 AS builder
+
+WORKDIR /app
+
+COPY go.mod go.sum ./
+RUN go mod download
+
+COPY cmd/ cmd/
+COPY css/ css/
+COPY internal/ internal/
+COPY js/ js/
+
+RUN go run ./cmd/build-assets
+
+ENV CGO_ENABLED=0
+RUN go build -ldflags="-s -w" -o direlex ./cmd/server
+
+# --- Final image ---
+FROM scratch
+
+WORKDIR /app
+
+COPY data/ data/
+COPY public/ public/
+COPY --from=builder /app/public/css/ public/css/
+COPY --from=builder /app/public/js/ public/js/
+COPY --from=builder /app/direlex .
+
+EXPOSE 80
+
+CMD ["./direlex"]

LICENSE

@@ -0,0 +1,35 @@
+.PHONY: help build-assets build generate start lint fix clean
+
+## help: Show this help message
+help:
+	@grep -E '^## ' $(MAKEFILE_LIST)
+
+## build-assets: Build CSS and JavaScript assets
+build-assets:
+	go run ./cmd/build-assets
+
+## build: Build the server binary
+build: build-assets
+	go build -buildvcs=false -ldflags="-s -w" -o direlex ./cmd/server
+
+## generate: Generate static site
+generate: build-assets
+	go run ./cmd/generate
+
+## start: Build and run the server
+start: build
+	./direlex
+
+## lint: Run all Go linters
+lint:
+	go vet ./...
+	gofmt -l .
+
+## fix: Format Go code
+fix:
+	go fmt ./...
+
+## clean: Remove built binaries and build artifacts
+clean:
+	rm -f direlex
+	rm -rf build/

Makefile

@@ -0,0 +1,111 @@
+# Diccionari de recursos lexicals
+
+*Catalan version available below / Versió en català disponible a continuació*
+
+Source code for the online version of the Diccionari de recursos lexicals ([DIRELEX](https://direlex.softcatala.org/)).
+
+## Dependencies
+
+### Option 1: Docker execution
+
+- Docker Compose
+
+### Option 2: Native compilation with Go
+
+- Go 1.24+
+
+## Build and execution
+
+### Static mode
+
+The website can be generated as a 100% static site and served with Caddy:
+
+```bash
+docker compose -f deploy/docker-compose.static.yml up
+```
+
+### Go server mode (development)
+
+#### Option 1: Docker
+
+```bash
+docker compose up
+```
+
+#### Option 2: Native Go
+
+```bash
+go run ./cmd/build-assets
+go build -o direlex ./cmd/server
+./direlex
+```
+
+Alternatively, you can use `make start` as a shortcut. Run `make` to see all available commands.
+
+## Copyright and licenses
+
+Copyright (c) Pere Orga Esteve <pere@orga.cat>, 2025.
+
+The source code of this project is distributed under the [AGPL-3.0](https://www.gnu.org/licenses/agpl-3.0.html.en) license or later.
+
+### Dictionary data
+
+Copyright (c) 2025 Carles Castellanos i Llorenç, Agustí Mayor i Lloret.
+
+The dictionary data included in this repository is subject to a different license than the source code: [CC BY-NC 4.0](https://creativecommons.org/licenses/by-nc/4.0/deed.en).
+
+---
+
+# Diccionari de recursos lexicals
+
+Codi font de la versió en línia del Diccionari de recursos lexicals ([DIRELEX](https://direlex.softcatala.org/)).
+
+## Dependències
+
+### Opció 1: execució amb Docker
+
+- Docker Compose
+
+### Opció 2: compilació nativa amb Go
+
+- Go 1.24+
+
+## Compilació i execució
+
+### Mode estàtic
+
+El lloc web es pot generar com un lloc 100% estàtic i servir-lo amb Caddy:
+
+```bash
+docker compose -f deploy/docker-compose.static.yml up
+```
+
+### Mode servidor Go (desenvolupament)
+
+#### Opció 1: Docker
+
+```bash
+docker compose up
+```
+
+#### Opció 2: Go natiu
+
+```bash
+go run ./cmd/build-assets
+go build -o direlex ./cmd/server
+./direlex
+```
+
+També podeu utilitzar `make start` com a drecera. Executeu `make` per veure totes les ordres.
+
+## Copyright i llicències
+
+Copyright (c) Pere Orga Esteve <pere@orga.cat>, 2025.
+
+El codi font d'aquest projecte es distribueix amb la llicència [AGPL-3.0](https://www.gnu.org/licenses/agpl-3.0.html.en) o superior.
+
+### Dades del diccionari
+
+Copyright (c) 2025 Carles Castellanos i Llorenç, Agustí Mayor i Lloret.
+
+Les dades del diccionari incloses en aquest repositori tenen una llicència diferent de la del codi font: [CC BY-NC 4.0](https://creativecommons.org/licenses/by-nc/4.0/deed.ca).

README.md

@@ -0,0 +1,67 @@
+{
+  "files": {
+    "includes": ["js/*.js", "css/*.css", "*.json"]
+  },
+  "formatter": {
+    "indentStyle": "space",
+    "lineWidth": 120
+  },
+  "linter": {
+    "rules": {
+      "complexity": {
+        "noForEach": "error",
+        "noImplicitCoercions": "error",
+        "noUselessStringConcat": "error",
+        "noVoid": "error"
+      },
+      "correctness": {
+        "noUndeclaredVariables": "error"
+      },
+      "nursery": {
+        "recommended": true
+      },
+      "style": {
+        "noNegationElse": "error",
+        "noDescendingSpecificity": "off",
+        "noNestedTernary": "error",
+        "noParameterAssign": "error",
+        "noSubstr": "error",
+        "noYodaExpression": "error",
+        "useBlockStatements": "error",
+        "useCollapsedElseIf": "error",
+        "useCollapsedIf": "error",
+        "useConsistentBuiltinInstantiation": "error",
+        "useDefaultParameterLast": "error",
+        "useDefaultSwitchClause": "error",
+        "useExplicitLengthCheck": "error",
+        "useForOf": "error",
+        "useGroupedAccessorPairs": "error",
+        "useNumberNamespace": "error",
+        "useShorthandAssign": "error",
+        "useSingleVarDeclarator": "error",
+        "useSymbolDescription": "error",
+        "useThrowNewError": "error",
+        "useTrimStartEnd": "error"
+      },
+      "suspicious": {
+        "noConstantBinaryExpressions": "error",
+        "useErrorMessage": "error",
+        "noEmptyBlockStatements": "error",
+        "noFunctionAssign": "error",
+        "noUnassignedVariables": "error",
+        "noVar": "error",
+        "useAwait": "error",
+        "useGuardForIn": "error",
+        "useNumberToFixedDigitsArgument": "error"
+      }
+    }
+  },
+  "assist": {
+    "actions": {
+      "source": {
+        "organizeImports": "on",
+        "useSortedProperties": "on"
+      }
+    }
+  }
+}