blob: 125cd1950984935c8e20780098875fe23d24a2e3 (
plain) (
blame)
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
# sally
sally is a small HTTP service you can host
to serve vanity import paths for Go modules.
## Installation
To build sally from source, use:
```bash
go install go.uber.org/sally@latest
```
Alternatively, get a pre-built Docker image from
https://github.com/uber-go/sally/pkgs/container/sally.
## Usage
Create a YAML file with the following structure:
```yaml
# sally.yaml
# Configures documentation linking.
# Optional.
godoc:
# Host for the Go documentation server.
# Defaults to pkg.go.dev.
host: pkg.go.dev
# Base URL for your package site.
# If you want your modules available under "example.com",
# specify example.com here.
# This field is required.
url: go.uber.org
# Collection of packages under example.com
# and their Git repositories.
packages:
# The key is the name of the package following the base URL.
# For example, if you want to make a package available at
# "example.com/foo", you'd specify "foo" here.
zap:
# Path to the Git repository.
#
# This field is required.
repo: github.com/uber-go/zap
# Branch of the Git repository that you're linking to.
#
# Defaults to "master".
branch: master
# Optional description of the package.
description: A fast, structured-logging library.
# Alternative base URL instead of the value configured at the top-level.
# This is useful if the same sally instance is
# hosted behind multiple base URLs.
#
# Defaults to the value of the top-level url field.
url: example.com
```
Run sally like so:
```shell
$ sally
```
This will read from sally.yaml and serve on port 8080.
To use a different port and/or configuration file,
use the `-yml` and `-port` flags.
```
$ sally -yml site.yaml -port 5000
```
|
