A preview of the full source code.
apm install minimap
- Plugin API: Use the plugin generation command and start developing your plugin right away.
- Decoration API: Use the same API to manage
TextEditor
andMinimap
decorations. - Canvas-based Rendering: Simple, fast and flexible.
Auto Toggle
: If checked the minimap is toggled on at startup. (default=true)Display Code Highlights
: If checked the code will be highlighted using the grammar tokens. (default=true)Display Minimap On Left
: If checked the minimap appears on the left side of editors, otherwise it appears on the ride side. (default=false)Char Height
: The height of a character in the minimap in pixels. (default=2)Char Width
: The width of a character in the minimap in pixels. (default=1)Interline
: The space between lines in the minimap in pixels. (default=1)Text Opacity
: The opacity used to render the line text in the minimap. (default=0.6)Display Plugins Controls
: If checked, the minimap plugins can be activated/deactivated from the minimap settings view and a quick settings dropdown will be available on the top right corner of the minimap. You need to restart Atom for this setting to be effective. (default=true)Minimap Scroll Indicator
: Toggles the display of a side line showing which part of the buffer is currently displayed by the minimap. The side line appear only if the minimap height is bigger than the editor view height. (default=true)Plugins *
: When plugins are installed, a setting is created for each to enable/disable them directly from the minimap settings view.Use Hardware Acceleration
: If checked the minimap scroll is done using atranslate3d
transform, otherwise thetranslate
transform is used. (default=true)
For instance the following result is obtained by setting a Char Height
of 1px
:
Customizing Key Bindings:
'atom-workspace':
'cmd-m': 'minimap:toggle'
'ctrl-alt-cmd-m': 'minimap:generate-plugin'
If you want to hide the default editor scrollbar, edit your style.less
(Open Your Stylesheet) and use the following snippet:
atom-text-editor .vertical-scrollbar,
atom-text-editor::shadow .vertical-scrollbar {
opacity: 0;
width: 0;
}
Use the Minimap: Generate Plugin
command available in the command palette or add a binding to the minimap:generate-plugin
event:
'atom-workspace':
'ctrl-alt-cmd-m': 'minimap:generate-plugin'
Below is the list of available plugins so far:
When the displayPluginsControls
setting is toggled on, plugins activation can be managed directly from the minimap package settings or by using the quick settings dropdown available on the mimimap itself:
- Minimap API Documentation
- How to create a minimap plugin?
- Minimap's Decorations API
- Quick Personal Hacks
The minimap
package try to follow the Atom contribution guidelines.
Especially, the commits should follow the conventions defined in the Git Commit Messages section of the guideline.
The CHANGELOG
content is then generated using the changelog-gen utils.
MIT