224 lines
7.3 KiB

<section id="branches-view" class="section--settings section--collapsible">
<div class="section__header">
<h2>
Branches view
<a
class="link__learn-more"
title="Learn more"
href="https://github.com/eamodio/vscode-gitlens/tree/master/#branches-view-"
>
<i class="icon icon__info"></i>
</a>
</h2>
<p class="section__header-hint">
Adds a Branches view
<a
class="command command--show-view"
title="Show View in Side Bar"
href="command:gitlens.showBranchesView"
></a>
to visualize, explore, and manage Git branches
</p>
</div>
<div class="section__collapsible">
<div class="section__group">
<div class="section__content">
<div class="settings settings--fixed ml-1">
<div class="setting">
<div class="setting__input">
<input
id="views.branches.showBranchComparison"
name="views.branches.showBranchComparison"
type="checkbox"
value="branch"
data-setting
/>
<label for="views.branches.showBranchComparison"
>Show a comparison of the branch with a user-selected reference (branch, tag, etc)
</label>
</div>
</div>
<div class="section__group">
<div class="section__content">
<div class="settings settings--fixed">
<div class="setting">
<div class="setting__input">
<input
id="views.branches.pullRequests.enabled"
name="views.branches.pullRequests.enabled"
type="checkbox"
data-setting
/>
<label for="views.branches.pullRequests.enabled"
>Show associated Pull Requests</label
>
</div>
<p class="setting__hint">
Requires a connection to a supported remote service (e.g. GitHub)
</p>
</div>
<div class="settings settings--fixed ml-2">
<div class="setting" data-enablement="views.branches.pullRequests.enabled">
<div class="setting__input">
<input
id="views.branches.pullRequests.showForBranches"
name="views.branches.pullRequests.showForBranches"
type="checkbox"
data-setting
disabled
/>
<label for="views.branches.pullRequests.showForBranches"
>Show the PR associated with each branch</label
>
</div>
</div>
<div class="setting" data-enablement="views.branches.pullRequests.enabled">
<div class="setting__input">
<input
id="views.branches.pullRequests.showForCommits"
name="views.branches.pullRequests.showForCommits"
type="checkbox"
data-setting
disabled
/>
<label for="views.branches.pullRequests.showForCommits"
>Show the PR that introduced each commit</label
>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="setting">
<div class="setting__input">
<label for="views.branches.branches.layout">Layout branches</label>
<div class="select-container">
<select
id="views.branches.branches.layout"
name="views.branches.branches.layout"
data-setting
>
<option value="list">as a list</option>
<option value="tree">as a tree</option>
</select>
</div>
</div>
</div>
<div class="setting">
<div class="setting__input">
<label for="sortBranchesBy">Sort branches</label>
<div class="select-container">
<select id="sortBranchesBy" name="sortBranchesBy" data-setting>
<option value="name:desc">by name, descending</option>
<option value="name:asc">by name, ascending</option>
<option value="date:desc">by date, descending</option>
<option value="date:asc">by date, ascending</option>
</select>
</div>
</div>
</div>
<div class="setting">
<div class="setting__input">
<label for="views.branches.files.layout">Layout files</label>
<div class="select-container">
<select
id="views.branches.files.layout"
name="views.branches.files.layout"
data-setting
>
<option value="auto">automatically</option>
<option value="list">as a list</option>
<option value="tree">as a tree</option>
</select>
</div>
</div>
<p class="setting__hint" data-visibility="views.branches.files.layout =auto">
Chooses the best layout based on the number of files at each nesting level
</p>
</div>
<div class="setting">
<div class="setting__input">
<input
id="views.branches.files.compact"
name="views.branches.files.compact"
type="checkbox"
data-setting
/>
<label for="views.branches.files.compact">Use compact file layout</label>
</div>
<p class="setting__hint">Compacts (flattens) unnecessary nesting when using a tree layouts</p>
</div>
<div class="setting">
<div class="setting__input">
<input
id="views.branches.avatars"
name="views.branches.avatars"
type="checkbox"
data-setting
/>
<label for="views.branches.avatars">Use author avatars</label>
</div>
</div>
</div>
</div>
<div class="section__preview">
<img
class="image__preview hidden"
src="#{root}/images/settings/branches-view-compare+pr.webp"
data-visibility="views.branches.showBranchComparison !false &amp; views.branches.pullRequests.enabled &amp; views.branches.pullRequests.showForBranches"
/>
<img
class="image__preview hidden"
src="#{root}/images/settings/branches-view-compare.webp"
data-visibility="views.branches.showBranchComparison !false &amp; views.branches.pullRequests.enabled =false"
/>
<img
class="image__preview hidden"
src="#{root}/images/settings/branches-view-compare.webp"
data-visibility="views.branches.showBranchComparison !false &amp; views.branches.pullRequests.enabled &amp; views.branches.pullRequests.showForBranches =false"
/>
<img
class="image__preview hidden"
src="#{root}/images/settings/branches-view-pr.webp"
data-visibility="views.branches.showBranchComparison =false &amp; views.branches.pullRequests.enabled &amp; views.branches.pullRequests.showForBranches"
/>
<img
class="image__preview hidden"
src="#{root}/images/settings/branches-view.webp"
data-visibility="views.branches.showBranchComparison =false &amp; views.branches.pullRequests.enabled =false"
/>
<img
class="image__preview hidden"
src="#{root}/images/settings/branches-view.webp"
data-visibility="views.branches.showBranchComparison =false &amp; views.branches.pullRequests.enabled &amp; views.branches.pullRequests.showForBranches =false"
/>
</div>
</div>
<div class="section__group">
<p class="section__hint">
<i class="icon icon__info"></i> For more options, open
<a
class="command"
title="Open Settings"
href="command:workbench.action.openSettings?%22gitlens.views.branches%22"
>Settings</a
>
and search for <b><i>gitlens.views.branches</i></b> or
<b><i>gitlens.views</i></b>
</p>
</div>
</div>
</section>