mirror of
https://github.com/arcan1s/arcanis.me.git
synced 2025-04-24 15:27:17 +00:00
add zsh-comp-tut (ru)
add tag hasTr
This commit is contained in:
arcan1s
parent
760d8108b9
commit
4449b24cf2
@ -1,16 +1,20 @@
|
||||
<p>
|
||||
{% if page.category == "ru" %}
|
||||
{% if page.type == "paper" %}
|
||||
{% if page.hasTr == true %}
|
||||
{% if page.type == "paper" %}
|
||||
<a href="{{ page.url | replace: '/ru/', '/en/' }}"><img src="/resources/en.png"></a>
|
||||
{% else %}
|
||||
{% else %}
|
||||
<a href="{{ page.url | replace: '/ru/', '/' }}"><img src="/resources/en.png"></a>
|
||||
{% endif %}
|
||||
{% endif %}
|
||||
<small>Расположено на GitHub Pages. <a href="/ru/authors">Авторы</a></small>
|
||||
{% else %}
|
||||
{% if page.type == "paper" %}
|
||||
{% if page.hasTr == true %}
|
||||
{% if page.type == "paper" %}
|
||||
<a href="{{ page.url | replace: '/en/', '/ru/' }}"><img src="/resources/ru.png"></a>
|
||||
{% else %}
|
||||
{% else %}
|
||||
<a href="/ru{{ page.url }}"><img src="/resources/ru.png"></a>
|
||||
{% endif %}
|
||||
{% endif %}
|
||||
<small>Hosted on GitHub Pages. <a href="/authors">Authors</a></small>
|
||||
{% endif %}
|
||||
|
||||
@ -2,6 +2,7 @@
|
||||
category: en
|
||||
type: paper
|
||||
layout: paper
|
||||
hasTr: true
|
||||
tags: zshrc, configuration, linux
|
||||
title: About zshrc
|
||||
short: about-zshrc
|
||||
|
||||
@ -2,6 +2,7 @@
|
||||
category: en
|
||||
type: paper
|
||||
layout: paper
|
||||
hasTr: true
|
||||
tags: archlinux, linux, building, qutim
|
||||
title: Building Qutim using Qt5
|
||||
short: building-qutim-using-qt5
|
||||
@ -80,7 +81,7 @@ diff -ruN qutim.orig/core/libqutim.qbs qutim/core/libqutim.qbs
|
||||
+ flags = flags.concat("-lc++abi");
|
||||
return flags;
|
||||
}
|
||||
|
||||
|
||||
{% endhighlight %}
|
||||
<p>And the second one is Vk plugin:</p>
|
||||
{% highlight diff %}
|
||||
@ -92,7 +93,7 @@ diff -ruN qutim.orig/protocols/vkontakte/vreen/vreen.qbs qutim/protocols/vkontak
|
||||
property string vreen_lib_path: "lib"
|
||||
property string vreen_libexec_path: "lib"
|
||||
+ property string lib_path: "lib"
|
||||
|
||||
|
||||
property string vreen_version_major: 1
|
||||
property string vreen_version_minor: 9
|
||||
{% endhighlight %}
|
||||
@ -162,7 +163,7 @@ prepare() {
|
||||
rm -rf "${srcdir}/build"
|
||||
fi
|
||||
mkdir "${srcdir}/build"
|
||||
|
||||
|
||||
cd "${_gitname}"
|
||||
# update modules
|
||||
git submodule update --init --recursive
|
||||
|
||||
@ -2,6 +2,7 @@
|
||||
category: en
|
||||
type: paper
|
||||
layout: paper
|
||||
hasTr: true
|
||||
tags: site, github pages
|
||||
title: Site changes
|
||||
short: site-changes
|
||||
|
||||
@ -2,6 +2,7 @@
|
||||
category: en
|
||||
type: paper
|
||||
layout: paper
|
||||
hasTr: true
|
||||
tags: archlinux, configuration, linux
|
||||
title: Creating own repository
|
||||
short: creating-custom-repo
|
||||
|
||||
@ -2,6 +2,7 @@
|
||||
category: en
|
||||
type: paper
|
||||
layout: paper
|
||||
hasTr: true
|
||||
tags: offtop
|
||||
title: Loveless
|
||||
short: loveless
|
||||
|
||||
@ -2,6 +2,7 @@
|
||||
category: en
|
||||
type: paper
|
||||
layout: paper
|
||||
hasTr: true
|
||||
tags: настройка, linux, archlinux
|
||||
title: Apps which I use
|
||||
short: my-desktop
|
||||
|
||||
@ -2,6 +2,7 @@
|
||||
category: en
|
||||
type: paper
|
||||
layout: paper
|
||||
hasTr: true
|
||||
tags: linux, archlinux, building
|
||||
title: Disabling baloo, gentoo-way
|
||||
short: disabling-baloo
|
||||
|
||||
@ -3,6 +3,7 @@ layout: default
|
||||
comment: false
|
||||
share: true
|
||||
back: 1
|
||||
hasTr: true
|
||||
title: About me
|
||||
---
|
||||
<body>
|
||||
|
||||
@ -3,6 +3,7 @@ layout: default
|
||||
comment: false
|
||||
share: false
|
||||
back: 2
|
||||
hasTr: true
|
||||
title: Authors
|
||||
---
|
||||
<body>
|
||||
|
||||
@ -4,6 +4,7 @@ title: Archive
|
||||
comment: false
|
||||
share: false
|
||||
back: 2
|
||||
hasTr: true
|
||||
---
|
||||
<body>
|
||||
<div class="wrapper">
|
||||
|
||||
@ -4,6 +4,7 @@ title: arcanis' blog
|
||||
comment: false
|
||||
share: false
|
||||
back: 1
|
||||
hasTr: true
|
||||
---
|
||||
<body>
|
||||
<div class="wrapper">
|
||||
|
||||
@ -3,6 +3,7 @@ layout: default
|
||||
comment: false
|
||||
share: true
|
||||
back: 0
|
||||
hasTr: true
|
||||
title: arcanis' homepage
|
||||
---
|
||||
<body>
|
||||
|
||||
@ -1,4 +1,5 @@
|
||||
---
|
||||
hasTr: true
|
||||
layout: project
|
||||
title: git-etc
|
||||
short: git-etc
|
||||
|
||||
@ -1,4 +1,5 @@
|
||||
---
|
||||
hasTr: true
|
||||
layout: default
|
||||
title: arcanis' projects
|
||||
comment: false
|
||||
|
||||
@ -1,4 +1,5 @@
|
||||
---
|
||||
hasTr: true
|
||||
layout: project
|
||||
title: Netctl GUI
|
||||
short: netctl-gui
|
||||
|
||||
@ -1,4 +1,5 @@
|
||||
---
|
||||
hasTr: true
|
||||
layout: project
|
||||
title: Oblikue strategies
|
||||
short: oblikuestrategies
|
||||
|
||||
@ -1,4 +1,5 @@
|
||||
---
|
||||
hasTr: true
|
||||
layout: project
|
||||
title: py-text-monitor
|
||||
short: pytextmonitor
|
||||
|
||||
@ -1,4 +1,5 @@
|
||||
---
|
||||
hasTr: true
|
||||
layout: project
|
||||
title: queued
|
||||
short: queued
|
||||
|
||||
@ -1,6 +1,7 @@
|
||||
---
|
||||
category: ru
|
||||
type: paper
|
||||
hasTr: true
|
||||
layout: paper
|
||||
tags: zshrc, настройка, linux
|
||||
title: О zshrc
|
||||
|
||||
@ -1,6 +1,7 @@
|
||||
---
|
||||
category: ru
|
||||
type: paper
|
||||
hasTr: true
|
||||
layout: paper
|
||||
tags: archlinux, linux, сборка, qutim
|
||||
title: Сборка Qutim с Qt5
|
||||
@ -80,7 +81,7 @@ diff -ruN qutim.orig/core/libqutim.qbs qutim/core/libqutim.qbs
|
||||
+ flags = flags.concat("-lc++abi");
|
||||
return flags;
|
||||
}
|
||||
|
||||
|
||||
{% endhighlight %}
|
||||
<p>И пофиксить сборку библиотеки для Vk:</p>
|
||||
{% highlight diff %}
|
||||
@ -92,7 +93,7 @@ diff -ruN qutim.orig/protocols/vkontakte/vreen/vreen.qbs qutim/protocols/vkontak
|
||||
property string vreen_lib_path: "lib"
|
||||
property string vreen_libexec_path: "lib"
|
||||
+ property string lib_path: "lib"
|
||||
|
||||
|
||||
property string vreen_version_major: 1
|
||||
property string vreen_version_minor: 9
|
||||
{% endhighlight %}
|
||||
@ -162,7 +163,7 @@ prepare() {
|
||||
rm -rf "${srcdir}/build"
|
||||
fi
|
||||
mkdir "${srcdir}/build"
|
||||
|
||||
|
||||
cd "${_gitname}"
|
||||
# update modules
|
||||
git submodule update --init --recursive
|
||||
|
||||
@ -1,6 +1,7 @@
|
||||
---
|
||||
category: ru
|
||||
type: paper
|
||||
hasTr: true
|
||||
layout: paper
|
||||
tags: сайт, github pages
|
||||
title: Изменения сайта
|
||||
|
||||
@ -1,6 +1,7 @@
|
||||
---
|
||||
category: ru
|
||||
type: paper
|
||||
hasTr: true
|
||||
layout: paper
|
||||
tags: archlinux, настройка, linux
|
||||
title: Создание собственного репозитория
|
||||
|
||||
@ -1,6 +1,7 @@
|
||||
---
|
||||
category: ru
|
||||
type: paper
|
||||
hasTr: true
|
||||
layout: paper
|
||||
tags: offtop
|
||||
title: Loveless
|
||||
|
||||
@ -1,6 +1,7 @@
|
||||
---
|
||||
category: ru
|
||||
type: paper
|
||||
hasTr: true
|
||||
layout: paper
|
||||
tags: настройка, linux, archlinux
|
||||
title: Приложения, которые я использую
|
||||
|
||||
@ -1,6 +1,7 @@
|
||||
---
|
||||
category: ru
|
||||
type: paper
|
||||
hasTr: true
|
||||
layout: paper
|
||||
tags: linux, archlinux, сборка
|
||||
title: Отключение baloo, gentoo-way
|
||||
|
||||
@ -1,6 +1,7 @@
|
||||
---
|
||||
category: ru
|
||||
type: paper
|
||||
hasTr: false
|
||||
layout: paper
|
||||
tags: archlinux
|
||||
title: Немного об Arch User Repository
|
||||
|
||||
146
ru/_posts/2014-07-17-writting-own-completions-p1.html
Normal file
146
ru/_posts/2014-07-17-writting-own-completions-p1.html
Normal file
@ -0,0 +1,146 @@
|
||||
---
|
||||
category: ru
|
||||
type: paper
|
||||
hasTr: true
|
||||
layout: paper
|
||||
tags: linux, разработка
|
||||
title: Написание собственных дополнений для Shell. Zsh
|
||||
short: writting-own-completions-p1
|
||||
description: В данных статьях описываются некоторые основы создания файлов автодополнений для собственной программы.
|
||||
---
|
||||
<h2><a name="preamble" class="anchor" href="#preamble"><span class="octicon octicon-link"></span></a>Преамбула</h2>
|
||||
<p>В процессе разработки <a href="/ru/projects/netctl-gui">одного своего проекта</a> возникло желание добавить также файлы автодополнений (только не спрашивайте зачем). Благо я как-то уже брался за написание подобных вещей, но читать что-либо тогда мне было лень, и так и не осилил.</p>
|
||||
|
||||
<h2><a name="introduction" class="anchor" href="#introduction"><span class="octicon octicon-link"></span></a>Введение</h2>
|
||||
<p>Существует несколько возможных вариантов написания файла автодополнения для zsh. В случае данной статьи я остановлюсь только на одном из них, который предоставляет большие возможности и не требует больших затрат (например, работы с регулярными выражениями).</p>
|
||||
|
||||
<p>Рассмотрим на примере моего же приложения, часть справки к которому выглядит таким образом:</p>
|
||||
{% highlight bash %}
|
||||
netctl-gui [ -h | --help ] [ -e ESSID | --essid ESSID ] [ -с FILE | --config FILE ]
|
||||
[ -o PROFILE | --open PROFILE ] [ -t NUM | --tab NUM ] [ --set-opts OPTIONS ]
|
||||
{% endhighlight %}
|
||||
|
||||
<p>Список флагов:
|
||||
<ul>
|
||||
<li>флаги <code>-h</code> и <code>--help</code> не требуют аргументов;</li>
|
||||
<li>флаги <code>-e</code> и <code>--essid</code> требуют аргумента в виде строки, без дополнения;</li>
|
||||
<li>флаги <code>-c</code> и <code>--config</code> требуют аргумента в виде строки, файл с произвольной локацией;</li>
|
||||
<li>флаги <code>-o</code> и <code>--open</code> требуют аргумента в виде строки, дополнение по файлам из определенной директории;</li>
|
||||
<li>флаги <code>-t</code> и <code>--tab</code> требуют аргумента в виде строки, дополнение из указанного массива;</li>
|
||||
<li>флаг <code>--set-opts</code> требует аргумента в виде строки, дополнение из указанного массива, разделены запятыми;</li>
|
||||
</ul>
|
||||
</p>
|
||||
|
||||
<h2><a name="file" class="anchor" href="#file"><span class="octicon octicon-link"></span></a>Структура файла</h2>
|
||||
<p>В заголовке должно быть обязательно указано, что это файл дополнений и для каких приложений он служит (можно строкой, если в файле будет содержаться дополнение для нескольких команд):
|
||||
|
||||
{% highlight bash %}
|
||||
#compdef netctl-gui
|
||||
{% endhighlight %}
|
||||
|
||||
Дальше идет описание флагов, вспомогательные функции и переменные. Замечу, что функции и переменные, которые будут использоваться для дополнения <b>должны возвращать массивы</b>, а не строки. В моем случае схема выглядит примерно так (все функции и переменные в этой главе умышленно оставлены пустыми):
|
||||
|
||||
{% highlight bash %}
|
||||
# variables
|
||||
_netctl_gui_arglist=()
|
||||
_netctl_gui_settings=()
|
||||
_netctl_gui_tabs=()
|
||||
_netctl_profiles() {}
|
||||
{% endhighlight %}
|
||||
|
||||
Затем идут основные функции, которые будут вызываться для дополнения для определенной команды. В моем случае команда одна, и функция одна:
|
||||
|
||||
{% highlight bash %}
|
||||
# work block
|
||||
_netctl-gui() {}
|
||||
{% endhighlight %}
|
||||
|
||||
Далее <b>без выделения в отдельную функцию</b> идет небольшое шаманство, связанное с соотнесением приложения, которое было декларировано в первой строке, с функцией в теле скрипта:
|
||||
|
||||
{% highlight bash %}
|
||||
case "$service" in
|
||||
netctl-gui)
|
||||
_netctl-gui "$@" && return 0
|
||||
;;
|
||||
esac
|
||||
{% endhighlight %}
|
||||
</p>
|
||||
|
||||
<h2><a name="flags" class="anchor" href="#flags"><span class="octicon octicon-link"></span></a>Флаги</h2>
|
||||
<p>Как я и говорил во введении, существует несколько способов создания подобных файлов. В частности, они различаются декларацией флагов и их дальнейшей обработкой. В данном случае я буду использовать команду <code>_arguments</code>, которая требует специфичный формат переменных. Выглядит он таким образом <code>ФЛАГ[описание]:СООБЩЕНИЕ:ДЕЙСТВИЕ</code>. Последние два поля не обязательны и, как Вы увидите чуть ниже, вовсе и не нужны в некоторых местах. Если Вы предусматриваете два флага (короткий и длинный формат) на одно действие, то формат чуть-чуть усложняется: <code>{(ФЛАГ_2)ФЛАГ_1,(ФЛАГ_1)ФЛАГ_2}[описание]:СООБЩЕНИЕ:ДЕЙСТВИЕ</code>. Замечу, что, если Вы хотите сделать дополнения для двух типов флагов, но некоторые флаги не имеют второй записи, то Вам необходимо продублировать его таким образом: <code>{ФЛАГ,ФЛАГ}[описание]:СООБЩЕНИЕ:ДЕЙСТВИЕ</code>. <code>СООБЩЕНИЕ</code> - сообщение, которое будет показано, <code>ДЕЙСТВИЕ</code> - действие, которое будет выполнено после этого флага. В случае данного туториала, <code>ДЕЙСТВИЕ</code> будет иметь вид <code>->СОСТОЯНИЕ</code>.</p>
|
||||
|
||||
<p>Итак, согласно нашим требованиям, получается такое объявление аргументов:
|
||||
|
||||
{% highlight bash %}
|
||||
_netctl_gui_arglist=(
|
||||
{'(--help)-h','(-h)--help'}'[show help and exit]'
|
||||
{'(--essid)-e','(-e)--essid'}'[select ESSID]:type ESSID:->essid'
|
||||
{'(--config)-c','(-c)--config'}'[read configuration from this file]:select file:->files'
|
||||
{'(--open)-o','(-o)--open'}'[open profile]:select profile:->profiles'
|
||||
{'(--tab)-t','(-t)--tab'}'[open a tab with specified number]:select tab:->tab'
|
||||
{'--set-opts','--set-opts'}'[set options for this run, comma separated]:comma separated:->settings'
|
||||
)
|
||||
{% endhighlight %}
|
||||
</p>
|
||||
|
||||
<h2><a name="variables" class="anchor" href="#variables"><span class="octicon octicon-link"></span></a>Массивы переменных</h2>
|
||||
<p>В нашем случае есть два статических массива (не изменятся ни сейчас, ни через пять минут) (массивы умышленно уменьшены):
|
||||
{% highlight bash %}
|
||||
_netctl_gui_settings=(
|
||||
'CTRL_DIR'
|
||||
'CTRL_GROUP'
|
||||
)
|
||||
|
||||
_netctl_gui_tabs=(
|
||||
'1'
|
||||
'2'
|
||||
)
|
||||
{% endhighlight %}
|
||||
|
||||
И есть динамический массив, который должен каждый раз генерироваться. Он содержит, в данном случае, файлы в указанной директории (это можно сделать и средствами zsh, кстати):
|
||||
|
||||
{% highlight bash %}
|
||||
_netctl_profiles() {
|
||||
print $(find /etc/netctl -maxdepth 1 -type f -printf "%f\n")
|
||||
}
|
||||
{% endhighlight %}
|
||||
</p>
|
||||
|
||||
<h2><a name="body" class="anchor" href="#body"><span class="octicon octicon-link"></span></a>Тело функции</h2>
|
||||
<p>Помните, там выше было что-то про состояние? Оно хранится в переменной <code>$state</code>, и в теле функции делается проверка на то, чему оно равно, чтобы подобрать соответствующие действия. В начале также нужно не забыть вызвать <code>_arguments</code> с нашими флагами.
|
||||
|
||||
{% highlight bash %}
|
||||
_netctl-gui() {
|
||||
_arguments $_netctl_gui_arglist
|
||||
case "$state" in
|
||||
essid)
|
||||
# не делать дополнения, ждать введенной строки
|
||||
;;
|
||||
files)
|
||||
# дополнение по существующим файлам
|
||||
_files
|
||||
;;
|
||||
profiles)
|
||||
# дополнение из функции
|
||||
# первая переменная описание
|
||||
# вторая массив для дополнения
|
||||
_values 'profiles' $(_netctl_profiles)
|
||||
;;
|
||||
tab)
|
||||
# дополнение из массива
|
||||
_values 'tab' $_netctl_gui_tabs
|
||||
;;
|
||||
settings)
|
||||
# дополнение из массива
|
||||
# флаг -s устанавливает разделитель и включает мультивыбор
|
||||
_values -s ',' 'settings' $_netctl_gui_settings
|
||||
;;
|
||||
esac
|
||||
}
|
||||
{% endhighlight %}
|
||||
</p>
|
||||
|
||||
<h2><a name="conclusion" class="anchor" href="#conclusion"><span class="octicon octicon-link"></span></a>Заключение</h2>
|
||||
<p>Файл хранится в директории <code>/usr/share/zsh/site-functions</code> с произвольным в общем-то именем с префиксом <code>_</code>. Файл примера полностью может быть найден <a href="https://raw.githubusercontent.com/arcan1s/netctl-gui/master/sources/gui/zsh-completions">в моем репозитории</a>.</p>
|
||||
|
||||
<p>Дополнительная информация может быть найдена в репозитории <a href="https://github.com/zsh-users/zsh-completions">zsh-completions</a>. Например, там есть такой <a href="https://github.com/zsh-users/zsh-completions/blob/master/zsh-completions-howto.org">How-To</a>. А еще там есть много примеров.</p>
|
||||
146
ru/_posts/2014-07-17-writting-own-completions-p1.html~
Normal file
146
ru/_posts/2014-07-17-writting-own-completions-p1.html~
Normal file
@ -0,0 +1,146 @@
|
||||
---
|
||||
category: ru
|
||||
type: paper
|
||||
hasTr: true
|
||||
layout: paper
|
||||
tags: linux, разработка
|
||||
title: Написание собственных дополнений для Shell. Zsh
|
||||
short: writting-own-completions-p1
|
||||
description: В данных статьях описываются некоторые основы создания файлов автодополнений для собственной программы.
|
||||
---
|
||||
<h2><a name="preamble" class="anchor" href="#preamble"><span class="octicon octicon-link"></span></a>Преамбула</h2>
|
||||
<p>В процессе разработки <a href="/ru/projects/netctl-gui">одного своего проекта</a> возникло желание добавить также файлы автодополнений (только не спрашивайте зачем). Благо я как-то уже брался за написание подобных вещей, но читать что-либо тогда мне было лень, и так и не осилил.</p>
|
||||
|
||||
<h2><a name="introduction" class="anchor" href="#introduction"><span class="octicon octicon-link"></span></a>Введение</h2>
|
||||
<p>Существует несколько возможных вариантов написания файла автодополнения для zsh. В случае данной статьи я остановлюсь только на одном из них, который предоставляет большие возможности и не требует больших затрат (например, работы с регулярными выражениями).</p>
|
||||
|
||||
<p>Рассмотрим на примере моего же приложения, часть справки к которому выглядит таким образом:</p>
|
||||
{% highlight bash %}
|
||||
netctl-gui [ -h | --help ] [ -e ESSID | --essid ESSID ] [ -с FILE | --config FILE ]
|
||||
[ -o PROFILE | --open PROFILE ] [ -t NUM | --tab NUM ] [ --set-opts OPTIONS ]
|
||||
{% endhighlight %}
|
||||
|
||||
<p>Список флагов:
|
||||
<ul>
|
||||
<li>флаги <code>-h</code> и <code>--help</code> не требуют аргументов;</li>
|
||||
<li>флаги <code>-e</code> и <code>--essid</code> требуют аргумента в виде строки, без дополнения;</li>
|
||||
<li>флаги <code>-c</code> и <code>--config</code> требуют аргумента в виде строки, файл с произвольной локацией;</li>
|
||||
<li>флаги <code>-o</code> и <code>--open</code> требуют аргумента в виде строки, дополнение по файлам из определенной директории;</li>
|
||||
<li>флаги <code>-t</code> и <code>--tab</code> требуют аргумента в виде строки, дополнение из указанного массива;</li>
|
||||
<li>флаг <code>--set-opts</code> требует аргумента в виде строки, дополнение из указанного массива, разделены запятыми;</li>
|
||||
</ul>
|
||||
</p>
|
||||
|
||||
<h2><a name="file" class="anchor" href="#file"><span class="octicon octicon-link"></span></a>Структура файла</h2>
|
||||
<p>В заголовке должно быть обязательно указано, что это файл дополнений и для каких приложений он служит (можно строкой, если в файле будет содержаться дополнение для нескольких команд):
|
||||
|
||||
{% highlight bash %}
|
||||
#compdef netctl-gui
|
||||
{% endhighlight %}
|
||||
|
||||
Дальше идет описание флагов, вспомогательные функции и переменные. Замечу, что функции и переменные, которые будут использоваться для дополнения <b>должны возвращать массивы</b>, а не строки. В моем случае схема выглядит примерно так (все функции и переменные в этой главе умышленно оставлены пустыми):
|
||||
|
||||
{% highlight bash %}
|
||||
# variables
|
||||
_netctl_gui_arglist=()
|
||||
_netctl_gui_settings=()
|
||||
_netctl_gui_tabs=()
|
||||
_netctl_profiles() {}
|
||||
{% endhighlight %}
|
||||
|
||||
Затем идут основные функции, которые будут вызываться для дополнения для определенной команды. В моем случае команда одна, и функция одна:
|
||||
|
||||
{% highlight bash %}
|
||||
# work block
|
||||
_netctl-gui() {}
|
||||
{% endhighlight %}
|
||||
|
||||
Далее <b>без выделения в отдельную функцию</b> идет небольшое шаманство, связанное с соотнесением приложения, которое было декларировано в первой строке, с функцией в теле скрипта:
|
||||
|
||||
{% highlight bash %}
|
||||
case "$service" in
|
||||
netctl-gui)
|
||||
_netctl-gui "$@" && return 0
|
||||
;;
|
||||
esac
|
||||
{% endhighlight %}
|
||||
</p>
|
||||
|
||||
<h2><a name="flags" class="anchor" href="#flags"><span class="octicon octicon-link"></span></a>Флаги</h2>
|
||||
<p>Как я и говорил во введении, существует несколько способов создания подобных файлов. В частности, они различаются декларацией флагов и их дальнейшей обработкой. В данном случае я буду использовать команду <code>_arguments</code>, которая требует специфичный формат переменных. Выглядит он таким образом <code>ФЛАГ[описание]:СООБЩЕНИЕ:ДЕЙСТВИЕ</code>. Последние два поля не обязательны и, как Вы увидите чуть ниже, вовсе и не нужны в некоторых местах. Если Вы предусматриваете два флага (короткий и длинный формат) на одно действие, то формат чуть-чуть усложняется: <code>{(ФЛАГ_2)ФЛАГ_1,(ФЛАГ_1)ФЛАГ_2}[описание]:СООБЩЕНИЕ:ДЕЙСТВИЕ</code>. Замечу, что, если Вы хотите сделать дополнения для двух типов флагов, но некоторые флаги не имеют второй записи, то Вам необходимо продублировать его таким образом: <code>{ФЛАГ,ФЛАГ}[описание]:СООБЩЕНИЕ:ДЕЙСТВИЕ</code>. <code>СООБЩЕНИЕ</code> - сообщение, которое будет показано, <code>ДЕЙСТВИЕ</code> - действие, которое будет выполнено после этого флага. В случае данного туториала, <code>ДЕЙСТВИЕ</code> будет иметь вид <code>->СОСТОЯНИЕ</code>.</p>
|
||||
|
||||
<p>Итак, согласно нашим требованиям, получается такое объявление аргументов:
|
||||
|
||||
{% highlight bash %}
|
||||
_netctl_gui_arglist=(
|
||||
{'(--help)-h','(-h)--help'}'[show help and exit]'
|
||||
{'(--essid)-e','(-e)--essid'}'[select ESSID]:type ESSID:->essid'
|
||||
{'(--config)-c','(-c)--config'}'[read configuration from this file]:select file:->files'
|
||||
{'(--open)-o','(-o)--open'}'[open profile]:select profile:->profiles'
|
||||
{'(--tab)-t','(-t)--tab'}'[open a tab with specified number]:select tab:->tab'
|
||||
{'--set-opts','--set-opts'}'[set options for this run, comma separated]:comma separated:->settings'
|
||||
)
|
||||
{% endhighlight %}
|
||||
</p>
|
||||
|
||||
<h2><a name="variables" class="anchor" href="#variables"><span class="octicon octicon-link"></span></a>Массивы переменных</h2>
|
||||
<p>В нашем случае есть два статических массива (не изменятся ни сейчас, ни через пять минут) (массивы умышленно уменьшены):
|
||||
{% highlight bash %}
|
||||
_netctl_gui_settings=(
|
||||
'CTRL_DIR'
|
||||
'CTRL_GROUP'
|
||||
)
|
||||
|
||||
_netctl_gui_tabs=(
|
||||
'1'
|
||||
'2'
|
||||
)
|
||||
{% endhighlight %}
|
||||
|
||||
И есть динамический массив, который должен каждый раз генерироваться. Он содержит, в данном случае, файлы в указанной директории (это можно сделать и средствами zsh, кстати):
|
||||
|
||||
{% highlight bash %}
|
||||
_netctl_profiles() {
|
||||
print $(find /etc/netctl -maxdepth 1 -type f -printf "%f\n")
|
||||
}
|
||||
{% endhighlight %}
|
||||
</p>
|
||||
|
||||
<h2><a name="body" class="anchor" href="#body"><span class="octicon octicon-link"></span></a>Тело функции</h2>
|
||||
<p>Помните, там выше было что-то про состояние? Оно хранится в переменной <code>$state</code>, и в теле функции делается проверка на то, чему оно равно, чтобы подобрать соответствующие действия. В начале также нужно не забыть вызвать <code>_arguments</code> с нашими флагами.
|
||||
|
||||
{% highlight bash %}
|
||||
_netctl-gui() {
|
||||
_arguments $_netctl_gui_arglist
|
||||
case "$state" in
|
||||
essid)
|
||||
# не делать дополнения, ждать введенной строки
|
||||
;;
|
||||
files)
|
||||
# дополнение по существующим файлам
|
||||
_files
|
||||
;;
|
||||
profiles)
|
||||
# дополнение из функции
|
||||
# первая переменная описание
|
||||
# вторая массив для дополнения
|
||||
_values 'profiles' $(_netctl_profiles)
|
||||
;;
|
||||
tab)
|
||||
# дополнение из массива
|
||||
_values 'tab' $_netctl_gui_tabs
|
||||
;;
|
||||
settings)
|
||||
# дополнение из массива
|
||||
# флаг -s устанавливает разделитель и включает мультивыбор
|
||||
_values -s ',' 'settings' $_netctl_gui_settings
|
||||
;;
|
||||
esac
|
||||
}
|
||||
{% endhighlight %}
|
||||
</p>
|
||||
|
||||
<h2><a name="conclusion" class="anchor" href="#conclusion"><span class="octicon octicon-link"></span></a>Заключение</h2>
|
||||
<p>Файл хранится в директории <code>/usr/share/zsh/site-functions</code> с произвольным в общем-то именем с префиксом <code>_</code>. Файл примера полностью может быть найден <a href="https://raw.githubusercontent.com/arcan1s/netctl-gui/master/sources/gui/zsh-completions">в моем репозитории</a>.</p>
|
||||
|
||||
<p>Дополнительная информация может быть найдена в репозитории <a href="https://github.com/zsh-users/zsh-completions">zsh-completions</a>. Например, там есть такой <a href="https://github.com/zsh-users/zsh-completions/blob/master/zsh-completions-howto.org">How-To</a>. А еще там есть много примеров.</p>
|
||||
@ -4,6 +4,7 @@ layout: default
|
||||
comment: false
|
||||
share: true
|
||||
back: 1
|
||||
hasTr: true
|
||||
title: Обо мне
|
||||
---
|
||||
<body>
|
||||
|
||||
@ -4,6 +4,7 @@ layout: default
|
||||
comment: false
|
||||
share: false
|
||||
back: 2
|
||||
hasTr: true
|
||||
title: Авторы
|
||||
---
|
||||
<body>
|
||||
|
||||
@ -5,6 +5,7 @@ title: Архив материалов
|
||||
comment: false
|
||||
share: false
|
||||
back: 2
|
||||
hasTr: true
|
||||
---
|
||||
<body>
|
||||
<div class="wrapper">
|
||||
|
||||
@ -5,6 +5,7 @@ title: Блог
|
||||
comment: false
|
||||
share: false
|
||||
back: 1
|
||||
hasTr: true
|
||||
---
|
||||
<body>
|
||||
<div class="wrapper">
|
||||
|
||||
@ -4,6 +4,7 @@ layout: default
|
||||
comment: false
|
||||
share: true
|
||||
back: 0
|
||||
hasTr: true
|
||||
title: arcanis
|
||||
---
|
||||
<body>
|
||||
|
||||
@ -1,5 +1,6 @@
|
||||
---
|
||||
category: ru
|
||||
hasTr: true
|
||||
layout: project
|
||||
title: git-etc
|
||||
short: git-etc
|
||||
|
||||
@ -1,5 +1,6 @@
|
||||
---
|
||||
category: ru
|
||||
hasTr: true
|
||||
layout: default
|
||||
title: Проекты
|
||||
comment: false
|
||||
|
||||
@ -1,5 +1,6 @@
|
||||
---
|
||||
category: ru
|
||||
hasTr: true
|
||||
layout: project
|
||||
title: Netctl GUI
|
||||
short: netctl-gui
|
||||
@ -84,7 +85,7 @@ sudo make install
|
||||
<li><code>-DBUILD_DATAENGINE:BOOL=0</code> - не собирать DataEngine;</li>
|
||||
<li><code>-DBUILD_DOCS:BOOL=0</code> - не собирать документацию;</li>
|
||||
<li><code>-DBUILD_GUI:BOOL=0</code> - не собирать GUI;</li>
|
||||
<li><code>-DBUILD_LIBRARY:BOOL=0</code> - не собирать библиотеку;</li>
|
||||
<li><code>-DBUILD_LIBRARY:BOOL=0</code> - не собирать библиотеку;</li>
|
||||
<li><code>-DBUILD_PLASMOID:BOOL=0</code> - не собирать плазмоид;</li>
|
||||
<li><code>-DUSE_QT5:BOOL=0</code> - использовать Qt4 вместо Qt5 для GUI.</li>
|
||||
</ul>
|
||||
|
||||
@ -1,5 +1,6 @@
|
||||
---
|
||||
category: ru
|
||||
hasTr: true
|
||||
layout: project
|
||||
title: Oblikue strategies
|
||||
short: oblikuestrategies
|
||||
|
||||
@ -1,5 +1,6 @@
|
||||
---
|
||||
category: ru
|
||||
hasTr: true
|
||||
layout: project
|
||||
title: py-text-monitor
|
||||
short: pytextmonitor
|
||||
|
||||
@ -1,5 +1,6 @@
|
||||
---
|
||||
category: ru
|
||||
hasTr: true
|
||||
layout: project
|
||||
title: queued
|
||||
short: queued
|
||||
|
||||
Loading…
Reference in New Issue
Block a user