Skip to content

Commit

Permalink
Editing ksnip.md (#2158)
Browse files Browse the repository at this point in the history
* move to the tools folder in Desktop
* add images of ksnip's main interface and ksnip with an image opened
* remove headings related to options, as this is unnecessary
* reword sentences to remove passive voice and add simplification
* add the requirement of the EPEL repository
  • Loading branch information
sspencerwire authored Jul 4, 2024
1 parent d85af91 commit 42e5693
Show file tree
Hide file tree
Showing 4 changed files with 98 additions and 134 deletions.
134 changes: 0 additions & 134 deletions docs/desktop/ksnip.md

This file was deleted.

Binary file added docs/desktop/tools/images/ksnip.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
98 changes: 98 additions & 0 deletions docs/desktop/tools/ksnip.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,98 @@
---
title: Annotating Screenshots with Ksnip
author: Joseph Brinkman
contributors: Steven Spencer
tested_with: 9.4
tags:
- Desktop
- Screenshot utility
---

## Prerequisites and assumptions

- Rocky 9.4 Workstation
- `sudo` privileges

## Introduction

Ksnip is a screenshot utility feature rich with tools for annotating screenshots. This guide focuses on installing Ksnip and its annotation tools.

## Install Ksnip

Ksnip requires the EPEL repository. If you do not have the EPEL enabled, you can do that with:

```bash
sudo dnf install epel-release
```

Then perform a system update:

```bash
sudo dnf update -y
```

Now, install Ksnip:

```bash
sudo dnf install ksnip -y
```

## Open an image

1. Open Ksnip
2. Click `File > Open`
3. Select the image you want to annotate

![ksnip](images/ksnip.png)

![ksnip_open](images/ksnip_image_opened.png)

## Annotate an image with Ksnip

Ksnip has handy and intuitive tools to annotate screenshots. In the image, down the left side are the options described below.

The `Select` tool: used to make a selection. Click an item to select it or click and drag to make a selection.

The `Duplicate` tool: used to duplicate a selection. Click and drag to make a selection. Then click and drag the selection to move or further transform it.

The `Arrow` tool: used to create arrows. Click and drag to create an arrow.

The `Double Arrow` tool (chosen by clicking the down arrow next to the arrow): used to create double-sided arrows. Click and drag to create a double-sided arrow.

The `Line` tool: used to create straight lines. Click and drag to create a line.

The `Pen` tool: used to make strokes that resemble a pen. Click and move the cursor across the screenshot to use the Pen. Customization options exist to change the style and stroke of the Pen in the top toolbar.

The `Marker Pen` tool: used to make strokes that resemble a highlighter. Hold click and move drag the cursor across the screenshot to use the Marker Pen. Customizations exist to change the opacity in the top toolbar.

The `Marker Rectangle` tool: is the Marker Pen tool, but when you click and drag your cursor, the Marker Rectangle tool will fill the rectangular selection. Customizations exist to change the opacity in the top toolbar.

The `Marker Ellipse` tool: is the Marker Pen tool, but when you left-click and drag your cursor, the Marker Ellipse tool will fill the ellipse made from the selection. Customizations exist to change the opacity in the top toolbar.

The `Text` tool: used to annotate a screenshot with text. Click anywhere on the image and begin typing to use the Text tool. Customizations exist in the top toolbar to change the border, color, font-family, font-size, font-style, and opacity of your text.

The `Text Pointer` tool: used to annotate a screenshot with text attached to a pointer. The pointer should bring attention to the text, similar to the Text Arrow tool.

The `Text Arrow` tool: used to annotate a screenshot with text attached to an arrow. The pointer should bring attention to the text, similar to the Text Pointer tool.

The `Number` tool: used to annotate a screenshot with a numbered shape. Click anywhere on the image to place a numbered shape. Customizations exist in the top toolbar to change the color, width, and opacity.

The `Number Pointer` tool: used to annotate a screenshot with a numbered shape attached to a pointer. Click anywhere on the image to place a numbered shape attached to a pointer. Customizations exist in the top toolbar to change the color, width, and opacity.

The `Number Arrow` tool: used to annotate a screenshot with a numbered shape attached to a pointer. Click anywhere on the image to place a numbered shape attached to an arrow. Customizations exist in the top toolbar to change the color, width, and opacity.

The `Blur` tool: used to blur a selection. Left-click and drag anywhere on the screenshot to blur a selection.

The `Pixelate` tool: used to pixelate a selection. Left-click and drag anywhere on the screenshot to pixelate a selection.

The `Rectangle` tool: used to make a rectangle from a selection. Left-click and drag anywhere on the screenshot to make rectangular selection. Customizations exist in the top toolbar to change the color, width, and opacity.

The `Ellipse` tool: used to make an ellipse from a selection. Left-click and drag anywhere on the screenshot to place an ellipse. Customizations exist in the top toolbar to change the color, width, and opacity.

The `Sticker` tool: used to place a sticker or emoji on a screenshot. Selecting the tool and clicking will place the sticker.

## Conclusion

Ksnip is an excellent utility for annotating screenshots. It can also take screenshots, however the main focus of this guide is the annotation capabilities and tools provided by Ksnip.

Checkout the [Ksnip GitHub Repo](https://github.com/ksnip/ksnip){target="_blank"} to learn more about this excellent screenshot utility.

0 comments on commit 42e5693

Please sign in to comment.