开源软件名称：

开源软件地址：

开源软件介绍：

philosophy|for whom?|screenshots|documentation|contribute|achievements|FAQ

Quick Install:

git clone https://github.com/syl20bnr/spacemacs ~/.emacs.d

Table of Contents

• Introduction
• Features
• Documentation
• Getting Help
• Prerequisites
  • Emacs
    • Linux distros
    • macOS
    • Windows
• Install
  • Default installation
  • Alternate installations
    • Modify HOME environment variable
    • Modify spacemacs-start-directory variable
  • Spacemacs logo
• Update
  • Automatic update (on master branch)
  • Manual update (on master branch)
  • On develop branch
  • Revert to a specific version
• Quotes
• Contributions
• Communities
• License
• Supporting Spacemacs

Introduction

Spacemacs is a new way to experience Emacs -- a sophisticated andpolished set-up focused on ergonomics, mnemonics and consistency.

Just clone it, launch it, then press the space bar to explore theinteractive list of carefully-chosen key bindings. You can also pressthe home buffer's [?] button for some great first key bindings totry.

Spacemacs can be used naturally by both Emacs and Vim users -- you caneven mix the two editing styles. Switching easily between input stylesmakes Spacemacs a great tool for pair-programming.

Spacemacs is currently in beta, and contributions are very welcome.

Features

• Great documentation: access documentation in Emacs withSPC h SPC.
• Beautiful GUI: you'll love the distraction free UI and its functionalmode-line.
• Excellent ergonomics: all the key bindings are accessible by pressingthe space bar or alt-m.
• Mnemonic key bindings: commands have mnemonic prefixes likeSPC b for all the buffer commands or SPC p for theproject commands.
• Batteries included: discover hundreds of ready-to-use packages nicelyorganised in configuration layers following a set ofconventions.

Documentation

Comprehensive documentation is available for each layer by pressingSPC h SPC.

You can also check the general documentation,quick start guide and the FAQ.

Getting Help

If you need help, ask your question in the Gitter Chat and a member of thecommunity will help you out.

If you prefer IRC, connect to the Gitter Chat IRC server and join the#syl20bnr/spacemacs channel.

Prerequisites

Emacs

Spacemacs requires Emacs 24.4 or above. The development version of Emacs (at thetime of writing, this is 25.2) is not officially supported, but shouldnevertheless be expected to work.

Some modes require third-party tools that you'll have to install via yourfavorite package manager.

Linux distros

Install Emacs from the package manager of your Linux distribution.

You should install the "emacs" package, not the "xemacs" package.XEmacs is an old fork of Emacs. The X in its name is unrelated to X11.Both Emacs and XEmacs have graphical support.

Note: Ubuntu LTS 12.04 and 14.04 repositories have only Emacs 24.3available. You have to build from source Emacs 24.4 or greater,as Spacemacs won't work with 24.3. The same may be true for other distributionsas well.

macOS

The recommended way of installing Emacs on macOS is using homebrew:

$ brew tap d12frosted/emacs-plus$ brew install emacs-plus$ brew linkapps emacs-plus

Note: these homebrew commands will install GNU Emacs, and link it to your/Applications directory. You still need to run the git clone mentioned atthe start of this file. That will populate your ~/.emacs.d directory, which iswhat transforms a regular GNU Emacs into Spacemacs.

Note: the proposed emacs-plus tap is identical to the emacs formulae, itjust builds GNU Emacs with support of several features by default along withproviding Spacemacs icon.See emacs-plus for moreinformation.

Note: after you have completed the install process below, it isalso recommended to add the osx layer to your dotfile. Installinstructions are available in the osx layer documentation.

Note: if the powerline separators on the spaceline are a different (lesssaturated) color than the rest of the line, you can add following snippet todotspacemacs/user-config in your .spacemacs file.

(setq ns-use-srgb-colorspace nil)

Keep in mind that this is not ideal solution as it affects all colours in Emacs.Another option is to use different powerline separator. For example, alternateand bar diminishes the difference. And using utf-8 separator makes it goaway completely without the need to change colour space. In order to changepowerline separator put following snippet in dotspacemacs/user-config.

(setq powerline-default-separator 'utf-8)

For more information about powerline separators, please refer to appropriatesection in Documentation.

Windows

You can download good quality builds from the emacs-w64 project.It is recommended to install the most recent stable build.

Be sure to declare a environment variable named HOME pointing to your userdirectory C:\Users\<username>. Then you can clone Spacemacs in this directory.

Sometimes you'll get the following error when you first start Emacs:

The directory ~/.emacs.d/server is unsafe

To fix it change the owner of the directory ~/.emacs.d/server:

• from Properties select the Tab “Security”,
• select the button “Advanced”,
• select the Tab “Owner”
• change the owner to your account name

Source: Stack Overflow

For efficient searches we recommend to install pt (the platinum searcher).pt version 1.7.7 or higher is required.

Install

Default installation

1. If you have an existing Emacs configuration, back it up first:

   cd ~mv .emacs.d .emacs.d.bakmv .emacs .emacs.bak

   Don't forget to backup and remove ~/.emacs file otherwise SpacemacsWILL NOT load since that file prevents Emacs from loading the properinitialization file.

2. Clone the repository:

   git clone https://github.com/syl20bnr/spacemacs ~/.emacs.d

   master is the stable branch and it is immutable, DO NOT make anymodification to it or you will break the update mechanism. If you want tofork Spacemacs safely use the develop branch where you handle the updatemanually.

3. (Optional) Install the Source Code Pro font.

   If you are running in terminal you'll also need to change font settings ofyour terminal.

4. Launch Emacs. Spacemacs will automatically install the packages it requires.If you get an error regarding package downloads then you may try to disablethe HTTPS protocol by starting Emacs with

   emacs --insecure

   Or you can set the dotspacemacs-elpa-https to nil in your dotfile toremove the need to start Emacs with --insecure argument. You may wish toclear out your .emacs.d/elpa directory before doing this, so that anycorrupted packages you may have downloaded will be re-installed.

5. Restart Emacs to complete the installation.

If the mode-line turns red then be sure to consult the FAQ.

Alternate installations

It may be useful to clone Spacemacs outside Emacs dotdirectory ~/.emacs.d soyou can try Spacemacs without replacing completely our own configuration.There is currently two possibilities to support alternative location forSpacemacs configuration.

Modify HOME environment variable

This solution is ideal to quickly try Spacemacs without compromising yourexisting configuration.

mkdir ~/spacemacsgit clone https://github.com/syl20bnr/spacemacs.git ~/spacemacs/.emacs.dHOME=~/spacemacs emacs

Note: If you're on Fish shell, you will need to modify the last command to: env HOME=$HOME/spacemacs emacs

Modify spacemacs-start-directory variable

This solution is better suited to "embed" Spacemacs into your own configuration.Say you cloned Spacemacs in ~/.emacs.d/spacemacs/ then drop these lines in~/.emacs.d/init.el:

(setq spacemacs-start-directory "~/.emacs.d/spacemacs/")(load-file (concat spacemacs-start-directory "init.el"))

Spacemacs logo

For Ubuntu users, follow this guide tochange the logo in Unity.

For Mac users, you need to download the .icns version of the logo,then change the logo on Dock.

Update

Spacemacs has a built-in notification of a new version when you are on themaster branch. If you are on the develop branch then you'll have toupdate Spacemacs manually by updating your repository.

Automatic update (on master branch)

When a new version is available a little arrow appears in the mode-line.

Its color depends on the number of versions available since your last update.Green means that your current version is recent, orange and red mean that yourcurrent version is older.

Click on the arrow to update Spacemacs to the last version.

Manual update (on master branch)

(Remove the angle brackets when typing the lines below into your shell.)

git fetchgit reset --hard <tag version which you are updating to>

On develop branch

1. Update Emacs packages by clicking (press RET) on the [Update Packages] link ofthe starting page.

2. Close Emacs and update the git repository:

   git pull --rebase

3. Restart Emacs to complete the upgrade.

Revert to a specific version

To revert to a specific version you just have to checkout the correspondingbranch, for instance to revert to the last 0.103:

git checkout origin/release-0.103

After you update, either manually, or automatically, you are advised to updateyour packages by clicking the [Update Packages] button on the Spacemacs HomeBuffer.

Quotes

Quote by ashnur:

«I feel that spacemacs is an aircraft carrier and I am playing table tennis on the deck as a freerider.»

Quote by deuill:

«I LOVE SPACEMACS AND MAGIT That is all»

Contributions

Spacemacs is a community-driven project, it needs you to keep it up todate and propose great and useful configuration for all the things!

Before contributing be sure to consult thecontribution guidelines and conventions.

Here is a throughput graph of the repository for the last few weeks:

Communities

• Gitter Chat
• Stack Exchange
• Reddit

License

The license is GPLv3 for all parts specific to Spacemacs, this includes:

• the initialization and core files
• all the layer files
• the documentation

For the packages shipped in this repository you can refer to the files header.

Spacemacs logo by Nasser Alshammari released under a Creative Commons Attribution-ShareAlike 4.0 International License.

Supporting Spacemacs

The best way to support Spacemacs is to contribute to it either by reportingbugs, helping the community on the Gitter Chat or sending pull requests.

You can show your love for the project by getting cool Spacemacs t-shirts, mugsand more in the Spacemacs Shop.

If you want to show your support financially you can contribute to Bountysource or buy a drink for themaintainer by clicking on the Paypal badge.

If you used spacemacs in a project and you want to show that fact, you can usethe spacemacs badge:

• For Markdown:

  [![Built with Spacemacs](https://cdn.rawgit.com/syl20bnr/spacemacs/442d025779da2f62fc86c2082703697714db6514/assets/spacemacs-badge.svg)](http://spacemacs.org)

• For HTML:

  <a href="http://spacemacs.org"><img src="https://cdn.rawgit.com/syl20bnr/spacemacs/442d025779da2f62fc86c2082703697714db6514/assets/spacemacs-badge.svg" /></a>

• For Org-mode:

  [[http://spacemacs.org][file:https://cdn.rawgit.com/syl20bnr/spacemacs/442d025779da2f62fc86c2082703697714db6514/assets/spacemacs-badge.svg]]

Thank you!