blob: 72eb3058d23996a44e8058e8b04f6a1bfdcb7097 (
plain)
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
|
---
title: "Repository Links"
linkTitle: "Repository Links"
weight: 8
description: >
Help your users interact with your source repository.
---
The Docsy [docs and blog layouts](/docs/adding-content/content/#adding-docs-and-blog-posts) include links for readers to edit the page or create issues for your docs or project via your site's source repository. The current generated links for each docs or blog page are:
* **Edit this page**: Brings the user to an editable version of the page content in their fork (if available) of your docs repo. If the user doesn't have a current fork of your docs repo, they are invited to create one before making their edit. The user can then create a pull request for your docs.
* **Create documentation issue**: Brings the user to a new issue form in your docs repo with the name of the current page as the issue's title.
* **Create project issue** (optional): Brings the user to a new issue form in your project repo. This can be useful if you have separate project and docs repos and your users want to file issues against the project feature being discussed rather than your docs.
This page shows you how to configure these links using your `config.toml` file.
Currently Docsy supports only GitHub repository links "out of the box". If you are using another repository such as Bitbucket and would like generated repository links, feel free to [add a feature request or update our theme](/docs/contribution-guidelines/).
## Link configuration
There are three variables you can configure in `config.toml` to set up links:
### `github_repo`
The URL for your site's source repository. This is used to generate the **Edit this page** and **Create documentation issue** links.
```toml
github_repo = "https://github.com/google/docsy"
```
### `github_subdir` (optional)
Specify a value here if your content directory is not in your repo's root directory. For example, this site is in the `userguide` subdirectory of its repo. Setting this value means that your edit links will go to the right page.
```toml
github_subdir = "userguide"
```
### `github_project_repo` (optional)
Specify a value here if you have a separate project repo and you'd like your users to be able to create issues against your project from the relevant docs. The **Create project issue** link appears only if this is set.
```toml
github_project_repo = "https://github.com/google/docsy"
```
|
