1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/coeuvre-spacemacs

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
Внести вклад в разработку кода
Синхронизировать код
Отмена
Подсказка: Поскольку Git не поддерживает пустые директории, создание директории приведёт к созданию пустого файла .keep.
Loading...
README.md

Функциональный режим

Отличная эргономика: все основные сочетания клавиш доступны при нажатии:

  • пробел;
  • alt-m.

Мнемонические сочетания клавиш: команды имеют мнемонические префиксы, такие как:

  • SPC b для всех команд буфера;
  • SPC p для команд проекта.

Всё включено: откройте для себя сотни готовых к использованию пакетов, красиво организованных в конфигурационные слои в соответствии с набором соглашений.

Документация

Доступна исчерпывающая документация по каждому слою при нажатии SPC h SPC.

Вы также можете ознакомиться с общей документацией, кратким руководством и FAQ.

Получение помощи

Если вам нужна помощь, задайте свой вопрос в Gitter Chat и член сообщества поможет вам.

Если вы предпочитаете IRC, подключитесь к серверу IRC Gitter Chat[] и присоединитесь к каналу #syl20bnr/spacemacs.

Предварительные требования

Emacs

Spacemacs требует Emacs 24.4 или выше. Версия разработки Emacs (на момент написания это 25.2) официально не поддерживается, но тем не менее должна работать.

Для некоторых режимов требуются сторонние инструменты, которые необходимо установить через ваш любимый менеджер пакетов.

Дистрибутивы Linux

Установите Emacs из менеджера пакетов вашего дистрибутива Linux.

Вам следует установить пакет «emacs», а не пакет «xemacs». XEmacs — это старый форк Emacs. X в его названии не связан с X11. И Emacs, и XEmacs поддерживают графический интерфейс.

Примечание. В репозиториях Ubuntu LTS 12.04 и 14.04 доступен только Emacs 24.3. Вам нужно [собрать из исходного кода][build_source] Emacs 24.4 или более позднюю версию, так как Spacemacs не будет работать с версией 24.3. То же самое может быть верно и для других дистрибутивов.

macOS

Рекомендуемый способ установки Emacs на macOS — использовать homebrew:

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

Примечание: эти команды homebrew установят GNU Emacs и свяжут его с вашим каталогом /Applications. Вам всё равно нужно запустить git clone, упомянутый в начале этого файла. Это заполнит ваш каталог ~/.emacs.d, который превращает обычный GNU Emacs в Spacemacs.

Примечание: предложенный кран emacs-plus идентичен формулам emacs, он просто собирает GNU Emacs с поддержкой нескольких функций по умолчанию, а также предоставляет значок Spacemacs. Дополнительную информацию см. в emacs-plus.

Примечание: после завершения процесса установки ниже рекомендуется также добавить [слой osx][] в ваш dotfile. Инструкции по установке доступны в документации [слоя osx] [].

Примечание: если разделители powerline на spaceline имеют другой (менее насыщенный) цвет, чем остальная часть строки, вы можете добавить следующий фрагмент в dotspacemacs/user-config в вашем файле .spacemacs:

(setq ns-use-srgb-colorspace nil)

Имейте в виду, что это не идеальное решение, поскольку оно влияет на все цвета в Emacs. Другой вариант — использовать другой разделитель powerline. Например, alternate и bar уменьшают разницу. А использование utf-8 разделителя полностью устраняет необходимость изменения цветового пространства. Чтобы изменить разделитель powerline, поместите следующий фрагмент в dotspacemacs/user-config.

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

Дополнительную информацию о разделителях powerline см. в соответствующем разделе документации.

Windows

Вы можете скачать высококачественные сборки из проекта emacs-w64. Рекомендуется установить самую последнюю стабильную сборку.

Обязательно объявите переменную среды с именем HOME, указывающую на ваш пользовательский каталог C:\Users\<username>. Затем вы можете клонировать Spacemacs в этот каталог.

Иногда при первом запуске Emacs вы получаете следующую ошибку:

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

Чтобы исправить это, измените владельца каталога ~/.emacs.d/server:

  • через свойства. Выберите вкладку «Безопасность»,
    выберите кнопку «Дополнительно»,
    выберите вкладку «Владелец»
    и измените владельца на имя вашей учётной записи.

Источник: Stack Overflow

Для эффективного поиска мы рекомендуем установить pt (the platinum searcher). Требуется версия 1.7.7 или выше.

Установка

Обычная установка

  1. Если у вас есть существующая конфигурация Emacs, сначала сделайте резервную копию:

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

    Не забудьте сделать резервную копию и удалить файл ~/.emacs, иначе Spacemacs НЕ БУДЕТ загружаться, так как этот файл мешает Emacs загрузить правильный файл инициализации.

  2. Клонируйте репозиторий:

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

    master — это стабильная ветка, она неизменяема, НЕ вносите в неё никаких изменений, иначе вы нарушите механизм обновления. Если вы хотите безопасно разветвить Spacemacs, используйте ветку develop, где вы будете управлять обновлением вручную.

  3. (Необязательно) Установите шрифт [Source Code Pro][] . Если вы работаете в терминале, вам также потребуется изменить настройки шрифта вашего терминала.

  4. Запустите Emacs. Spacemacs автоматически установит необходимые пакеты. Если вы получаете сообщение об ошибке относительно загрузки пакетов, вы можете попробовать отключить протокол HTTPS, запустив Emacs с помощью команды:

    emacs --insecure

    Или вы можете установить dotspacemacs-elpa-https в значение nil в вашем файле dotfile, чтобы не запускать Emacs с аргументом --insecure. Возможно, перед этим вы захотите очистить каталог .emacs.d/elpa, чтобы все повреждённые пакеты, которые вы могли загрузить, были переустановлены.

  5. Перезапустите Emacs для завершения установки. Если строка режима становится красной, обязательно обратитесь к FAQ.

Альтернативная установка

Может быть полезно клонировать Spacemacs вне каталога точек Emacs ~/.emacs.d, чтобы вы могли попробовать Spacemacs без полной замены нашей собственной конфигурации. В настоящее время существует две возможности поддержки альтернативного расположения конфигурации Spacemacs.

Изменить переменную среды HOME

Это решение идеально подходит для быстрой проверки Spacemacs без ущерба для существующей конфигурации.

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

Примечание: если вы используете оболочку Fish, вам нужно будет изменить последнюю команду на: env HOME=$HOME/spacemacs emacs

Изменить переменную spacemacs-start-directory

Это решение лучше подходит для «внедрения» Spacemacs в вашу собственную конфигурацию. Скажем, вы клонировали Spacemacs в ~/.emacs.d/spacemacs/, тогда добавьте эти строки в ~/.emacs.d/init.el:

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

Логотип Spacemacs

Для пользователей Ubuntu следуйте этому руководству по [изменению логотипа в Unity][cpaulik-unity-icon]. Для пользователей Mac вам необходимо [загрузить версию логотипа .icns][icon-repository], а затем [изменить логотип на Dock][icon-mac-instructions].

Обновление

Spacemacs имеет встроенное уведомление о новой версии, когда вы находитесь на ветке master. Если вы находитесь на ветке develop, вам придётся обновить Spacemacs вручную, обновив свой репозиторий.

Автоматическое обновление (на главной ветке)

Когда доступна новая версия, в строке режима появляется маленькая стрелка. Её цвет зависит от количества версий, доступных с момента последнего обновления. Зелёный означает, что ваша текущая версия актуальна, оранжевый и красный означают, что ваша текущая версия устарела. powerline_update Нажмите на стрелку, чтобы обновить Spacemacs до последней версии.

Ручное обновление (на основной ветке)

(Удалите угловые скобки при вводе строк ниже в свою оболочку.)

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

На ветке разработки

  1. Обновите пакеты Emacs, нажав (нажмите RET) на ссылку [Update Packages] начальной страницы.
  2. Закройте Emacs и обновите репозиторий git:
    git pull --rebase
    ``` **3. Перезапустите Emacs для завершения обновления**
    

Возврат к определённой версии

Чтобы вернуться к определённой версии, вам нужно просто проверить соответствующую ветку, например, чтобы вернуться к последнему 0.103:

git checkout origin/release-0.103

После обновления, будь то вручную или автоматически, рекомендуется обновить пакеты, нажав кнопку «Обновить пакеты» в главном буфере Spacemacs.

Цитаты

[Цитата][quote01] от ashnur:

«Я чувствую, что spacemacs — это авианосец, а я играю в настольный теннис на палубе как фрирайдер».

[Цитата][quote02] от deuill:

«Мне нравится spacemacs и magit.

 Это всё».

Вклад

Spacemacs — проект, управляемый сообществом, ему нужны вы, чтобы поддерживать его в актуальном состоянии и предлагать отличные и полезные конфигурации для всего!

Прежде чем вносить свой вклад, обязательно ознакомьтесь с руководством по внесению вклада и соглашениями.

Вот график пропускной способности репозитория за последние несколько недель:

График пропускной способности

Сообщества

Лицензия

Лицензия GPLv3 распространяется на все части, относящиеся к Spacemacs, включая:

  • файлы инициализации и ядра;
  • все файлы слоёв;
  • документацию.

Для пакетов, поставляемых в этом репозитории, вы можете обратиться к файлам заголовков.

[Логотип Spacemacs][] от Nasser Alshammari выпущен под лицензией Creative Commons Attribution-ShareAlike 4.0 International.

Поддержка Spacemacs

Лучший способ поддержать Spacemacs — внести свой вклад либо путём сообщения об ошибках, помощи сообществу в Gitter Chat или отправки запросов на вытягивание.

Вы можете выразить свою любовь к проекту, приобретая классные футболки, кружки и многое другое в [магазине Spacemacs][].

Если вы хотите поддержать проект финансово, вы можете внести свой вклад в [Bountysource][] или купить напиток для сопровождающего, нажав на значок Paypal.

Если вы использовали spacemacs в проекте и хотите показать этот факт, вы можете использовать значок spacemacs: Создано с помощью Spacemacs

  • Для Markdown:

    [![Создано с помощью Spacemacs](https://cdn.rawgit.com/syl20bnr/spacemacs/442d025779da2f62fc86c2082703697714db6514/assets/spacemacs-badge.svg)](http://spacemacs.org)
  • Для HTML:

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

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

Спасибо!

[cpaulik-unity-icon]: http://splendidabacus.com/posts/2015/03/spacemacs-unity-icon/ [icon-mac-instructions]: http://www.idownloadblog.com/2014/07/16/как-изменить-значок-приложения-на-маке/ [icon-repository]: https://github.com/nashamri/spacemacs-logo [Stack Exchange]: http://emacs.stackexchange.com/questions/tagged/spacemacs [Reddit]: https://www.reddit.com/r/spacemacs [quote01]: https://gitter.im/syl20bnr/spacemacs?at=568e627a0cdaaa62045a7df6 [quote02]: https://gitter.im/syl20bnr/spacemacs?at=5768456c6577f032450cfedb [build_source]: https://www.gnu.org/software/emacs/manual/html_node/efaq/Установка-Emacs.html [Bountysource]: https://salt.bountysource.com/teams/spacemacs [Source Code Pro]: https://github.com/adobe-fonts/source-code-pro [Spacemacs Shop]: https://shop.spreadshirt.com/spacemacs-shop

Комментарии ( 0 )

Вы можете оставить комментарий после Вход в систему

Введение

A community-driven Emacs distribution - The best editor is neither Emacs nor Vim, it's Emacs *and* Vim! Развернуть Свернуть
CC-BY-SA-4.0
Отмена

Обновления

Пока нет обновлений

Участники

все

Недавние действия

Загрузить больше
Больше нет результатов для загрузки
1
https://api.gitlife.ru/oschina-mirror/coeuvre-spacemacs.git
git@api.gitlife.ru:oschina-mirror/coeuvre-spacemacs.git
oschina-mirror
coeuvre-spacemacs
coeuvre-spacemacs
master