Capable Search integration

Capable Search can sort and filter by Github files, show a Github panel on each page, and offer ready-made natural-language queries. Here is what you get:

  • Two sort options: Git Last Updated and Git File Count.

  • Four grid columns: Files, Repositories, Organizations and File Types.

  • Four filters: Minimum Files, Repository, Organization and File Type.

  • A Github panel on each page, subtitled Github files referenced on this page.

  • Four natural-language query suggestions.


#Worth knowing

The grid column labels and the CQL field names differ. The grid says Files where the sort menu and CQL say Git File Count.


#Where you do it

Task

Where

Connect your GitHub account

On a Confluence page, insert the Github file (Capable) macro, then press Connect GitHub in the macro. Or open the macro configuration and press Connect in the Browse GitHub window.

Add a file from a repository to a page

Macro configuration, then the Browse GitHub window.

Connect a second GitHub account (for example, work and personal)

In the Browse GitHub window, open the account dropdown and choose Add account. Or use the Manage Connections panel from the toolbar in the picker.


#Settings that affect this

Setting

Where

What it does

GitHub settings screen

Nowhere

Github has no tab in Capable global settings or space settings, and no admin screen to connect the site to GitHub. Each person connects their own GitHub account instead.

Hide GitHub across the whole site

Not on a settings screen

Hides Github site-wide, but only the byline. Existing Github macros still show on pages.

Turn GitHub on or off per space

Not on a settings screen

Turning Github off hides the byline in that space. Turning it on shows the byline even on pages with no Github file. Again, this is the byline only. Macros still show.



How it actually behaves.