apm install code-annotations
Code Annotations (Atom package)
This is an atom package for creating code annotations. An annotation is a piece of content that has a name and can be displayed in atom. While working only the name of the code annotation is visible but it can be shown by clicking on the pin icon (in the atom gutter)
By default, this package can render the following kinds of content:
- links / URLs
- plain text
Further renderers can be added by installing code-annotation plugin packages.
Creation and destruction
Code annotations can be added and deleted from the context menu, from the
ShowCommandsView, and of course from the command palette.
When adding or removing the position is the current (or last) cursor is relevant (so just right clicking to a certain position is insufficient (for now)).
A new annotation is added above the line of the cursor; for deleting one the cursor must be at the annotation’s line.
Each annotation is identified by a name (so it must be unique among all annotations of the same project folder).
When creating an annotation its contents can be set in 2 ways:
- from a file (for e.g. images)
- from text input (for e.g. plain text)
- All annotations from text input are displayed as plain text first. The type can be changed later.
Navigating to annotations
show-all command a select list containing all package commands
There are only 2:
ctrl-alt-c ctrl-alt-c and
Yes, the first is what it looks like -
ctr-alt-c twice in a row.
This shortcut shows a select list with the commands of the package (so this is kinda like a prefiltered command palette).
escape is for hiding the container (see next section).
The reasoning behind this is to avoid conflicts with other packages without making it harder to use the package without the mouse.
Showing annotations (rendering)
Each annotation is associated with a file. The file extension of that file determines how the file contents are rendered in the popup (called
hide-container command (which is triggered on
The container is made visible by clicking on the icon displayed in the gutter - currently this is a pin icon.
- GitHub Flavored Markdown
- HTML (Ruby - ERB)
- Perl 6
- Shell Script