Check if page is mounted?

support
1

Is there any way to check if the current page has been mounted to a different directory?

The reason I’m asking is:
We import a number of Markdown files from other repositories. We also have “edit this page” links which points to the source file on GitHub. We construct the edit URL using the repo URL + .File.Path

This doesn’t work for pages that have been mounted to a different directory with modules. For example, clicking the edit link on this page gives you a 404: Dockerfile reference | Docker Docs

The source file for this page is located at https://github.com/moby/buildkit/blob/master/frontend/dockerfile/docs/reference.md
We mount the file like this: https://github.com/docker/docs/blob/main/hugo.yaml#L253-L254

I assume there’s no way for me to construct the actual GitHub URL for the source file. But if there was a way to to a boolean check to see if the current page has been mounted, then I could at least skip rendering the “edit this page” link for these pages.

2

I think you can look for the presence of .GitInfo on a page.

It would be nice if we could get .GitInfo across repositories, but I think that’s an expensive enhancement. See https://github.com/gohugoio/hugo/issues/5533.

3

@jmooring thanks, checking .GitInfo does help!

Unfortunately for me, we’re currently vendoring all the dependencies, so .GitInfo is not empty. Might have to reconsider vendoring then.

Agree that it would be nice to have .GitInfo across repositories!

4

When you mount a directory (not an individual file), are the contents mingled with an existing directory, or are you adding a new directory?

For example:

source: docs/api
target:content/engine/api  <-- does this directory already exist in the project, and does it have content?
5

I’m still interested in the answer to my previous question, but if all dependencies are vendored, they’re all in the _vendor directory, correct?

{{/* Must set enableGitInfo = true in site configuration. */}}

{{ if .File }}
  {{ if strings.HasPrefix (strings.TrimPrefix hugo.WorkingDir .File.Filename) "/_vendor/" }}
    {{ if .GitInfo }}
      I AM FROM A VENDORED MOUNT, AND I HAVE GITINFO
    {{ else }}
      I AM FROM A VENDORED MOUNT, BUT I DON'T HAVE GITINFO
    {{ end }}
  {{ else }}
    {{ if .GitInfo }}
      I AM NOT FROM A MOUNT, AND I HAVE GITINFO
    {{ else }}
      I AM FROM A NON-VENDORED MOUNT (OR MAYBE YOU HAVEN'T COMMITTED ME YET)
    {{ end }}
  {{ end }}
{{ else }}
  I AM NOT FROM A MOUNT, BUT I DON'T HAVE GITINFO BECAUSE I'M NOT BACKED BY A FILE
{{ end }}

The above should work regardless of whether or not you’ve vendored the dependencies.

6

Thanks a lot @jmooring - we vendor all of our dependencies so simply checking for _vendor in .File.Filename does it! Merge pull request #18097 from dvdksn/fix-edit-page-link-upstream · docker/docs@fbfd79b · GitHub