blob: ff7b18827693c3b9113e884882b303384565a11f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
|
# SVGU
SVGU (short for *Static, Vanity, Go URL*) is a flexible and easy to use
tool for creating vanity URLs for your Go projects.
It allows publishing a Go module under a custom domain name, without the need
to use your code forge's domain name.
For example, if you have a project hosted on GitHub, you can use SVGU to
publish it under a custom domain name, such as `myproject.com/foo` instead of
`github.com/myproject/foo`.
## How it works
SVGU requires a configuration file, usually named `DOMAINS.star`, which
describes the modules to export.
The configuration file is a [Starlark](https://starlark.net) script, which
allows for a lot of flexibility.
Starlark is a subset of Python for configuration files, and is used by the
[Bazel](https://bazel.build) build system and others.
It is a simple language, and you don't need to know Python to use it.
See the [reference documentation](doc/references.md) for more information.
Once the configuration file is ready, you can run SVGU to generate the
necessary files, and then publish them on your web server.
```shell
$ svgu
```
This will generate a `dst` directory containing the files to publish.
## Documentation
- [Getting started](doc/getting-started.md)
- [Reference documentation](doc/references.md)
- [Bug tracker](https://github.com/nseezero/svgu/issues)
- [Source code](https://github.com/nseezero/svgu)
## License
The SVGU project is governed by a [BSD-style license](LICENSE).
The documentation is licensed under the [Creative Commons Attribution 4.0
International License](https://creativecommons.org/licenses/by/4.0/).
|
