41d271f09da28a31dd80760383440d58413abded
services/Distributed-Wiki-New.md
| ... | ... | @@ -4,6 +4,12 @@ |
| 4 | 4 | |
| 5 | 5 | It can serve pages live through its built-in Go HTTP server or generate a fully static HTML export for external hosting. All content is stored in a Git repository, making it easy to replicate across nodes or run in disconnected environments. |
| 6 | 6 | |
| 7 | +## Live Version |
|
| 8 | +- [https://wiki.dn42/](https://wiki.dn42/) (DN42 Access) |
|
| 9 | +- [https://dn42.jp/](https://dn42.jp/) (Clearnet) |
|
| 10 | + |
|
| 11 | + |
|
| 12 | + |
|
| 7 | 13 | ## Operating Modes |
| 8 | 14 | |
| 9 | 15 | You can run `dn42-wiki-go` in three different ways: |
| ... | ... | @@ -82,7 +88,8 @@ When `webhook.enabled` = true, the server exposes: |
| 82 | 88 | - GET | POST /api/webhook/push |
| 83 | 89 | Pushes local commits to the remote. |
| 84 | 90 | |
| 85 | -If `webhook.secret` is set, requests must include an Authorization header that matches the secret. |
|
| 91 | +If `webhook.secret` is set, requests must include an Authorization header that matches the secret. |
|
| 92 | +If `webhook.secret` is empty, a random secret will be generated on startup to secure the endpoint (used for polling). |
|
| 86 | 93 | |
| 87 | 94 | ### Polling Integration |
| 88 | 95 | |
| ... | ... | @@ -118,14 +125,14 @@ All settings are provided through a JSON file. Below is a concise reference of a |
| 118 | 125 | - `git.binPath` *(string, default `git`)*: Path to the Git executable. |
| 119 | 126 | - `git.remote` *(string, default empty)*: Remote URL. Leave empty for standalone/local repositories. |
| 120 | 127 | - `git.localDirectory` *(string, default `./repo`)*: Directory where the wiki repository is cloned or initialised. |
| 121 | -- `git.pullIntervalSec` *(int, default `300`)*: Seconds between background `git pull` operations in live mode. Disabled if no remote is set. |
|
| 128 | +- `git.pullIntervalSec` *(int, default `3600`)*: Seconds between background `git pull` operations in live mode. Disabled if no remote is set. |
|
| 122 | 129 | - `git.author` *(string, default `"Anonymous <anonymous@localhost>"`)*: Author string used for commits generated by the application. |
| 123 | 130 | - `git.commitMessagePrefix` *(string, default empty)*: Optional prefix prepended verbatim to commit messages supplied by users. |
| 124 | 131 | - `git.commitMessageAppendRemoteAddr` *(string, default empty)*: Optional suffix appended when a request carries a remote address. If the value contains `%s` it is treated as a `fmt` format string; otherwise it is concatenated. |
| 125 | 132 | |
| 126 | 133 | ### Webhook |
| 127 | 134 | - `webhook.enabled` *(bool, default `false`)*: Expose webhook endpoints on the main HTTP server. |
| 128 | -- `webhook.secret` *(string, default empty)*: Shared secret expected in the `Authorization` header. Ignored when empty. |
|
| 135 | +- `webhook.secret` *(string, default empty)*: Shared secret expected in the `Authorization` header. If empty, a random secret is generated on startup. |
|
| 129 | 136 | - `webhook.polling.enabled` *(bool, default `false`)*: Keep a registration active with the remote notification service and trigger periodic pulls. |
| 130 | 137 | - `webhook.polling.endpoint` *(string, default empty)*: URL of the notification service (eg. Usage with [dn42notifyd](https://git.dn42.dev/dn42/dn42notifyd): `https://git.dn42/dn42notify/poll`). |
| 131 | 138 | - `webhook.polling.callbackUrl` *(string, default empty)*: Public URL for `/api/webhook/pull`. Required when `webhook.polling.enabled` is `true`. |
| ... | ... | @@ -158,4 +165,3 @@ All settings are provided through a JSON file. Below is a concise reference of a |
| 158 | 165 | - live = true requires write access to the Git repo for local commits. |
| 159 | 166 | - With no remote configured, `dn42-wiki-go` initializes a local-only repository. |
| 160 | 167 | - Template changes require restarting the server or rebuilding static output. |
| 161 | - |