Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation Link Checker #782

Merged
merged 4 commits into from
Feb 19, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion .github/workflows/gh-page-unstable.yml
Original file line number Diff line number Diff line change
Expand Up @@ -17,11 +17,14 @@ jobs:
with:
mdbook-version: 'latest'

- name: Install mdbook plugins
run: cargo install mdbook-linkcheck

- run: mdbook build book

- name: Publish book
uses: peaceiris/actions-gh-pages@v3
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_branch: gh-pages-unstable
publish_dir: ./book/book
publish_dir: ./book/book/html
5 changes: 4 additions & 1 deletion .github/workflows/gh-page.yml
Original file line number Diff line number Diff line change
Expand Up @@ -17,10 +17,13 @@ jobs:
with:
mdbook-version: 'latest'

- name: Install mdbook plugins
run: cargo install mdbook-linkcheck

- run: mdbook build book

- name: Publish book
uses: peaceiris/actions-gh-pages@v3
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_dir: ./book/book
publish_dir: ./book/book/html
4 changes: 3 additions & 1 deletion book/book.toml
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,6 @@ src = "src"
[output.html]
cname = "halloy.squidowl.org"
git-repository-url = "https://github.com/squidowl/halloy"
edit-url-template = "https://github.com/squidowl/halloy/edit/main/book/{path}"
edit-url-template = "https://github.com/squidowl/halloy/edit/main/book/{path}"

[output.linkcheck]
2 changes: 1 addition & 1 deletion book/src/configuration/buffer.md
Original file line number Diff line number Diff line change
Expand Up @@ -554,7 +554,7 @@ Control if the text input should auto format the input. By default text is only
auto_format = "markdown"
```

> 💡 Read more about [text formatting](../../guides/text-formatting.html).
> 💡 Read more about [text formatting](../guides/text-formatting.html).

### `[buffer.text_input.autocomplete]`

Expand Down
4 changes: 2 additions & 2 deletions book/src/configuration/servers.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Eg:
# ...
```

> 💡 For a multiple server example see [here](../../guides/multiple-servers.html)
> 💡 For a multiple server example see [here](../guides/multiple-servers.html)

## `nickname`

Expand Down Expand Up @@ -368,7 +368,7 @@ who_poll_interval = 2

A list of nicknames to [monitor](https://ircv3.net/specs/extensions/monitor) (if IRCv3 Monitor is supported by the server).

> 💡 Read more about [monitoring users](../../guides/monitor-users.html).
> 💡 Read more about [monitoring users](../guides/monitor-users.html).

```toml
# Type: array of string
Expand Down
4 changes: 2 additions & 2 deletions book/src/guides/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ To get started with Halloy, you need to connect to at least one IRC server. The

Once connected to a server, you can join channels. This can be done automatically from the config file or manually using the join command: `/join #channel`[^1]. To find channels, you can either use the list command: `/list`, or [browse for channels online](https://netsplit.de/channels/).

> 💡 Configuration in Halloy happens through a `config.toml` file. See [Configuration](../configuration/index.html).
> 💡 Configuration in Halloy happens through a `config.toml` file. See [Configuration](../configuration/).

Here are a few useful IRC commands for a new user[^2]

Expand All @@ -18,4 +18,4 @@ Here are a few useful IRC commands for a new user[^2]


[^1]: Channel names always start with a `#` symbol and do not contain spaces.
[^2]: Find more commands [here](https://en.wikipedia.org/wiki/List_of_Internet_Relay_Chat_commands).
[^2]: Find more commands [here](https://en.wikipedia.org/wiki/List_of_Internet_Relay_Chat_commands).
2 changes: 1 addition & 1 deletion book/src/guides/multiple-servers.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Multiple servers

Creating multiple `[servers]` sections lets you connect to multiple servers.
All configuration options can be found [here](../configuration/servers/index.html).
All configuration options can be found [here](../configuration/servers.html).

```toml
[servers.liberachat]
Expand Down