mirror of
https://github.com/pulsar-edit/pulsar.git
synced 2025-01-09 00:30:14 +03:00
📝 Update customizing atom guide
This commit is contained in:
parent
30ea10cfb8
commit
3589fcc107
@ -2,57 +2,26 @@
|
|||||||
"title": "Customizing Atom"
|
"title": "Customizing Atom"
|
||||||
}}}
|
}}}
|
||||||
|
|
||||||
# Configuration Settings
|
# Customizing Atom
|
||||||
|
|
||||||
## Your .atom Directory
|
To change a setting, configure a theme, or install a package just open the
|
||||||
|
Settings pane in the current window by pressing `cmd+,`.
|
||||||
|
|
||||||
When you install Atom, an _.atom_ directory is created in your home directory.
|
## Changing The Theme
|
||||||
If you press `cmd-,`, that directory is opened in a new window. For the
|
|
||||||
time being, this serves as the primary interface for adjusting configuration
|
|
||||||
settings, adding and changing key bindings, tweaking styles, etc.
|
|
||||||
|
|
||||||
Atom loads configuration settings from the `config.cson` file in your _~/.atom_
|
Because Atom themes are based on CSS, it's possible (and encouraged) to have
|
||||||
directory, which contains CoffeeScript-style JSON:
|
multiple themes active at the same time. Atom comes with both light and dark
|
||||||
|
interface themes as well as several syntax themes (you can also [create your
|
||||||
|
own][create-theme]).
|
||||||
|
|
||||||
```coffeescript
|
To change the active themes just open the Settings pane (`cmd-,`) and select the
|
||||||
core:
|
`Themes` tab. You can install non-bundled themes by going to the `Available
|
||||||
hideGitIgnoredFiles: true
|
Themes` section on the `Packages` tab within the Settings panel.
|
||||||
editor:
|
|
||||||
fontSize: 18
|
|
||||||
```
|
|
||||||
|
|
||||||
Configuration is broken into namespaces, which are defined by the config hash's
|
## Installing Packages
|
||||||
top-level keys. In addition to Atom's core components, each package may define
|
|
||||||
its own namespace.
|
|
||||||
|
|
||||||
## Glossary of Config Keys
|
You can install non-bundled packages by going to the `Available Packages` section
|
||||||
|
on the `Packages` tab within the Settings panel (`cmd-,`).
|
||||||
- `core`
|
|
||||||
- `disablePackages`: An array of package names to disable
|
|
||||||
- `hideGitIgnoredFiles`: Whether files in the _.gitignore_ should be hidden
|
|
||||||
- `ignoredNames`: File names to ignore across all of Atom (not fully implemented)
|
|
||||||
- `themes`: An array of theme names to load, in cascading order
|
|
||||||
- `autosave`: Save a buffer when its view loses focus
|
|
||||||
- `editor`
|
|
||||||
- `autoIndent`: Enable/disable basic auto-indent (defaults to `true`)
|
|
||||||
- `autoIndentOnPaste`: Enable/disable auto-indented pasted text (defaults to `false`)
|
|
||||||
- `nonWordCharacters`: A string of non-word characters to define word boundaries
|
|
||||||
- `fontSize`: The editor font size
|
|
||||||
- `fontFamily`: The editor font family
|
|
||||||
- `invisibles`: Specify characters that Atom renders for invisibles in this hash
|
|
||||||
- `tab`: Hard tab characters
|
|
||||||
- `cr`: Carriage return (for Microsoft-style line endings)
|
|
||||||
- `eol`: `\n` characters
|
|
||||||
- `space`: Leading and trailing space characters
|
|
||||||
- `preferredLineLength`: Identifies the length of a line (defaults to `80`)
|
|
||||||
- `showInvisibles`: Whether to render placeholders for invisible characters (defaults to `false`)
|
|
||||||
- `fuzzyFinder`
|
|
||||||
- `ignoredNames`: Files to ignore *only* in the fuzzy-finder
|
|
||||||
- `whitespace`
|
|
||||||
- `ensureSingleTrailingNewline`: Whether to reduce multiple newlines to one at the end of files
|
|
||||||
- `wrapGuide`
|
|
||||||
- `columns`: Array of hashes with a `pattern` and `column` key to match the
|
|
||||||
the path of the current editor to a column position.
|
|
||||||
|
|
||||||
## Customizing Key Bindings
|
## Customizing Key Bindings
|
||||||
|
|
||||||
@ -66,7 +35,7 @@ built-in keymaps:
|
|||||||
'enter': 'editor:newline'
|
'enter': 'editor:newline'
|
||||||
|
|
||||||
".select-list .editor.mini":
|
".select-list .editor.mini":
|
||||||
'enter': 'core:confirm',
|
'enter': 'core:confirm'
|
||||||
```
|
```
|
||||||
|
|
||||||
This keymap defines the meaning of `enter` in two different contexts. In a
|
This keymap defines the meaning of `enter` in two different contexts. In a
|
||||||
@ -80,32 +49,68 @@ in alphabetical order when Atom is started. They will always be loaded last,
|
|||||||
giving you the chance to override bindings that are defined by Atom's core
|
giving you the chance to override bindings that are defined by Atom's core
|
||||||
keymaps or third-party packages.
|
keymaps or third-party packages.
|
||||||
|
|
||||||
## Changing The Theme
|
## Advanced Configuration
|
||||||
|
|
||||||
Atom comes bundled with two themes `atom-dark-*` and `atom-light-*`.
|
Atom loads configuration settings from the `config.cson` file in your _~/.atom_
|
||||||
|
directory, which contains CoffeeScript-style JSON:
|
||||||
|
|
||||||
Because Atom themes are based on CSS, it's possible to have multiple themes
|
```coffeescript
|
||||||
active at the same time.
|
core:
|
||||||
|
hideGitIgnoredFiles: true
|
||||||
|
editor:
|
||||||
|
fontSize: 18
|
||||||
|
```
|
||||||
|
|
||||||
For example, you'll usually select a theme for the UI and another theme for
|
The configuration itself is grouped by the package name or one of the two core
|
||||||
syntax highlighting. You can change themes from the preferences pane.
|
namespaces: `core` and `editor`.
|
||||||
|
|
||||||
You install new themes by placing them in the _~/.atom/themes_ directory. A
|
### Configuration Key Reference
|
||||||
theme can be a single LESS file or a directory containing multiple LESS files.
|
|
||||||
|
|
||||||
## Installing Packages
|
- `core`
|
||||||
|
- `autosave`: Save a buffer when its view loses focus
|
||||||
|
- `disabledPackages`: An array of package names to disable
|
||||||
|
- `excludeVcsIgnoredPaths`: Don't search within files specified by _.gitignore_
|
||||||
|
- `hideGitIgnoredFiles`: Whether files in the _.gitignore_ should be hidden
|
||||||
|
- `ignoredNames`: File names to ignore across all of Atom (not fully implemented)
|
||||||
|
- `projectHome`: The directory where projects are assumed to be located
|
||||||
|
- `themes`: An array of theme names to load, in cascading order
|
||||||
|
- `editor`
|
||||||
|
- `autoIndent`: Enable/disable basic auto-indent (defaults to `true`)
|
||||||
|
- `autoIndentOnPaste`: Enable/disable auto-indented pasted text (defaults to `false`)
|
||||||
|
- `nonWordCharacters`: A string of non-word characters to define word boundaries
|
||||||
|
- `fontSize`: The editor font size
|
||||||
|
- `fontFamily`: The editor font family
|
||||||
|
- `invisibles`: Specify characters that Atom renders for invisibles in this hash
|
||||||
|
- `tab`: Hard tab characters
|
||||||
|
- `cr`: Carriage return (for Microsoft-style line endings)
|
||||||
|
- `eol`: `\n` characters
|
||||||
|
- `space`: Leading and trailing space characters
|
||||||
|
- `normalizeIndentOnPaste`: Enable/disable conversion of pasted tabs to spaces
|
||||||
|
- `preferredLineLength`: Identifies the length of a line (defaults to `80`)
|
||||||
|
- `showInvisibles`: Whether to render placeholders for invisible characters (defaults to `false`)
|
||||||
|
- `showIndentGuide`: Show/hide indent indicators within the editor
|
||||||
|
- `showLineNumbers`: Show/hide line numbers within the gutter
|
||||||
|
- `softWrap`: Enable/disable soft wrapping of text within the editor
|
||||||
|
- `softWrapAtPreferredLineLength`: Enable/disable soft line wrapping at `preferredLineLength`
|
||||||
|
- `tabLength`: Number of spaces within a tab (defaults to `2`)
|
||||||
|
- `fuzzyFinder`
|
||||||
|
- `ignoredNames`: Files to ignore *only* in the fuzzy-finder
|
||||||
|
- `whitespace`
|
||||||
|
- `ensureSingleTrailingNewline`: Whether to reduce multiple newlines to one at the end of files
|
||||||
|
- `removeTrailingWhitespace`: Enable/disable striping of whitespace at the end of lines (defaults to `true`)
|
||||||
|
- `wrapGuide`
|
||||||
|
- `columns`: Array of hashes with a `pattern` and `column` key to match the
|
||||||
|
the path of the current editor to a column position.
|
||||||
|
|
||||||
FIXME: Rewrite for the new dialog.
|
### Quick Personal Hacks
|
||||||
|
|
||||||
## Quick Personal Hacks
|
|
||||||
|
|
||||||
### user.coffee
|
### user.coffee
|
||||||
|
|
||||||
When Atom finishes loading, it will evaluate _user.coffee_ in your _~/.atom_
|
When Atom finishes loading, it will evaluate _user.coffee_ in your _~/.atom_
|
||||||
directory, giving you a chance to run arbitrary personal CoffeeScript code to
|
directory, giving you a chance to run arbitrary personal CoffeeScript code to
|
||||||
make customizations. You have full access to Atom's API from code in this file.
|
make customizations. You have full access to Atom's API from code in this file.
|
||||||
Please refer to the [Atom Internals Guide](./internals/intro,md) for more information. If your
|
If customizations become extensive, consider [creating a
|
||||||
customizations become extensive, consider [creating a package](./packages/creating_packages.md).
|
package][create-a-package].
|
||||||
|
|
||||||
### user.less
|
### user.less
|
||||||
|
|
||||||
@ -123,3 +128,6 @@ contains the cursor, you could add the following style to _user.less_:
|
|||||||
color: @highlight-color;
|
color: @highlight-color;
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
[create-a-package]: creating-packages.md
|
||||||
|
[create-theme]: creating-a-theme.md
|
||||||
|
Loading…
Reference in New Issue
Block a user