Skip to content

Commit 10bd25c

Browse files
authored
Update publish.md for clarity and redirect examples
Clarified instructions for saving ojobpub.json and updated redirect examples.
1 parent d86f908 commit 10bd25c

File tree

1 file changed

+12
-11
lines changed

1 file changed

+12
-11
lines changed

docs/quickstart/publish.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -11,16 +11,10 @@ There are a few ways to make ojobpub.json accessible:
1111

1212
## Local Path
1313

14-
Save the ojobpub.json on your webserver's root path by creating a directory `.well-known/` (not the dot prefix).
14+
Save the ojobpub.json on your webserver's root path by creating a directory `.well-known/` (note the dot prefix).
1515

1616
The root path of your website might look like something like `/var/www/example.com/`, so the file _ojobpub.json_ would be placed in `/var/www/example.com/.well-known/ojobpub.json`.
1717

18-
## HTTP Redirects
19-
20-
Creating a redirect to a different domain, vHost or path.
21-
22-
### Different vHost
23-
2418
If you have a website under https://www.example.com you can try what happens if you place the ojobpub.json in this `vhost` so it would be accessible like so `https://www.example.com/.well-known/ojobpub.json`.
2519

2620
Then access the location `https://example.com/.well-known/ojobpub.json` and see if it worked. Why? Many webservers are configured to redirect `example.com` to `www.example.com` while keeping the URI (path) per default.
@@ -32,12 +26,19 @@ location: https://www.example.com/.well-known/ojobpub.json
3226
server: Caddy
3327
content-length: 0
3428
date: Wed, 24 Dec 2025 10:59:51 GMT
35-
3629
```
3730

38-
### Different Domain
31+
The interesting information is the `HTTP 302` which stands for "Redirection" and the `location: ...` where you can see the address. NOTE: This must not be just `https://www.example.com/` but the also the full path to ojobpub.json.
32+
33+
If test was not successful, read further about HTTP Redirects configuration options.
34+
35+
## HTTP Redirects
36+
37+
Creating a redirect to a different domain, vHost or path.
38+
39+
### Different Domain / vhost
3940

40-
You can redirect to another domain like `https://jobs.example.com/just-an example/ojobpub.json`.
41+
You can redirect to another domain like `https://jobs.example.com/just-an example/ojobpub.json` or same domain but different path:
4142

4243
=== "Apache HTTPD"
4344

@@ -46,7 +47,7 @@ You can redirect to another domain like `https://jobs.example.com/just-an exampl
4647
ServerName www.example.com
4748
ServerAlias example.com
4849

49-
Redirect "/.well-known/ojobpub.json" "https://jobs.example.com/just-an-example/ojobpub.json"
50+
Redirect "/.well-known/ojobpub.json" "https://www.example.com/just-an-example/ojobpub.json"
5051
</VirtualHost>
5152
```
5253

0 commit comments

Comments
 (0)