История изменений
Исправление Deleted, (текущая версия) :
Итак, первый этап оформления конфигов был завершён, добавил конфиги zsh, xorg, urxvt, mpv и скучные обои.
Структура и основные положения будут расписаны в README.md, но пока их нет:
1. Благодаря XDG переменным все конфиги лежат у меня в $HOME/dots. Это и есть этот репозиторий.
2. Т.к. не весь софт поддерживает XDG Base Directory Specification (а некоторый — частично), есть несколько хаков, часть из которых в файлах, пользователю не принадлежащих, но в принципе всё сделано более-менее универсально.
3. Конфиги zsh нельзя полностью перенести из $HOME, если не воспользоваться хаком и определить $ZDOTDIR в /etc/zsh/zshenv, у меня так и сделано (с проверкой на юзера). Конфигов из рута пока нет, ибо частенько в них будут недоступны XDG_* переменные и я их планирую генерировать из шаблонов.
4. Не рекомендуется использовать конфиги «как есть». Часть настроек зависят от окружения, часть могут показаться «дикими». Либо переносите по одному файлу, после чего изучая примечания, либо копируйте интересующие строчки, благо большинство важных моментов помечены примечаниями.
Немного о примечаниях:
Для того чтобы узнать, что делает конкретная опция/настройка в конфигах — читайте маны, в конфиги эта инфа не включена (и не будет). Важные моменты, связанные с конфигурацией описаны примечаниям. Примечания на английском, но с минимальным знанием и/или гуглтранслейтом понять будет не сложно.
Примечания разделены на несколько категорий:
1. TODO — что-то, что я ещё не сделал, если нечего делать — можете сделать форк и пулл-реквест в чужие конфиги. Альтруисты, welcome.
Пример:
config/mpv/scripts/flatbox.lua:
-- TODO: clear code and make PR
...
2. DEP — зависимость от чего-то, если у вас этого нет, скорее всего можно поменять на то, что используете вы или поменяв немного конфиг/код, просто избавиться от зависимости.
Пример:
config/zsh/environ:
# DEP: neovim (user-specific)
export EDITOR="nvim"
export VISUAL="$EDITOR"
3. OPT — зависимость, наличие которой проверяется, если этой зависимости нет, ничего не сломается, но и что-то возможно не будет работать на всю катушку.
4. NOTE — просто примечание, обычно стоит у спорных опций, которые вы, вероятно, захотите сменить. Также в нём может быть объяснение почему конкретно эта опция такая и/или как с этим жить.
Пример:
config/mpv/mpv.conf:
# NOTE: can produce buffer underruns
pulse-buffer=50
5. ENV — одно из самых важных. Означает что следующая опция/строчка кода зависит от окружения (настроек, набора пакетов, DE, аппаратуры, проприетарных/опенсурсных драйверов и т.д.)
Пример:
config/X11/xinitrc:
# ENV: monitor configuration is environment specific
xrandr --output DP-4 --auto --output DP-2 --right-of DP-4
6. SETUP — говорит, что при установке пакета должны быть выполнены некоторые действия, при стандартной установке не предусмотренные (например установка в другое место, применение патча, инициализация после установки и т.д.).
Пример:
config/zsh/oh-my-zsh:
# SETUP: make sure to install oh-my-zsh to $XDG_DATA_HOME/oh-my-zsh
source $ZSH/oh-my-zsh.sh
7. DANGER — всё, что может вызвать проблемы (от проблем с безопасностью, до непонятных падений производительности), проверять и менять в первую очередь.
Пример:
config/mpv/mpv.conf:
# DANGER: 8GiB cache in total
cache-default=4000000
cache-backbuffer=4000000
Конфиги i3 и polybar'а будут добавлены как можно скорее.
Молодец, кто дочитал, держите ссылку: репозиторий.
Исправление Deleted, :
Итак, первый этап оформления конфигов был завершён, добавил конфиги zsh, xorg, urxvt, mpv и скучные обои.
Структура и основные положения будут расписаны в README.md, но пока их нет:
1. Благодаря XDG переменным все конфиги лежат у меня в $HOME/dots. Это и есть этот репозиторий.
2. Т.к. не весь софт поддерживает XDG Base Directory Specification (а некоторый — частично), есть несколько хаков, часть из которых в файлах, пользователю не принадлежащих, но в принципе всё сделано более-менее универсально.
3. Конфиги zsh нельзя полностью перенести из $HOME, если не воспользоваться хаком и определить $ZDOTDIR в /etc/zsh/zshenv, у меня так и сделано (с проверкой на юзера). Конфигов из рута пока нет, ибо частенько в них будут недоступны XDG_* переменные и я их планирую генерировать из шаблонов.
4. Не рекомендуется использовать конфиги «как есть». Часть настроек зависят от окружения, часть могут показаться «дикими». Либо переносите по одному файлу, после чего изучая примечания, либо копируйте интересующие строчки, благо большинство важных моментов помечены примечаниями.
Немного о примечаниях:
Для того чтобы узнать, что делает конкретная опция/настройка в конфигах — читайте маны, в конфиги эта инфа не включена (и не будет). Важные моменты, связанные с конфигурацией описаны примечаниям. Примечания на английском, но с минимальным знанием и/или гуглтранслейтом понять будет не сложно.
Примечания разделены на несколько категорий:
1. TODO — что-то, что я ещё не сделал, если нечего делать — можете сделать форк и пулл-реквест в чужие конфиги. Альтруисты, welcome.
Пример:
config/mpv/scripts/flatbox.lua:
-- TODO: clear code and make PR
...
2. DEP — зависимость от чего-то, если у вас этого нет, скорее всего можно поменять на то, что используете вы или поменяв немного конфиг/код, просто избавиться от зависимости.
Пример:
config/zsh/environ:
# DEP: neovim (user-specific)
export EDITOR="nvim"
export VISUAL="$EDITOR"
3. OPT — зависимость, наличие которой проверяется, если этой зависимости нет, ничего не сломается, но и что-то возможно будет не работать не на всю катушку.
4. NOTE — просто примечание, обычно стоит у спорных опций, которые вы, вероятно, захотите сменить. Также в нём может быть объяснение почему конкретно эта опция такая и/или как с этим жить.
Пример:
config/mpv/mpv.conf:
# NOTE: can produce buffer underruns
pulse-buffer=50
5. ENV — одно из самых важных. Означает что следующая опция/строчка кода зависит от окружения (настроек, набора пакетов, DE, аппаратуры, проприетарных/опенсурсных драйверов и т.д.)
Пример:
config/X11/xinitrc:
# ENV: monitor configuration is environment specific
xrandr --output DP-4 --auto --output DP-2 --right-of DP-4
6. SETUP — говорит, что при установке пакета должны быть выполнены некоторые действия, при стандартной установке не предусмотренные (например установка в другое место, применение патча, инициализация после установки и т.д.).
Пример:
config/zsh/oh-my-zsh:
# SETUP: make sure to install oh-my-zsh to $XDG_DATA_HOME/oh-my-zsh
source $ZSH/oh-my-zsh.sh
7. DANGER — всё, что может вызвать проблемы (от проблем с безопасностью, до непонятных падений производительности), проверять и менять в первую очередь.
Пример:
config/mpv/mpv.conf:
# DANGER: 8GiB cache in total
cache-default=4000000
cache-backbuffer=4000000
Конфиги i3 и polybar'а будут добавлены как можно скорее.
Молодец, кто дочитал, держите ссылку: репозиторий.
Исходная версия Deleted, :
Конфиги
Итак, первый этап оформления конфигов был завершён, добавил конфиги zsh, xorg, urxvt, mpv и скучные обои.
Структура и основные положения будут расписаны в README.md, но пока их нет:
1. Благодаря XDG переменным все конфиги лежат у меня в $HOME/dots. Это и есть этот репозиторий.
2. Т.к. не весь софт поддерживает XDG Base Directory Specification (а некоторый — частично), есть несколько хаков, часть из которых в файлах, пользователю не принадлежащих, но в принципе всё сделано более-менее универсально.
3. Конфиги zsh нельзя полностью перенести из $HOME, если не воспользоваться хаком и определить $ZDOTDIR в /etc/zsh/zshenv, у меня так и сделано (с проверкой на юзера). Конфигов из рута пока нет, ибо частенько в них будут недоступны XDG_* переменные и я их планирую генерировать из шаблонов.
4. Не рекомендуется использовать конфиги «как есть». Часть настроек зависят от окружения, часть могут показаться «дикими». Либо переносите по одному файлу, после чего изучая примечания, либо копируйте интересующие строчки, благо большинство важных моментов помечены примечаниями.
Немного о примечаниях:
Для того чтобы узнать, что делает конкретная опция/настройка в конфигах — читайте маны, в конфиги эта инфа не включена (и не будет). Важные моменты, связанные с конфигурацией описаны примечаниям. Примечания на английском, но с минимальным знанием и/или гуглтранслейтом понять будет не сложно.
Примечания разделены на несколько категорий:
1. TODO — что-то, что я ещё не сделал, если нечего делать — можете сделать форк и пулл-реквест в чужие конфиги. Альтруисты, welcome.
Пример:
config/mpv/scripts/flatbox.lua:
-- TODO: clear code and make PR
...
2. DEP -- зависимость от чего-то, если у вас этого нет, скорее всего можно поменять на то, что используете вы или поменяв немного конфиг/код, просто избавиться от зависимости.
Пример:
config/zsh/environ:
# DEP: neovim (user-specific)
export EDITOR="nvim"
export VISUAL="$EDITOR"
3. OPT -- зависимость, наличие которой проверяется, если этой зависимости нет, ничего не сломается, но и что-то возможно будет не работать не на всю катушку.
4. NOTE -- просто примечание, обычно стоит у спорных опций, которые вы, вероятно, захотите сменить. Также в нём может быть объяснение почему конкретно эта опция такая и/или как с этим жить.
Пример:
config/mpv/mpv.conf:
# NOTE: can produce buffer underruns
pulse-buffer=50
5. ENV -- одно из самых важных. Означает что следующая опция/строчка кода зависит от окружения (настроек, набора пакетов, DE, аппаратуры, проприетарных/опенсурсных драйверов и т.д.)
Пример:
config/X11/xinitrc:
# ENV: monitor configuration is environment specific
xrandr --output DP-4 --auto --output DP-2 --right-of DP-4
6. SETUP -- говорит, что при установке пакета должны быть выполнены некоторые действия, при стандартной установке не предусмотренные (например установка в другое место, применение патча, инициализация после установки и т.д.).
Пример:
config/zsh/oh-my-zsh:
# SETUP: make sure to install oh-my-zsh to $XDG_DATA_HOME/oh-my-zsh
source $ZSH/oh-my-zsh.sh
7. DANGER -- всё, что может вызвать проблемы (от проблем с безопасностью, до непонятных падений производительности), проверять и менять в первую очередь.
Пример:
config/mpv/mpv.conf:
# DANGER: 8GiB cache in total
cache-default=4000000
cache-backbuffer=4000000
Конфиги i3 и polybar'а будут добавлены как можно скорее.
Молодец, кто дочитал, держите ссылку:
[url=https://github.com/codingjerk/dotfiles]репозиторий[/url].