From: Dan Allen Date: Sun, 28 Jun 2020 20:54:21 +0000 (-0600) Subject: document the FORCE_SHOW_EDIT_PAGE_LINK environment variable X-Git-Url: https://old-git.evergreen-ils.org/?a=commitdiff_plain;h=3acbf71f3ba4010d623d3f9a8bb0467d5bb6fe13;p=eg-antora.git document the FORCE_SHOW_EDIT_PAGE_LINK environment variable --- diff --git a/docs/modules/ROOT/pages/templates.adoc b/docs/modules/ROOT/pages/templates.adoc index 3facf8b..1e06d65 100644 --- a/docs/modules/ROOT/pages/templates.adoc +++ b/docs/modules/ROOT/pages/templates.adoc @@ -129,8 +129,12 @@ If there are multiple versions of the component, the canonical URL is the qualif If there's only a single version of the component, the canonical URL is the qualified URL of the current page. | page.editUrl -| The URL to edit the current page (typically a web-based editor on the git host). -The only hosts supported right now are github.com, gitlab.com, pagure.io, and bitbucket.org. +| The URL to edit the current page (i.e., activates the web-based editor on the git host). +This value is derived automatically for the hosts github.com, gitlab.com, pagure.io, and bitbucket.org, even if the repository is private. +If the host is not recognized, or you want to customize the value, you can use the `edit_url` key on the content source in the playbook. + +The default UI shows an "Edit this Page" link that points to this URL unless the repository is private (i.e., `page.origin.private` is true). +You can force the link to be shown by setting the environment variable `FORCE_SHOW_EDIT_PAGE_LINK` or by customizing the UI template. | page.origin.private | This value will be true if the repository requires authentication or the repository URL embeds credentials.