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

OSCHINA-MIRROR/mirrors-spacemacs

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
README.md 16 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
gitlife-traslator Отправлено 28.11.2024 13:43 6400c1e

Быстрый старт

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

  • В командной строке:

    git clone https://github.com/syl20bnr/spacemacs $HOME/.emacs.d
  • PowerShell в Windows:

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

    Если HOME не задан в среде или реестре:

    git clone https://github.com/syl20bnr/spacemacs $env:APPDATA/.emacs.d

Если у вас уже есть конфигурация Emacs, ознакомьтесь с полными инструкциями по установке для других вариантов.

Введение

Spacemacs — это новый способ работы с Emacs — сложный и отточенный набор настроек, ориентированный на эргономику, мнемонику и согласованность.

Просто клонируйте и запустите его, затем нажмите клавишу пробела, чтобы изучить интерактивный список тщательно подобранных сочетаний клавиш. Вы также можете нажать кнопку [?] в домашнем буфере, чтобы попробовать несколько отличных первых сочетаний клавиш.

Spacemacs можно легко использовать как пользователям Emacs, так и пользователям Vim — вы даже можете смешивать два стиля редактирования. Возможность быстро переключаться между стилями ввода делает Spacemacs отличным инструментом для парного программирования.

В настоящее время Spacemacs находится в стадии бета-тестирования, и любые вклады приветствуются.

spacemacs_python

Особенности

  • Отличная документация: доступ к документации Spacemacs с помощью SPC h SPC.
  • Красивый графический интерфейс: вам понравится интерфейс без отвлекающих факторов и функциональная строка режима.
  • Превосходная эргономика: все сочетания клавиш доступны при нажатии SPC или Alt-m.
  • Мнемонические сочетания клавиш: команды имеют мнемонические префиксы, такие как SPC b для всех команд буфера или SPC p для команд проекта.
  • Всё включено: Инициализация. Эти шаги необходимо выполнить, чтобы Spacemacs загружался корректно.

Файлы и каталог необходимо переименовать:

[ -d $HOME/.emacs.d ] && mv $HOME/.emacs.d $HOME/.emacs.d.bak
[ -f $HOME/.emacs.el ] && mv $HOME/.emacs.el .emacs.el.bak
[ -f $HOME/.emacs ] && mv $HOME/.emacs $HOME/.emacs.bak

Или в PowerShell:

if( TestPath -Path $HOME/.emacs.d )
{
    Rename-Item $HOME/.emacs.d $HOME/.emacs.d.bak
}
if( TestPath -Path $HOME/.emacs.el )
{
    Rename-Item $HOME/.emacs.el $HOME/.emacs.el.bak
}
if( TestPath -Path $HOME/.emacs )
{
    Rename-Item $HOME/.emacs $HOME/.emacs.bak
}
  1. Теперь клонируйте этот репозиторий с помощью Git. Следующие команды работают как для оболочки, так и для PowerShell:
git clone https://github.com/syl20bnr/spacemacs $HOME/.emacs.d

Если у вас ограниченное подключение к интернету или ограниченная скорость:

git clone --depth 1 https://github.com/syl20bnr/spacemacs ~/.emacs.d
  1. Теперь вы можете запустить Emacs, и Spacemacs будет загружен.

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

Чтобы установить Spacemacs в другом месте, сначала нужно понять, как Spacemacs загружается:

Когда Emacs запускается, он ищет файл инициализации [детерминированным способом][Emacs: Find Init]. В установке по умолчанию это работает так: файл занимает $HOME/.emacs.d/init.el, и Emacs использует его как файл инициализации.

Другими словами, в установке по умолчанию Emacs находит и загружает $HOME/.emacs.d/init.el, который затем отвечает за загрузку других файлов в $HOME/.emacs.d.

Если вы хотите установить Spacemacs в другое место, вам нужно убедиться, что он загружен Emacs в одном из его файлов инициализации [Emacs: Find Init].

Например, если вы клонировали Spacemacs на $HOME/Spacemacs и используете $HOME/.emacs.el в качестве файла инициализации Emacs, то следующие строки в $HOME/.emacs.el:

;; загрузить файл инициализации Spacemacs, "~" эквивалентно "$HOME"
(load-file "~/Spacemacs/init.el")

Первый запуск и настройка

  1. После клонирования Spacemacs при первом запуске Emacs Spacemacs автоматически установит необходимые пакеты. Это этап начальной загрузки.

  2. Как только пакеты начальной загрузки установлены, Spacemacs проверяет, есть ли у вас файл настройки $HOME/.spacemacs, известный как dotspacemacs:

  • Если он уже существует, Spacemacs загружает его как конфигурацию.
  • В противном случае вам нужно ответить на несколько вопросов, и Spacemacs создаст для вас файл dotspacemacs.

Если вы новичок в Emacs и/или Spacemacs, можно просто принять значения по умолчанию. Их можно изменить позже в файле dotspacemacs.

  1. Spacemacs скачает и установит остальные пакеты, которые ему потребуются, согласно вашему dotspacemacs. Когда все пакеты будут установлены, перезапустите Emacs для завершения установки.

  2. dotspacemacs — это файл конфигурации для Spacemacs, он самоочевиден и написан на Emacs Lisp. Для получения дополнительной информации прочитайте [общую документацию][DOCUMENTATION.org] и [краткое руководство][QUICK_START.org].

  3. Если вы хотите сохранить свой dotspacemacs в другом месте, например, под $HOME/.spacemacs.d:

  • Сначала установите переменную среды SPACEMACSDIR на $HOME/.spacemacs.d.
  • Переместите $HOME/.spacemacs на $HOME/.spacemacs.d/init.el.

Другими словами, установите SPACEMACSDIR как родительский каталог вашего dotspacemacs и переместите dotspacemacs в указанный каталог.

Логотип Spacemacs

Для пользователей Linux создайте spacemacs.desktop в ~/.local/share/applications/ с использованием [этого файла .desktop][spacemacs-desktop] в качестве ссылки. Измените параметр Name на Name=Spacemacs и параметр Icon на Icon=/PATH/TO/EMACSD/core/banners/img/spacemacs.png, где /PATH/TO/EMACSD — путь к вашему каталогу .emacs.d, по умолчанию ~/.emacs.d.

Для пользователей macOS вам необходимо [загрузить версию логотипа .icns][icon-repository] и просто [изменить логотип на панели запуска][launchpad]. Док][значок-мак-инструкции].

Примечания

  • В зависимости от установленной версии GnuTLS, безопасная установка пакетов Emacs может завершиться ошибкой. Также это может произойти при плохом интернет-соединении. В любом случае можно установить пакеты с помощью команды emacs --insecure. Однако имейте в виду, что это означает, что ваши пакеты будут переданы через HTTP, используйте на свой страх и риск.

  • (Windows) Если после запуска Emacs появляется следующая ошибка:

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

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

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

    Источник: [Stack Overflow][со-сервер-небезопасен]

  • (Windows) Точка (.) перед именем файла или папки означает, что это скрытый файл или папка. Чтобы показать скрытые файлы и папки:

    • Нажмите клавишу Windows,
    • Введите «Параметры проводника»,
    • Выберите вкладку «Вид» вверху,
    • Установите флажок «Показывать скрытые файлы, папки и диски»,
    • Нажмите «ОК».

Обновление

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

  1. Закройте Emacs и обновите репозиторий git:

    git pull --rebase
  2. Перезапустите Emacs для завершения обновления.

После обновления Spacemacs также следует проверить, доступны ли обновления для ваших пакетов. На главном буфере Spacemacs SPC b h, нажмите (нажмите RET) на кнопке [Update Packages] или используйте удобную комбинацию клавиш SPC f e U

Переход с устаревшей ветки master

Если вы всё ещё находитесь на старой ветке master (т. е. если git branch --show-current показывает master, а не develop), вам необходимо сначала перейти на ветку develop [ссылка].

Цитаты

[Цитата][цитата01] от ashnur:

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

[Цитата][цитата02] от deuill:

«Я ЛЮБЛЮ SPACEMACS И MAGIT

 Это всё».

Вклад

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

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

Сообщества

  • [Gitter Chat][]
  • [Stack Exchange][]
  • [Reddit][]

Spacemacs везде

Как только вы изучите сочетания клавиш Spacemacs, вы сможете использовать их в других IDE/инструментах благодаря следующим проектам:

  • Intellimacs — сочетания клавиш, подобные Spacemacs, для платформы IntelliJ
  • Spaceclipse — сочетания клавиш, подобные Spacemacs, для Eclipse
  • SpaceVim — модульный дистрибутив vim, созданный сообществом
  • VSpaceCode — сочетания клавиш, подобные Spacemacs, для Visual Studio Code

Лицензия

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

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

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

[Логотип Spacemacs][] от [Nasser Alshammari][] выпущен под [Creative Commons Attribution-ShareAlike 4.0 International License][creativecommons-4].

Поддержка Spacemacs

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

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

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

Если использовали Spacemacs в проекте и хотите это показать, можете использовать Spacemacs badge:

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

Для HTML:

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

Для Org-mode:

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

И так далее.

Основной язык текста запроса — английский. Солт. Баунтисёрс точка ком / тимс / спейсмэкс.

Опубликовать ( 0 )

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

1
https://api.gitlife.ru/oschina-mirror/mirrors-spacemacs.git
git@api.gitlife.ru:oschina-mirror/mirrors-spacemacs.git
oschina-mirror
mirrors-spacemacs
mirrors-spacemacs
develop