diff --git a/README.md b/README.md index 0cd75d3..e87d726 100644 --- a/README.md +++ b/README.md @@ -23,8 +23,9 @@ the `main` branch mirrored to [Codeberg](https://codeberg.org/dananglin/enbas) a ### Documentation -- **[Installation guide](./docs/install.md)**: Follow this link to install Enbas. -- **[Getting started guide](./docs/getting_started.md)**: Follow this link to go through the Getting started guide. +- **[Installation guide](./docs/install.md)**: A guide for installing Enbas on your machine. +- **[Getting started guide](./docs/getting_started.md)**: A guide to help you get started on using Enbas. +- **[Configuration reference](./docs/configuration.md)**: The configuration reference documentation. ### Licensing diff --git a/docs/configuration.md b/docs/configuration.md new file mode 100644 index 0000000..69c8379 --- /dev/null +++ b/docs/configuration.md @@ -0,0 +1,35 @@ + + +# Configuration reference + +## Config + +| Field | Type | Description | +|--------------------|-------------------------------|--------------------------------------------------| +| `credentialsFile` | string | The (absolute) path to your credentials file. | +| `cacheDirectory` | string | The (absolute) path to the root cache directory. | +| `lineWrapMaxWidth` | int | The character limit used for line wrapping. | +| `http` | [HTTPConfig](#httpconfig) | HTTP settings. | +| `integrations` | [Integrations](#integrations) | Specify your integrations with Enbas. | + + +## HTTPConfig + +| Field | Type | Description | +|----------------|------|---------------------------------------------------------------------| +| `timeout` | int | The timeout (in seconds) for normal HTTP requests to your instance. | +| `mediaTimeout` | int | The timeout (in seconds) for retrieving media from your instance. | + +## Integrations + +| Field | Type | Description | +|---------------|--------|--------------------------------------------------------------------------------------------------------| +| `browser` | string | The browser used for opening URLs (e.g. URL to a remote account). | +| `editor` | string | The text editor used for writing statuses (not yet implemented). | +| `pager` | string | The pager used for paging through long outputs (e.g. status timelines). Leave blank to disable paging. | +| `imageViewer` | string | The image viewer used for viewing images from media attachments. | +| `videoPlayer` | string | The video player used for viewing videos from media attachments. | diff --git a/docs/getting_started.md b/docs/getting_started.md index 5dcd184..76e79e8 100644 --- a/docs/getting_started.md +++ b/docs/getting_started.md @@ -41,7 +41,8 @@ enbas --config-dir ./config init ``` You should now see a file called `config.json` in your configuration directory. -Feel free to edit the file to your preferences (configuration documentation coming soon). +Feel free to edit the file to your preferences. +The [configuration reference page](./configuration.md) should help you with this. For this 'Getting Started' guide you may want to specify your preferred browser in the configuration to allow Enbas to open the link to your instance's authorisation page. diff --git a/docs/manual.md b/docs/manual.md index c2f46b5..d1d4b74 100644 --- a/docs/manual.md +++ b/docs/manual.md @@ -4,4 +4,4 @@ SPDX-FileCopyrightText: 2024 Dan Anglin SPDX-License-Identifier: CC-BY-4.0 --> -# Manual +# User Manual