Auto-convert pasted GitHub links
Paste a GitHub file link into the editor and it becomes the GitHub macro, with the repository, file path and branch taken from the link. No need to open the picker.
It works with github.com file links (the ones with /blob/ in them) and raw.githubusercontent.com links. Folder (tree/) links, gist links, GitHub Enterprise addresses and www.github.com do not convert.
#Where you do it
Task | Where |
|---|---|
Connect your GitHub account | On a Confluence page, insert the "Github file (Capable)" macro, then select Connect GitHub in the macro. Or open the macro's configuration and select Connect in the Browse GitHub window. |
Add a file from a repository to a page | Macro configuration → Browse GitHub window |
Add a file without opening the picker | The Confluence editor. Paste a GitHub file link. |
#Settings that affect this
Setting | Where | What it does |
|---|---|---|
There is no GitHub settings screen | Nowhere | Capable global settings and space settings have no GitHub tab. There is also no admin screen for connecting the whole site to GitHub. Each person connects their own account. |
Hide GitHub across the whole site | Capable's site-wide hidden capabilities setting | Hides GitHub across the whole site. This affects the byline only. Existing GitHub macros keep showing on pages. |
Turn GitHub on or off per space | Capable's per-space capability setting (always off or always on) | Always off hides the byline in that space. Always on shows it even on pages with no GitHub macro. Again, this affects the byline only. Macros still show. |
#Related
How it actually behaves.
