Appendix: author-config.csv advanced syntax

Given below are the advanced syntax available for author-config.csv.

Multiple Repository's Location per author

Specifying multiple Repository's Location

To specify multiple Repository's Location in a single row, we can use a semicolon ; as a separator.

Below is an example:

Repository's Location Branch Author's Git Host ID ... Hidden columns
https://github.com/reposense/RepoSense.git;https://github.com/MarkBind/markbind.git master sikai00 --

We have now furnished author details for both repositories in a single row, instead of having two individual rows per Repository's Location.


Specifying Repository's Location with one or more specific branches

To list out one or more branches for a particular Repository's Location, we can use a pipe | separator to demarcate the different branches.

Below is an example:

Repository's Location Branch Author's Git Host ID ... Hidden columns
https://github.com/reposense/RepoSense.git~master|release|cypress master sikai00 --

We have now provided author details for three different branches in a single repo, using a single row.

The branch specified through the delimiter syntax will take precedence over the Branch column.

Using GitHub branch URL as Repository's Location

We can also use GitHub branch URL as copied from the address bar directly, to be able to quickly use the URL to specify the Repository's Location and a specific Branch at the same time.

Below is an example:

Repository's Location Branch Author's Git Host ID ... Hidden columns
https://github.com/reposense/RepoSense/tree/release sikai00 --

There is no need to specify the Branch column now, as we have specified it through the GitHub branch URL.

GitLab and BitBucket branch URL are not supported at the moment.

Combining the advanced syntax

It is possible to combine the above-mentioned advanced syntax. By doing so, we can go from:

Repository's Location Branch Author's Git Host ID ... Hidden columns
https://github.com/MarkBind/markbind/tree/vue3-migration sikai00 --
https://github.com/reposense/RepoSense.git master sikai00 --
https://github.com/reposense/RepoSense.git cypress sikai00 --

to:

Repository's Location Branch Author's Git Host ID ... Hidden columns
https://github.com/MarkBind/markbind/tree/vue3-migration;https://github.com/reposense/RepoSense.git~master|cypress sikai00 --